Documentation

Currency List Endpoint

The Currency List endpoint provides a complete list of all supported currencies, cryptocurrencies, and precious metals available through our API. This endpoint is useful for building currency selection interfaces or validating currency codes before making conversion requests.

We currently support 152 currencies including major world currencies, cryptocurrencies like Bitcoin and Ethereum, and precious metals like gold and silver.

Currency List

GET /api/v1/currencies
Available on:
All Plans

Request Parameters

key string

Your API key

output string

Response output format. Use `json` (default) or `xml`.

Default: json

Response Properties

valid boolean

Indicates whether the request was successful

currencies object

Object containing currency codes as keys and currency names as values

Common Use Cases

The Currency List endpoint is commonly used for:

  • Building currency selectors: Populate dropdown menus or search interfaces
  • Validating currency codes: Check if a currency code is supported before making requests
  • Displaying currency information: Show currency names and symbols in your application
  • Filtering by currency type: Separate fiat currencies from cryptocurrencies or precious metals
  • Caching currency data: Store the list locally to reduce API calls

Best Practices

To optimize your use of the Currency List endpoint:

  • Cache the response: Currency lists don't change frequently, so cache the response for 24-48 hours
  • Use JSON format: JSON is more compact and easier to parse than XML
  • Handle errors gracefully: Always check for error responses and handle them appropriately
  • Consider your use case: Only fetch the currency list when you need it, not on every page load