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.

ActionEndpoint
Create a quotePOST /api/v2/transfers/quotes

After you create a quote:

  • Use its id to 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 (individual or business), and chain when the asset is a stablecoin.
  • destination: what the recipient gets: asset, type, and country for fiat or chain for a stablecoin.
  • amount: set it on source or destination, not both. See Source or Destination Amount.
  • commission (optional): your fee, as an amount, a percentage, or both. See Commission.
  • on_behalf_of (optional): the Customer's uuid. 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 onSender paysCommissionRecipient gets
destination: 100105.27 USD5.26100.00 USDC
source: 100100.00 USD5.0095.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.

FieldDescription
idThe quote ID, starting with quote_. Use it to get the transfer requirements and create the transfer.
payment_methodHow the funds move, such as ACH_PULL, SPEI or ON_CHAIN.
source_amount / destination_amountWhat the sender pays and what the recipient gets.
exchange_rate / exchange_pairThe rate between the two currencies.
feesEach fee: its type, amount, who charges it and who pays it.
quote_expire_dateWhen the quote expires. Create the transfer before then.
customer_limitsOnly 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, RTP and DOMESTIC_WIRE.
  • source_country is set. destination_chain is the chain the stablecoins are sent on.
  • No settlement time fields.

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 *_limit of 0 means no limit for that period, not that the Customer is blocked.
  • When there's no limit, the matching *_remaining and current_remaining are also 0. Check *_limit first.

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

CodeCause
2005Invalid request. For example, no amount, or an amount outside the allowed range.
3018No quotes are available for this route.


Did this page help you?