GOgoldprice
ratios

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

Changed on

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)
  • Physical: 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

Request

  • Base URL
    https://api.goldprice.dev
  • URL
    https://api.goldprice.dev/v1/ratios
  • Auth
    • HTTP bearer
    • or API key in header X-API-Key

Query parameters

pairstring required

Pair slug. With data: gold-silver, gld-xau. Platinum and palladium pairs (gold-platinum, silver-platinum, gold-palladium) are accepted but not available yet: they return no points.

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', '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

  • b7c4b36e1fa1Revision changes
    • warning

      removed the optional property from the response with the status

    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security BearerAuth was added to the API

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status