Global stock market data API
US equities use the equity endpoint; A-shares via cn candle paths; global markets use multi-market /market/quote . Snapshots, multi-interval candles, and WebSocket share one API key and JSON envelope.
Key specs
- Coverage
- US · A-shares · Global
- Batch quotes
- 1–20 US symbols / requestMulti-market quote up to 50
- Candle intervals
- 1 minute – 1 month
- Bars per request
- US ≤ 1,000 barsA-shares ≤ 5,000 bars
- Latency tiers
- Realtime from GrowthEnterprise Level 2
- Protocol
- REST + WebSocket
- History depth
- Varies by market & planSee console entitlements
Figures from TIQEX docs and plan APIs; latency, adjustment, and history depth vary by market and plan — see console entitlements.
Exchanges & endpoints
Same auth and rate limits; paths differ by market. Code formats: US ticker, A-share 6-digit.
| Market | Exchange | Example | Quote | K-line | WS market |
|---|---|---|---|---|---|
| US | NASDAQ · NYSE | AAPL | GET /market/equity/quote | GET /market/equity/kline | stocks |
| A-shares | SSE · SZSE | 600519 | GET /market/quote | GET /market/cn/kline | cn |
| Global equities | TPEX · Xetra · BX etc. | TPEX:0050 | GET /market/tv/quote | GET /market/tv/kline | global |
All paths are prefixed with https://api.tiqex.io/api/v1. Country list is on the market data hub.
Data fields
Business fields for US quotes and candles; A-share quote fields match the multi-market quote.
| Field | Type | Description | Scope |
|---|---|---|---|
succ | boolean | Success flag | Envelope |
data | object | array | Payload; see fields below | Envelope |
msg / code | string | Human message and machine code (e.g. MARKET_NOT_ENABLED) | Envelope |
X-Request-Id | header | Trace ID in response headers, not JSON body | Envelope |
assetCode / symbol / name | string | Asset code, symbol, name | US quote |
last / change / changePercent | number | Last, change, change % | US quote |
previousClose / regularClose / preMarketClose | number | Previous / regular / pre-market close | US quote |
volume / amount / marketCap | number | Volume, amount, market cap | US quote |
marketPhase | string | Session phase (pre/regular/post) | US quote |
bid / ask / bidSize / askSize | number | Bid/ask and sizes (optional) | US quote |
adjustmentMode | string | Adjustment mode | US k-line |
bars[].open / high / low / close / volume | number | OHLCV | US k-line |
bars[].vwap / trades / session | mixed | VWAP, trade count, session | US k-line |
Request examples
Send X-API-Key (or Authorization: Bearer). Use WebSocket for live ticks; REST for snapshots and backfill.
# Batch US snapshots (1–20 symbols)
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-shares use "cn"
symbols: ["AAPL", "MSFT"]
}))
ws.onmessage = (ev) => {
const msg = JSON.parse(ev.data)
if (msg.type === "tick") console.log(msg)
}Handshake counts as 1 call; ticks are free. Conn / symbol caps ≈ Growth 3/25, Pro 10/50, Enterprise 50/200 (console wins).
Use cases
Trading terminals
Multi-market quotes, movers, and sparklines — US, A-shares, and global markets side by side.
Quant research & backtests
Pull OHLCV by interval; US bars include VWAP and trade counts for factors.
Research & allocation
Major exchanges for macro boards, sector rotation, and cross-market valuation.
FAQ
Why do US and A-shares use different endpoints?
US equities use the equity endpoint with pre-market close, market cap, and phase fields; A-share quotes use multi-market /market/quote with candles via the cn path. All share the same auth, error codes, and envelope.
How many symbols per request?
equity/quote: 1–20 US symbols; multi-market /market/quote: up to 50. Prefer WebSocket for continuous refresh.
What stocks does Free include?
Free includes realtime crypto only; US equities, metals, and forex start at Growth; A-shares start at Pro; all markets are realtime, Level 2 is Enterprise-only.
Are candles adjusted?
US bars expose adjustmentMode. A-share / HK adjustment and history depth follow endpoint docs and console entitlements.
Do quotes match the exchange tape?
We do not guarantee field-by-field parity with any single exchange. Coverage, latency, and depth follow the console and docs.
Start with global equities
Register for a free key and hit your first quote in minutes.