---
title: "Physical gold — dealer quotes for one country"
method: GET
path: "/v1/physical/{country}"
tags: ["physical"]
---

# Physical gold — dealer quotes for one country

`GET /v1/physical/{country}`

## Request

- Base URL: `https://api.goldprice.dev`
- URL: `https://api.goldprice.dev/v1/physical/{country}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

§5.2 — latest dealer quotes + premium_over_spot_bps for one country.

## Path parameters

- `country` string, required

## Query parameters

- `metal` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `400`: Bad request.
- `401`: Authentication failed.
- `403`: The caller's tier does not allow this request.
- `404`: The requested resource is unavailable or not found.
- `422`: Validation Error
- `429`: Rate limit or quota exceeded. `error` is one of: `rate_limited` (keyless caller over the per-IP hourly cap, X-RateLimit-Scope anon-ip-hour), `rate_limit_exceeded` (API key over its per-minute limit, scope tier-rate-minute) or `quota_exceeded` (monthly quota used, scope tier-quota-month). Wait for Retry-After seconds before retrying; do not retry a monthly quota error automatically.
- `500`: The operation failed internally.
- `503`: A required backend or data source is temporarily unavailable.

## Changes

- **2026-10-16** `bebfcafcb37f`: 2 info
  - added the new optional `query` request parameter `metal`
  - added the non-success response with the status `400`
- **2026-08-18** `b7c4b36e1fa1`: 1 warning, 11 info
  - removed the optional property `detail` from the response with the `422` status
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was added to the API
  - added the media type `application/json` for the response with the status `403`
  - …8 more

[Operation history](https://skmtc.dev/goldprice/apis/gold-api/changes/v1/physical/:country/get.md)

---

[API](https://skmtc.dev/goldprice/apis/gold-api.md) - [All operations](https://skmtc.dev/goldprice/apis/gold-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goldprice/apis/gold-api/revisions/cb56f61da26c?raw)