Skip to main content
Returns the latest stored rate for a currency pair.
This is a stored reference rate. The endpoint does not execute a swap, reserve funds, or guarantee a conversion price. It does not check the age of the stored rate, so do not treat the result as fresh or executable.

Headers

string
required
Your active Vanryx API key. See API keys and authentication.
string
Use application/json. The examples send JSON request bodies.

Body parameters

string
required
Maximum 20 characters. Must resolve through the supported public currency symbol mapping. See Currency symbols.
string
required
Maximum 20 characters. The value is uppercased and matched against stored rate rows.

How the rate is defined

rate is the value of one unit of from_currency expressed in to_currency. For example, {"from_currency":"BTC","to_currency":"USD"} returns the stored value of 1 BTC in USD.

Currency symbols

Public symbols for from_currency: BTC, LTC, DOGE, BCH, ETH, BNB, TRON, USDT, SOL, XRP, USDC, and USD. Use BNB and USDT for those two assets. Internal codes such as BSC and USDT_TRON are not the public symbols. to_currency has no fixed allowlist, but a response requires a matching stored rate row. Stored asset-to-USD rates exist for the 11 supported assets. Other pairs may not be populated.

Response

object
string
Result message.

Errors

See Errors and integration notes.