全球股票行情 API
美股走 equity 专用端点，A股走 cn K 线路径，其他全球市场通过多市场 /market/quote 查询。报价快照、多周期 K 线与 WebSocket 推送共用一把 API Key 和同一种 JSON 外壳。
关键参数
- 覆盖市场
- 美股 · A股 · 全球
- 批量报价
- 1–20 个美股代码 / 次多市场 quote 最多 50 个
- K 线周期
- 1 分钟 – 1 月
- 单次 K 线
- 美股 ≤ 1,000 根A股 ≤ 5,000 根
- 行情档位
- 标准版起实时企业版 Level 2
- 协议
- REST + WebSocket
- 历史深度
- 因市场与套餐而异以控制台权益为准
参数来自 TIQEX 开发者文档与套餐接口；延迟档位、复权与历史深度因市场和套餐而异，以控制台权益为准。
覆盖交易所与端点
同一套鉴权和限流，不同市场按路径区分。代码格式：美股 ticker、A股 6 位。
| 市场 | 交易所 | 代码示例 | 报价 | K 线 | WS market |
|---|---|---|---|---|---|
| 美股 | NASDAQ · NYSE | AAPL | GET /market/equity/quote | GET /market/equity/kline | stocks |
| A股 | 上交所 · 深交所 | 600519 | GET /market/quote | GET /market/cn/kline | cn |
| 全球股票 | 台湾 TPEX · 德国 Xetra · 瑞士 BX 等 | TPEX:0050 | GET /market/tv/quote | GET /market/tv/kline | global |
所有路径前缀为 https://api.tiqex.io/api/v1。国别市场清单见市场数据中心。
数据字段
美股报价与 K 线的业务字段；A股报价字段与多市场 quote 一致。
| 字段 | 类型 | 说明 | 所属 |
|---|---|---|---|
succ | boolean | 是否成功 | 外壳 |
data | object | array | 业务数据，见下方字段 | 外壳 |
msg / code | string | 失败时的可读信息与机器错误码（如 MARKET_NOT_ENABLED） | 外壳 |
X-Request-Id | header | 请求追踪 ID，在响应头中，不在 JSON body | 外壳 |
assetCode / symbol / name | string | 资产代码、产品、名称 | 美股报价 |
last / change / changePercent | number | 最新价、涨跌额、涨跌幅 | 美股报价 |
previousClose / regularClose / preMarketClose | number | 昨收 / 常规时段收盘 / 盘前收 | 美股报价 |
volume / amount / marketCap | number | 成交量、成交额、市值 | 美股报价 |
marketPhase | string | 交易阶段（盘前、常规、盘后等） | 美股报价 |
bid / ask / bidSize / askSize | number | 买卖价与挂单量（可选） | 美股报价 |
adjustmentMode | string | 复权模式 | 美股 K 线 |
bars[].open / high / low / close / volume | number | OHLCV | 美股 K 线 |
bars[].vwap / trades / session | mixed | 成交量加权均价、成交笔数、所属交易时段 | 美股 K 线 |
请求示例
在请求头带上 X-API-Key（也可用 Authorization: Bearer）。实时行情走 WebSocket，REST 用于快照与补数。
# 批量查询美股快照（1–20 个代码）
curl "https://api.tiqex.io/api/v1/market/equity/quote?symbols=AAPL,MSFT,NVDA" \
-H "X-API-Key: $TIQEX_KEY"import os, requests
r = requests.get(
"https://api.tiqex.io/api/v1/market/cn/kline",
params={"symbol": "600519", "interval": "1d", "limit": 500},
headers={"X-API-Key": os.environ["TIQEX_KEY"]},
timeout=10,
)
bars = r.json()["data"]["bars"]const ws = new WebSocket("wss://api.tiqex.io/api/v1/market/stream")
ws.onopen = () => ws.send(JSON.stringify({
action: "subscribe",
market: "stocks", // A股用 "cn"
symbols: ["AAPL", "MSFT"]
}))
ws.onmessage = (ev) => {
const msg = JSON.parse(ev.data)
if (msg.type === "tick") console.log(msg)
}握手计 1 次调用，之后的 tick 推送不再计次。连接数 / 订阅产品上限：标准版 3 / 25，专业版 10 / 50，企业版 50 / 200（以控制台为准）。
适用场景
交易终端与行情看板
多市场报价、涨跌幅榜与迷你走势图，美股、A股、全球市场同屏刷新。
量化研究与回测
按周期批量拉取 OHLCV，美股 K 线附带 VWAP 与成交笔数，可直接进因子计算。
投研与资产配置
覆盖全球主要交易所，支撑宏观看板、行业轮动与跨市场估值对比。
常见问题
美股和 A股为什么用不同端点？
美股走 equity 端点，带盘前收、市值、交易阶段等扩展字段；A股报价用多市场 /market/quote，K 线走 cn 路径。三者共用鉴权、错误码和响应外壳。
一次能查询多少只股票？
equity/quote 每次 1–20 个美股代码；多市场 /market/quote 每次最多 50 个。需要持续刷新时建议改用 WebSocket。
免费版能拿到哪些股票数据？
免费版仅含加密行情；美股、金属与外汇从标准版开始提供，A股从专业版开始提供；全部市场均为实时，Level 2 仅企业版提供。
K 线是否复权？
美股 K 线在响应里用 adjustmentMode 标明复权模式；A股 / 港股的复权口径与历史深度以端点文档和控制台权益为准。
数据与交易所官方盘口完全一致吗？
不保证与单一交易所盘口逐字段一致。数据口径、行情档位与覆盖范围以控制台和文档为准。
开始接入全球股票行情
注册即得免费密钥，按文档 5 分钟跑通第一个报价请求。