LIVE connecting…

Market data,
one integration.

Real-time quotes, candles and twelve months of history across Forex, Metals, Indices, Energy, Crypto and equities. One REST API. One WebSocket.

Live · 24h change connecting
0
Instruments
0
Ticks per second
0
Asset classes
0 months
History per request

Coverage

Counts are read live from the feed.

Live terminal

Running on the production feed — nothing here is simulated.

kivoxdata://terminal connecting
GOLD
loading…

API

Authenticate with ?key=YOUR_API_KEY. Responses are JSON. Read the full documentation →

Equivalent request
idle /v1/quote?symbol=GOLD
// Send a request to see the live response.

Endpoints

GET /v1/symbols Every symbol

Symbols are case-sensitive and broker-specific — GOLD, not XAUUSD. Always resolve names from here.

ParamRequiredDescription
searchnoSubstring filter
limitnoMax rows. Default 5000
GET /v1/categories Grouped by class

Symbols grouped into FOREX, METALS, CRYPTO, INDICES, ENERGY and STOCKS/OTHER, plus a counts object.

GET /v1/quote Latest bid / ask
ParamRequiredDescription
symbolyesExact symbol name
{"symbol":"GOLD","bid":4639.09,"ask":4639.24,"time":"2026-08-26T09:12:16.667"}
GET /v1/candles Recent bars
ParamRequiredDescription
symbolyesExact symbol name
tfno1, 5, 15, 30, 60, 240 or 1440 minutes. Default 1
countno1–2000 bars. Default 500
GET /v1/history Up to 12 months

A cold symbol may answer 202 while its archive is prepared — retry after a few seconds and it returns from cache.

ParamRequiredDescription
symbolyesExact symbol name
fromyesYYYY-MM-DD
tonoDefaults to now
tfnoTimeframe in minutes. Default 1
WS /stream Real-time
→ {"action":"subscribe","symbols":["GOLD","EURUSD"]}
← {"type":"subscribed","symbols":["GOLD","EURUSD"]}
← {"type":"batch","messages":[
    {"type":"tick","symbol":"GOLD","bid":4639.09,"ask":4639.24,"time":"…"},
    {"type":"candle","symbol":"GOLD","tf":1,"open":…,"high":…,"low":…,"close":…}
  ]}

One connection carries any number of symbols.

Status codes

200Success
202History warming — retry shortly
400Bad parameters
401Missing or invalid API key
404Unknown symbol or endpoint
429Rate limit exceeded

Quickstart


        

Keep your key on your server and proxy through it — anything in a browser bundle is public. Full reference in the documentation.

Request an API key

Tell us what you're building. We issue a sandbox key with the full instrument universe.

  • Sandbox key within one business day
  • REST + WebSocket from day one
  • No credit card, no minimum term