Developer docs

Real-time market data API developer docs

Clear references, runnable examples, and SDKs for the languages your team already uses.

Three steps

From zero to first tick

Register, authenticate, and subscribe — the same path every integration follows.

01

Create an API key

Generate a key in the console for REST and WebSocket authentication.

02

Make your first call

Send X-API-Key requests, or connect to the streaming endpoint.

03

Subscribe to live feeds

Receive tick and candle pushes to power trading and analytics apps.

Authentication

Every request needs an API key. Keep secrets out of public front-end repos.

  • Header: X-API-Key: YOUR_API_KEY
  • Create multiple keys per environment and rotate anytime
  • Invalid or rate-limited keys return 401 / 429
curl https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT \
  -H "X-API-Key: YOUR_API_KEY"

Read full topic: Authentication & API Keys

REST API

Snapshot quotes, candles, market metadata, and financial news for on-demand pulls.

  • Consistent JSON response shape
  • Filter by symbol, interval, or news category
  • Pagination and rate-limit headers
GET/api/v1/market/crypto/quoteLatest quote snapshot
GET/api/v1/market/crypto/klineHistorical candles
GET/api/v1/market/equity/quoteUS equity quotes
GET/api/v1/market/equity/klineUS equity candles
GET/api/v1/market/quoteFX / commodities / A-shares / HK / futures / indices quotes
GET/api/v1/market/cn/klineA-share candles
GET/api/v1/market/hk/klineHong Kong candles
GET/api/v1/market/tv-futures/klineContinuous futures candles (/tv-futures, futures scope)
GET/api/v1/market/agri/klineAgriculture candles
GET/api/v1/market/commodities/klineCommodities candles
GET/api/v1/market/futures/quoteBinance USDT-M futures quotes (/futures, crypto scope)

WebSocket streams

Millisecond delivery for terminals, dashboards, and strategy runtimes.

  • Send a subscribe JSON with market and symbols
  • Heartbeat and reconnect guidance
  • Batch multi-symbol subscriptions
wss://api.tiqex.io/api/v1/market/stream
{ "action": "subscribe", "market": "crypto", "symbols": ["BTCUSDT"] }

Market coverage

US stocks, A-shares, Hong Kong, FX, crypto, futures, indices, and commodities through one API.

  • US / A-share / HK quotes and candles
  • Forex, indices, and continuous futures
  • Crypto plus metals / energy / agriculture
  • REST snapshots + WebSocket live streams

Read full topic: Market Coverage & Hours

Error handling

Standard error bodies for logging and alerting hooks.

  • JSON: succ / msg / code; trace via X-Request-Id header
  • 4xx client issues, 429 quota/rate limits, 5xx upstream/server
  • Honor Retry-After on 429 responses

Read full topic: Errors & Rate Limits

Official SDKs

Integrate in familiar languages — examples match the homepage playground.

JavaScript

Browser and Node.js clients

Python

Data science and quant scripts

PHP

Web and backend integrations

Java

Enterprise services and backends

Go

High-concurrency gateways

// TIQEX — GET /api/v1/market/crypto/quote
const res = await fetch(
  'https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT',
  {
    headers: { 'X-API-Key': 'your_api_key' }
  }
)
const json = await res.json()
console.log(json.data)

Read full topic: SDKs & Language Examples

Developer docs

Developer FAQ

Common questions when integrating market data APIs.

Which markets and data types does TIQEX support?

US, CN, HK equities, forex, crypto, futures, indices, commodities, and financial news. REST for snapshots and history; WebSocket for live streams.

How does authentication work? Can I put keys in the browser?

Send X-API-Key on every request. Store keys server-side only—never in public frontend bundles.

What can the free tier do? When should I upgrade?

Free tier is for learning and integration tests. Upgrade for WebSocket, lower latency, higher quotas, or more markets in production.

How should I handle HTTP 429 rate limits?

Honor Retry-After, use exponential backoff, log X-Request-Id for support, and cache non-real-time data locally.

Where are error codes documented?

Failures return succ=false with msg and code. Use the X-Request-Id response header for tracing. Common quota codes: DAILY_LIMIT_EXCEEDED / RATE_LIMIT_EXCEEDED.

How should REST and WebSocket work together?

Use REST for snapshots and historical candles; WebSocket for live ticks. Same API key. Stream handshake counts once; pushed ticks are not re-billed.

How do I format symbols?

Crypto often uses BTCUSDT; US equities like AAPL; multi-market quote accepts product short codes or TV symbols. See each endpoint’s parameter table and the console symbol lists.

How should I interpret latency and coverage?

Latency, field granularity, and history depth vary by market and plan—check console entitlements and endpoint docs. Output may not match any single exchange tick-for-tick.

Ready to build

Open the docs and ship your first feed.

Create a free account, grab a key, and follow the quickstart.