GOgoldprice
download

Bulk OHLCV download — presigned Parquet or CSV file (paid plans)

Changed on

Bulk download of OHLCV bars for a symbol+interval+year from the archive.

Returns a 307 redirect to a time-limited presigned URL (1 hour TTL). Free and anonymous callers are blocked — bulk download is the paid depth moat.

Tier gates: Free/anonymous: 403 plan_gated. Physical, Basic: 365-day window — years within the last year only. Pro, Realtime Pro, Plus, Pro (2026): full history (back to 1996 for XAU/USD daily).

get/v1/download

Request

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

Query parameters

symbolstring required

Symbol to download. E.g. "XAU/USD", "XAU-USD-SPOT", "GLD". Only symbols with archived data are available.

intervalstring

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

yearinteger required

Calendar year to download (1996-2026). Each year is one archive partition.

fmtstring

Download format. "parquet" (default) = presigned Parquet URL. "csv" = precomputed CSV sidecar from the same yearly archive partition.

Changes

  • b7c4b36e1fa1Revision changes
    • breaking

      removed the success response with the status

    • 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 media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the 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

      removed 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