Sign in
Quotes V3

Best quote per payment platform for an exact fiat amount.

post/v3/quote/best-by-platform

Headers

x-pp-keystring

Optional env-configured Peer Pay service key

Optional env-configured Peer Pay service key

Request body

fiatCurrencystring required

Fiat currency code (e.g., 'USD', 'EUR')

exactFiatAmountstring required

Exact fiat amount in token units (e.g., '100000000' = $100)

userstring required

User's Ethereum address (excluded from quotes)

recipientstring required

Recipient Ethereum address

destinationChainIdinteger required

Destination chain ID

destinationTokenstring required

Token address (e.g., USDC on Base)

referrerstring

Optional referrer address

escrowAddressesstring[] required

List of escrow contract addresses to search

minDepositSuccessRateBpsinteger

Minimum maker success rate in basis points (0-10000)

supportBusinessAccountsboolean

Include business accounts in quotes (default: false)

mode'eligible' | 'eligible_with_chargeback' | 'eligible_with_chargeback_staked'

eligible returns quotes the user can take via the direct route: whitelist-off deposits without dispute, plus whitelist-enabled deposits the user is whitelisted for (whitelisted takers bypass dispute staking); eligible_with_chargeback also returns dispute-route quotes, where stake is locked at signal; eligible_with_chargeback_staked returns dispute-route quotes only when the user's free stake covers the signal amount

quotePreference'EXCLUSIVE_SAR' | 'PREFER_SAR' | 'PREFER_BUYER_TEE' | 'EXCLUSIVE_BUYER_TEE'

Preferred quote pool and fallback behavior

excludedPayToValuesstring[]

Payee values to exclude from quote selection

Response

Success

successboolean required
messagestring required
statusCodenumber required
errorCodestring

Changes