> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dzap.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Quotes
> Best-route quotes for same-chain swaps and cross-chain bridges.
Returns the best available routes for one or more swap/bridge pairs, including recommended provider, priced route, and fees. Transaction calldata is not included - call [`/v1/buildTx`](/api/trade/build-tx) separately once you've picked a route.
### Body
Source chain ID for every item in `data`.
Array of trade requests to quote.
Amount to send, in the source token's smallest unit.
Source token contract address.
Source token decimals (skips a lookup if provided).
Destination token contract address.
Destination token decimals (skips a lookup if provided).
Destination chain ID.
Slippage tolerance, in percent.
Restrict/prefer quoting to a specific provider ID.
User's wallet address.
Quote filter: `all` (default), `best`, or `fastest`.
Request gasless-eligible quotes.
Request private/MEV-protected quotes.
Skip gas/output estimation for a faster response.
Allow/deny list of bridge providers: `{ allow?: string[]; deny?: string[] }`.
Allow/deny list of DEX providers: `{ allow?: string[]; deny?: string[] }`.
Fine-tune quote collection timing.
Minimum wait time before returning results. Default `1000`.
Maximum wait time for quote optimization. Default `5000`.
Delay between subsequent provider batches. Default `500`.
Target number of quotes to collect. Default `3`.
Return partial results once `maxWaitTimeMs` is hit.
### Response
The response is an object keyed by pair identifier (`{fromChain}_{srcToken}_{toChain}_{destToken}`), not wrapped in a `data` envelope.
Per-pair status, if applicable.
Provider ID of the recommended route.
Provider ID with the best return - use as a fallback route.
Provider ID with the fastest execution (bridge quotes only).
Map keyed by provider ID, each value a full quote.
Present for bridge routes. Same shape as `providerDetails` above.
Effective exchange rate for this route.
Same shape as `srcToken` above.
Estimated seconds to completion.
Whether the fee is already netted into the shown amounts.
Same item shape as `gasFee` above.
Same item shape as `gasFee` above.
High-level step summary.
`{ logo, name }`.
Detailed route path.
Same shape as `providerDetails` above.
Same shape as the top-level `srcToken` above.
Same shape as the top-level `srcToken` above.
Same shape as the top-level `fee` above.
Optional route badges.
Provider-specific extra data (shape varies).
Map of `chainId` → token addresses missing price data.
### Examples
```bash curl theme={null}
curl -X POST https://api.dzap.io/v1/quotes \
-H "Content-Type: application/json" \
-d '{
"fromChain": 42161,
"data": [
{
"amount": "1000000",
"srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"destToken": "0x4200000000000000000000000000000000000006",
"toChain": 8453,
"slippage": 1
}
],
"account": "0x99BCEBf44433E901597D9fCb16E799a4847519f6"
}'
```
```ts SDK theme={null}
const quotes = await dzap.getTradeQuotes({
fromChain: 42161,
data: [
{
amount: '1000000',
srcToken: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
destToken: '0x4200000000000000000000000000000000000006',
toChain: 8453,
slippage: 1,
},
],
account: '0x99BC...',
});
```
```json 200 theme={null}
{
"42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831_8453_0x4200000000000000000000000000000000000006": {
"recommendedSource": "across",
"bestReturnSource": "across",
"quoteRates": {
"across": {
"providerDetails": { "id": "across", "name": "Across", "icon": "https://..." },
"srcAmount": "1000000",
"srcAmountUSD": "1.00",
"destAmount": "300000000000000",
"destAmountUSD": "0.99",
"minDestAmount": "298500000000000",
"priceImpactPercent": "0.12",
"duration": "90",
"gasless": false,
"fee": { "gasFee": [], "protocolFee": [], "providerFee": [] },
"steps": [{ "type": "bridge", "exchange": { "logo": "https://...", "name": "Across" } }],
"path": []
}
},
"tokensWithoutPrice": {}
}
}
```