Skip to main content
POST
/
payout
/
onramp
/
quote
cURL
curl -X POST https://api.relayer.fi/v1/payout/onramp/quote \
  -H "Authorization: ApiKey $RELAYER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from":   { "currency": "mxn",  "country": "MX" },
    "to":     { "currency": "usdc", "chain": "base" },
    "amount": "10000.00"
  }'
{
  "source_amount": "1000.00",
  "source_currency": "mxn",
  "destination_amount": "49.45",
  "destination_currency": "usdc",
  "midmarket_rate": "0.0500",
  "sell_rate": "0.0497",
  "display_rate": "1 USD ≈ 20.10 MXN",
  "network_fee_percent": 0.6,
  "network_fee_amount": "0.30",
  "service_fee_percent": 0.5,
  "service_fee_amount": "0.25",
  "total_fee_percent": 1.1,
  "total_fee_amount": "0.55",
  "developer_fee_percent": 0.5,
  "developer_fee_amount": "0.25",
  "estimated_arrival": "≈ 2 minutes after deposit"
}

Documentation Index

Fetch the complete documentation index at: https://docs.relayer.fi/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use this format: ApiKey <your_api_key>

Body

application/json
​
source_currency
enum<string>
required

Source fiat currency code

Available options:
usd,
eur,
mxn,
brl,
gbp
Example:

"mxn"

​
destination_currency
enum<string>
required

Destination stablecoin code

Available options:
usdc,
usdt
Example:

"usdc"

​
source_amount
string

Amount in source fiat currency. Provide this OR destination_amount.

Example:

"1000.00"

​
destination_amount
string

Desired amount in destination stablecoin. Provide this OR source_amount.

Example:

"50.00"

Response

Live quote with rate + fee breakdown

​
source_amount
string
required
Example:

"1000.00"

​
source_currency
string
required
Example:

"mxn"

​
destination_amount
string
required
Example:

"49.45"

​
destination_currency
string
required
Example:

"usdc"

​
midmarket_rate
string
required
Example:

"0.0500"

​
sell_rate
string
required
Example:

"0.0497"

​
display_rate
string
required
Example:

"1 USD ≈ 20.10 MXN"

​
network_fee_percent
number
required

Network conversion fee (Bridge spread).

Example:

0.6

​
network_fee_amount
string
required
Example:

"0.30"

​
service_fee_percent
number
required

Our service fee (Relayer margin).

Example:

0.5

​
service_fee_amount
string
required
Example:

"0.25"

​
total_fee_percent
number
required

All-in fee vs midmarket rate.

Example:

1.1

​
total_fee_amount
string
required
Example:

"0.55"

​
developer_fee_percent
number
required
deprecated
Example:

0.5

​
developer_fee_amount
string
required
deprecated
Example:

"0.25"

​
estimated_arrival
string
required
Example:

"≈ 2 minutes after deposit"