在当今快节奏的金融市场中，获取准确、及时的行情数据至关重要。一些金融数据服务提供商通过 API 接口，为用户提供包括股票实时行情、股票行情 API、股票实时报价 API、金融 API、金融行情数据 API、股指期货、金融行情、外汇实时行情、股票实时行情、期货行情、基金实时行情、外汇 API、基金 API 等多种资产类型的实时行情与历史数据。常见的接口类型通常包括 REST API 与 WebSocket API，支持对接全球主流市场的行情信息。本文将以典型的接入流程为例，介绍如何使用这类接口进行开发，文中示例代码将采用 Python 语言编写，以便于读者理解和进行集成测试。
本文将分享如何使用 iTick API 实现覆盖全球多个市场，包括外汇（GB 市场）、股票（HK、SZ、SH、US 等）、期货（US、HK、CN）和基金（US 等）。接口类型主要分为 RESTful HTTP GET 请求和 WebSocket 实时推送。REST API 适合批量查询历史数据或单次获取实时行情，而 WebSocket 则适用于低延迟的实时数据流订阅。
在使用前，用户需在官网注册获取 Token。以下将分模块总结接口，不逐一列出所有代码示例，而是重点突出请求地址、参数，并挑选典型接口提供详细 Python 示例。
REST API 详解
REST API 通过 HTTPS GET 请求访问，基址为https://api.itick.org。所有接口都需要在 headers 中添加accept: application/json和token: your_token。
1. 外汇 API（Forex）
外汇 API 聚焦 EUR/USD、GBP/USD 等主流货币对，支持实时报价、盘口、成交和历史 K 线。市场代码固定为GB。
-
实时报价：GET
/forex/quote?region={region}&code={code}- 参数：region (必填，GB), code (必填，如 EURUSD)
- 响应：最新价(ld)、开盘价(o)等。
-
实时盘口：GET
/forex/depth?region={region}&code={code}- 参数：同上。
- 响应：买盘(b)、卖盘(a)，包括价格(p)和挂单量(v)。
-
实时成交：GET
/forex/tick?region={region}&code={code}- 参数：同上。
- 响应：最新价(ld)、成交量(v)、时间戳(t)。
-
历史 K 线查询：GET
/forex/kline?region={region}&code={code}&kType={kType}&limit={limit}&et={et}- 参数：region (GB), code (EURUSD), kType (1-10，分钟到月 K), limit (K 线数量，必填), et (截止时间戳，可选)。
- 响应：数组，每项包括开盘(o)、最高(h)、最低(l)、收盘(c)等。
详细 Python 示例（实时报价）：
import requestsurl = "https://api.itick.org/forex/quote?region=GB&code=EURUSD"
headers = {"accept": "application/json","token": "your_token"
}response = requests.get(url, headers=headers)
if response.status_code == 200:data = response.json()print("最新价:", data.get('data', {}).get('ld'))
else:print("请求失败:", response.text)
此示例演示如何获取 EUR/USD 的实时报价，响应中ld字段即为最新价格。
2. 股票 API（Stock）
股票 API 支持全球多个交易所，如 HK（港股）、US（美股）。接口包括实时报价、盘口、成交和 K 线。
-
实时报价：GET
/stock/quote?region={region}&code={code}- 参数：region (如 HK), code (如 700 for 腾讯控股)。
- 响应：类似外汇，包括涨跌幅(chp)。
-
实时盘口：GET
/stock/depth?region={region}&code={code}- 参数：同上。
- 响应：多档买盘/卖盘。
-
实时成交：GET
/stock/tick?region={region}&code={code}- 参数：同上。
-
历史 K 线查询：GET
/stock/kline?region={region}&code={code}&kType={kType}&limit={limit}&et={et}- 参数：类似外汇，region 支持 HK、US 等。
详细 Python 示例（历史 K 线）：
import requestsurl = "https://api.itick.org/stock/kline?region=HK&code=700&kType=2&limit=10"
headers = {"accept": "application/json","token": "your_token"
}response = requests.get(url, headers=headers)
if response.status_code == 200:kline_data = response.json().get('data', [])for bar in kline_data:print(f"时间: {bar['t']}, 开盘: {bar['o']}, 收盘: {bar['c']}")
else:print("请求失败")
此代码获取腾讯控股的最近 10 根 5 分钟 K 线，支持数据分析和图表绘制。
3. 期货 API（Future）
期货 API 覆盖商品、金融期货，支持 US、HK、CN 市场，如股指期货（NQ for 纳斯达克指数期货）。
-
实时报价：GET
/future/quote?region={region}&code={code}- 参数：region (US 等), code (NQ)。
-
实时盘口：GET
/future/depth?region={region}&code={code} -
实时成交：GET
/future/tick?region={region}&code={code} -
历史 K 线查询：GET
/future/kline?region={region}&code={code}&kType={kType}&limit={limit}&et={et}
这些接口响应格式与股票类似，适合量化交易策略。
4. 基金 API（Fund）
基金 API 主要针对场内 ETF/LOF，如 US 市场的 QQQ（纳斯达克 ETF）。
-
实时报价：GET
/fund/quote?region={region}&code={code}- 参数：region (US), code (QQQ)。
-
实时盘口：GET
/fund/depth?region={region}&code={code} -
实时成交：GET
/fund/tick?region={region}&code={code} -
历史 K 线查询：GET
/fund/kline?region={region}&code={code}&kType={kType}&limit={limit}&et={et}
接口设计与期货相似，强调 IOPV 净值等基金特有数据。
WebSocket API 详解
WebSocket 适合实时推送，连接地址如wss://api.itick.org/stock（替换为 forex/future/fund）。需在 headers 中传递 Token。
连接流程：
-
连接后收到"Connected Successfully"。
-
自动验证，成功后"authenticated"。
-
发送订阅请求：
{"ac": "subscribe", "params": "AAPL$US", "types": "quote,tick,depth"}- params: 标的，如"AAPL$US"（多标的用逗号分隔）。
- types: quote(报价)、tick(成交)、depth(盘口)。
-
接收数据：JSON 格式，包含 type 字段区分类型。
Python 示例（使用 websocket 库）：
import websocket
import jsonWS_URL = "wss://api.itick.org/stock"
API_TOKEN = "your_token"def on_message(ws, message):data = json.loads(message)print("收到数据:", data)def on_open(ws):print("连接成功")subscribe_msg = {"ac": "subscribe","params": "AAPL$US","types": "quote,tick"}ws.send(json.dumps(subscribe_msg))ws = websocket.WebSocketApp(WS_URL, header={"token": API_TOKEN},on_open=on_open, on_message=on_message)
ws.run_forever()
此示例订阅苹果股票的实时报价和成交，支持心跳包（每 30s 发送 ping）以保持连接。
结语
本文基于 Python 编程语言描述了如何使用 iTick API 接入全球外汇、股票、期货、基金市场的全方位实时行情数据服务，通过 RESTful 和 WebSocket 两种接口形式满足不同场景需求——REST API 适合批量数据查询和历史数据获取，WebSocket 则为实时性要求高的交易场景提供低延迟数据流。接口设计统一规范，支持多档盘口、K 线数据、实时报价等多种数据类型，配合完善的认证机制和 JSON 响应格式，为量化分析、交易系统开发、金融应用构建提供了稳定可靠的数据基础。
温馨提示：本文仅供参考，不构成任何投资建议。市场有风险，投资需谨慎
参考文档：https://docs.itick.org/
GitHub：https://github.com/itick-org/