Quotes

Fetch an indicative quote for a crypto deposit route

Quote a route before creating a deposit account. Quotes do not require a wallet ID or an authorization signature. Omit the input amount to quote approximately $50 of the source asset. Source and destination must both be mainnet or both be testnet.

This calls POST /v1/deposit_accounts/crypto/quote.

The body uses input_amount and slippage_bps for the amount and slippage.

curl --request POST https://api.privy.io/v1/deposit_accounts/crypto/quote \
  -u "<your-privy-app-id>:<your-privy-app-secret>" \
  -H "privy-app-id: <your-privy-app-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {"chain": "base", "asset": "usdc"},
    "destination": {"chain": "tempo", "asset": "pathusd"},
    "input_amount": "1.5",
    "slippage_bps": 50
  }'

source · object · required

Asset the quote prices as input. Unlike create, both chain and asset are required.

Hide properties

source.chain · string · required

A quote is a specific route, so chain cannot be omitted.

source.asset · string · required

destination · object · required

Asset delivered to the destination wallet.

Hide properties

destination.chain · string · required

destination.asset · string · required

input_amount · string

Amount as a decimal string in the source token’s standard unit (for example, "1.5" for 1.5 USDC). Not the smallest on-chain unit. Omit to quote approximately $50 of the source asset.

slippage_bps · number

Slippage tolerance in basis points.

The request rejects when the route is unsupported or source and destination are not both mainnet or both testnet. It returns:

input_amount · string

Quoted input as a decimal string in the source token’s standard unit.

estimated_output_amount · string

Estimated output as a decimal string in the destination token’s standard unit.

created_at · string

ISO 8601 timestamp when the quote was created.

Related

Create a deposit account

Provision deposit addresses

Orders

Poll sweep status after a deposit is sent

Quote API

POST /v1/deposit_accounts/crypto/quote