以下为公开只读接口,无需鉴权。数据仅供学习研究使用。
统一标的 ID
格式:{MARKET}:{VENUE}.{CODE}
- A股股票:
CN:SH.600519
- A股 ETF:
CN:SH.510300、CN:SZ.159919
- A股 LOF:
CN:SZ.161631、CN:SH.501225
- 港股:
HK:HK.00700
- 美股:
US:OQ.AAPL
A股 ETF / LOF 字段格式
ETF 与 LOF 在库中统一标记为 assetType: "etf",仅 A 股市场(market: "CN")。
| 字段 | 说明 | 示例 |
instrumentId | 统一标的 ID | CN:SH.510300 |
code | 6 位数字代码 | 510300、159919 |
symbol | 腾讯行情代码(含交易所前缀) | sh510300、sz159919 |
exchange | 交易所 | SH 或 SZ |
assetType | 固定为 ETF 类 | etf |
board | 板块 key | etf |
nameCn | 基金简称 | 沪深300ETF华泰柏瑞 |
代码段规则(6 位 code):
| 前缀 | 市场 | 类型 |
51 / 52 / 56 / 58 | 沪市 | ETF |
159 | 深市 | ETF |
16 | 深市为主 | LOF(含 QDII-LOF) |
A股 ETF 名录
GET /api/v1/etfs?page=1&pageSize=50&q=红利
GET /api/v1/stocks?market=CN&assetType=etf&page=1&pageSize=50
GET /api/v1/search?q=510300&assetType=etf
推荐专用接口 /etfs;亦可通过 assetType=etf 筛选个股列表或搜索。
个股列表(分页)
GET /api/v1/stocks?page=1&pageSize=50&market=CN&board=cyb&industry=pt01801120&q=茅台
参数:market 市场,board 板块 key,industry 行业代码,assetType 类型(equity / etf),q 关键词。
板块目录
GET /api/v1/boards?market=CN
关键词搜索
GET /api/v1/search?q=茅台&market=CN&assetType=equity&limit=20
行业列表
GET /api/v1/industries?market=CN&level=1&q=银行
行业成分股
GET /api/v1/industries/stocks?code=pt01801120&limit=100
服务状态
GET /api/v1/stats
GET /api/v1/health
管理接口(需鉴权)
同步接口需配置环境变量 SYNC_ADMIN_TOKEN,请求时携带:
Authorization: Bearer <SYNC_ADMIN_TOKEN>
POST /api/v1/admin/sync?mode=full
响应示例(ETF)
{
"page": 1,
"pageSize": 50,
"total": 1168,
"totalPages": 24,
"items": [{
"instrumentId": "CN:SH.510300",
"market": "CN",
"code": "510300",
"symbol": "sh510300",
"nameCn": "沪深300ETF华泰柏瑞",
"assetType": "etf",
"exchange": "SH",
"board": "etf",
"boards": ["etf"],
"industryName": "ETF"
}]
}