# financial-api **Repository Path**: markets2022/financial-api ## Basic Information - **Project Name**: financial-api - **Description**: 同花顺云端A股数据网关(FastAPI) - 已部署魔搭 modeai/financial-api,含前端查询UI - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-17 - **Last Updated**: 2026-10-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 同花顺金融数据网关 · 魔搭一键部署(financial-api) 把「同花顺官方 A股金融数据服务」的 Python 客户端包成一套 **REST API**,跑在魔搭空间的 7860 端口, 对外提供干净的 HTTP 接口,前端/学生/其他项目直接调用,**密钥放在服务端不暴露**。 真实数据来自同花顺云端 `fuyao.aicubes.cn`,本服务是**网关/代理**,不是数据库。 ## 先决条件(必须有) - **`HITHINK_FINANCE_API_KEY`**:同花顺金融数据服务的统一 API Key。 到 https://fuyao.aicubes.cn/admin 注册获取(通常需付费/授权)。**没有它取不到任何数据。** ## 目录结构 ``` financial-api/ ├── Dockerfile # python:3.11 + fastapi,监听 7860 ├── main.py # FastAPI 网关,把 fuyao_client 的各能力暴露为 REST 接口 ├── fuyao_client.py # 原仓库 Python 客户端(原样拷贝,契约一致) ├── marketdb/credentials.py # 极简密钥解析垫片(只读环境变量) ├── requirements.txt ├── deploy.sh # 一键建空间 + 推代码 + 注入密钥 + 部署 └── .env.example ``` ## 部署 ```bash # 方式一:带 key 自动注入 secret HITHINK_FINANCE_API_KEY=你的key bash deploy.sh # 方式二:先建空间,再手动在魔搭控制台加 secret(设置→变量/密钥) bash deploy.sh ``` 部署完访问 `https://modeai-financial-api.ms.show`,接口文档在 `/docs`。 ## 常用接口(返回 JSON) | 接口 | 说明 | 关键参数 | | --- | --- | --- | | `/tickers/search?q=茅台` | 股票名称/代码搜 thscode | `q, exchange, asset_type, limit` | | `/prices/snapshot?thscodes=600519.SH` | 最新行情快照 | `thscodes` 逗号分隔 | | `/prices/historical?thscode=600519.SH&start=2024-01-01&end=2024-12-31` | 历史日K | `start/end` 用日期,自动转毫秒 | | `/financials/income?thscode=600519.SH&period=annual` | 利润表 | `period=annual/quarterly` | | `/financials/indicators?thscode=600519.SH&report=2025-1` | 财务指标 | `report=YYYY-[1-4]` | | `/valuations/snapshot?thscodes=600519.SH` | 估值快照 | `thscodes` | | `/special/limit-up-pool` | 涨停股票池 | `date, page, size` | | `/special/limit-up-ladder` | 连板天梯 | 无 | | `/special/dragon-tiger-list` | 龙虎榜 | `board_type, date` | | `/index/snapshot?thscodes=000300.SH` | 指数行情 | `thscodes` | | `/fund/nav?thscode=xxxxxx.SH&fund_type=exchange` | 基金净值 | `fund_type=otc/exchange/reits` | 完整 35+ 个接口见 `main.py` 与 `/docs`。 ## 安全 - 设了环境变量 `GATEWAY_TOKEN` 后,调用需带 `?token=xxx` 或 `X-Token` 头,防止公网被白嫖。 - 不设则开放调用,适合内部/教学演示。 - 数据版权归同花顺,接口返回内容**不构成投资建议**。 ## 已知限制 - 魔搭免费空间网关对**单请求约 25 秒掐断**;多数接口很快,但超过 10 年的 `prices/historical` 自动分片可能偏慢,注意调用超时。 - 数据来自同花顺云端,需要本服务所在容器能访问外网(魔搭默认可出网)。