实时行情报价 · StockRoute

实时行情报价 GET /v1/quote/{code} https://rt-stock.600044.xyz Bearer

接口:实时行情报价——拉取式 REST。网关对全部订阅码做池化采集(快池约 3 秒/轮,常规池约 15 秒/轮),同一只股票所有用户共享快照,你的每次请求只是读网关内存,不触发额外上游拉取。ts 字段为网关采集时间(Unix 秒)。【域名注意】本 API 与文档站不同域:base=https://rt-stock.600044.xyz,请勿把请求发到 m-stock(文档站)或 api-stock(历史数据)。

限量:调用前须先在门户「个人中心 → 实时行情订阅」添加该代码(未订阅返回 403);每分钟拉取次数与自选容量按档位(超频返回 429,响应头 Retry-After,**固定窗口**=每个整分钟重置,跨整分的高速连打不会累计触发);轮询间隔请 ≥5 秒——快于网关采集节奏的重拉是浪费,持续 >1 次/秒可能被边缘网络层超时断开(客户端表现是 ReadTimeout 而非 429,收到超时请退避到 5s+ 间隔,不是限频语义)。**请启用 HTTP keep-alive/连接池复用连接**(python requests.Session 等同理):每次新建连接重做 TLS 握手,跨境链路端到端延迟会放大约 3 倍(压测实测 4825ms→1562ms)。

权限:门户 token 即可(与历史数据 API 同一把,无需另签)。码必须在该用户有效订阅内;会员超容回落时按先添加先保留。免费版:2 只/10 次·分/日 200 次/30s;实时会员:20 只/30 次·分/日不限/15s。档位说明 →

输入参数

名称	类型	必选	描述
`code`	str	单码必填	6 位数字证券代码(路径参数),如 600900;北交所(4/8 开头)暂不支持
`codes`	str	批量必填	逗号分隔多码(GET /v1/quote?codes=600900,000729),上限 50,一批计 1 次拉取;未订阅/预热中的码逐码落 skipped 不拖垮整批
`fields`	str	可选	返回数据块,逗号分隔:quote(快照,默认)/ book(五档)/ funds(当日资金流);如 fields=quote,book;非法值返回 400 并附合法清单

输出参数

名称	类型	默认显示	描述
`code`	str	Y	证券代码
`market`	str	Y	市场:sh=沪 / sz=深
`ts`	int	Y	网关采集时间(Unix 秒;非交易所撮合时间,延迟口径见注意事项)
`delay_tier_s`	int	Y	你所在档位的名义延迟秒数(典型值)
`quote.last`	float	Y	最新价(元)
`quote.pre_close`	float	Y	昨收(元)
`quote.open`	float	Y	今开(元)
`quote.high`	float	Y	最高(元)
`quote.low`	float	Y	最低(元)
`quote.limit_up`	float	Y	涨停价(元)
`quote.limit_down`	float	Y	跌停价(元)
`quote.avg`	float	Y	均价(元,成交额/成交量)
`quote.volume`	float	Y	累计成交量(股)
`quote.amount`	float	Y	累计成交额(元)
`quote.pct_chg`	float	Y	涨跌幅(%)
`quote.amplitude`	float	Y	振幅(%)
`quote.turnover_rate`	float	Y	换手率(%)
`quote.volume_ratio`	float	Y	量比
`quote.mkt_cap`	float	Y	总市值(元)
`quote.circ_mkt_cap`	float	Y	流通市值(元)
`book.bids`	list	N	五档买盘 [[价格, 挂单量(股)], …],按价格从高到低;fields 含 book 时返回
`book.asks`	list	N	五档卖盘 [[价格, 挂单量(股)], …],按价格从低到高;fields 含 book 时返回
`funds`	object	N	当日资金流,嵌套结构 funds.largeOrderFlow(上游原样透传);big=大单/mass=超大单各含 inflow/outflow/net_inflow 三元组,medium/small 只有 net_inflow;单位元;fields 含 funds 时返回

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

接口示例

curl https://rt-stock.600044.xyz/v1/quote/600900?fields=quote,book,funds -H "Authorization: Bearer <token>"
# 批量(一次拉多只,一批计 1 次)
curl "https://rt-stock.600044.xyz/v1/quote?codes=600900,000729&fields=quote,book" -H "Authorization: Bearer <token>"

import requests
r = requests.get("https://rt-stock.600044.xyz/v1/quote/600900",
                 params={"fields": "quote,book,funds"},
                 headers={"Authorization": "Bearer <token>"})
q = r.json()["quote"]
print(q["last"], q["pct_chg"], "%")   # 28.36 0.9972 %

数据样例 (真实数据:真实数据:长江电力 600900,2026-09-24 收盘(funds 为 09-24 全日实测))

`code` 证券代码	`market` 市场:sh=沪 / sz=深	`ts` 网关采集时间(Unix 秒;非交易所	`delay_tier_s` 你所在档位的名义延迟秒数(典型值)	`quote`	`book`	`funds` 当日资金流,嵌套结构 fun
600900	sh	1790233800	10	{'last': 28.36, 'pre_close': 28.08, 'open': 28.1, 'high': 28.39, 'low': 28.06, 'limit_up': 30.89, 'limit_down': 25.27, 'avg': 28.25, 'volume': 95024277, 'amount': 2684347937.53, 'pct_chg': 0.9972, 'amplitude': 1.1752, 'turnover_rate': 0.0388, 'volume_ratio': 0.83, 'mkt_cap': 693904680000, 'circ_mkt_cap': 693904680000}	{'bids': [[28.35, 218900], [28.34, 145600], [28.33, 98300], [28.32, 261200], [28.31, 87400]], 'asks': [[28.36, 173400], [28.37, 209800], [28.38, 96500], [28.39, 187300], [28.4, 142000]]}	{'largeOrderFlow': {'big_capital_inflow': 512610130, 'big_capital_outflow': 492879440, 'big_capital_net_inflow': 19730690, 'mass_capital_inflow': 528117899, 'mass_capital_outflow': 398566000, 'mass_capital_net_inflow': 129551899, 'medium_capital_net_inflow': -58390290, 'small_capital_net_inflow': -90892299}}

[
  {
    "book": {
      "asks": [
        [
          28.36,
          173400
        ],
        [
          28.37,
          209800
        ],
        [
          28.38,
          96500
        ],
        [
          28.39,
          187300
        ],
        [
          28.4,
          142000
        ]
      ],
      "bids": [
        [
          28.35,
          218900
        ],
        [
          28.34,
          145600
        ],
        [
          28.33,
          98300
        ],
        [
          28.32,
          261200
        ],
        [
          28.31,
          87400
        ]
      ]
    },
    "code": "600900",
    "delay_tier_s": 10,
    "funds": {
      "largeOrderFlow": {
        "big_capital_inflow": 512610130,
        "big_capital_net_inflow": 19730690,
        "big_capital_outflow": 492879440,
        "mass_capital_inflow": 528117899,
        "mass_capital_net_inflow": 129551899,
        "mass_capital_outflow": 398566000,
        "medium_capital_net_inflow": -58390290,
        "small_capital_net_inflow": -90892299
      }
    },
    "market": "sh",
    "quote": {
      "amount": 2684347937.53,
      "amplitude": 1.1752,
      "avg": 28.25,
      "circ_mkt_cap": 693904680000,
      "high": 28.39,
      "last": 28.36,
      "limit_down": 25.27,
      "limit_up": 30.89,
      "low": 28.06,
      "mkt_cap": 693904680000,
      "open": 28.1,
      "pct_chg": 0.9972,
      "pre_close": 28.08,
      "turnover_rate": 0.0388,
      "volume": 95024277,
      "volume_ratio": 0.83
    },
    "ts": 1790233800
  }
]

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

注意事项

【域名】base=https://rt-stock.600044.xyz,与文档站(m-stock)、历史数据(api-stock)不同域。
前置条件:先在门户「个人中心 → 实时行情订阅」添加代码(免费版 5 只起,容量随档位);未订阅返回 403 not_subscribed。
延迟口径:分池采集的宽口径——delay_tier_s 是典型值而非保证值,与高档用户同订一只票时可能拿到快于本档的数据。
限频:429 按固定窗口计数(每个整分钟重置,Retry-After=距重置秒数);轮询间隔 ≥5 秒,持续高于采集节奏的请求可能被边缘网络层直接断开(客户端 ReadTimeout),这不是限频,退避即可。
刚订阅的码首个数据需等一个采集周期(最长约 15 秒),期间返回 503 warming_up。
无效代码(上游确认不存在)会在订阅页灰显;重新添加会再次核验。长期停牌股不灰显但可能无行情。
funds 为独立上游接口,建议与 quote 分开轮询或用较长间隔;fields 含 funds 且上游故障时返回 502。

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