Metal Spot Price
Spot price for a single metal, in the currency, unit of mass and purity you ask for.
The instrument actually quoted is chosen from the metal, currency and unit together, and is reported as source_instrument. Where no instrument is quoted directly in the requested currency, the price is crossed via USD and cross_rate is true - this consumes an additional FX product call and widens the bid/ask gap.
Authorizations
Query Parameters
Metal symbol, defaults to XAU Three-letter metal symbol, e.g. XAU for gold
X[A-Z]{2}"XAU"
Target currency, defaults to USD Three-letter ISO 4217 currency code
[A-Z]{3}Unit of mass to price in. Defaults to oz_t for precious metals and metric_tonne for base metals. Handle for a unit of mass that metal prices can be quoted in
gram, kilogram, metric_tonne, grain, pennyweight, oz_t, lb_t, oz_av, lb_av, tael, baht, tola Purity to price at, for precious metals only - ignored for base metals. Either a code from /metals/purities, or any custom fineness between 0 and 1000 exclusive of zero. Omit for the quoted (pure) price. A purity code from /metals/purities (e.g. '750'), or any custom fineness in parts per thousand between 1 and 1000. A custom value is echoed back with a purity_name of 'custom'.
"750"
Include the display-name fields in the response Truthy values are true, 1, yes and y. Anything else is treated as false.
"true"
Response
Success
A spot price converted to the requested currency, unit and purity. The *_name fields appear only when verbose is set. grade fields appear for base metals, purity fields for precious metals.
A price, as a string to preserve the significant figures of the source quote. Parse as a decimal rather than a float where precision matters.
"2500.50"
Three-letter metal symbol, e.g. XAU for gold
X[A-Z]{2}"XAU"
Three-letter ISO 4217 currency code
[A-Z]{3}Handle for a unit of mass that metal prices can be quoted in
gram, kilogram, metric_tonne, grain, pennyweight, oz_t, lb_t, oz_av, lb_av, tael, baht, tola Milliseconds since Jan 1 1970 (unix timestamp with millisecond precision)
1739305030072
Quote time, formatted per the account's datetime format
True when the price was crossed via USD rather than quoted directly in the requested currency
Origin of the price data
The instrument actually quoted to build this price
A price, as a string to preserve the significant figures of the source quote. Parse as a decimal rather than a float where precision matters.
"2500.50"
A price, as a string to preserve the significant figures of the source quote. Parse as a decimal rather than a float where precision matters.
"2500.50"
A price, as a string to preserve the significant figures of the source quote. Parse as a decimal rather than a float where precision matters.
"2500.50"
Metal name. Verbose only.
Currency name. Verbose only.
Display name for the unit. Verbose only.
Deliverable contract grade. Base metals only.
Display name for the contract grade. Base metals only, verbose only.
Minimum purity of the contract grade, as a percentage. Base metals only, verbose only.
Purity code the price is quoted at. Precious metals only.
Display name for the purity, or 'custom' for a caller-supplied fineness. Precious metals only.
Server response time in milliseconds