---
title: "List supported currencies"
method: GET
path: "/currencies/v1/symbols"
tags: ["Currencies"]
---

# List supported currencies

`GET /currencies/v1/symbols`

Returns the supported-currency catalog: one object per currency (code, name, symbol), sorted by code. symbol is null where the currency has no conventional sign (e.g. XAU, gold). Takes no parameters beyond the key. Every code listed here is usable as a from, to, or base elsewhere in the API.

## Query parameters

- `pretty` boolean

## Response `200`

Supported-currency catalog, one object per currency, sorted by code.

- SymbolsResponse
  - `data` object, required
    - `objects` Currency[], required
      - `code` string, required — Uppercase currency code (e.g. USD, BTC).
      - `name` string, required
      - `symbol` string, nullable, required
    - `meta` ResultMeta
      - `total` integer, required — Number of objects returned.
      - `request_id` string, required
      - `duration` integer, required — Server-side processing time in milliseconds.

## Other responses

- `401` — Unauthorized. Missing, invalid, expired, or revoked API key.
- `403` — Forbidden. The account is deleted, disabled, frozen, or pending approval; the request origin isn't in the key's allowed CORS origins; a paid-only field was used as a search, filter, or lookup target on a plan that doesn't include it; a limit above the plan's ceiling but within the paid maximum was requested on a non-paid plan; or the monthly quota has been exceeded past the soft-limit grace period.
- `404` — Not found. The route doesn't match any defined endpoint, the API isn't active, or listing isn't supported for this API version.
- `405` — Method not allowed. Every endpoint is GET-only.
- `410` — Gone. The requested API version is no longer active.
- `429` — Too Many Requests. Sustained traffic above the edge rate limit (20 requests per 10 seconds) is rejected by Cloudflare before the request reaches the API, so this response is generated at the edge and does not carry the standard JSON error envelope. Back off briefly and retry.

---

[API](https://skmtc.net/restcountries/apis/rest-countries.md) · [All operations](https://skmtc.net/restcountries/apis/rest-countries/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/restcountries/rest-countries/versions/87a86bdd79f6/schema)