Quotes
Get a price for a transfer before you create it.
A quote is a price for a transfer: the amounts on each side, the exchange rate and the fees. Every Transfer (V2) starts with a quote, which locks these values until it expires.
| Action | Endpoint |
|---|---|
| Create a quote | POST /api/v2/transfers/quotes |
After you create a quote:
- Use its
idto get the transfer requirements. - Create the transfer with the same
id, before the quote expires.
Create a Quote
POST /api/v2/transfers/quotes
source: what the sender pays with:country,asset,type(individualorbusiness), andchainwhen the asset is a stablecoin.destination: what the recipient gets:asset,type, andcountryfor fiat orchainfor a stablecoin.amount: set it onsourceordestination, not both. See Source or Destination Amount.commission(optional): your fee, as anamount, apercentage, or both. See Commission.on_behalf_of(optional): the Customer'suuid. Only the payment methods that Customer can use are returned, with their limits.gas_fee_payer: leave it out to use the default.
Example: an on-ramp quote from USD to USDC on the Ethereum network, for 100 USDC to the recipient.
curl --location --request POST 'https://harbor-sandbox.owlpay.com/api/v2/transfers/quotes' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-API-KEY: {{API_KEY}}' \
--data-raw '{
"on_behalf_of": "cus_2XxcIyUQbPNzMAdyJ7NFjolt8t5zBEvqr402fjqK",
"source": {
"country": "US",
"asset": "USD",
"type": "individual"
},
"destination": {
"chain": "ethereum",
"asset": "USDC",
"amount": 100,
"type": "individual"
},
"commission": {
"amount": 1,
"percentage": 5
}
}'{
"data": [
{
"id": "quote_Qqz1jQTOF2a0mNVEQyjVxeYY5JNg5muSXEpLxJPs",
"payment_method": "DEBIT_CARD",
"payment_method_label": "Debit Card",
"chain": null,
"source_country": "US",
"destination_country": null,
"source_amount": "106.32",
"source_currency": "USD",
"destination_amount": "100.000000",
"destination_currency": "USDC",
"destination_chain": "ethereum",
"exchange_rate": "1.00000000",
"exchange_pair": "USD/USDC",
"routing_key": "rtk_oe123cbbb153bbb8c",
"source_type": "individual",
"destination_type": "individual",
"quote_expire_date": "2026-10-06T04:11:15+00:00",
"crypto_funds_settlement_expire_date": "2026-10-06T03:41:15+00:00",
"fees": [
{
"type": "HARBOR_FEE",
"amount": "1.791336",
"currency": "USDC",
"charge_from": "OwlPay Harbor",
"payer": "Your Company LLC"
},
{
"type": "COMMISSION_FEE",
"amount": "6.320000",
"currency": "USDC",
"charge_from": "Your Company LLC",
"payer": "customer"
}
],
"customer_limits": {
"per_transaction_limit": "500.00",
"daily_limit": "9999.00",
"weekly_limit": "25000.00",
"monthly_limit": "50000.00",
"daily_spent": "0",
"daily_remaining": "9999.00",
"weekly_spent": "0",
"weekly_remaining": "25000.00",
"monthly_spent": "0",
"monthly_remaining": "50000.00",
"current_remaining": "500.00"
},
"created_at": "2026-10-06T03:11:15+00:00",
"updated_at": "2026-10-06T03:11:15+00:00"
},
{
"id": "quote_JvmJtSoxxNANhYhM2pWgVcbOfjK4c8TmuAAILFN5",
"payment_method": "ACH_PULL",
"payment_method_label": "ACH Pull (Direct Debit)",
"chain": null,
"source_country": "US",
"destination_country": null,
"source_amount": "106.32",
"source_currency": "USD",
"destination_amount": "100.000000",
"destination_currency": "USDC",
"destination_chain": "ethereum",
"exchange_rate": "1.00000000",
"exchange_pair": "USD/USDC",
"routing_key": "rtk_od7729a412cf1f8b1",
"source_type": "individual",
"destination_type": "individual",
"quote_expire_date": "2026-10-06T04:11:15+00:00",
"crypto_funds_settlement_expire_date": "2026-10-06T03:41:15+00:00",
"fees": [
{
"type": "HARBOR_FEE",
"amount": "1.791336",
"currency": "USDC",
"charge_from": "OwlPay Harbor",
"payer": "Your Company LLC"
},
{
"type": "COMMISSION_FEE",
"amount": "6.320000",
"currency": "USDC",
"charge_from": "Your Company LLC",
"payer": "customer"
}
],
"customer_limits": {
"per_transaction_limit": "9999.00",
"daily_limit": "9999.00",
"weekly_limit": "25000.00",
"monthly_limit": "50000.00",
"daily_spent": "0",
"daily_remaining": "9999.00",
"weekly_spent": "0",
"weekly_remaining": "25000.00",
"monthly_spent": "0",
"monthly_remaining": "50000.00",
"current_remaining": "9999.00"
},
"created_at": "2026-10-06T03:11:15+00:00",
"updated_at": "2026-10-06T03:11:15+00:00"
},
{
"id": "quote_sZegJBTtEuHUhvlksJ7aWb5lgwkCQGrJsT12MOJJ",
"payment_method": "RTP",
"payment_method_label": "Real-Time Payment (RTP)",
"chain": null,
"source_country": "US",
"destination_country": null,
"source_amount": "106.32",
"source_currency": "USD",
"destination_amount": "100.000000",
"destination_currency": "USDC",
"destination_chain": "ethereum",
"exchange_rate": "1.00000000",
"exchange_pair": "USD/USDC",
"routing_key": "rtk_o37095658fc1a9056",
"source_type": "individual",
"destination_type": "individual",
"quote_expire_date": "2026-10-06T04:11:15+00:00",
"crypto_funds_settlement_expire_date": "2026-10-06T03:41:15+00:00",
"fees": [
{
"type": "HARBOR_FEE",
"amount": "1.791336",
"currency": "USDC",
"charge_from": "OwlPay Harbor",
"payer": "Your Company LLC"
},
{
"type": "COMMISSION_FEE",
"amount": "6.320000",
"currency": "USDC",
"charge_from": "Your Company LLC",
"payer": "customer"
}
],
"customer_limits": {
"per_transaction_limit": "9999.00",
"daily_limit": "9999.00",
"weekly_limit": "0.00",
"monthly_limit": "0.00",
"daily_spent": "0",
"daily_remaining": "9999.00",
"weekly_spent": "0",
"weekly_remaining": "0",
"monthly_spent": "0",
"monthly_remaining": "0",
"current_remaining": "9999.00"
},
"created_at": "2026-10-06T03:11:15+00:00",
"updated_at": "2026-10-06T03:11:15+00:00"
},
{
"id": "quote_ZaEVXnMmlxEv6o8FkO60YxdkSTyyA9n0ZZhlQsbQ",
"payment_method": "DOMESTIC_WIRE",
"payment_method_label": "Domestic Wire",
"chain": null,
"source_country": "US",
"destination_country": null,
"source_amount": "106.32",
"source_currency": "USD",
"destination_amount": "100.000000",
"destination_currency": "USDC",
"destination_chain": "ethereum",
"exchange_rate": "1.00000000",
"exchange_pair": "USD/USDC",
"routing_key": "rtk_oa1edc136c1db36ee",
"source_type": "individual",
"destination_type": "individual",
"quote_expire_date": "2026-10-06T04:11:15+00:00",
"crypto_funds_settlement_expire_date": "2026-10-06T03:41:15+00:00",
"fees": [
{
"type": "HARBOR_FEE",
"amount": "1.791336",
"currency": "USDC",
"charge_from": "OwlPay Harbor",
"payer": "Your Company LLC"
},
{
"type": "COMMISSION_FEE",
"amount": "6.320000",
"currency": "USDC",
"charge_from": "Your Company LLC",
"payer": "customer"
}
],
"customer_limits": {
"per_transaction_limit": "0",
"daily_limit": "0",
"weekly_limit": "0",
"monthly_limit": "0",
"daily_spent": "120.10000000",
"daily_remaining": "0",
"weekly_spent": "220.18000000",
"weekly_remaining": "0",
"monthly_spent": "220.18000000",
"monthly_remaining": "0",
"current_remaining": "0"
},
"created_at": "2026-10-06T03:11:15+00:00",
"updated_at": "2026-10-06T03:11:15+00:00"
}
]
}Source or Destination Amount
Where you put amount decides which side is fixed:
- On
destination: the recipient gets exactly that amount. The quote tells you how much the sender pays, including fees. - On
source: the sender pays exactly that amount. The quote tells you how much the recipient gets, after fees.
Use destination when the recipient must receive a set amount, such as an invoice. Use source when the sender has a set amount to spend.
For example, converting USD to USDC with a 5% commission:
"commission": {
"percentage": 5
}amount set on | Sender pays | Commission | Recipient gets |
|---|---|---|---|
destination: 100 | 105.27 USD | 5.26 | 100.00 USDC |
source: 100 | 100.00 USD | 5.00 | 95.00 USDC |
The Response
data is an array, with one quote for each available payment method. Pick the one you want and use its id.
| Field | Description |
|---|---|
id | The quote ID, starting with quote_. Use it to get the transfer requirements and create the transfer. |
payment_method | How the funds move, such as ACH_PULL, SPEI or ON_CHAIN. |
source_amount / destination_amount | What the sender pays and what the recipient gets. |
exchange_rate / exchange_pair | The rate between the two currencies. |
fees | Each fee: its type, amount, who charges it and who pays it. |
quote_expire_date | When the quote expires. Create the transfer before then. |
customer_limits | Only when you send on_behalf_of. See Customer Limits. |
Some fields depend on the type of transfer:
- One quote for each payment method the sender can pay with, such as
DEBIT_CARD,ACH_PULL,RTPandDOMESTIC_WIRE. source_countryis set.destination_chainis the chain the stablecoins are sent on.- No settlement time fields.
- One quote for each local payout method, such as
SPEIfor Mexico. chainis the chain the sender pays on.destination_countryis set.fiat_settlement_time_min/_max/_unit: how long the payout usually takes.crypto_funds_settlement_expire_date: the deadline for the stablecoins to arrive.
payment_methodisON_CHAIN.chainanddestination_chainare set, and both countries arenull.crypto_settlement_time_min/_max/_unit: how long the transfer usually takes.crypto_funds_settlement_expire_date: the deadline for the stablecoins to arrive.feesincludesBLOCKCHAIN_NETWORK_FEE, paid by the sender. Each fee also has alabelandis_deducted_from_amount.exchange_rateincludes the network fee, so it's below1even for the same stablecoin.
How long a quote is valid depends on the transfer. Always check quote_expire_date.
The HARBOR_FEE is billed to your company at the end of each billing cycle. It isn't included in source_amount or destination_amount, so the sender and the recipient don't pay it. See Fees.
Customer Limits
When you send on_behalf_of, each quote includes customer_limits: the Customer's payment method limits and how much they have left.
- These are payment method limits, not tier limits.
- A
*_limitof0means no limit for that period, not that the Customer is blocked. - When there's no limit, the matching
*_remainingandcurrent_remainingare also0. Check*_limitfirst.
A quote doesn't check the tier limits. They're checked when you create the transfer, so a transfer can still be rejected after a successful quote.
Missing Payment Methods
A payment method can be missing from the response when:
- The amount is over that method's limit.
- No price is available for that method right now. Harbor gets prices from downstream, and if downstream doesn't return one, that method isn't included.
Errors
| Code | Cause |
|---|---|
2005 | Invalid request. For example, no amount, or an amount outside the allowed range. |
3018 | No quotes are available for this route. |
Updated about 1 month ago