streamQuotes | 0x Docs

Stream cross-chain quotes as they become available

Query parameters

originChainstringRequired

The source chain from which the cross-chain swap will originate. Can be specified as chain ID or name. See here for the list of supported chains

The source chain from which the cross-chain swap will originate. Can be specified as chain ID or name. See [here](https://0x-docs.gitbook.io/0x-cross-chain-api-beta/developer-resources/supported-chains-and-providers) for the list of supported chains

destinationChainstringRequired

The destination chain where tokens will be received after the cross-chain swap. Can be specified as chain ID or name. See here for the list of supported chains

The destination chain where tokens will be received after the cross-chain swap. Can be specified as chain ID or name. See [here](https://0x-docs.gitbook.io/0x-cross-chain-api-beta/developer-resources/supported-chains-and-providers) for the list of supported chains

sellTokenstringRequired

The contract address of the token to sell on the origin chain. Format varies by chain type (EVM address for EVM/HyperCore chains, token mint address for Solana, base58check address for Tron)

buyTokenstringRequired

The contract address of the token to buy on the destination chain. Format varies by chain type (EVM address for EVM/HyperCore chains, token mint address for Solana, base58check address for Tron)

sellAmountstringRequiredformat: "^-?(0|[1-9]\d*)$"

The amount of sellToken (in sellToken’s base units) to sell on the origin chain

originAddressstringRequired

The wallet address on the origin chain that holds the sellToken balance and will initiate the cross-chain transaction

destinationAddressstringOptional

The wallet address on the destination chain that will receive the buyToken. If not specified, defaults to originAddress on the destination chain

gasPayerstringOptional

The Solana address that will pay for transaction fees when the origin chain is Solana. Only applicable for Solana origin chains

solanaEphemeralSignerPubkeystringOptional

Pubkey of an integrator-held ephemeral keypair used as a one-shot extra transaction signer for Solana origin routes that require one (e.g. the CCTP event account). Generate a fresh keypair per request and sign the returned transaction with it; the account must not already exist on-chain and is not reusable afterwards. Routes requiring an ephemeral signer are only quoted when this is set. Only applicable for Solana origin chains

slippageBpsintegerOptional0-10000Defaults to 100

The maximum acceptable slippage for each swap or bridge step of the cross-chain swap in basis points (100 = 1%)

excludedBridgesstringOptional

Comma-separated list of bridge providers to exclude from routing

includedBridgesstringOptional

Comma-separated list of bridge providers to include in routing. Mutually exclusive with excludedBridges

excludedSwapSourcesstringOptional

Comma-separated list of DEX sources to exclude from routing on both chains

feeBpsstringOptionalDefaults to

The trading fee amounts in basis points to charge on the origin chain (supports single or comma-separated values). Must be used together with feeRecipient. When multiple values are provided, must match the length of feeRecipient. Note: integrator fee collection is not yet supported for Tron-originated routes.

feeRecipientstringOptionalDefaults to

The wallet addresses to receive trading fees on the origin chain (supports single or comma-separated values). Must be used together with feeBps. When multiple values are provided, must match the length of feeBps. Note: integrator fee collection is not yet supported for Tron-originated routes.

feeTokenstringOptionalDefaults to

The token addresses for fee collection on the origin chain (supports single or comma-separated values). Must be the same as sellToken. When multiple values are provided, must match the length of feeBps. If omitted, defaults to sellToken. Note: integrator fee collection is not yet supported for Tron-originated routes.

maxNumQuotesintegerOptional1-10Defaults to 5

The maximum number of cross-chain quotes to return, between 1 and 10. Each quote represents a different combination of bridges and DEXs

Response

Successful response

zidstring

The unique ZeroEx identifier of the request

eventobject

The streaming event containing either quote data or final result

Errors

400

Bad Request Error

500

Internal Server Error

$	curl -G https://api.0x.org/cross-chain/quotes/stream \
>	-H "0x-api-key: 0x-api-key" \
>	-d originChain=8453 \
>	-d destinationChain=42161 \
>	-d sellToken=0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf \
>	-d buyToken=0xaf88d065e77c8cc2239327c5edb3a432268e5831 \
>	-d sellAmount=2570 \
>	-d originAddress=0x56EB0aD2dC746540Fab5C02478B31e2AA9DdC38C \
>	-d destinationAddress=0x56EB0aD2dC746540Fab5C02478B31e2AA9DdC38C

1	{
2	"zid": "0xbed7b45844099af94219ba8c",
3	"event": {
4	"type": "quote",
5	"data": {
6	"quote": {
7	"sellAmount": 2570,
8	"buyAmount": 2972100,
9	"minBuyAmount": 2942339,
10	"fees": {
11	"integratorFee": null,
12	"integratorFees": [
13	{
14	"amount": 1,
15	"token": "string",
16	"type": "volume"
17	}
18	],
19	"zeroExFee": {
20	"amount": 6,
21	"token": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
22	"type": "volume"
23	},
24	"bridgeNativeFee": null
25	},
26	"gasCosts": {
27	"chainType": "evm",
28	"gasPrice": 11550962,
29	"gasLimit": 672945,
30	"totalNetworkFee": 7790577030769
31	},
32	"steps": [
33	{
34	"type": "swap",
35	"chainId": 8453,
36	"sellToken": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
37	"buyToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
38	"sellAmount": 2564,
39	"buyAmount": 2979865,
40	"minBuyAmount": 2950101,
41	"estimatedTimeSeconds": 0
42	},
43	{
44	"type": "bridge",
45	"originChainId": 8453,
46	"destinationChainId": 42161,
47	"sellToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
48	"buyToken": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
49	"sellAmount": 2979865,
50	"buyAmount": 2972100,
51	"minBuyAmount": 2942339,
52	"provider": "across_v3",
53	"estimatedTimeSeconds": 3
54	}
55	],
56	"transaction": {
57	"chainType": "evm",
58	"details": {
59	"to": "0x0000000000001ff3684f28c67538d4d072c22734",
60	"data": "0x2213bc0b...",
61	"gas": 672945,
62	"gasPrice": 0,
63	"value": 0
64	}
65	},
66	"estimatedTimeSeconds": 3,
67	"issues": {
68	"allowance": null,
69	"balance": {
70	"token": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
71	"actual": 0,
72	"expected": 2570
73	},
74	"simulationIncomplete": false
75	},
76	"quoteId": "0xbed7b45844099af94219ba8c00000001"
77	},
78	"allowanceTarget": "0x0000000000001ff3684f28c67538d4d072c22734"
79	}
80	}
81	}

Headers

Query parameters

Response

Errors