Real-time market data API developer docs

Quickstart

Three steps from sign-up to your first live push. The free tier needs no credit card.

1. Create an API keyGenerate a key in theconsole · API keyssection — use a separate key for dev, staging, and production.
2. Make your first REST callSendX-API-Keyin the request header and call the crypto quote endpoint to verify auth.
3. Subscribe over WebSocketConnect to the stream channel and send subscribe; the handshake counts once against quota, and later tick pushes are not billed again.

curl "https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT" \\
  -H "X-API-Key: $TIQEX_KEY"

{
  "succ": true,
  "data": { ... }   // Field details are documented per endpoint; on failure succ=false with msg and code
}

Base URL and response envelope

Authentication

Every REST and WebSocket request needs an API key. Send it asX-API-Key: YOUR_API_KEYheader, or useAuthorization: Bearer YOUR_API_KEY.

• Keep keys on the server or in a secret manager — never in front-end code or a Git repository.
• Create separate keys per environment and rotate or revoke them from the console at any time.
• A missing or invalid key returns 401; a market that is not enabled or insufficient scope returns 403.

Read the full guide:Authentication →

REST endpoints

One JSON envelope, with filtering by symbol or interval, plus pagination and rate-limit headers. Endpoints are grouped by market scope.

WebSocket live streaming

Connect towss://api.tiqex.io/api/v1/market/streamthen make subscribe the first frame. One connection can batch-subscribe multiple symbols, limited by your plan.

Send a subscription

{ "action": "subscribe", "market": "crypto", "symbols": ["BTCUSDT", "ETHUSDT"] }

Server messagesSample value

Messages are flat: a successful subscribe replies with type=subscribed (market + symbols); quotes arrive as type=tick with the fields listed above. Verified against the live implementation.

{ "type": "subscribed", "market": "crypto", "symbols": ["BTCUSDT", "ETHUSDT"] }

{
  "type": "tick",
  "tick": {
    "symbol": "BTCUSDT",
    "last": 0.00, "bid": 0.00, "ask": 0.00, "volume": 0,
    "change": 0.00, "changePercent": 0.00, "high": 0.00, "low": 0.00,
    "at": "2026-10-12T06:00:00.000Z"
  }
}

{ "type": "error", "code": "WS_CONN_LIMIT", "msg": "WebSocket connection limit reached for your plan" }

Client example

const ws = new WebSocket("wss://api.tiqex.io/api/v1/market/stream");
ws.onopen = () => {
  ws.send(JSON.stringify({ action: "subscribe", market: "crypto", symbols: ["BTCUSDT"] }));
};
ws.onmessage = (ev) => {
  const msg = JSON.parse(ev.data);
  if (msg.type === "tick") console.log(msg.tick.symbol, msg.tick.last);
  if (msg.type === "error") console.warn(msg.code, msg.msg);
};
// On disconnect, reconnect with 1s, 2s, 4s... backoff and resend every subscribe

Rate limits and quotas

REST quote / kline calls and stream handshakes count against your daily (or monthly) quota and RPM; tick pushes after the handshake are not billed again. Figures are the defaults from the online docs — the console plan is authoritative.

On 429, readRetry-After, retry with exponential backoff plus jitter, and cache non-real-time data locally. Use theQuota calculatorto estimate your usage.

Error codes overview

Most 4xx errors are client-side, 429 means quota or rate limiting, and 5xx comes from upstream or the server. The most common ones are below; the full list is on the error codes page.

See all error codes (searchable) →

SDKs & language examples

The REST API is plain HTTP + JSON, so any language can call it directly. The examples below match the code window on the home page.

// Node 18+ / same-origin BFF in the browser; keep the key server-side only
const res = await fetch(
  "https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT",
  { headers: { "X-API-Key": process.env.TIQEX_KEY } }
);
const json = await res.json();
if (!json.succ) throw new Error(json.code + " " + json.msg);
console.log(json.data);

import os, requests

resp = requests.get(
    "https://api.tiqex.io/api/v1/market/crypto/quote",
    params={"symbols": "BTCUSDT"},
    headers={"X-API-Key": os.environ["TIQEX_KEY"]},
    timeout=10,
)
body = resp.json()
if not body["succ"]:
    raise RuntimeError(body.get("code"), resp.headers.get("X-Request-Id"))
print(body["data"])

<?php
$ch = curl_init("https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("TIQEX_KEY")],
  CURLOPT_TIMEOUT => 10,
]);
$body = json_decode(curl_exec($ch), true);
var_dump($body["data"]);

// JDK 11+ ships HttpClient
HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT"))
    .header("X-API-Key", System.getenv("TIQEX_KEY"))
    .build();
HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

req, _ := http.NewRequest("GET",
    "https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT", nil)
req.Header.Set("X-API-Key", os.Getenv("TIQEX_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer res.Body.Close()
io.Copy(os.Stdout, res.Body)

Per-language install, WebSocket, and wrapper guidance → · GitHub · TIQEXAPI

FAQ