Sign in

v2

latestOpenAPI 3.1.0Commercial API license2026-08-01592492.6 KB
bars

OHLCV bar history — cursor-paginated, real data, is_closed label

Paginated OHLCV bar history from the canonical price_bars store.

Results are ordered DESC by bar_start (newest first). Paginate via next_cursor — pass it as ?cursor= on the next request. When next_cursor is null the result is exhausted. Empty range returns 200 with bars: [].

Tier depth gates:

  • Free: 30 days
  • Basic: 1 year
  • Pro+: full history (daily back to 1996 for XAU/USD; intraday from 2006)

Intraday intervals (1m, 5m, 15m, 30m, 1h, 2h, 4h) require Pro+.

get/v1/bars

Query parameters

symbolstring required

Symbol in slash or dash form. E.g. "XAU/USD", "XAU-USD-SPOT", "GLD".

Symbol in slash or dash form. E.g. "XAU/USD", "XAU-USD-SPOT", "GLD".

intervalstring

Bar interval. One of: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d.

Bar interval. One of: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d.

fromstring required

ISO-8601 start (inclusive).

ISO-8601 start (inclusive).

tostring required

ISO-8601 end (inclusive).

ISO-8601 end (inclusive).

limitinteger

Max bars per page (1-10000). Default 100.

Max bars per page (1-10000). Default 100.

cursorstring nullable

Opaque keyset pagination cursor from a prior response's next_cursor. When set, returns bars older than the cursor within the from/to window.

Opaque keyset pagination cursor from a prior response's next_cursor. When set, returns bars older than the cursor within the from/to window.

Response

Successful Response

symbolstring required

The requested symbol (e.g. 'XAU/USD', 'GLD').

intervalstring required

The requested interval (e.g. '1d', '15m').

next_cursorstring nullable

Opaque cursor for the next page. Pass as ?cursor= on the next request. Null when the result is exhausted. Encoding: base64url of the bar_start_utc ISO-8601 string of the last bar in this page.