Current spot prices as JSON
Current spot prices in the requested currency and unit — the JSON endpoint most callers reaching for the private /api/metal-prices actually want. Note that metals here is filtered by metal symbol (xau), not name (gold), unlike /api/metal-prices-previous-day; that difference is real and long-standing rather than a documentation slip.
Request
- Base URL: https://www.stackerscan.com
- URL: https://www.stackerscan.com/api/premiums/metal-prices
- Auth: none required
Query parameters
Currency the prices are converted to, as an ISO 4217 code, BTC, or a metal code. Validated against the live catalog from /api/currencies, and unenforced in the window where that catalog cannot be read.
Weight unit prices are quoted in. Exactly these two spellings — oz, ounce, g and grams are rejected (#1122).
Comma-separated metal symbols to include. Omit for every metal. Matched case-insensitively; duplicates collapse.
Optional opaque correlation identifier echoed through to the pricing backend. Bounded to 128 characters of A-Za-z0-9._~:-.
Response
Spot prices for the requested metals.
Per-metal current prices with the base currency and unit they are quoted in.
Changes
No recorded changes to this operation across all 1 revision of this API.