feat(FEAT-MO-005): 增加全市场成交额趋势接口

2026-08-25 02:04:00 +08:00
parent 7b76dd1353
commit ad40ffffc4
6 changed files with 381 additions and 3 deletions
@@ -545,6 +545,54 @@
        },
        "required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
        "type": "object"
+      },
+      "TurnoverPointDto": {
+        "properties": {
+          "amount": {
+            "description": "该时间区间成交额，单位亿元",
+            "type": "number"
+          },
+          "cumulativeAmount": {
+            "description": "当日累计成交额，单位亿元",
+            "type": "number"
+          },
+          "time": { "format": "date-time", "type": "string" }
+        },
+        "required": ["time", "amount", "cumulativeAmount"],
+        "type": "object"
+      },
+      "TurnoverTrendDataDto": {
+        "properties": {
+          "granularity": { "enum": ["5", "15"], "type": "string" },
+          "invalidPointCount": { "type": "number" },
+          "marketCount": { "maximum": 3, "minimum": 1, "type": "number" },
+          "points": {
+            "items": { "$ref": "#/components/schemas/TurnoverPointDto" },
+            "type": "array"
+          },
+          "unit": { "example": "亿元", "type": "string" }
+        },
+        "required": ["points", "granularity", "unit", "marketCount", "invalidPointCount"],
+        "type": "object"
+      },
+      "TurnoverTrendResponseDto": {
+        "properties": {
+          "asOf": { "format": "date-time", "type": "string" },
+          "data": {
+            "allOf": [{ "$ref": "#/components/schemas/TurnoverTrendDataDto" }],
+            "nullable": true,
+            "type": "object"
+          },
+          "snapshotId": { "type": "string" },
+          "source": { "enum": ["tdx", "aktools", "mixed"], "type": "string" },
+          "status": {
+            "enum": ["fresh", "delayed", "partial", "unavailable"],
+            "type": "string"
+          },
+          "warnings": { "items": { "type": "string" }, "type": "array" }
+        },
+        "required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
+        "type": "object"
      }
    }
  },
@@ -873,6 +921,38 @@
        },
        "tags": ["market-overview"]
      }
+    },
+    "/api/v1/market-overview/turnover-trend": {
+      "get": {
+        "operationId": "MarketStructureController_getTurnoverTrend",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "tradeDate",
+            "required": false,
+            "schema": { "pattern": "^\\d{8}$", "type": "string" }
+          },
+          {
+            "in": "query",
+            "name": "interval",
+            "required": false,
+            "schema": { "enum": ["5", "15"], "type": "string" }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TurnoverTrendResponseDto"
+                }
+              }
+            },
+            "description": ""
+          }
+        },
+        "tags": ["market-overview-structure"]
+      }
    }
  },
  "servers": [],