Payout Prices
How do I retrieve payout prices?
Overview
The Prices API provides real-time exchange rates for converting US Dollars (USD) into local currencies for cross-border payouts. These rates enable you to show customers the current exchange rate before initiating international payments.
Contact Cybrid support to enable this feature for your bank .
Get all available payout prices
Understanding Payout Symbols
Payout symbols represent local currency conversions from USD:
- MXN-USD: Mexican Peso from US Dollar
- ARS-USD: Argentine Peso from US Dollar
- BRL-USD: Brazilian Real from US Dollar
- COP-USD: Colombian Peso from US Dollar
- KES-USD: Kenyan Shilling from US Dollar
The format is always [Local Currency]-USD.
Participants Type
The participants_type parameter defines the sender-receiver relationship:
| Type | Sender | Receiver | Typical Use Case |
|---|---|---|---|
| C2C | Consumer (Individual) | Consumer (Individual) | Personal remittances, sending money to family |
| C2B | Consumer (Individual) | Business | Individual paying a business invoice |
| B2C | Business | Consumer (Individual) | Payroll, contractor payments, refunds |
| B2B | Business | Business | Corporate cross-border payments, supplier payments |
Why it matters: Different participants types may have different:
- Exchange rates
- Processing fees
- Transaction limits
- Regulatory requirements
Always use the participants type that matches your actual use case.
Delivery Route
The route parameter specifies how funds are delivered:
| Route | Description |
|---|---|
| bank_account | Direct bank transfer to recipient's account |
| mobile_wallet | Digital wallet providers |
Making a Request
Get all available payout prices
GET /api/prices?payout_symbol=MXN-USD
Authorization: Bearer YOUR_ACCESS_TOKENRequired scope: prices:read
Filter by specific criteria
GET /api/prices?payout_symbol=MXN-USD&participants_type=B2B&route=bank_account
Authorization: Bearer YOUR_ACCESS_TOKENQuery Parameters:
| Parameter | Type | Description |
|---|---|---|
payout_symbol | String | Currency pair (e.g., MXN-USD, ARS-USD) |
country_code | String | Destination country (e.g., MX, AR, BR) |
participants_type | String | Sender-receiver relationship (C2C, C2B, B2C, B2B) |
route | String | Delivery method (bank_account, mobile_wallet) |
Response Example
[
{
"symbol": "MXN-USD",
"type": "payout",
"buy_price": 1855,
"sell_price": null,
"buy_price_last_updated_at": "2025-10-31T18:59:00.000000Z",
"sell_price_last_updated_at": null,
"country_code": "MX",
"participants_type": "B2B",
"route": "bank_account"
}
]Related Resources
Updated about 2 hours ago