Quotes V3

Quote minimum fiat input for an exact token output amount.

post/v3/quote/exact-token

Headers

x-pp-keystring

Optional env-configured Peer Pay service key

Optional env-configured Peer Pay service key

Request body

paymentPlatformsstring[] required

Payment platforms

fiatCurrencystring required

Fiat currency

userstring required

User submitting transactions

recipientstring required

Final recipient address

destinationChainIdinteger required

Destination chain ID

destinationTokenstring required

Destination token address

referrerstring

Referrer

useMultihopboolean

Use multihop from a base asset

escrowAddressesstring[] required

List of escrow contract addresses to search (e.g., ['0xabc...', '0xdef...']).

supportBusinessAccountsboolean

Whether quotes may include business accounts (default: false)

minDepositSuccessRateBpsinteger

Minimum historical deposit success rate in basis points (0–10000). Defaults to 0 when omitted

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

maxTakerConversionRatestring

Maximum acceptable taker conversion rate, scaled by 1e18. Candidates quoting above this are excluded from both exact and nearby searches. Omit for no ceiling.

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

exactTokenAmountstring required

Exact amount of tokens user wants to receive

includeNearbyQuotesboolean

Include nearby quote suggestions when no exact match

nearbySearchRangenumber

Max percentage deviation to search (1-100%). Unlimited if omitted

nearbyQuotesCountnumber

Max quotes per direction (default: 3, max: 10)

Response

Success

successboolean required
messagestring required
statusCodenumber required
errorCodestring

Changes