经典版接口 · HTTP / WebSocket

一把密钥
接入全球主要市场行情

HTTP 接口按需查询产品列表、实时报价、K 线、市场状态和财务信息;WebSocket 长连接按产品或按市场订阅实时推送。覆盖股票、期货、外汇与数字货币。

40个国家和地区的股票
150+个市场代码
9种 K 线周期
GET /api/mini_prices?market=NASDAQ&symbol=AAPL
[
  {
    "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",
      // ...
    }
  }
]
请求头 Authorization: 你的密钥HTTP 200
COVERAGE

覆盖全球主要市场

卡片里的代码就是接口参数 market 的取值,一套写法查所有市场。

US3 个市场

美国股票

纳斯达克、纽约证券交易所、美国证券交易所。

NASDAQNYSEAMEX
HK1 个市场

香港股票

香港交易所的股票行情,财务信息支持繁体中文。

HK
JP4 个市场

日本 · 韩国

东京、名古屋、福冈三个交易所与韩国交易所。

TSENAGFSEKRX
IN7 个市场

印度 · 东南亚

印度、马来西亚、越南、印度尼西亚。

NSEBSEMYXHOSEUPCOMHNXIDX
FU11 个市场

国际期货

美国、德国、英国、新加坡、日本、香港、马来西亚。

CBOTCMENYMEXCOMEXICEEUREXLMESGXTOCOMHKEXMDEX
FX4 个市场

外汇 · 数字货币

全球外汇、数字货币、差价合约、股票股指。

FCJMCJQQGZ

另有土耳其、巴西、尼日利亚等市场和各国指数,完整清单见 国家与市场参数 →

FEATURES

行情、K 线、财务,一套接口

查询用 HTTP,持续更新用 WebSocket。

实时报价

整个市场一次取回,或按产品代码查一个、多个;盘口和逐笔交易一并给出。

K 线

1 分钟到月线共 9 个周期;历史数据按页往前翻,也可以按起止时间取。

WebSocket 推送

一条长连接,按产品或按整个市场订阅,行情一有变化就推送过来。

产品列表

一个市场的全部产品一次取回,带产品代码、名称和产品类型。

市场状态

今天明天是否交易日、交易时段、节假日标记,以及距开盘或收盘的倒计时。

财务信息与新闻

公司介绍、财务字段、板块涨跌、排行榜、IPO、分红与拆股,以及多语言的通用新闻。

ACCESS

三种用法,一把密钥

按使用场景选择接入方式。

01

HTTP 查询

全部是 GET 请求,返回 JSON;请求头里带上密钥即可,适合按需拉取。

GET /api/mini_prices
02

WebSocket 订阅

密钥写在连接地址里,连上后发送订阅命令,持续接收行情推送。

/sub/NASDAQ:AAPL
03

额度查询

每把密钥按接口和市场有各自的额度,已用和剩余次数随时可查。

GET /api/use/{type}/times
DEVELOPER FIRST

几行代码,开始接入

标准的 HTTP 与 WebSocket,任何语言都能调用;文档里每个接口都有参数说明和返回示例。

  • HTTP 接口全部是 GET 请求
  • 鉴权只需要一个请求头 Authorization
  • WebSocket 按产品或按市场订阅
  • K 线支持翻页和按时间范围查询
阅读完整文档
curl -H "Authorization: 你的密钥" \
  "http://接口地址/api/mini_prices?market=NASDAQ&symbol=AAPL"

# 返回
[
  {
    "status": 0,
    "market": "NASDAQ",
    "code": "AAPL",
    "message": "SUCCESS",
    "data": { "price": 333.69, ... }
  }
]
API CATALOG

接口目录

每个接口的参数、返回字段和示例都在开发文档里。

另有多语言、多国家的通用新闻接口,可按关键字、类型、时间范围筛选,见 通用新闻 →

FAQ

常见问题

怎么获取接口密钥?

联系客服,说明需要的市场和接口即可开通。拿到密钥后可以在登录页验证密钥是否有效,并查看使用情况。

HTTP 接口怎么鉴权?

每个请求带请求头 Authorization,值就是密钥。WebSocket 则把密钥写在连接地址的最后一段。

一次能查多少个产品?

报价和 K 线的多产品接口一次最多 200 个产品;一次只能查一个市场,不同市场分开请求。

历史 K 线怎么取?

用 mini_list 接口从第 1 页往前翻,每页 500 根;也可以传起止时间按范围取,一次最多 500 根。

WebSocket 怎么保持连接?

建议每 10 秒发一次心跳 /heartbeat/PING;订阅只对当前连接有效,断线重连后要重新发送订阅命令。

怎么知道还剩多少次调用?

用「账号使用情况」接口 use/{type}/times 查本周期的总额度和已用次数;行情接口和财务信息接口的额度分开计算。

使用须知

  • 只保证接口数据正常输出,请勿以此作为投资的唯一参考。
  • 数据禁止二次分发,限个人开发者使用。
  • 接口必须在当地法律允许的条件下使用。
  • 不同市场的字段有差异,数值可能是数字也可能是字符串,请以接口实际返回为准。

立即接入全球行情数据

已有密钥?登录后可以查看连接、用量和额度。