---
title: "Current spot prices as JSON"
method: GET
path: "/api/premiums/metal-prices"
tags: ["Prices"]
---

# Current spot prices as JSON

`GET /api/premiums/metal-prices`

## Request

- Base URL: `https://www.stackerscan.com`
- URL: `https://www.stackerscan.com/api/premiums/metal-prices`
- Auth: none required

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.

## Query parameters

- `base` string
- `unit` 'troy_oz' | 'gram'
- `metals` string
- `analysisId` string

## Response `200`

Spot prices for the requested metals.

- object: Per-metal current prices with the base currency and unit they are quoted in.

## Other responses

- `400`: A parameter was missing or outside its accepted values. `type` is `missing-parameter` or `invalid-parameter`, and `detail` names the parameter.
- `500`: The request was well formed but could not be served. Retrying later may succeed.

---

[API](https://skmtc.dev/stackerscan/apis/stackerscan-public-api.md) · [All operations](https://skmtc.dev/stackerscan/apis/stackerscan-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stackerscan/apis/stackerscan-public-api/revisions/476d2eaffc90?raw)