Buvei
API ReferencePayouts

Query Payout Rate

Indicative USD → target currency FX rate.

POST/open-api/v1/payouts/rate

Returns the indicative FX rate (margin included) used by payouts. Source currency is always USD. Stateless — the actual charge at submit time is recalculated using the live rate.

Body

targetCurrencystringbodyrequired

ISO-3 code of the currency the payee will receive. Must be one of the supported currencies — any other value returns 400 Unsupported currency: <code>.

Supported currencies

Payouts currently support these target currencies only:

USD · GBP · EUR · AUD · JPY · CAD · MXN

Any other targetCurrency is rejected with HTTP 400 and message: "Unsupported currency: <code>".

Response

ratenumber
FX rate 1 USD = X targetCurrency, with margin included.
Request
{
  "targetCurrency": "EUR"
}
Response
{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "rate": 0.8624
  }
}

The final charge at submit time may differ slightly from this rate due to live FX movement. The rate does not need to be stored or replayed.

On this page

Body
Supported currencies
Response