Forex market data API
88 major pairs: quotes via multi-market /market/quote, candles via /market/forex/kline, stream with market=forex. Same fields as stocks and commodities — fit for FX terminals, risk, and macro research.
Key specs
- Pairs
- 88Homepage figure
- Batch quotes
- Up to 50 / request
- Candle intervals
- 1 minute – 1 month
- Bars per request
- Default 300, max 5,000 bars
- Latency tiers
- Realtime from GrowthEnterprise live
- Protocol
- REST + WebSocket
- History depth
- Varies by market & planSee console entitlements
Pair count follows tiqex.io homepage; other limits from docs and plan APIs.
Coverage & endpoints
Dedicated FX kline path; snapshots share multi-market quote with commodities and indices.
| Item | Description | Endpoint / example |
|---|---|---|
| Pairs | 88 majors such as EURUSD, GBPUSD | GET /market/codes Filter by category |
| Symbol format | 6 letters, no slash | EURUSD · GBPUSD |
| Quote snapshot | Multiple pairs per request | GET /market/quote?codes=EURUSD,GBPUSD |
| History candles | Minute to monthly OHLCV | GET /market/forex/kline |
| Live stream | Handshake billed once; ticks free | WS /market/stream market=forex |
| Central-bank reference FX | Homepage marketing mention; no dedicated REST/WS path | — No public dedicated endpoint; use quote + forex/kline + stream |
Spreads and liquidity vary by upstream; not guaranteed to match any market-maker book.
Data fields
Quotes from multi-market quote; candles use standard bars.
| 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 |
code / symbol / market / category | string | Code and market category | Quote |
last / bid / ask / volume | number | Last, bid/ask, volume | Quote |
change / changePercent / high / low | number | Change, change %, day high/low | Quote |
timestampMs | number | Timestamp (ms) | Quote |
delayed / unavailable | boolean | Snapshot fallback / unavailable | Quote |
symbol / interval | string | Resolved symbol, normalized interval | K-line |
source / market | string | Source identifier, market tag | K-line |
bars[].openTime / openTimeMs | string | number | Bar open time (RFC3339 / ms) | K-line |
bars[].closeTime / closeTimeMs | string | number | Bar close time | K-line |
bars[].open / high / low / close | number | OHLC | K-line |
bars[].volume | number | Volume | K-line |
Request examples
K-line: symbol required; interval 1m, 5, 15, 1h, 4h, 1d, 1w, 1mo; limit 1–5000.
curl "https://api.tiqex.io/api/v1/market/quote?codes=EURUSD,GBPUSD,USDJPY" \
-H "X-API-Key: $TIQEX_KEY"import os, requests
r = requests.get(
"https://api.tiqex.io/api/v1/market/forex/kline",
params={"symbol": "EURUSD", "interval": "1h", "limit": 1000},
headers={"X-API-Key": os.environ["TIQEX_KEY"]},
timeout=10,
)const ws = new WebSocket("wss://api.tiqex.io/api/v1/market/stream")
ws.onopen = () => ws.send(JSON.stringify({
action: "subscribe", market: "forex", symbols: ["EURUSD", "GBPUSD"]
}))Use cases
FX trading terminals
Major-pair quotes, bid/ask, and intraday charts for retail and institutional UIs.
Market-making & risk
Combine snapshots and WebSocket for discovery, mark-to-market, and threshold alerts.
Macro & carry research
Multi-interval candles for spreads, vol, and correlation work.
FAQ
Can Free test FX?
Free excludes FX. Growth, Pro and Enterprise all include realtime FX.
What does delayed mean on a quote?
delayed=true marks a fallback snapshot (quote sourced from the last candle close because the live quote was unavailable); unavailable=true means no usable quote right now.
Do streams stop on weekends/holidays?
FX streams may be quiet when the market is closed — expected. Align monitors with the trading calendar.
Do spreads match a market maker?
Spreads vary by upstream; not guaranteed to match any MM book. Fine for display, research, and risk — not as a hard fill price.
Connect major FX markets
Integrate on Growth realtime data, then upgrade to Pro for the remaining markets.