Currencies

Public list of currencies the platform supports in your environment. Use it to discover valid currency values for wallets, virtual accounts, beneficiaries, and payouts — instead of hard-coding a list.

The result is environment-scoped to your API key: a sandbox (sk_test_…) key returns the currencies active in test; a live (sk_live_…) key returns the currencies active in live. The two sets can differ while a currency is being rolled out.

GETList currencies

GET/v1/currencies

Returns the currencies active in your environment, ordered with our home market (NGN) first. There is no filter parameter — this endpoint is the list. Cached on Swappr’s side (5-minute TTL); safe to cache locally for hours.

Response fields

Field	Type	Notes
`code`	string	ISO 4217 currency code (e.g. `NGN`, `USD`, `GBP`). The value to send on `currency` params across the API.
`name`	string	Full display name, e.g. `Nigerian Naira`.
`symbol`	string	Currency symbol, e.g. `₦`, `£`, `$`.
`decimals`	integer	Minor units per major unit, as a power of 10 (`NGN`/`USD` = `2`; `JPY`/`KRW` = `0`). Use it to format and parse minor-unit amounts correctly.

Notes

This is platform-level discovery — it answers “what currencies does the platform support in this environment”, not “what can my account transact right now”. For the currencies your account holds or can pay out in, see your wallets and the payout form in the dashboard.
The set is environment-scoped to your key (see above). Always read it with the key for the environment you’re integrating against.
No extra permission is needed — any valid key can read it.

Errors

Code	HTTP	Cause
`unauthorized`	401	Missing or invalid API key.

Request

curl 'https://api.swappr.me/api/v1/currencies' \
  -H "Authorization: Bearer sk_live_..."

// Fetch once at app start, cache in memory
type Currency = { code: string; name: string; symbol: string; decimals: number };
let currencyList: Currency[] | null = null;
let currencyListExpiresAt = 0;
 
async function getCurrencies(): Promise<Currency[]> {
  if (currencyList && Date.now() < currencyListExpiresAt) return currencyList;
 
  const res = await fetch('https://api.swappr.me/api/v1/currencies', {
    headers: { 'Authorization': `Bearer ${process.env.SWAPPR_API_KEY}` },
  });
  const data = await res.json();
 
  currencyList = data.data;
  currencyListExpiresAt = Date.now() + 60 * 60 * 1000; // 1h
  return currencyList;
}

import os, time, requests
from typing import Optional
 
# Fetch once at app start, cache in memory.
_currency_list: Optional[list] = None
_currency_list_expires_at: float = 0
 
def get_currencies() -> list:
    global _currency_list, _currency_list_expires_at
    if _currency_list and time.time() < _currency_list_expires_at:
        return _currency_list
 
    res = requests.get(
        'https://api.swappr.me/api/v1/currencies',
        headers={'Authorization': f"Bearer {os.environ['SWAPPR_API_KEY']}"},
    )
    res.raise_for_status()
 
    _currency_list = res.json()['data']
    _currency_list_expires_at = time.time() + 60 * 60  # 1h
    return _currency_list

Response

{
  "object": "list",
  "data": [
    {
      "code": "NGN",
      "name": "Nigerian Naira",
      "symbol": "₦",
      "decimals": 2
    },
    {
      "code": "USD",
      "name": "US Dollar",
      "symbol": "$",
      "decimals": 2
    },
    {
      "code": "GBP",
      "name": "Pound Sterling",
      "symbol": "£",
      "decimals": 2
    }
    // ...
  ]
}

200 OK

Banks Postman quickstart