Skip to main content
GET
/
wallet
/
rates
Get Exchange Rates
curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/wallet/rates \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "message": "Rates retrieved successfully",
  "data": {
    "rates": [
      {
        "fromCurrency": "USD",
        "toCurrency": "NGN",
        "rate": 1550,
        "rateToken": "<string>"
      }
    ]
  }
}
Retrieve current exchange rates for all supported currency pairs. Use the rateToken from the response to lock in a rate when performing a swap.

​
Example Request

curl -X GET "https://api.rolla.xyz/api/v1/external/wallet/rates" \
  -H "X-API-Key: your_api_key_here"

​
Example Response

{
  "success": true,
  "message": "Rates retrieved successfully",
  "data": {
    "rates": [
      {
        "fromCurrency": "USD",
        "toCurrency": "NGN",
        "rate": 1550.00,
        "rateToken": "rt_abc123def456"
      },
      {
        "fromCurrency": "NGN",
        "toCurrency": "USD",
        "rate": 0.000645,
        "rateToken": "rt_def456ghi789"
      }
    ]
  }
}
Exchange rates are live and may change between the time you fetch them and when you execute a swap. Pass the rateToken to the /wallet/swap endpoint to lock in the quoted rate.

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Response

Rates retrieved successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Rates retrieved successfully"

​
data
object