Skip to main content
GET
/
v1
/
currencies
GET /v1/currencies HTTP/1.1
Host: api.rails.dev

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

​
Authorization
string
Optional Bearer API Key.

​
Response

Returns the standard success envelope wrapping supported currency objects.
​
status
string
Response state (success).
​
data
array
List of supported fiat options.
​
code
string
ISO or platform currency code (e.g. NGN, KES, UGX, TZS, MWK, BRL).
​
name
string
Official name of the currency.
​
supported_routes
array
The available offramp pathways for this currency.
  • route_a: Configured B2B settlement route on Sui.
​
ceiling_rate
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: api.rails.dev

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