API REFERENCE

期货实时分钟

实时行情

股票、ETF、交易所指数、申万指数与期货分开请求。返回统一采用 data.fields + data.items，并在 data.meta 中给出数据时间与缓存状态。

期货实时分钟线

POSThttps://jinniu.ziyoutang.com/api/rt_fut_min

获取一个或多个期货合约的最新分钟 K 线，支持日盘和夜盘。需要开通“期货实时分钟”权限。

请求参数

参数必填说明
ts_code是一个或多个仍在交易的期货合约代码，逗号分隔，单次最多 100 个，例如 RB2701.SHF,RB2705.SHF。请先通过期货合约信息核对 list_date 和 delist_date；交割日期不代表仍可交易。
freq是1min、5min、15min、30min 或 60min。
fields否可选字段：ts_code,freq,trade_time,open,close,high,low,vol,amount,oi。

请求示例

curl -X POST 'https://jinniu.ziyoutang.com/api/rt_fut_min' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"RB2701.SHF","freq":"1min"}'

返回参数

字段类型说明
success / messageboolean / string请求是否成功、响应消息；无计量单位。
data.fields / data.itemsarray / array返回列名及最新分钟数据；每行按 fields 顺序排列。
ts_code / freq / trade_timestring期货合约代码、K 线周期和交易时间；文本字段，无计量单位。
open / close / high / lownumber开盘、收盘、最高、最低价；单位为该期货合约的报价单位。
volnumber成交量，单位：手。
amountnumber成交金额，单位：元人民币。
oinumber持仓量，单位：手。
data.metaobject缓存状态和数据时间，字段说明见本节末尾。

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","freq","trade_time","open","close","high","low","vol","amount","oi"],"items":[["RB2610.SHF","1min","2026-09-09 15:00:00",3098,3097,3099,3097,627,19427810,482137]],"meta":{"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-09 15:00:02","max_age_seconds":2}}}

实时返回元数据

字段说明
cached是否命中服务器缓存；实时分钟线可能为 true，实时日线固定为 false。
stale是否在行情服务临时失败时返回短时缓存；实时日线不使用缓存，固定为 false。
cache_ttl_seconds缓存有效期，单位：秒；实时分钟线为 2 秒，实时日线为 0 秒。
cache_age_seconds当前缓存已存在的时长，单位：秒；实时日线固定为 0。
server_received_at服务器接收到行情数据的北京时间；时间字段，无计量单位。
max_age_seconds返回 K 线中最旧数据距服务器当前时间的最大时长，单位：秒；无法计算时为 null。