List Currencies

GET /v1/currencies HTTP/1.1
Host: b2b.usetapp.xyz

{
  "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"
    }
  ]
}

GET

currencies

GET /v1/currencies HTTP/1.1
Host: b2b.usetapp.xyz

{
  "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"
    }
  ]
}

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

Header Parameters

string

Optional Bearer API Key.

Response

Returns the standard success envelope wrapping supported currency objects.

string

Response state (success).

array

List of supported fiat options.

string

ISO or platform currency code (e.g. NGN, KES, UGX, TZS, MWK, BRL).

string

Official name of the currency.

array

The available offramp pathways for this currency.

route_a: Configured B2B settlement route on Sui.

string

The maximum allowed exchange rate before transactions trigger automatic slippage refunds.

Routing Logic Constraints

The docs story exposes the configured B2B route for settlement and local fiat payout.

Example Payloads

GET /v1/currencies HTTP/1.1
Host: b2b.usetapp.xyz

{
  "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"
    }
  ]
}

Get Conversion Rate List Institutions

Introduction

Implementation

Products on Rails

Reference

API Reference

List Currencies

Header Parameters

Response

Routing Logic Constraints

Example Payloads

​Header Parameters

​Response

​Routing Logic Constraints

​Example Payloads

Header Parameters

Response

Routing Logic Constraints

Example Payloads