HTTP 接口按需查询产品列表、实时报价、K 线、市场状态和财务信息;WebSocket 长连接按产品或按市场订阅实时推送。覆盖股票、期货、外汇与数字货币。
[
{
"status": 0,
"market": "NASDAQ",
"code": "AAPL",
"message": "SUCCESS",
"data": {
"name": "Apple Inc.",
"price": 333.69,
"open": 333.26,
"high": 334.54,
"low": 330.61,
"close": 330.32,
"change": "3.370",
"up": "1.020",
// ...
}
}
]
卡片里的代码就是接口参数 market 的取值,一套写法查所有市场。
纳斯达克、纽约证券交易所、美国证券交易所。
香港交易所的股票行情,财务信息支持繁体中文。
东京、名古屋、福冈三个交易所与韩国交易所。
印度、马来西亚、越南、印度尼西亚。
美国、德国、英国、新加坡、日本、香港、马来西亚。
全球外汇、数字货币、差价合约、股票股指。
另有土耳其、巴西、尼日利亚等市场和各国指数,完整清单见 国家与市场参数 →
查询用 HTTP,持续更新用 WebSocket。
整个市场一次取回,或按产品代码查一个、多个;盘口和逐笔交易一并给出。
1 分钟到月线共 9 个周期;历史数据按页往前翻,也可以按起止时间取。
一条长连接,按产品或按整个市场订阅,行情一有变化就推送过来。
一个市场的全部产品一次取回,带产品代码、名称和产品类型。
今天明天是否交易日、交易时段、节假日标记,以及距开盘或收盘的倒计时。
公司介绍、财务字段、板块涨跌、排行榜、IPO、分红与拆股,以及多语言的通用新闻。
按使用场景选择接入方式。
全部是 GET 请求,返回 JSON;请求头里带上密钥即可,适合按需拉取。
GET /api/mini_prices
密钥写在连接地址里,连上后发送订阅命令,持续接收行情推送。
/sub/NASDAQ:AAPL
每把密钥按接口和市场有各自的额度,已用和剩余次数随时可查。
GET /api/use/{type}/times
标准的 HTTP 与 WebSocket,任何语言都能调用;文档里每个接口都有参数说明和返回示例。
curl -H "Authorization: 你的密钥" \
"http://接口地址/api/mini_prices?market=NASDAQ&symbol=AAPL"
# 返回
[
{
"status": 0,
"market": "NASDAQ",
"code": "AAPL",
"message": "SUCCESS",
"data": { "price": 333.69, ... }
}
]
import requests
KEY = "你的密钥"
url = "http://接口地址/api/mini_prices"
resp = requests.get(url, params={
"market": "NASDAQ",
"symbol": "AAPL,TSLA",
}, headers={"Authorization": KEY})
for item in resp.json():
print(item["code"], item["data"]["price"])
const KEY = "你的密钥";
const url = "http://接口地址/api/mini_list"
+ "?market=NASDAQ&symbol=AAPL&interval=5min";
const res = await fetch(url, { headers: { Authorization: KEY } });
const { data } = await res.json();
// 每根 K 线:时间,收,开,高,低,备用,成交量
for (const bar of data.split(";")) {
const [time, close, open, high, low] = bar.split(",");
console.log(time, open, high, low, close);
}
const ws = new WebSocket(
"ws://接口地址/websocket/json/你的密钥");
ws.onmessage = (e) => {
const m = JSON.parse(e.data);
// 连接成功后再订阅,并每 10 秒发一次心跳
if (m.Cmd === "connect" && m.State === 0) {
ws.send("/sub/NASDAQ:AAPL,NASDAQ:TSLA");
setInterval(() => ws.send("/heartbeat/PING"), 10000);
}
// 行情推送
if (m.Cmd === "rm") console.log(m.Msg.code, m.Msg.price);
};
每个接口的参数、返回字段和示例都在开发文档里。
按市场代码 market 查询
另有多语言、多国家的通用新闻接口,可按关键字、类型、时间范围筛选,见 通用新闻 →
联系客服,说明需要的市场和接口即可开通。拿到密钥后可以在登录页验证密钥是否有效,并查看使用情况。
每个请求带请求头 Authorization,值就是密钥。WebSocket 则把密钥写在连接地址的最后一段。
报价和 K 线的多产品接口一次最多 200 个产品;一次只能查一个市场,不同市场分开请求。
用 mini_list 接口从第 1 页往前翻,每页 500 根;也可以传起止时间按范围取,一次最多 500 根。
建议每 10 秒发一次心跳 /heartbeat/PING;订阅只对当前连接有效,断线重连后要重新发送订阅命令。
用「账号使用情况」接口 use/{type}/times 查本周期的总额度和已用次数;行情接口和财务信息接口的额度分开计算。