Ticks & candles

API Reference

Base URL: https://api.metakit.cloud

Authentication Pagination Billing Accounts Symbols Ticks & candles Analyses Performance Brokers Deals / Positions / Orders Trading Copiers Equity Monitors Webhooks Webhook Events llms.txtThis whole reference as one file, written for LLMs and coding agents.

Raw price data for any symbol the account can trade. Prefer candles for charting — one day of EURUSD ticks is hundreds of thousands of rows, while the same day is 1440 M1 bars.

GET

/v1/accounts/{id}/candles

Get candles

OHLC bars at a chosen timeframe. With neither from nor to, returns the most recent count bars — the usual case for drawing a chart. Supplying both gives every bar in that window. time is the bar’s OPEN, and realVolume is usually 0 on FX because brokers rarely report it.

Parameters

Name	Type	Required	Description
symbol	string	No	Required, e.g. EURUSD.
timeframe	string	No	M1, M5, M15, M30, H1, H4, D1, W1 or MN1. Defaults to M1.
from	string	No	ISO 8601 or YYYY-MM-DD.
to	string	No	With from, returns the full range.
count	integer	No	Default 500, max 5000. Used when to is absent.

Example request

curl https://api.metakit.cloud/v1/accounts/123/candles \
  -H "Authorization: Bearer stk_live_..."

Example response

{
  "data": [
    {
      "time": "2026-07-28T09:00:00.000Z",
      "open": 1.16401,
      "high": 1.16455,
      "low": 1.16388,
      "close": 1.16433,
      "tickVolume": 1843,
      "spread": 12,
      "realVolume": 0
    }
  ],
  "symbol": "EURUSD",
  "timeframe": "H1",
  "count": 1,
  "truncated": false
}

GET

/v1/accounts/{id}/ticks

Get ticks

Raw bid/ask ticks. Two modes: from + to returns every tick in the window; from + count returns N ticks starting at that point, which covers an unpredictable span of time since ticks arrive irregularly. to without from is rejected. When truncated is true the result hit the 50000 cap — narrow the window or use candles.

Parameters

Name	Type	Required	Description
symbol	string	No	Required, e.g. EURUSD.
from	string	No	ISO 8601 or YYYY-MM-DD. Defaults to 24h ago.
to	string	No	Presence switches to a true range query.
count	integer	No	Default 500, max 50000. Ignored when to is set.

Example request

curl https://api.metakit.cloud/v1/accounts/123/ticks \
  -H "Authorization: Bearer stk_live_..."

Example response

{
  "data": [
    {
      "time": "2026-07-28T09:00:00.123Z",
      "bid": 1.16421,
      "ask": 1.16433,
      "last": 0,
      "volume": 0
    }
  ],
  "symbol": "EURUSD",
  "count": 1,
  "truncated": false
}