Gold prices,ready to use.

Indicative spot prices with the currency, unit, quote sides, effective time, and freshness kept explicit.

Gold APILocal preview

api.narwhalapi.com 200 OK

GET/v1/gold/spot/USD

{
  "symbol": "XAU-USD",
  "price": "3371.42",
  "bid": "3371.31",
  "ask": "3371.53",
  "currency": "USD",
  "unit": "troy_ounce",
  "timestamp": "2026-08-22T06:29:41Z",
  "stale": false
}

A gold price without the missing context.

Price and quote sides

Use the selected price directly while bid and ask remain separate, nullable fields.

Currency and unit

Every result states its quote currency and troy-ounce unit. No implicit conversion.

Effective time

The timestamp describes the returned value, and stale tells you when it is too old.

One predictable object.

The response is deliberately small. Financial values stay decimal strings, absent quote sides stay null, and internal source machinery stays out of customer JSON.

price: Selected indicative spot price.
bid / ask: Independent quote sides; never manufactured.
timestamp: Effective time of the returned value.
stale: Whether the value exceeds the freshness rule.

Endpoint planv1

GET/v1/gold/spot/{currency}

Latest indicative spot price

First release

GET/v1/gold/bars

Closed daily OHLC history

Next release

These pages show the accepted response shape. Public API traffic remains disabled during backend hardening.

Narwhal mascot checking a sheet of price data

Spot is not a benchmark or a futures contract.

Narwhal keeps indicative spot prices separate from official benchmarks, futures settlements, and dealer prices. That separation makes the number easier to use correctly.

Start with one gold request.

Use the same Narwhal key for Gold, FX, and later economic data.

Get an API key Read the docs