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>",
      "filtered": false,
      "supportsSignatures": true,
      "logoUrl": "<string>",
      "markupSupported": true,
      "slippageSupported": true,
      "apiMarkupValue": 123,
      "restrictedCountries": [
        "<string>"
      ],
      "rewardsAvailable": true,
      "min": 123,
      "max": 123,
      "rateId": "<string>",
      "fixed": true,
      "validUntil": "<string>",
      "requiresApproval": true,
      "isPriority": true,
      "refundAddress": "<string>"
    }
  ],
  "total": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.houdiniswap.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
amount
number<double>
required

Amount of the from token to swap as a decimal float in the token's display units (e.g. 1.5 BTC, 250.75 USDT) — not a base-units / wei integer like 100000000000000. Must be strictly greater than 0 and at most the maximum BSON Double value (Number.MAX_VALUE ≈ 1.7976931348623157e308).

Required range: 0 <= x <= 1.7976931348623157e+308
​
from
string
required

Token ID from which the swap is initiated. Must be a MongoDB ObjectId (24-char hex string), not a symbol. Use GET /v2/tokens to look up token IDs.

​
to
string
required

Token ID to which the swap is directed. Must be a MongoDB ObjectId (24-char hex string), not a symbol. Use GET /v2/tokens to look up token IDs.

​
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

​
fixed
boolean

Request a fixed-rate quote. Only partners that support fixed rate will be returned.

​
refundAddress
string

Sender's wallet address for refunds if a fixed-rate swap fails.

Maximum string length: 200
​
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,
tc,
sw,
dl,
ad,
wh,
cf,
un,
jp,
mn,
rd,
ps,
cs,
kd,
ct,
zx,
wc,
su,
bd,
tt,
sd,
bg,
ab,
pt
​
inLegIncludedSwaps
string[]

Allowlist for the in-leg of anonymous (private, 2-hop) paths. When set, only these providers may be used as the in-leg. Silently ignored for STANDARD and DEX quotes, which are single-hop and have no in/out leg concept.

​
inLegExcludedSwaps
string[]

Providers excluded from the in-leg of anonymous (private, 2-hop) paths. Does not affect the out-leg. Silently ignored for STANDARD and DEX quotes, which are single-hop and have no in/out leg concept.

​
outLegIncludedSwaps
string[]

Allowlist for the out-leg of anonymous (private, 2-hop) paths. When set, only these providers may be used as the out-leg. Silently ignored for STANDARD and DEX quotes, which are single-hop and have no in/out leg concept.

​
outLegExcludedSwaps
string[]

Providers excluded from the out-leg of anonymous (private, 2-hop) paths. Does not affect the in-leg. Silently ignored for STANDARD and DEX quotes, which are single-hop and have no in/out leg concept.

​
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