FX Rates

Query real-time foreign exchange rates and create locked quotes.

Authentication Collections Payouts Customers Balances Webhooks Products Disputes FX Rates

GET/v1/fx/rates

Get current exchange rates

Parameters

Name	Type	In	Required	Description
`from`	`string`	query	Required	Source currency
`to`	`string`	query	Required	Target currency
`amount`	`integer`	query	Optional	Amount to convert (smallest unit)

Response Codes

200Rate retrieved400Unsupported currency pair

1{
2  "from": "USD",
3  "to": "NGN",
4  "rate": 1580.50,
5  "inverse_rate": 0.000633,
6  "converted_amount": 7902500,
7  "quoted_at": "2026-05-01T14:00:00Z",
8  "expires_at": "2026-05-01T14:05:00Z"
9}

POST/v1/fx/quotes

Lock an FX rate for 5 minutes

Parameters

Name	Type	In	Required	Description
`from`	`string`	body	Required	Source currency
`to`	`string`	body	Required	Target currency
`amount`	`integer`	body	Required	Amount in source currency

Response Codes

201Quote locked400Invalid parameters

1{
2  "id": "quote_abc123",
3  "from": "USD",
4  "to": "NGN",
5  "rate": 1580.50,
6  "source_amount": 500000,
7  "target_amount": 790250000,
8  "fee": 7500,
9  "locked_at": "2026-05-01T14:00:00Z",
10  "expires_at": "2026-05-01T14:05:00Z"
11}