> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onswitch.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get currencies

> List supported local currencies, channels and limits.

**GET `/coverage`** returns the supported local currencies you can use convert to or from stablecoin. Shows metadata such as country (ISO code), channels, the default channel, typical settlement times, transaction limits etc.

## Example Request

<CodeGroup>
  ```bash cURL theme={"dark"}
  curl -L \
    --request GET \
    --url 'https://api.onswitch.xyz/coverage?direction=OFFRAMP' \
    --header 'x-service-key: '"$YOUR_SERVICE_KEY" \
    --header 'Accept: */*'
  ```

  ```javascript Node.js theme={"dark"}
  const params = new URLSearchParams({ direction: 'OFFRAMP' });
  const res = await fetch(`https://api.onswitch.xyz/coverage?${params}`, {
    method: 'GET',
    headers: {
      'x-service-key': process.env.YOUR_SERVICE_KEY,
      Accept: '*/*',
    },
  });

  const json = await res.json();
  console.log(json.data?.length, 'corridors');
  ```

  ```python Python theme={"dark"}
  import os, json, urllib.parse, urllib.request

  q = urllib.parse.urlencode({"direction": "OFFRAMP"})
  req = urllib.request.Request(
      f"https://api.onswitch.xyz/coverage?{q}",
      method="GET",
      headers={
          "x-service-key": os.environ["YOUR_SERVICE_KEY"],
          "Accept": "*/*",
      },
  )

  with urllib.request.urlopen(req, timeout=60) as r:
      payload = json.load(r)
      print(len(payload.get("data", [])), "corridors")
  ```
</CodeGroup>

<Note>
  Direction can be `ONRAMP` or `OFFRAMP`. `ONRAMP` returns currencies that can be converted to stablecoin. `OFFRAMP` returns currencies that stablecoin can be converted to.
</Note>

### Example Response

```json theme={"dark"}
{
  "success": true,
  "message": "Coverage fetched successfully",
  "timestamp": "2026-03-31T03:38:23.073Z",
  "data": [
    {
      "country": "NG",
      "currency": ["NGN"],
      "continent": "AFRICA",
      "default_channel": "BANK",
      "channel": ["BANK", "BLOCKCHAIN"],
      "direction": ["ONRAMP", "OFFRAMP"],
      "settlement_time": {
        "BANK": "5-10 minutes",
        "BLOCKCHAIN": "5-10 minutes"
      },
      "payout_limit": {
        "BANK": { "min": "$0.5", "max": "$100,000" },
        "BLOCKCHAIN": { "min": "$1", "max": "$100,000" },
        "note": "This represents the maximum USD value allowed per transaction."
      }
    },
    {
      "country": "GB",
      "currency": ["EUR", "GBP"],
      "continent": "EUROPE",
      "default_channel": "DOMESTIC_GBP",
      "channel": ["SEPA_EUR", "DOMESTIC_GBP"],
      "direction": ["OFFRAMP"],
      "settlement_time": {
        "SEPA_EUR": "5-10 minutes",
        "DOMESTIC_GBP": "5-10 minutes"
      },
      "payout_limit": {
        "SEPA_EUR": { "min": "$25", "max": "$100,000" },
        "DOMESTIC_GBP": { "min": "$25", "max": "$100,000" },
        "note": "This represents the maximum USD value allowed per transaction."
      }
    }
  ]
}
```

<Note>
  **`payout_limit`** represents the maximum USD value that is allowed in a single transaction and varies by channel and currency.
</Note>

## Need Help?

<CardGroup cols={2}>
  <Card title="Email Support" icon="mail" href="mailto:contact@onswitch.xyz">
    Send us a message.
  </Card>

  <Card title="Book a call" icon="calendar" href="https://calendly.com/contact-onswitch/30min">
    Hop on a call with us.
  </Card>
</CardGroup>