Appearance
Rates
The rates endpoint returns the current token-to-fiat exchange rate for a specific token on a given network. Use it to display an indicative fiat value in your UI before a settlement quote is requested.
Rates are indicative only
The rate returned by this endpoint is for display purposes. Actual settlement amounts are determined at quote time by POST /partner/settlement/quote, which locks in a guaranteed rate for 15 minutes. Do not use the rates endpoint to calculate the token amount to transfer on-chain.
Endpoint
| Endpoint | Description |
|---|---|
GET /api/v4/partner/rates/{currency}/{network}/{token} | Get the current exchange rate for a token and settlement currency |
URL parameters
| Parameter | Description | Example |
|---|---|---|
currency | Settlement currency | EUR, GBP |
network | Blockchain network identifier | ethereum, polygon |
token | Token contract address on the specified network | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
Response fields
The response payload contains one top-level field:
| Field | Description |
|---|---|
rate | Token-to-fiat rate — how many units of the settlement currency are received per 1 token |
Example response
json
{
"status": "ok",
"payload": {
"rate": "0.9175"
}
}Usage guidance
| Goal | Use |
|---|---|
| Show an indicative fiat value for a token amount in the UI | rate × token amount |
| Calculate the exact token amount to send for a settlement | Use POST /partner/settlement/quote instead |
Supported currencies
Currently EUR and GBP are supported as settlement currencies. Pass the currency as the first path segment in the URL.