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.

fromstring required

ISO-8601 start (inclusive).

tostring required

ISO-8601 end (inclusive).

limitinteger

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.

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.

Changes

Changed in 1 of the 7 revisions of this API.112

Aug 18, 2026b7c4b36e1fa1112See the full diff
- ●
  removed the optional property detail from the response with the 422 status
  response-optional-property-removed
- ○
  the endpoint scheme security ApiKeyAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security BearerAuth was added to the API
  api-security-added
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  added the non-success response with the status 401
  response-non-success-status-added
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the non-success response with the status 404
  response-non-success-status-added
- ○
  added the non-success response with the status 429
  response-non-success-status-added
- ○
  added the non-success response with the status 500
  response-non-success-status-added
- ○
  added the non-success response with the status 503
  response-non-success-status-added
- ○
  added the required property details to the response with the 422 status
  response-required-property-added
- ○
  added the required property error to the response with the 422 status
  response-required-property-added
- ○
  added the required property message to the response with the 422 status
  response-required-property-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history