GOgoldprice
prices

Latest spot price for one symbol — flat shape, no envelope (parity convenience)

Changed on

Paid plans get live prices. Free and keyless callers get the same prices 15 minutes late. bid/ask are paid-only and omitted when no two-sided quote is available.

get/v1/spot/{symbol}

Request

  • Base URL
    https://api.goldprice.dev
  • URL
    https://api.goldprice.dev/v1/spot/{symbol}
  • Auth
    • none
    • or HTTP bearer
    • or API key in header X-API-Key

Path parameters

symbolstring required

Query parameters

includestring nullable

Comma-separated field groups to include in the response. Tokens: sources, karat, stats, all. Unknown tokens are ignored. Omit for the lean default. The stats group requires authentication.

Response

Successful Response

symbolstring required
quote_currencystring required
unitstring required
contract_typestring required
pricestring nullable

Price value as Decimal (up to 8 decimal places). JSON-serialized as a string by Pydantic to avoid float drift; callers should parse with Decimal(), not float().

bidstring nullable

Price value as Decimal (up to 8 decimal places). JSON-serialized as a string by Pydantic to avoid float drift; callers should parse with Decimal(), not float().

askstring nullable

Price value as Decimal (up to 8 decimal places). JSON-serialized as a string by Pydantic to avoid float drift; callers should parse with Decimal(), not float().

is_staleboolean required
divergence_flagboolean nullable

Present only when requested via ?include= (stats or all). True when a tokenized-gold source diverges > 0.5% from primary.

computed_atstring nullable
divergence_bpsinteger nullable
live_qualitystring nullable

Selected live quote quality when a live source is served.

price_gram_24kstring nullable
price_gram_22kstring nullable
price_gram_21kstring nullable
price_gram_20kstring nullable
price_gram_18kstring nullable
price_gram_16kstring nullable
price_gram_14kstring nullable
price_gram_10kstring nullable
open_pricestring nullable

Price value as Decimal (up to 8 decimal places). JSON-serialized as a string by Pydantic to avoid float drift; callers should parse with Decimal(), not float().

high_pricestring nullable

Price value as Decimal (up to 8 decimal places). JSON-serialized as a string by Pydantic to avoid float drift; callers should parse with Decimal(), not float().

low_pricestring nullable

Price value as Decimal (up to 8 decimal places). JSON-serialized as a string by Pydantic to avoid float drift; callers should parse with Decimal(), not float().

prev_close_pricestring nullable
chstring nullable
chpstring nullable
open_timeinteger nullable

Changes

  • c7f6fc3add28Revision changes
    • warning

      removed the optional property from the response with the status

  • b7c4b36e1fa1Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      response property message list-of-types was widened by adding types null to media type application/json of response 400

    • breaking

      response property message list-of-types was widened by adding types null to media type application/json of response 401

    • breaking

      response property message list-of-types was widened by adding types null to media type application/json of response 403

    • breaking

      response property message list-of-types was widened by adding types null to media type application/json of response 404

    • breaking

      response property message list-of-types was widened by adding types null to media type application/json of response 429

    • breaking

      response property message list-of-types was widened by adding types null to media type application/json of response 503

    • 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 optional 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

    • info

      added the required property to the response with the status