feat(FEAT-MO-005): 增加行业题材资金流向接口

2026-08-25 01:56:51 +08:00
parent 8174f3f698
commit 7b76dd1353
6 changed files with 379 additions and 6 deletions
@@ -29,6 +29,69 @@
        "required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
        "type": "object"
      },
+      "CapitalFlowDataDto": {
+        "properties": {
+          "category": {
+            "enum": ["industry", "concept", "board"],
+            "type": "string"
+          },
+          "items": {
+            "items": { "$ref": "#/components/schemas/CapitalFlowItemDto" },
+            "type": "array"
+          },
+          "sort": { "enum": ["inflow", "outflow"], "type": "string" }
+        },
+        "required": ["items", "sort", "category"],
+        "type": "object"
+      },
+      "CapitalFlowItemDto": {
+        "properties": {
+          "category": {
+            "enum": ["industry", "concept", "board"],
+            "type": "string"
+          },
+          "code": { "nullable": true, "type": "string" },
+          "flowDefinition": { "type": "string" },
+          "name": { "type": "string" },
+          "netInflow": {
+            "description": "亿元",
+            "nullable": true,
+            "type": "number"
+          },
+          "netOutflow": {
+            "description": "亿元",
+            "nullable": true,
+            "type": "number"
+          },
+          "tradeDate": { "nullable": true, "type": "string" },
+          "turnoverAmount": {
+            "description": "亿元",
+            "nullable": true,
+            "type": "number"
+          }
+        },
+        "required": ["category", "name", "flowDefinition"],
+        "type": "object"
+      },
+      "CapitalFlowResponseDto": {
+        "properties": {
+          "asOf": { "format": "date-time", "type": "string" },
+          "data": {
+            "allOf": [{ "$ref": "#/components/schemas/CapitalFlowDataDto" }],
+            "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"
+      },
      "DependencyHealthDto": {
        "properties": {
          "detail": { "type": "string" },
@@ -535,6 +598,47 @@
        "tags": ["market-overview"]
      }
    },
+    "/api/v1/market-overview/capital-flow": {
+      "get": {
+        "operationId": "MarketStructureController_getCapitalFlow",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": { "maximum": 100, "minimum": 1, "type": "number" }
+          },
+          {
+            "in": "query",
+            "name": "sort",
+            "required": false,
+            "schema": { "enum": ["inflow", "outflow"], "type": "string" }
+          },
+          {
+            "in": "query",
+            "name": "category",
+            "required": false,
+            "schema": {
+              "enum": ["industry", "concept", "board"],
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CapitalFlowResponseDto"
+                }
+              }
+            },
+            "description": ""
+          }
+        },
+        "tags": ["market-overview-structure"]
+      }
+    },
    "/api/v1/market-overview/funds": {
      "get": {
        "operationId": "MarketOverviewController_getFunds",