v2

latestOpenAPI 3.1.0Commercial API license2026-08-01592492.6 KB
ratios

Cross-commodity ratio time-series — date-joined daily closes (Pro+)

Paginated cross-commodity ratio series from the canonical price_bars store.

Results are ordered DESC by date (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 points: [].

A date where either leg has no bar is absent — no forward-fill, no fabrication (Invariant #1 honesty).

Tier depth gates (same as /v1/bars 1d):

  • Free: 30 days (403 plan_gated)
  • Basic: 1 year (403 plan_gated)
  • Pro+: full history All pairs require Pro+ (all pairs involve a non-XAU or non-spot leg).
get/v1/ratios

Query parameters

pairstring required

Pair slug. Supported: gold-silver, gold-platinum, silver-platinum, gold-palladium, gld-xau. Alternatively pass numerator+denominator symbols directly.

Pair slug. Supported: gold-silver, gold-platinum, silver-platinum, gold-palladium, gld-xau. Alternatively pass numerator+denominator symbols directly.

fromstring required

ISO-8601 start (inclusive).

ISO-8601 start (inclusive).

tostring required

ISO-8601 end (inclusive).

ISO-8601 end (inclusive).

limitinteger

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

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

cursorstring nullable

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

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

Response

Successful Response

pairstring required

The pair slug (e.g. 'gold-silver', 'gold-platinum', 'gld-xau'). Echoed from the request for self-describing responses.

numeratorstring required

Resolved numerator instrument symbol (e.g. 'XAU/USD').

denominatorstring required

Resolved denominator instrument symbol (e.g. 'XAG/USD').

intervalstring

Bar interval. Currently always '1d' (intraday ratios out of scope at launch).

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 date string ('YYYY-MM-DD') of the last point in this page.