平台简介
RTick 是覆盖美股、港股、A股、外汇、期货与加密货币的实时行情数据 API,通过统一的 REST 与 WebSocket 接口对外提供服务。本文档面向量化交易、行情客户端、Web/App 行情终端开发者。
通信规范
| 项目 | 说明 |
|---|---|
| 基础 URL | https://api.rtick.io |
| 通信协议 | HTTPS(TLS 1.2+) / HTTP;WebSocket 为 WSS / WS |
| 请求方式 | 全部 HTTP 接口均为 GET,参数经 Query String 传递 |
| 字符编码 | UTF-8 |
| 响应格式 | Content-Type: application/json; charset=utf-8 |
| 网络压缩 | HTTP 建议 Accept-Encoding: gzip, deflate, br;WS 支持 permessage-deflate |
鉴权机制
所有接口受统一鉴权保护。客户端请求时在 HTTP Header 携带 apiKey:
apiKey: <your_api_key>
WebSocket 在握手 URL 携带 apiKey 查询参数:
wss://api.rtick.io/ws?apiKey=<your_api_key>
apiKey 缺失、无效或过期时,HTTP 返回 401 Unauthorized,WebSocket 下发 code=401 控制帧后主动关闭连接。
统一响应外层结构
所有 HTTP 接口均统一使用 data 作为核心业务数据载荷字段:
{
"code": 200,
"msg": "success",
"data": []
}
接口一览
| 接口 | 路径 | 用途 |
|---|---|---|
| 历史 K 线 | GET /api/market/kline/history |
单标的单周期历史 K 线,time 滑动窗口分页,单次最多 500 根 |
| 最近 K 线 | GET /api/market/kline/recent |
批量多标的、多周期最近 N 根 K 线 |
| 最近两根 K 线 | GET /api/market/kline/recent_two |
首屏双 K 线优化(前一根已完结 + 当前跳动) |
| 最新逐笔 | GET /api/market/tick |
批量最新 1 笔逐笔成交 |
| 盘口快照 | GET /api/market/orderbook |
批量买卖盘深度快照 |
术语
- sym / syms:产品代码(如
AAPL.US、0700.HK、EURUSD、BTCUSDT),多个以英文逗号分割。 - ktype / ktypes:K 线周期,如
1m、5m、1d,枚举见 历史 K 线。 - autype:复权类型,
1=不复权(默认)、2=前复权、3=后复权。外汇/期货/加密忽略。 - session:美股交易时段,
0=仅盘中、1=仅盘中、2=全时段(含盘前盘后)。
下一步:快速开始。