经典版接口 · 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 查本周期的总额度和已用次数;行情接口和财务信息接口的额度分开计算。

使用须知

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

最新文章

行情数据接口的使用方法和接入教程。

怎么用香港行情数据API接口获取实时报价:以腾讯控股 HK00700 为例,一次请求取到最新价、涨跌幅和五档买卖盘

怎么用香港行情数据API接口获取实时报价

香港行情数据API接口基础教学方案:以港股的腾讯控股(HK00700)和阿里巴巴(HK09988)为例,三步取到最新价、涨跌幅、成交量和五档买卖盘,讲清楚港股代码怎么写、返回的字段怎么读,附可以直接运行的完整代码。

怎么用日本行情数据API接口获取历史K线:以东京证券交易所的丰田汽车 7203 为例,按页或按时间范围取日线

怎么用日本行情数据API接口获取历史K线

日本行情数据API接口基础教学方案:以东京证券交易所(TSE)的丰田汽车(7203)为例,三步取到历史 K 线——取最新一页、往前翻页、按时间范围取,讲清楚返回的每一项怎么读,附可以直接运行的完整代码。

怎么用韩国行情数据API接口获取股票列表:一次请求取到 KRX 全部产品的代码、名称和类型,以三星电子 005930 为例

怎么用韩国行情数据API接口获取股票列表

韩国行情数据API接口基础教学方案:以韩国交易所(KRX)为例,三步取到全部股票的代码和名称——请求产品列表、按类型筛选并存下来、再用代码查报价,以三星电子(005930)为例,附可以直接运行的完整代码。

怎么用越南行情数据API接口获取涨幅榜:一次请求取到越南股票涨幅最大的 20 只,跌幅榜、活跃榜写法相同

怎么用越南行情数据API接口获取涨幅榜

越南行情数据API接口基础教学方案:一次请求取到越南股票的涨幅榜,再用同样的写法取跌幅榜和活跃榜,讲清楚带币种的价格、带符号的涨跌幅、带单位的成交量怎么转成数字,附可以直接运行的完整代码。

怎么用印度行情数据API接口获取公司介绍:以 NSE 的 RELIANCE 为例,一次请求取到名称、简介、板块、行业、CEO、官网

怎么用印度行情数据API接口获取公司介绍

印度行情数据API接口基础教学方案:以 NSE 的信实工业(RELIANCE)为例,三步取到公司名称、简介、板块、行业、CEO、官网等公司介绍,并讲清楚取不到时怎么处理,附可以直接运行的完整代码。

使用美国行情数据API接口合成动态K线:HTTP 历史 K 线加 WebSocket 动态 K 线推送

使用美国行情数据API接口怎么合成动态K线

美国行情数据API接口基础教学方案:以 NASDAQ 的 AAPL 为例,先用 HTTP 接口取历史 K 线,再用 WebSocket 推送的动态 K 线更新最新一根,三步合成一张实时跳动的 K 线图,附可以直接运行的完整代码。

查看全部文章 →

立即接入全球行情数据

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