API Reference

Get transfer rates

Without source_wallet_id, returns indicative exchange rates, which you can filter by currency. With source_wallet_id, destination_wallet_id, receive_asset and amount, it prices a USDT and USDC conversion between two wallets of one customer. Neither is a locked price; the transfer is priced again when you create it.

GEThttps://api.gravv.xyz/v1/transfer/rates

Query Parameters

The currency received. Not case-sensitive.

Prices a conversion from this crypto wallet

Conversion price only. A wallet of the same customer.

Conversion price only. It must differ from the asset sent.

Possible values: USDT, USDC

Conversion price only. Defaults to the wallet's asset.

Possible values: USDT, USDC

Conversion price only. Positive, with at most 2 decimal places.

Responses

Status	Description
`200`	The rates, in one list with no paging
`400`	The request failed. Read `error`.

200 response

Four-part pair key, such as USD_US_NGN_NG. USDT_USDC for a conversion price.

When the rate was set. Check it, as a row can be old.

Conversion price only

{
"data": {
"items": [
  {
    "currency_pair": "USD_US_NGN_NG",
    "direction": "USD_NGN",
    "from_currency": "USD",
    "from_currency_name": "US Dollar",
    "pair_type": "fiat",
    "rate": "1368.27",
    "timestamp": "2026-10-13T22:20:08.941956Z",
    "to_currency": "NGN",
    "to_currency_name": "NGN"
  }
]
},
"error": null
}

400 response

What went wrong

{
"data": null,
"error": "internal server error"
}

Authorization

ApiKeyAuth

Was this page helpful?