Skip to main content
GET
/
quotes
Get available quotes for a given amount and token pair.
curl --request GET \
  --url https://api-partner.houdiniswap.com/v2/quotes \
  --header 'Authorization: <api-key>'
{
  "quotes": [
    {
      "swap": "<string>",
      "quoteId": "<string>",
      "duration": 123,
      "gas": 123,
      "gasUsd": 123,
      "amountIn": 123,
      "amountOut": 123,
      "amountOutUsd": 123,
      "feeUsd": 123,
      "bridgeFeeUsd": 123,
      "netAmountOut": 123,
      "error": "<string>",
      "swapName": "<string>",
      "type": "private",
      "filtered": false,
      "supportsSignatures": true,
      "logoUrl": "<string>",
      "markupSupported": true,
      "slippageSupported": true,
      "apiMarkupValue": 123,
      "markupType": "absolute",
      "restrictedCountries": [
        "<string>"
      ],
      "rewardsAvailable": true,
      "min": 123,
      "max": 123,
      "rateId": "<string>",
      "requiresApproval": true
    }
  ],
  "total": 123
}

Authorizations

​
Authorization
string
header
required

Query Parameters

​
amount
number<double>
required

Amount to be quoted

Required range: 0 <= x <= 10000000
​
from
string
required

Id of the token from which the swap is initiated

​
to
string
required

Id of the token to which the swap is directed

​
slippage
number<double>

Slippage percentage, only used for decentralized swaps.

Required range: 0 <= x <= 100
​
useXmr
boolean

Use XMR if true, if false use another token for the anonymous transaction

​
deviationThreshold
number<double>

Maximum price deviation percentage when rotating wallets. Only used if rotatePayoutWallets is true. Default 5

Required range: 0 <= x <= 100
​
rotationLookback
number<double>

Number of recent orders to check for path rotation. Only used if rotatePayoutWallets is true. Default 10

Required range: 1 <= x <= 100
​
rotatePayoutWallets
boolean

Enable payout wallet rotation for better privacy. Only used for centralized quotes

​
types
enum<string>[]

Types of quotes to return; if omitted, all types are used

Available options:
private,
standard,
dex
​
swaps
enum<string>[]

Swaps to use for the quote; if omitted, all swaps are used

Available options:
ch,
cl,
cn,
el,
le,
se,
ss,
sz,
sp,
eb,
nx,
cc,
qx,
sw,
dl,
ad,
wh,
cf,
un,
jp,
mn,
rd,
ps,
cs,
kd,
ct,
zx,
wc,
su,
bd,
tt,
sd,
bg,
ab
​
senderAddress
string

Address of the wallet initiating the swap

​
receiverAddress
string

If different from senderAddress, DEX routes that don't support sending to another wallet are filtered. Also used for payout wallet rotation

​
sort
enum<string>

Sort the quotes by the given field (default: amountOut)

Available options:
amountOut,
amountOutUsd,
duration
​
sortOrder
enum<string>

Sort direction for quotes (default: desc)

Available options:
asc,
desc

Response

Success

​
quotes
object[]
required
​
total
number<double>
required