Rates
Best executable rate across all routes
GET
/rates/bestScope
rates:readAuth Bearer keyCompares every eligible execution route's fresh price for the pair and returns the best rate available to you, after our margin, with the winning route attributed by its short route code. Quotes older than 60 seconds are excluded. Indicative for pricing decisions — a firm, time-boxed rate comes from POST /quotes or POST /transfers/quote. Currently supports USD/NGN and NGN/USD.
Query parameters
pairstringoptionalBASE/QUOTE pair. Defaults to USD/NGN.
amountstringoptionalAmount in the base currency used to size the comparison.
Responses
200Best executable rate
json
{
"object": "best_rate",
"pair": "USD/NGN",
"base_currency": "USD",
"quote_currency": "NGN",
"amount": "1000.00",
"rate": "1578.9100",
"inverse_rate": "0.00063335",
"quote_amount": "1578910.00",
"source": {
"route": "NUV",
"type": "partner_route",
"quoted_at": "2026-08-30T11:00:00.000Z"
},
"routes_compared": 3,
"routes": [
{
"object": "rate_route",
"route": "NUV",
"rate": "1578.9100",
"behind_best_pct": "0.0000",
"fresh": true,
"quoted_at": "2026-08-30T11:00:00.000Z",
"latency_ms": 412
},
{
"object": "rate_route",
"route": "QDX",
"rate": "1571.2000",
"behind_best_pct": "0.4883",
"fresh": true,
"quoted_at": "2026-08-30T11:00:00.000Z",
"latency_ms": 605
}
],
"indicative": true,
"as_of": "2026-08-30T11:00:00.000Z"
}Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X GET "https://business.boundlesspay.com/api/public/v1/rates/best" \ -H "Authorization: Bearer $BOUNDLESS_API_KEY"