> ## 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. # Get multi quotes > Returns the available routes for each swap in a batch. Optional. [Create multi exchange](/api-reference/multi-exchange/create-multi-exchange) picks its own routes and takes no `quoteId`, so call this only when you want to show rates before committing. - standard and private CEX only — no DEX - `mode=single` quotes just the first swap, as a faster preview Beta — the response shape may still change. ## OpenAPI ````yaml https://api-partner.houdiniswap.com/v2/openapi.json post /quotes/multi openapi: 3.0.0 info: title: Houdini Swap Partner API version: 2.1.2 description: >- Quote and execute private, standard, and DEX swaps — one at a time or batched. license: name: ISC contact: {} servers: - url: https://api-partner.houdiniswap.com/v2 security: [] tags: - name: Private and Standard Swaps description: >- CEX swaps in two modes, sharing the same endpoints — pick one with the `types` parameter. - `types=standard` — direct single-leg swap. Fastest, no privacy hop. - `types=private` — two legs through a privacy bridge, so deposit and payout are not linkable on-chain. Adds `anonymous`, `useXmr`, `rotatePayoutWallets` and the `inLeg*` / `outLeg*` filters. Flow: [Get tokens](/api-reference/private-and-standard-swaps/get-tokens) with `hasCex=true` → [Get quotes](/api-reference/private-and-standard-swaps/get-quotes) → [Create exchange](/api-reference/private-and-standard-swaps/create-exchange) → [track the order](/api-reference/private-and-standard-swaps/get-order-details). `markup` works in both modes. - name: Private Send description: >- Send a token to another wallet privately — same token in and out, with no on-chain link between the two addresses. - find eligible tokens with [Get tokens](/api-reference/private-send/get-tokens) and `hasSelfPrivate=true` - quote with Get private send quote, then create with Create private send order - you can also stay on the main endpoints with a private same-token `quoteId` See the [Private send](/docs/v2/private-send) guide. - name: Multi-Exchange description: >- Create and track a group of swaps sharing one `multiId`. - post the orders straight to Create multi exchange — there is no quote step and no `quoteId` - Get multi quotes is optional, for showing rates first - each order gets its own deposit address; poll [Get batch status](/api-reference/multi-exchange/get-batch-status) for every leg - CEX standard and private only — no DEX in a batch To fund the whole group in one transaction, see Bundler SOL or Bundler EVM. See the [multi-swap flow](https://docs.houdiniswap.com/developer-hub/swap-flows/multi-swap) for the full sequence. - name: Bundler SOL description: >- Fund a whole multi-exchange group with one Solana batch transfer. - one call — Get batch transaction returns the transaction to sign and broadcast - up to 10 deposits per batch; every order must send the same token - find batchable tokens with [Get tokens](/api-reference/multi-exchange/get-tokens) and `hasBundler=true` - nothing to submit back afterwards — retry and recovery are EVM-only See the [multi-swap flow](https://docs.houdiniswap.com/developer-hub/swap-flows/multi-swap) for the full sequence. - name: Bundler EVM description: >- Fund a whole multi-exchange group with one ERC-4337 UserOperation, submitted through the bundler. - Ethereum, Base and BNB Smart Chain only; other EVM chains are rejected - up to 20 legs per batch; every order must send the same source token - find batchable tokens with [Get tokens](/api-reference/multi-exchange/get-tokens) and `hasBundler=true` - build the UserOp, then submit the signed result - if a bundle fails: retry within 30 minutes, or recover stuck assets See the [multi-swap flow](https://docs.houdiniswap.com/developer-hub/swap-flows/multi-swap) for the full sequence. - name: On-chain DEX or Bridge description: >- On-chain swaps signed and funded from the user's own wallet. Flow: [Get tokens](/api-reference/on-chain-dex-or-bridge/get-tokens) with `hasDex=true` → [Get quotes](/api-reference/on-chain-dex-or-bridge/get-quotes) with `types=dex` → [Get token approval data](/api-reference/on-chain-dex-or-bridge/get-token-approval-data) → send it and poll [Check token allowance](/api-reference/on-chain-dex-or-bridge/check-token-allowance) → [Get next chain signature](/api-reference/on-chain-dex-or-bridge/get-next-chain-signature) → [Create exchange](/api-reference/on-chain-dex-or-bridge/create-exchange) → [Confirm DEX transaction](/api-reference/on-chain-dex-or-bridge/confirm-dex-transaction) → [track the order](/api-reference/on-chain-dex-or-bridge/get-order-details). - `slippage` applies to DEX only - `markup` is not supported - name: Reference Data description: >- Optional lookups: supported chains, liquidity providers, and per-pair min/max swap amounts. Responses are cached and change rarely — safe to fetch once and reuse. Token ids come from `/tokens`, listed in each swap section above. - name: Partner Account description: >- Your orders, profile, earned commissions, withdrawals, volume analytics, and the rate-limit budget attached to your API key. Every endpoint is scoped to the partner that owns the key making the request. - name: System description: >- Service health. [Get system health](/api-reference/system/get-system-health) is unauthenticated and exempt from x402 payment — use it for uptime monitoring. paths: /quotes/multi: post: tags: - Multi-Exchange summary: Get multi quotes description: >- Returns the available routes for each swap in a batch. Optional. [Create multi exchange](/api-reference/multi-exchange/create-multi-exchange) picks its own routes and takes no `quoteId`, so call this only when you want to show rates before committing. - standard and private CEX only — no DEX - `mode=single` quotes just the first swap, as a faster preview Beta — the response shape may still change. operationId: GetMultiQuotes parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MultiQuoteRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/MultiQuoteResult' examples: Example 1: value: mode: all batched: true orders: - index: 0 quoted: true total: 1 quotes: - quoteId: 69a02882f48d56c923119d95 swap: cl swapName: Changelly type: private amountIn: 0.25 amountOut: 3.5182 amountInUsd: 26450.5 amountOutUsd: 26301.44 netAmountOut: 3.5182 duration: 22 providerEta: 18 min: 0.0012 max: 12.5 fixed: false filtered: false amountType: send - index: 1 quoted: true total: 0 quotes: [] error: code: SWAP_AMOUNT_IS_OUT_OF_BOUNDS message: Amount is below the minimum for this pair '401': description: >- Credentials missing, malformed, or rejected — all return `INVALID_API_CREDENTIALS`. Sending only `partner-id` returns `PARTNER_ID_NOT_SUPPORTED`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '402': description: >- Payment required — x402 protocol. The body is empty; what to pay is in the `payment-required` header. Not returned when you send an `Authorization` header. content: application/json: schema: $ref: '#/components/schemas/X402PaymentRequired' headers: payment-required: schema: type: string required: true '404': description: Token not found or disabled content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Failed content: application/json: schema: $ref: '#/components/schemas/ValidationError' '429': description: Rate limit exceeded — back off and retry content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKey: [] components: schemas: MultiQuoteRequest: properties: orders: items: $ref: '#/components/schemas/MultiQuoteOrderItem' type: array description: >- The swaps to quote, 1 to 10 per request. Each is quoted on its own, so one failing does not fail the rest. minItems: 1 maxItems: 10 filters: $ref: '#/components/schemas/QuoteFilters' description: Provider filters applied to every order in the batch. mode: $ref: '#/components/schemas/MultiQuoteMode' description: >- How many of the submitted orders to quote. `all` (the default) quotes every order; `single` quotes only the first order and returns the rest with `quoted: false`. See MultiQuoteMode for the full behaviour. batched: type: boolean description: >- Quote the orders in parallel (`true`, the default) or one after another. Leave it unset unless you are measuring latency — the results are the same either way. required: - orders type: object additionalProperties: false MultiQuoteResult: properties: mode: $ref: '#/components/schemas/MultiQuoteMode' description: The `mode` this batch was quoted with. batched: type: boolean description: The `batched` setting this request ran with. orders: items: $ref: '#/components/schemas/MultiQuoteOrderResult' type: array description: >- One entry per order you sent, in the same order. Match them up with `index`. required: - mode - batched - orders type: object additionalProperties: false ErrorResponse: properties: message: type: string code: type: string description: >- Machine-readable reason for the failure. Branch on this, not on `message` — messages are free to change. The value depends on the HTTP status. The common ones: - `400` — `BAD_REQUEST` - `401` — `INVALID_API_CREDENTIALS`, `PARTNER_ID_NOT_SUPPORTED` - `403` — `ACCESS_DENIED`, `FIXED_RATE_NOT_ALLOWED` - `404` — `NOT_FOUND`, `TOKEN_NOT_FOUND`, `TOKEN_DISABLED` - `409` — `ALREADY_SUBMITTED`, `STATIC_DEPOSIT_IN_USE` - `422` — `VALIDATION_ERROR`, `AMOUNT_TOO_LOW`, `INVALID_SWAP`, `FIXED_RATE_QUOTE_EXPIRED`, and most other request problems - `429` — `RATE_LIMIT_EXCEEDED` - `5xx` — `INTERNAL_SERVER_ERROR`, `PROVIDER_EXCHANGE_FAILED`, `SERVICE_UNAVAILABLE` New codes are added over time, so treat this as an open set: match the ones you handle and fall back to the HTTP status for the rest. requestId: type: string description: >- Unique id for this request. Quote it when contacting support — it is how we find the failure in our logs. required: - message - code type: object additionalProperties: false X402PaymentRequired: description: >- Body of a `402 Payment required`. Empty — `{}` — for API clients; a request that looks like a browser gets an HTML paywall page instead. This is the x402 payment protocol, not the normal error format, so there is no `code` or `message` to branch on. What to pay is always in the `payment-required` response header, in both cases: base64-encoded JSON whose `accepts[]` entries each carry the `network`, the `asset` to pay in, the `amount`, and the `payTo` address, alongside `maxTimeoutSeconds` and the x402 `scheme`. Sending `Authorization` skips the payment flow, so a 402 only reaches callers paying per request. An `apiKey` query param also skips it but is not a credential — those requests fail with `401 INVALID_API_CREDENTIALS`. properties: {} type: object additionalProperties: false ValidationError: properties: message: type: string code: type: string description: >- Machine-readable reason for the failure. Branch on this, not on `message` — messages are free to change. The value depends on the HTTP status. The common ones: - `400` — `BAD_REQUEST` - `401` — `INVALID_API_CREDENTIALS`, `PARTNER_ID_NOT_SUPPORTED` - `403` — `ACCESS_DENIED`, `FIXED_RATE_NOT_ALLOWED` - `404` — `NOT_FOUND`, `TOKEN_NOT_FOUND`, `TOKEN_DISABLED` - `409` — `ALREADY_SUBMITTED`, `STATIC_DEPOSIT_IN_USE` - `422` — `VALIDATION_ERROR`, `AMOUNT_TOO_LOW`, `INVALID_SWAP`, `FIXED_RATE_QUOTE_EXPIRED`, and most other request problems - `429` — `RATE_LIMIT_EXCEEDED` - `5xx` — `INTERNAL_SERVER_ERROR`, `PROVIDER_EXCHANGE_FAILED`, `SERVICE_UNAVAILABLE` New codes are added over time, so treat this as an open set: match the ones you handle and fall back to the HTTP status for the rest. requestId: type: string description: >- Unique id for this request. Quote it when contacting support — it is how we find the failure in our logs. fields: $ref: '#/components/schemas/FieldErrors' required: - message - code - fields type: object additionalProperties: false MultiQuoteOrderItem: description: A single order to quote within a POST /quotes/multi batch. properties: from: type: string description: >- Token ID from which the swap is initiated. Must be a MongoDB ObjectId (24-char hex string). example: 6689b73ec90e45f3b3e51564 minLength: 24 maxLength: 24 to: type: string description: >- Token ID to which the swap is directed. Must be a MongoDB ObjectId (24-char hex string). example: 6689b73ec90e45f3b3e51558 minLength: 24 maxLength: 24 amount: type: number format: double description: >- Input amount as a decimal float in the token's display units. Must be > 0. minimum: 0 anonymous: type: boolean description: Use anonymous (private) routing for this order. useXmr: type: boolean description: >- Use Monero (XMR) as the bridge token on a private swap. Unset picks from a rotating set of other tokens. markup: type: number format: double description: |- Partner markup for this request, as a percentage (0.5 = 0.5%). Accepted range: 0–4. This value overrides your account’s default markup for this trade. Send 0 to apply no markup, or leave the field empty / set it to null if no markup is requested. Providers that do not support the requested markup will be excluded. example: 0.5 minimum: 0 maximum: 4 required: - from - to - amount type: object additionalProperties: false QuoteFilters: properties: onlySwaps: items: type: string type: array description: >- Only quote these providers. Omit to use all of them. Values are `shortName` from [Get swap providers](/api-reference/reference-data/get-swap-providers). rotatePayoutWallets: type: boolean description: >- Rotate the payout path for better privacy. Private swaps only — standard and DEX are single-leg and ignore it. rotateFallback: type: boolean description: >- When strict rotation runs out of rotated routes, use a valid non-rotated route instead of failing. Default false. Needs `rotatePayoutWallets` — on its own it does nothing. deviationThreshold: type: number format: double description: >- How far the rate may move, as a percentage, before a rotated route is rejected. Default 5. Only used when `rotatePayoutWallets` is true. minimum: 0 maximum: 100 rotationLookback: type: integer format: int32 description: >- How many of your recent orders to look at when picking a different payout path. Default 10. Only used when `rotatePayoutWallets` is true. minimum: 1 maximum: 100 inLeg: $ref: '#/components/schemas/LegFilter' description: >- Provider filter for the in-leg of a private (2-hop) route. Omit it and `onlySwaps` applies to both legs. Ignored by standard and DEX, which are single-hop. outLeg: $ref: '#/components/schemas/LegFilter' description: >- Provider filter for the out-leg of a private (2-hop) route. Omit it and `onlySwaps` applies to both legs. Ignored by standard and DEX, which are single-hop. type: object additionalProperties: false MultiQuoteMode: type: string enum: - all - single description: >- Controls how many of the submitted orders are individually quoted. - `all` (default): every order is quoted and returns its own array of candidate routes. - `single`: only the first order is quoted; the remaining orders come back with `quoted: false` and no candidates — a lighter, faster preview for when quoting the whole batch is too slow. MultiQuoteOrderResult: description: Per-order quote result envelope; `quotes` is empty when `error` is set. properties: index: type: number format: double description: Index of this order in the request `orders` array. quoted: type: boolean description: False when the order was not individually quoted (single mode). total: type: number format: double description: Number of candidate quotes returned for this order. quotes: items: $ref: '#/components/schemas/QuoteV2' type: array description: >- Routes for this order, best rate first. Empty when `quoted` is false or `error` is set. error: $ref: '#/components/schemas/MultiQuoteOrderError' description: >- Why this order could not be quoted. Only the affected order fails — the rest of the batch still returns, and the request is still a 200. required: - index - quoted - total - quotes type: object additionalProperties: false FieldErrors: properties: {} type: object additionalProperties: properties: value: {} message: type: string required: - message type: object LegFilter: properties: include: items: type: string type: array description: >- Only use these providers for this leg. Values are `shortName` from [Get swap providers](/api-reference/reference-data/get-swap-providers). exclude: items: type: string type: array description: >- Never use these providers for this leg. Values are `shortName` from [Get swap providers](/api-reference/reference-data/get-swap-providers). type: object additionalProperties: false QuoteV2: properties: swap: type: string description: >- Provider short code, e.g. `se`. Matches `shortName` from [Get swap providers](/api-reference/reference-data/get-swap-providers). Absent on private quotes — the providers behind a private route are not disclosed. quoteId: type: string description: >- Pass this to [Create exchange](/api-reference/private-and-standard-swaps/create-exchange) to execute the quote. duration: type: number format: double description: Our estimate of how long the swap takes, in minutes. providerEta: type: number format: double description: >- The provider's own stated ETA, in minutes. May differ from `duration`. gas: type: number format: double description: >- Estimated gas cost, in the source chain's native gas units. DEX routes only. gasUsd: type: number format: double description: Estimated gas cost in USD. DEX routes only. amountIn: type: number format: double description: Amount you send, e.g. `0.25` BTC. amountOut: type: number format: double description: Amount you receive, e.g. `3.52` ETH. amountOutUsd: type: number format: double description: '`amountOut` valued in USD.' amountInUsd: type: number format: double description: '`amountIn` valued in USD. Present on exact-out quotes only.' feeUsd: type: number format: double description: >- Provider fee in USD, charged on the source chain in its native token. Does not include gas. bridgeFeeUsd: type: number format: double description: Bridge fee in USD, when the route crosses chains. netAmountOut: type: number format: double description: >- The field to compare routes on: `amountOut` minus `feeUsd`, in the output token — not USD. - equals `amountOut` on CEX quotes, which carry no `feeUsd` - gas is not deducted - falls back to `amountOut` when the output token has no USD price error: type: string description: >- Why this route could not be priced. When set, the amounts are not usable. swapName: type: string description: |- Provider display name, e.g. `StealthEx`. Absent on private quotes, for the same reason as `swap`. type: $ref: '#/components/schemas/QuoteType' description: 'Which route this is: `private`, `standard`, or `dex`.' filtered: type: boolean description: >- True when the route was returned but should not be used — check `filteredReason`. Creating an exchange from a filtered route is rejected. default: false filteredReason: $ref: '#/components/schemas/FilteredReason' description: >- Why the route was filtered: unacceptable price impact, or the payout wallet differs from the sender. supportsSignatures: type: boolean description: >- True when the route accepts EIP-712 permit signatures instead of a separate approval transaction. logoUrl: type: string description: Provider logo. markupSupported: type: boolean description: >- True when the route can apply partner markup. Routes that cannot are excluded when you send `markup`. slippageSupported: type: boolean description: True when the route honours the `slippage` parameter. apiMarkupValue: type: number format: double description: Markup the route was priced with, in the unit given by `markupType`. markupType: type: string enum: - absolute - percentage - bp description: >- How to read `apiMarkupValue`: `percentage`, `absolute`, or `bp` (basis points). restrictedCountries: items: type: string type: array description: ISO country codes where this route may not be offered. rewardsAvailable: type: boolean description: True when the swap earns rewards. min: type: number format: double description: Smallest amount this route accepts, e.g. `0.001` BTC. max: type: number format: double description: Largest amount this route accepts, e.g. `5` BTC. minOut: type: number format: double description: >- Smallest amount you can receive, e.g. `100` USDT. Present only when `amountType` is `receive` and the provider returns receive-side bounds. maxOut: type: number format: double description: >- Largest amount you can receive, e.g. `50000` USDT. Present only when `amountType` is `receive` and the provider returns receive-side bounds. rateId: type: string description: >- Identifies the locked rate on a fixed-rate quote. You do not pass this when creating the exchange — `quoteId` carries it. fixed: type: boolean description: True when the rate is locked until `validUntil`. validUntil: type: string description: >- When the locked rate expires, as a Unix timestamp in seconds, e.g. `"1767225600"`. Fixed-rate quotes only — create the exchange before it passes. requiresApproval: type: boolean description: >- DEX quotes only. True when the wallet must approve the token before swapping — EVM and Tron non-native tokens. Call [Get token approval data](/api-reference/on-chain-dex-or-bridge/get-token-approval-data), send what it returns, then poll [Check token allowance](/api-reference/on-chain-dex-or-bridge/check-token-allowance) until it turns true. isPriority: type: boolean depositAddressSupported: type: boolean description: >- DEX quotes only. True when the route can be funded by sending to a deposit address, with no connected wallet. requiresRefundAddress: type: boolean description: >- True when this provider needs a `refundAddress` to execute. Collect one before creating the exchange; without it the swap falls through to the next provider. appliedApiMarkup: type: number format: double description: >- The `markup` you sent, as a percentage (`0.5` = 0.5%), returned back so you can check it was used. Absent when your stored account markup applied. On a private swap this is the PER-LEG value and is charged on both legs. refundAddress: type: string description: >- The `refundAddress` you sent, returned back so you can check it was used. It sits on the source chain. amountType: type: string enum: - send - receive description: >- Whether the amounts are driven by the send side (`send`) or the receive side (`receive`). requiresIntermediateRefundAddress: type: boolean description: >- True when this route settles through an on-chain hop, which needs a second refund address on top of `refundAddress`. Collect it from the user and send it as `intermediateRefundAddress` at [Create exchange](/api-reference/private-and-standard-swaps/create-exchange), or the call is rejected. `intermediateRefundChain` and `intermediateRefundToken` say which chain it must be on and which token it would receive. intermediateRefundChain: type: string description: >- Chain the `intermediateRefundAddress` must be on, e.g. `base`, `ethereum` or `solana`. Present only on a route that settles through an on-chain hop. intermediateRefundToken: type: string description: >- Token the intermediate refund arrives in, e.g. `USDC`. The address you supply must be able to receive it. Present only on a route that settles through an on-chain hop. type: object additionalProperties: false MultiQuoteOrderError: properties: message: type: string description: >- What went wrong, in plain text. Show it, but do not branch on it — the wording can change. code: anyOf: - type: string - type: number format: double description: >- Machine-readable reason, from the same set of codes as a top-level error response. Branch on this. required: - message type: object additionalProperties: false QuoteType: enum: - private - standard - dex type: string FilteredReason: enum: - price_impact - different_recipient type: string securitySchemes: apiKey: type: apiKey name: Authorization in: header description: >- Send `Authorization: :` — joined by a colon, raw. No `Bearer` prefix, no base64. [Get your credentials](https://docs.houdiniswap.com/developer-hub/getting-started/authentication) ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.