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

# List Currencies

> Retrieve a list of supported fiat currencies and the configured route capabilities.

Retrieve all supported fiat currencies, their ceiling rates, and their configured routing capabilities.

### Header Parameters

<ParamField header="Authorization" type="string">
  Optional Bearer API Key.
</ParamField>

### Response

Returns the standard success envelope wrapping supported currency objects.

<ResponseField name="status" type="string">
  Response state (`success`).
</ResponseField>

<ResponseField name="data" type="array">
  List of supported fiat options.

  <ResponseField name="code" type="string">
    ISO or platform currency code (e.g. `NGN`, `KES`, `UGX`, `TZS`, `MWK`, `BRL`).
  </ResponseField>

  <ResponseField name="name" type="string">
    Official name of the currency.
  </ResponseField>

  <ResponseField name="supported_routes" type="array">
    The available offramp pathways for this currency.

    * `route_a`: Configured B2B settlement route on Sui.
  </ResponseField>

  <ResponseField name="ceiling_rate" type="string">
    The maximum allowed exchange rate before transactions trigger automatic slippage refunds.
  </ResponseField>
</ResponseField>

### Routing Logic Constraints

<Note>
  The docs story exposes the configured B2B route for settlement and local fiat payout.
</Note>

***

### Example Payloads

<RequestExample>
  ```http List Currencies theme={null}
  GET /v1/currencies HTTP/1.1
  Host: b2b.usetapp.xyz
  ```
</RequestExample>

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "status": "success",
    "message": "Currencies retrieved",
    "data": [
      {
        "code": "NGN",
        "name": "Nigerian Naira",
        "supported_routes": ["route_a"],
        "ceiling_rate": "1374.60"
      },
      {
        "code": "KES",
        "name": "Kenyan Shilling",
        "supported_routes": ["route_a"],
        "ceiling_rate": "134.50"
      },
      {
        "code": "TZS",
        "name": "Tanzanian Shilling",
        "supported_routes": ["route_a"],
        "ceiling_rate": "2710.00"
      },
      {
        "code": "MWK",
        "name": "Malawian Kwacha",
        "supported_routes": ["route_a"],
        "ceiling_rate": "5.62"
      },
      {
        "code": "UGX",
        "name": "Ugandan Shilling",
        "supported_routes": ["route_a"],
        "ceiling_rate": "0.39"
      },
      {
        "code": "BRL",
        "name": "Brazilian Real",
        "supported_routes": ["route_a"],
        "ceiling_rate": "285.10"
      }
    ]
  }
  ```
</ResponseExample>