数据集列表 · StockRoute

数据集列表 GET /api/datasets Bearer

接口:datasets——返回数据平台全部对你可见的数据集:字段单位口径(units)、更新 SLA、会员准入、PIT 规则。建议调用一次保存本地,作为后续/api/query 等直查接口的元数据字典。

限量:单次返回全部可见数据集(当前 90+ 条);建议本地缓存,每日刷新一次即可。

权限:注册即可调用。按身份过滤:需历史会员的数据集对免费版不返回。档位说明 →

输出参数

名称	类型	默认显示	描述
`name`	str	Y	数据集唯一名(点分域,如 kline / fin.profit)
`label`	str	Y	数据集中文名
`domain`	str	Y	所属域(quote/financial/lhb/moneyflow…)
`units`	object	Y	字段→单位口径映射(判 45 是 45% 还是 0.45 的依据)
`status`	str	Y	active=在产 / planned=待接入
`sla`	object	Y	更新时效承诺 {type: trade-day, days: 1}
`min_points`	int	Y	0=免费可用;>0=基础档起(需开通会员,2026-09-29 档位制)
`open`	bool	Y	是否对外开放(全部数据集开放,准入走 min_points=会员判定)
`access`	str	Y	访问方式:query=GET /api/query 直查;或专用端点路径(如 /api/kline);internal=内部数据集暂不对外
`params`	object	N	access=query 时返回:该数据集在 /api/query 接受的参数清单(code/start/end/limit)及各自是否必填——机器可读,客户端不用猜参数名;传白名单外参数返回 422
`pit`	str	N	PIT 规则说明(财报族才有,如 pubDate strictly < as_of)

units 口径随每个响应返回——消费方据此判 45 是 45% 还是 0.45,不必猜。

接口示例

curl -H "Authorization: Bearer <token>" https://api-stock.600044.xyz/api/datasets

import requests
r = requests.get("https://api-stock.600044.xyz/api/datasets",
                 headers={"Authorization": "Bearer <token>"}).json()
units = {d["name"]: d["units"] for d in r["datasets"]}   # 单位口径字典,落地保存

数据样例 (真实数据:贵州茅台 600519)

`name` 数据集唯一名(点分域,如 kline	`label` 数据集中文名	`domain` 所属域(quote/financia	`status` active=在产 / planne	`sla` 更新时效承诺 {type: trad	`min_points` 0=免费可用;>0=基础档起(需开通	`open` 是否对外开放(全部数据集开放,准入走	`access` 访问方式:query=GET /ap	`units` 字段→单位口径映射(判 45 是 4	`pit` PIT 规则说明(财报族才有,如 p
kline	日K线	quote	active	{'type': 'trade-day', 'days': 1}	0	True	query	{'volume': '股', 'amount': '元'}	null
fin.profit	盈利能力(点时)	financial	active	{'type': 'disclosure', 'days': 1}	0	True	{'roeAvg': '比率', 'netProfit': '元', 'epsTTM': '元/股'}	pubDate strictly < as_of

[
  {
    "access": "query",
    "domain": "quote",
    "label": "\u65e5K\u7ebf",
    "min_points": 0,
    "name": "kline",
    "open": true,
    "pit": null,
    "sla": {
      "days": 1,
      "type": "trade-day"
    },
    "status": "active",
    "units": {
      "amount": "\u5143",
      "volume": "\u80a1"
    }
  },
  {
    "domain": "financial",
    "label": "\u76c8\u5229\u80fd\u529b(\u70b9\u65f6)",
    "min_points": 0,
    "name": "fin.profit",
    "open": true,
    "pit": "pubDate strictly \u003c as_of",
    "sla": {
      "days": 1,
      "type": "disclosure"
    },
    "status": "active",
    "units": {
      "epsTTM": "\u5143/\u80a1",
      "netProfit": "\u5143",
      "roeAvg": "\u6bd4\u7387"
    }
  }
]

表头第二行为字段含义(悬停无截断完整版见上方「输出参数表」);首列固定,横向滚动查看更多字段。

注意事项

units 是跨源运算的前提:不同源同名字段单位可能不同,先查 units 再算。

← 返回接口列表 · 错误码:401 无效token / 403 需会员(该数据集基础档起) / 404 无数据 / 422 缺必填 / 429 限速或月配额 / 503 授权暂不可用(fail-closed)