历史行情数据接口

快速开始

在个人中心创建 API Key。请求时优先将 Key 放入 X-Api-Key 请求头，不要把 Key 写进浏览器前端、公开仓库或截图。

MCP 接入

支持无状态 Streamable HTTP MCP。将服务地址设为 https://jinniu.lingxideai.com/mcp，并在请求头中使用 Authorization: Bearer YOUR_API_KEY；也兼容 X-Api-Key。

请帮我添加并连接这个MCP服务：
名称：金牛行情数据
类型：Streamable HTTP
地址：https://jinniu.lingxideai.com/mcp
鉴权：Authorization: Bearer YOUR_API_KEY

安装后请读取tools/list验证连接；如果不能自动添加，请告诉我配置入口。

连接验证

curl -X POST 'https://jinniu.lingxideai.com/mcp' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"example","version":"1.0"}}}'

连接后通过 tools/list 获取31个工具及其输入参数说明；通过 tools/call 查询数据。返回数据仍使用正式的 data.fields + data.items 结构。

基础信息与分类

股票列表

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/stock_basic' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Api-Key: YOUR_API_KEY' \\
  -d '{
    "name": "平安银行",
    "list_status": "L"
  }'

请求字段

返回示例

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "symbol", "name", "area", "industry", "fullname", "enname", "cnspell", "market", "exchange", "curr_type", "list_status", "list_date", "delist_date", "is_hs", "act_name", "act_ent_type"],
    "items": [["000001.SZ", "000001", "平安银行", "深圳", "银行", "平安银行股份有限公司", "Ping An Bank Co., Ltd.", "PAYH", "主板", "SZSE", "CNY", "L", "19910403", "", "N", null, null]]
  }
}

返回参数

curl -X POST 'https://jinniu.lingxideai.com/api/trade_cal' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"exchange":"BSE","start_date":"20260810","end_date":"20260907","limit":64}'

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["exchange", "cal_date", "is_open", "pretrade_date"],
    "items": [["BSE", "20260810", 1, "20260807"]]
  }
}

curl -X POST 'https://jinniu.lingxideai.com/api/stock_st' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"trade_date":"20260820","limit":1}'

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "name", "trade_date", "type", "type_name"],
    "items": [["000003.SZ", "ST金田A", "20010102", "ST", "风险警示板"]]
  }
}

curl -X POST 'https://jinniu.lingxideai.com/api/namechange' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"000001.SZ","limit":1}'

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "name", "start_date", "end_date", "ann_date", "change_reason"],
    "items": [["000001.SZ", "深发展A", "19910403", "20061008", "19910403", "其他"]]
  }
}

curl -X POST 'https://jinniu.lingxideai.com/api/stock_company' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"000001.SZ","limit":1}'

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "com_name", "com_id", "exchange"],
    "items": [["688322.SH", "奥比中光科技集团股份有限公司", "91440300061436270G", "SSE"]]
  }
}

curl -X POST 'https://jinniu.lingxideai.com/api/bse_mapping' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"limit":1}'

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["name", "o_code", "n_code", "list_date"],
    "items": [["永顺生物", "839729.BJ", "920729.BJ", "20200727"]]
  }
}

curl -X POST 'https://jinniu.lingxideai.com/api/sw_index_basic' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"801780.SI","limit":1}'

{"success":true,"message":"","data":{"fields":["ts_code","name","market","publisher","category","base_date","base_point","list_date"],"items":[["801780.SI","银行","SW","上海申银万国证券研究所有限公司","一级行业指数","19991230",1000.0,"20140221"]],"meta":{"returned_count":1,"truncated":false}}}

curl -X POST 'https://jinniu.lingxideai.com/api/sw_index_classify' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"level":"L1","src":"SW2021","limit":2}'

{"success":true,"message":"","data":{"fields":["index_code","industry_name","level","industry_code","is_pub","parent_code","src"],"items":[["801010.SI","农林牧渔","L1","110000","1","0","SW2021"]],"meta":{"returned_count":1,"truncated":false}}}

curl -X POST 'https://jinniu.lingxideai.com/api/sw_index_member' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"l1_code":"801780.SI","is_new":"Y","limit":2}'

{"success":true,"message":"","data":{"fields":["l1_code","l1_name","l2_code","l2_name","l3_code","l3_name","ts_code","name","in_date","out_date","is_new"],"items":[["801780.SI","银行","801783.SI","股份制银行Ⅱ","857831.SI","股份制银行Ⅲ","000001.SZ","平安银行","19910403",null,"Y"]],"meta":{"returned_count":1,"truncated":false}}}

curl -X POST 'https://jinniu.lingxideai.com/api/index_member' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"002310.SZ","as_of_date":"20200102","limit":20}'

{"success":true,"message":"","data":{"fields":["index_code","index_name","con_code","con_name","in_date","out_date","is_new"],"items":[["801720.SI","建筑装饰(申万)","002310.SZ","东方新能","20140221","20241227","N"]],"meta":{"returned_count":1,"truncated":false,"as_of_date":"20200102"}}}

查询股票历史日线

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/daily' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Api-Key: YOUR_API_KEY' \\
  -d '{
    "ts_code": "000001.SZ",
    "start_date": "20260820",
    "end_date": "20260820",
    "limit": 1
  }'

股票日线请求参数

股票日线返回说明

返回示例

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "trade_date", "open", "high", "low", "close", "pre_close", "change", "pct_chg", "vol", "amount"],
    "items": [["000001.SZ", "20260804", 12.31, 12.48, 12.20, 12.42, 12.28, 0.14, 1.14, 1234567, 1523400000]]
  }
}

返回字段

查询指数历史日线

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/index_daily' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{
    "ts_code": "000300.SH",
    "start_date": "20260820",
    "end_date": "20260820",
    "limit": 1
  }'

仅支持单个指数代码；可使用 trade_date、start_date、end_date、limit 和 fields 筛选。返回原始不复权指数行情，标准字段为股票日线标准字段，不支持盘后固定成交量和成交额字段；返回结构同样为 fields 与 items。单次最多返回 5000 条。

请求参数

返回示例

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "trade_date", "open", "high", "low", "close", "pre_close", "change", "pct_chg", "vol", "amount"],
    "items": [["000300.SH", "20260814", 4653.7182, 4685.6612, 4637.1282, 4665.8812, 4657.9752, 7.906, 0.17, 1234567, 1523400000]]
  }
}

返回字段

查询申万指数历史日线

查询申万行业指数日线行情及估值、市值指标，需要开通“申万指数日线”权限。指数代码使用 .SI 后缀。

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/sw_daily' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"801780.SI","start_date":"20260921","end_date":"20260922","limit":2}'

请求参数

返回字段与单位

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","trade_date","name","open","low","high","close","change","pct_change","vol","amount","pe","pb","float_mv","total_mv"],"items":[["801780.SI","20260922","银行",4139.17,4118.99,4153.04,4146.78,-4.31,-0.1,289687.0,2242988.0,6.32,0.52,258046089.0,1123792502.0]],"meta":{"returned_count":1,"truncated":false}}}

查询 ETF 历史日线

仅支持单个 ETF 代码，返回原始不复权日线。字段、日期参数和返回结构与指数日线一致。

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/etf_daily' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Api-Key: YOUR_API_KEY' \\
  -d '{
    "ts_code": "159995.SZ",
    "start_date": "20260820",
    "end_date": "20260820",
    "limit": 1
  }'

请求参数

返回示例

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "trade_date", "open", "high", "low", "close", "pre_close", "change", "pct_chg", "vol", "amount"],
    "items": [["159995.SZ", "20260805", 1.245, 1.268, 1.238, 1.262, 1.241, 0.021, 1.69, 1256345, 158726.48]]
  }
}

返回字段

查询股票复权因子

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/adj_factor' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{
    "ts_code": "000001.SZ",
    "start_date": "20260820",
    "end_date": "20260820",
    "limit": 1
  }'

仅支持单个 A 股股票代码。支持 trade_date、start_date、end_date、limit 和 fields；返回结构为 fields 与 items，单次最多返回 5000 条。

请求参数

返回示例

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "trade_date", "adj_factor"],
    "items": [["000001.SZ", "20260814", 181.284]]
  }
}

返回字段

查询 ETF 复权因子

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/etf_adj_factor' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{
    "ts_code": "510300.SH",
    "start_date": "20260820",
    "end_date": "20260820",
    "limit": 1
  }'

请求参数

返回示例

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["ts_code", "trade_date", "adj_factor"],
    "items": [["510300.SH", "20260805", 1.025]]
  }
}

返回字段

查询历史分钟 K 线

分钟线按标的类别拆分为股票、ETF、交易所指数与申万指数四类独立接口。每个接口均支持 1min、5min、15min、30min、60min。

股票分钟 K 线

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/stk_mins' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"000001.SZ","freq":"1min","start_date":"2026-08-20 09:30:00","end_date":"2026-08-20 09:31:00","limit":2}'

请求字段

返回字段

返回示例

{
  "success": true,
  "message": "",
  "data": {"fields": ["ts_code", "trade_time", "open", "close", "high", "low", "vol", "amount"], "items": [["000001.SZ", "2026-08-05 09:35:00", 12.31, 12.34, 12.36, 12.28, 1234500, 15234000.0]], "meta": {"matched_count": 240, "returned_count": 1, "truncated": true}}
}

ETF 分钟 K 线

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/etf_mins' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"159995.SZ","freq":"1min","start_date":"2026-08-20 09:30:00","end_date":"2026-08-20 09:31:00","limit":2}'

请求字段

返回字段

返回示例

{
  "success": true,
  "message": "",
  "data": {"fields": ["ts_code", "trade_time", "open", "close", "high", "low", "vol", "amount"], "items": [["159995.SZ", "2026-08-05 09:35:00", 1.245, 1.247, 1.249, 1.242, 853000, 1064350.0]], "meta": {"matched_count": 240, "returned_count": 1, "truncated": false}}
}

指数分钟 K 线

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/idx_mins' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"000300.SH","freq":"1min","start_date":"2026-08-20 09:30:00","end_date":"2026-08-20 09:31:00","limit":2}'

请求字段

返回字段

返回示例

{
  "success": true,
  "message": "",
  "data": {"fields": ["ts_code", "trade_time", "open", "close", "high", "low", "vol", "amount"], "items": [["000300.SH", "2026-08-05 09:35:00", 3985.20, 3988.65, 3990.18, 3982.76, 2864100, 3589240000.0]], "meta": {"matched_count": 240, "returned_count": 1, "truncated": false}}
}

申万指数分钟 K 线

查询申万行业指数历史分钟 K 线，需要开通“申万指数分钟线”权限。指数代码使用 .SI 后缀，例如申万 A 指为 801003.SI。

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/sw_mins' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"801003.SI","freq":"1min","start_date":"2026-09-21 09:30:00","end_date":"2026-09-21 15:00:00","limit":241}'

请求字段

返回字段

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","trade_time","open","close","high","low","vol","amount"],"items":[["801003.SI","2026-09-21 09:30:00",4644.318,4644.154,4644.318,4644.154,1438409200,22328654000]],"meta":{"matched_count":241,"returned_count":1,"truncated":true}}}

调用建议

• 单次最多返回 5,000 条，不限制固定自然日跨度；超出时按时间区间分批查询。
• 申万指数分钟线单次最多返回 5,000 条。
• 增量同步时记录本地最后一条 trade_time，下次从该时间之后开始请求。
• 同一时间范围与参数的重复请求不会产生新信息，应优先复用已保存结果。
• 如需多个周期，可按业务需要直接请求对应周期；不要将不同标的类型的代码混用到同一接口。

期货与期权

期货、期权均使用独立权限与独立接口；返回统一采用 data.fields + data.items，每行按字段顺序排列。

期货分钟线

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/fut_mins' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"C1305.DCE","freq":"1min","start_date":"2013-01-04 09:30:00","end_date":"2013-01-04 09:31:00","limit":2}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","trade_time","open","close","high","low","vol","amount","oi"],"items":[["CU2310.SHF","2023-08-25 15:00:00",68920,68930,68940,68910,373,128543250,146733]],"meta":{"matched_count":100,"returned_count":100,"truncated":false}}}

期权合约信息

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/opt_basic' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"90001246.SZ","limit":1,"fields":"ts_code,name,exchange,call_put,exercise_price,maturity_date"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","name","exchange","call_put","exercise_price","maturity_date"],"items":[["10007976.SH","期权合约","SSE","C",3.5,"20260923"]],"meta":{"returned_count":1,"truncated":false}}}

期权日线

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/opt_daily' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"90001246.SZ","trade_date":"20221101","limit":1}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","trade_date","exchange","pre_settle","pre_close","open","high","low","close","settle","vol","amount","oi"],"items":[["10007976.SH","20260904","SSE",0.1267,0.1267,0.127,0.138,0.125,0.137,0.1368,8200,108.6,6499]],"meta":{"returned_count":1,"truncated":false}}}

期权分钟线

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/opt_mins' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"90001246.SZ","freq":"1min","start_date":"2022-11-01 09:30:00","end_date":"2022-11-01 09:31:00","limit":2}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","trade_time","open","close","high","low","vol","amount","oi"],"items":[["10007976.SH","2024-09-27 15:00:00",0.1267,0.137,0.137,0.1267,44,60280,6499]],"meta":{"matched_count":100,"returned_count":100,"truncated":false}}}

实时行情

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

股票实时分钟线

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_min' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"000001.SZ","freq":"1min"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","freq","trade_time","open","close","high","low","vol","amount"],"items":[["000001.SZ","1min","2026-09-07 10:30:00",12.31,12.34,12.36,12.28,1234500,15234000]],"meta":{"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-07 10:30:02","max_age_seconds":2}}}

A股日内分钟线

获取单只A股当日开盘以来的全部分钟K线，返回时间从早到晚排列。该接口跟随“股票实时分钟”权限和实时接口频率限制。

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_min_daily' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"600000.SH","freq":"1min"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","freq","trade_time","open","close","high","low","vol","amount"],"items":[["600000.SH","1min","2026-09-07 09:30:00",9.43,9.43,9.43,9.43,270300,2548929],["600000.SH","1min","2026-09-07 09:31:00",9.43,9.44,9.44,9.43,306500,2891342]],"meta":{"matched_count":2,"returned_count":2,"truncated":false,"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-07 09:31:02"}}}

交易所指数实时分钟线

查询上交所、深交所和北交所指数的最新分钟 K 线，需要单独开通“指数实时”权限。申万 .SI 代码不适用于本接口。

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_idx_min' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"000001.SH,399300.SZ","freq":"1min"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","freq","trade_time","open","close","high","low","vol","amount"],"items":[["000001.SH","1min","2026-09-22 15:00:00",3952.128,3952.128,3952.128,3952.128,5888482,9424701045.4]],"meta":{"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-22 15:00:02","max_age_seconds":2}}}

交易所指数盘中分钟线

查询单个交易所指数当日开盘以来的全部分钟 K 线，返回时间从早到晚排列，并沿用“指数实时”权限。

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_idx_min_daily' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"399300.SZ","freq":"5min"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","freq","trade_time","open","close","high","low","vol","amount"],"items":[["399300.SZ","5min","2026-09-22 09:35:00",4621.2,4628.4,4630.1,4618.6,128335000,2839740000]],"meta":{"matched_count":48,"returned_count":48,"truncated":false,"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-22 15:00:02"}}}

申万指数实时行情

查询申万指数的最新实时截面，需要单独开通“申万指数实时”权限。该接口返回当日开盘、最高、最低和最新点位，不是逐分钟 K 线；申万历史分钟请使用 /api/sw_mins。

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_sw_k' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"801003.SI"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","name","trade_time","pre_close","open","high","low","close","vol","amount"],"items":[["801003.SI","申万Ａ指","2026-09-22 15:07:00",4644.15,4675.841,4686.74,4634.995,4646.64,115006220219,2126911542039]],"meta":{"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-22 15:07:02","max_age_seconds":2}}}

ETF 实时分钟线

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_etf_min' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"159995.SZ","freq":"1min"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","freq","trade_time","open","close","high","low","vol","amount"],"items":[["510300.SH","5min","2026-09-07 10:30:00",3.86,3.87,3.88,3.85,853000,3297110]],"meta":{"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-07 10:30:02","max_age_seconds":2}}}

ETF 盘中分钟线

获取单只 ETF 当日开盘以来的全部分钟 K 线，返回时间从早到晚排列。该接口沿用“ETF 实时分钟”权限，并计入实时接口频率限制。

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_etf_min_daily' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"159995.SZ","freq":"1min"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","freq","trade_time","open","close","high","low","vol","amount"],"items":[["159995.SZ","1min","2026-09-09 09:30:00",1.114,1.117,1.119,1.114,3669100,4093438.8],["159995.SZ","1min","2026-09-09 09:31:00",1.117,1.116,1.118,1.115,1714300,1913644.2]],"meta":{"matched_count":241,"returned_count":241,"truncated":false,"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-09 15:00:02","max_age_seconds":19802}}}

期货实时分钟线

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

请求参数

请求示例

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

返回参数

返回示例

{"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}}}

期货盘中分钟线

获取单个期货合约当前交易日开市以来的全部分钟 K 线，覆盖日盘和夜盘并按时间从早到晚排列。需要开通“期货实时分钟”权限；可选回放日期仅支持当前交易日或前一交易日。

请求参数

请求示例

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

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","freq","trade_time","open","close","high","low","vol","amount","oi"],"items":[["RB2610.SHF","1min","2026-09-09 09:01:00",3102,3103,3104,3100,418,12967940,510912],["RB2610.SHF","1min","2026-09-09 09:02:00",3103,3101,3104,3101,365,11322050,510706]],"meta":{"matched_count":225,"returned_count":225,"truncated":false,"cached":false,"stale":false,"cache_ttl_seconds":2,"cache_age_seconds":0,"server_received_at":"2026-09-09 15:00:02","max_age_seconds":21542}}}

股票实时日线

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_k' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"000001.SZ"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","name","pre_close","high","open","low","close","vol","amount","num"],"items":[["000001.SZ","平安银行",12.28,12.48,12.31,12.2,12.42,1234567,152340000,8654]],"meta":{"cached":false,"stale":false,"cache_ttl_seconds":0,"cache_age_seconds":0,"server_received_at":"2026-09-07 10:30:02","max_age_seconds":null}}}

ETF 实时日线

请求参数

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/rt_etf_k' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"159995.SZ"}'

返回参数

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","name","pre_close","high","open","low","close","vol","amount","num"],"items":[["510300.SH","沪深300ETF",3.85,3.88,3.86,3.84,3.87,853000,3297110,1260]],"meta":{"cached":false,"stale":false,"cache_ttl_seconds":0,"cache_age_seconds":0,"server_received_at":"2026-09-07 10:30:02","max_age_seconds":null}}}

实时返回元数据

调用限制与错误码

• 历史数据接口每个账户每分钟最多 60 次；实时数据接口每个账户每分钟最多 100 次。账户到期、权限关闭或超限时，接口会拒绝请求。
• 历史数据接口单次最多返回5000条；申万指数日线、申万基础信息和ETF复权因子等原上限低于5000条的接口继续执行各自较低上限。删除或重新生成 API Key 不会重置账户调用次数。
• 分钟线不限制固定自然日跨度；超过单次返回量时请按时间范围分批查询。
• 所有 API 支持可选 gzip 响应压缩：带 Accept-Encoding: gzip 时返回压缩内容；不带时按默认 JSON 返回。常见浏览器和 HTTP 客户端会自动协商并解压。
• 请妥善保管 API Key。发现泄露时，在个人中心轮换 Key，旧 Key 会立即失效。
• 数据仅限研究、学习和个人使用，使用者应自行核验并遵守适用的法律、平台与数据使用规则。

规范调用建议

• 同一 API Key 最多同时发起 3 个并发请求；达到上限时服务端会返回 429 和 Retry-After: 2，请等待已有请求完成后再继续下一批。
• 按代码和时间范围分批查询，并通过 fields 仅请求所需字段；已成功获取的数据请保存在本地，避免重复拉取。
• 收到 429 时必须按照 Retry-After 等待后再重试，不要立即连续重发；网络异常建议间隔 2、5、10 秒逐步重试，最多 3 次。
• 大批量历史数据建议安排在非交易时段执行；实时接口仅查询当前业务需要的代码，不要循环请求全市场。

import json
import time
import requests

API_KEY = "YOUR_API_KEY"
URL = "https://jinniu.lingxideai.com/api/stk_mins"

session = requests.Session()
session.headers.update({
    "X-Api-Key": API_KEY,
    "Content-Type": "application/json",
    "Accept-Encoding": "gzip",
})

def query_minutes(ts_code, start_date, end_date):
    payload = {
        "ts_code": ts_code,
        "freq": "1min",
        "start_date": start_date,
        "end_date": end_date,
        "fields": "ts_code,trade_time,open,close,high,low,vol,amount",
        "limit": 4000,
    }
    retry_delays = [2, 5, 10]

    for attempt in range(4):
        try:
            response = session.post(URL, json=payload, timeout=60)
            if response.status_code == 429:
                time.sleep(int(response.headers.get("Retry-After", 5)))
                continue
            response.raise_for_status()
            return response.json()
        except requests.RequestException:
            if attempt == 3:
                raise
            time.sleep(retry_delays[attempt])

# 按日期串行查询；同一 API Key 最多同时运行 3 个并发请求。
dates = ["2026-09-08", "2026-09-09", "2026-09-10"]
for trade_date in dates:
    result = query_minutes(
        ts_code="000001.SZ",
        start_date=f"{trade_date} 09:30:00",
        end_date=f"{trade_date} 15:00:00",
    )
    with open(f"000001.SZ_{trade_date}.json", "w", encoding="utf-8") as file:
        json.dump(result, file, ensure_ascii=False)
    time.sleep(1)

错误码

400 参数错误，401 API Key 无效或已删除，403 账户期限或数据权限不满足，429 请求超过限额，503 行情数据暂不可用。错误响应包含 code、message 和 data 字段。