GOgoldprice
convert

Convert between metals, currencies, and units

Changed on

Convert an amount between metals, currencies, and units.

  • metal → currency: spot price in that currency via FX cross through USD
  • currency → metal: inverse of the above
  • metal → metal: ratio of USD spot prices
  • currency → currency: FX cross through USD (live rate first, then the last stored rate only up to three days old)

Two-leg source skew: currency → currency conversions resolve EACH leg independently through the fresh-first/last-stored chain, so the two legs can have different ages (e.g. a fresh EUR rate crossed with an older stored THB rate). The response timestamp reflects the to leg only — the from leg's timestamp is discarded — so it can understate (or overstate) the age of the other half of the cross. Both legs share the USD anchor, so cross drift is bounded by the staleness of the older leg — never compounded.

The unit param applies to the metal side only (oz / gram / kg). Historical conversion via date is not supported; use /v1/bars + /v1/prices/history for historical spot data.

get/v1/convert

Request

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

Query parameters

fromstring required

Source symbol: XAU, XAG, USD, EUR, …

tostring required

Target symbol: USD, EUR, XAU, …

amountnumber

Amount to convert (default 1).

unitstring

Unit for the metal side: oz | gram | kg (default oz).

Response

Successful Response

fromstring required

Source symbol (e.g. XAU, USD).

tostring required

Target symbol (e.g. USD, EUR).

amountstring required

Input amount.

ratestring required

Conversion rate (1 from-unit = rate to-units).

resultstring required

amount x rate.

unitstring required

Unit applied to the metal side (oz, gram, kg).

timestampstring required

UTC ISO-8601 timestamp of the source data. For currency-to-currency conversions the two FX legs resolve independently (live-first with daily fallback) and may differ in source/age; this reflects one leg only.

Changes

  • 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

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

      removed 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