GET /swap/v1/quote

Quote
Get an easy-to-consume quote for buying or selling any ERC20 token. The return format is a valid unsigned Ethereum transaction and can be submitted directly to an Ethereum node (or the nodes of other chains if applicable) to complete the swap. For transactions where the sellToken is not ETH, you will have to set your allowances. 
Request
Either a sellAmount or buyAmount is required. Do not provide both fields at the same quote request.
Query Param
Description
Example
sellToken
The ERC20 token address or symbol of the token you want to send. Native token such as "ETH" can be provided as a valid sellToken. If the symbol given is not supported, try using token address instead. 
sellToken=ETH, sellToken=0x6b175474e89094c44da98b954eedeac495271d0f

buyToken
The ERC20 token address or symbol of the token you want to receive. Native token such as "ETH" can be provided as a valid buyToken. If the symbol given is not supported, try using token address instead. 
buyToken=ETH, buyToken=0x6b175474e89094c44da98b954eedeac495271d0f
sellAmount
(Optional) The amount of sellToken (in sellToken base units) you want to send. 
sellAmount=100000000000
buyAmount
(Optional) The amount of buyToken (in buyToken base units) you want to receive. 
buyAmount=100000000000
slippagePercentage
(Optional) The maximum acceptable slippage of the buyToken amount if sellAmount is provided; The maximum acceptable slippage of the sellAmount amount if buyAmount is provided. E.g 0.03 for 3% slippage allowed. 
slippagePercentage=0.03
gasPrice
(Optional, defaults to ethgasstation "fast") The target gas price (in wei) for the swap transaction. If the price is too low to achieve the quote, an error will be returned.
gasPrice=1000000
takerAddress
(Optional) The address which will fill the quote. When provided the gas will be estimated and returned and the entire transaction will be validated for success. If the validation fails a Revert Error will be returned in the response. The quote should be fillable if this address is provided. For example, make sure this address has enough token balance.
takerAddress=0xa8aac589a67ecfade31efde49a062cc21d68a64e
excludedSources
(Optional) Liquidity sources (Uniswap, SushiSwap, 0x, Curve etc) that will not be included in the provided quote. See here for a full list of sources
excludedSources=Uniswap,SushiSwap,Curve
includedSources
(Optional) For now only supports RFQT, which should be used when the integrator only wants RFQT liquidity without any other DEX orders. Requires a particular agreement with the 0x integrations team. This parameter cannot be combined with excludedSources.
includedSources=RFQT
skipValidation
(Optional) Normally, whenever a takerAddress is provided, the API will validate the quote for the user. (For more details, see "How does takerAddress help with catching issues?".) When this parameter is set to true, that validation will be skipped. See also here.

For /quote, the default of 
skipValidation=false but can be overridden to true. 
skipValidation=false
intentOnFilling
(Optional) Used to enable RFQ-T liquidity. For more details see the guide here. 
intentOnFilling=true
feeRecipient
(Optional) The ETH address that should receive affiliate fees specified with buyTokenPercentageFee. Can be used combination with buyTokenPercentageFee to set a commission/trading fee when using the API. More info here.
feeRecipient=0xa8aac589a67ecfade31efde49a062cc21d68a64e
buyTokenPercentageFee
(Optional) The percentage (between 0 - 1.0) of the buyAmount that should be attributed to feeRecipient as affiliate fees. Note that this requires that the feeRecipient parameter is also specified in the request.
buyTokenPercentageFee=0.1
affiliateAddress
(Optional) An ETH address for which to attribute the trade for tracking and analytics purposes. Note affiliateAddress is only for tracking trades and has no impact on affiliate fees, for affiliate fees use feeRecipient.
affiliateAddress=0xa8aac589a67ecfade31efde49a062cc21d68a64e
Response
Field
Description
price
If buyAmount was specified in the request it provides the price of buyToken in sellToken and vice versa. This price does not include the slippage provided in the request above, and therefore represents the best possible price.
guaranteedPrice
The price which must be met or else the entire transaction will revert. This price is influenced by the slippagePercentage parameter. On-chain sources may encounter price movements from quote to settlement.
to
The address of the contract to send call data to.
data
The call data required to be sent to the to contract address.
value
The amount of ether (in wei) that should be sent with the transaction. (Assuming protocolFee is paid in ether).
gasPrice
The gas price (in wei) that should be used to send the transaction. The transaction needs to be sent with this gasPrice or lower for the transaction to be successful.
gas
The estimated gas limit that should be used to send the transaction to guarantee settlement. While a computed estimate is returned in all responses, an accurate estimate will only be returned if a takerAddress is included in the request.
estimatedGas
The estimate for the amount of gas that will actually be used in the transaction. Always less than gas.
protocolFee
The maximum amount of ether that will be paid towards the protocol fee (in wei), and what is used to compute the value field of the transaction.
minimumProtocolFee
The minimum amount of ether that will be paid towards the protocol fee (in wei) during the transaction.
buyAmount
The amount of buyToken (in buyToken units) that would be bought in this swap. Certain on-chain sources do not allow specifying buyAmount, when using buyAmount these sources are excluded.
sellAmount
The amount of sellToken (in sellToken units) that would be sold in this swap. Specifying sellAmount is the recommended way to interact with 0xAPI as it covers all on-chain sources.
sources
The percentage distribution of buyAmount or sellAmount split between each liquidity source. Ex: [{ name: '0x', proportion: "0.8" }, { name: 'Kyber', proportion: "0.2"}, ...]
buyTokenAddress
The ERC20 token address of the token you want to receive in quote.
sellTokenAddress
The ERC20 token address of the token you want to sell with quote.
allowanceTarget
The target contract address for which the user needs to have an allowance in order to be able to complete the swap. For swaps with "ETH" as sellToken, wrapping "ETH" to "WETH" or unwrapping "WETH" to "ETH" no allowance is needed, a null address of 0x0000000000000000000000000000000000000000 is then returned instead.
orders
The details of fill orders
sellTokenToEthRate
The rate between ETH and sellToken 
buyTokenToEthRate
The rate between ETH and buyToken 
Examples
Simple DAI Buy with WETH
Specify a buyToken, sellToken and either a sellAmount to get a simple quote of 1 WETH for DAI.
Request
Get
1
https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=WETH&sellAmount=100000000000000000
Copied!
Response
1
{
2
    "chainId": 1,
3
    "price": "2504.4918553394464675",
4
    "guaranteedPrice": "2479.4469367860520028",
5
    "to": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
6
    "data": "0xd9627aa40000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000002386f26fc100000000000000000000000000000000000000000000000000015817a685f9a1645c00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f869584cd000000000000000000000000100000000000000000000000000000000000001100000000000000000000000000000000000000000000001c2e352fd761f763ab",
7
    "value": "0",
8
    "gas": "111000",
9
    "estimatedGas": "111000",
10
    "gasPrice": "93000000000",
11
    "protocolFee": "0",
12
    "minimumProtocolFee": "0",
13
    "buyTokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
14
    "sellTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
15
    "buyAmount": "25044918553394464675",
16
    "sellAmount": "10000000000000000",
17
    "sources": [
18
        {
19
            "name": "0x",
20
            "proportion": "0"
21
        },
22
        {
23
            "name": "Uniswap",
24
            "proportion": "0"
25
        },
26
        {
27
            "name": "Uniswap_V2",
28
            "proportion": "0"
29
        },
30
        {
31
            "name": "Eth2Dai",
32
            "proportion": "0"
33
        },
34
        {
35
            "name": "Kyber",
36
            "proportion": "0"
37
        },
38
        {
39
            "name": "Curve",
40
            "proportion": "0"
41
        },
42
        {
43
            "name": "Balancer",
44
            "proportion": "0"
45
        },
46
        {
47
            "name": "Balancer_V2",
48
            "proportion": "0"
49
        },
50
        {
51
            "name": "Bancor",
52
            "proportion": "0"
53
        },
54
        {
55
            "name": "mStable",
56
            "proportion": "0"
57
        },
58
        {
59
            "name": "Mooniswap",
60
            "proportion": "0"
61
        },
62
        {
63
            "name": "Swerve",
64
            "proportion": "0"
65
        },
66
        {
67
            "name": "SnowSwap",
68
            "proportion": "0"
69
        },
70
        {
71
            "name": "SushiSwap",
72
            "proportion": "1"
73
        },
74
        {
75
            "name": "Shell",
76
            "proportion": "0"
77
        },
78
        {
79
            "name": "MultiHop",
80
            "proportion": "0"
81
        },
82
        {
83
            "name": "DODO",
84
            "proportion": "0"
85
        },
86
        {
87
            "name": "DODO_V2",
88
            "proportion": "0"
89
        },
90
        {
91
            "name": "CREAM",
92
            "proportion": "0"
93
        },
94
        {
95
            "name": "LiquidityProvider",
96
            "proportion": "0"
97
        },
98
        {
99
            "name": "CryptoCom",
100
            "proportion": "0"
101
        },
102
        {
103
            "name": "Linkswap",
104
            "proportion": "0"
105
        },
106
        {
107
            "name": "Lido",
108
            "proportion": "0"
109
        },
110
        {
111
            "name": "MakerPsm",
112
            "proportion": "0"
113
        },
114
        {
115
            "name": "KyberDMM",
116
            "proportion": "0"
117
        },
118
        {
119
            "name": "Smoothy",
120
            "proportion": "0"
121
        },
122
        {
123
            "name": "Component",
124
            "proportion": "0"
125
        },
126
        {
127
            "name": "Saddle",
128
            "proportion": "0"
129
        },
130
        {
131
            "name": "xSigma",
132
            "proportion": "0"
133
        },
134
        {
135
            "name": "Uniswap_V3",
136
            "proportion": "0"
137
        },
138
        {
139
            "name": "Curve_V2",
140
            "proportion": "0"
141
        },
142
        {
143
            "name": "ShibaSwap",
144
            "proportion": "0"
145
        }
146
    ],
147
    "orders": [
148
        {
149
            "makerToken": "0x6b175474e89094c44da98b954eedeac495271d0f",
150
            "takerToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
151
            "makerAmount": "25044918553394464675",
152
            "takerAmount": "10000000000000000",
153
            "fillData": {
154
            "tokenAddressPath": [
155
                "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
156
                "0x6b175474e89094c44da98b954eedeac495271d0f"
157
            ],
158
            "router": "0xd9e1ce17f2641f24ae83637ab66a2cca9c378b9f"
159
        },
160
        "source": "SushiSwap",
161
        "sourcePathId": "0xe58bde9f0ca002c1e99df8df403eabe6431a3b0476ee5dfb92fe0a35af2f5ead",
162
        "type": 0
163
        }
164
    ],
165
    "allowanceTarget": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
166
    "sellTokenToEthRate": "1",
167
    "buyTokenToEthRate": "2504.46738154874763977"
168
}
Copied!
Excluding liquidity sources
Supply a comma delimited list of liquidty source names to exclude them from the aggregator logic. See here for a full list of sources.
Request
Get
1
https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=1000000000000000000&excludedSources=0x,Kyber
Copied!
Response
1
{
2
    "chainId": 1,
3
    "price": "2484.996784870669179426",
4
    "guaranteedPrice": "2460.146817021962487631",
5
    "to": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
6
    "data": "0xd9627aa400000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000000000000000000000000000855d653faa3dfe074f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee0000000000000000000000006b175474e89094c44da98b954eedeac495271d0f869584cd00000000000000000000000010000000000000000000000000000000000000110000000000000000000000000000000000000000000000ee7813bf1e61f766c0",
7
    "value": "1000000000000000000",
8
    "gas": "136000",
9
    "estimatedGas": "136000",
10
    "gasPrice": "96000000000",
11
    "protocolFee": "0",
12
    "minimumProtocolFee": "0",
13
    "buyTokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
14
    "sellTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
15
    "buyAmount": "2484996784870669179426",
16
    "sellAmount": "1000000000000000000",
17
    "sources": [
18
        {
19
            "name": "0x",
20
            "proportion": "0"
21
        },
22
        {
23
            "name": "Uniswap",
24
            "proportion": "0"
25
        },
26
        {
27
            "name": "Uniswap_V2",
28
            "proportion": "1"
29
        },
30
        {
31
            "name": "Eth2Dai",
32
            "proportion": "0"
33
        },
34
        {
35
            "name": "Kyber",
36
            "proportion": "0"
37
        },
38
        {
39
            "name": "Curve",
40
            "proportion": "0"
41
        },
42
        {
43
            "name": "Balancer",
44
            "proportion": "0"
45
        },
46
        {
47
            "name": "Balancer_V2",
48
            "proportion": "0"
49
        },
50
        {
51
            "name": "Bancor",
52
            "proportion": "0"
53
        },
54
        {
55
            "name": "mStable",
56
            "proportion": "0"
57
        },
58
        {
59
            "name": "Mooniswap",
60
            "proportion": "0"
61
        },
62
        {
63
            "name": "Swerve",
64
            "proportion": "0"
65
        },
66
        {
67
            "name": "SnowSwap",
68
            "proportion": "0"
69
        },
70
        {
71
            "name": "SushiSwap",
72
            "proportion": "0"
73
        },
74
        {
75
            "name": "Shell",
76
            "proportion": "0"
77
        },
78
        {
79
            "name": "MultiHop",
80
            "proportion": "0"
81
        },
82
        {
83
            "name": "DODO",
84
            "proportion": "0"
85
        },
86
        {
87
            "name": "DODO_V2",
88
            "proportion": "0"
89
        },
90
        {
91
            "name": "CREAM",
92
            "proportion": "0"
93
        },
94
        {
95
            "name": "LiquidityProvider",
96
            "proportion": "0"
97
        },
98
        {
99
            "name": "CryptoCom",
100
            "proportion": "0"
101
        },
102
        {
103
            "name": "Linkswap",
104
            "proportion": "0"
105
        },
106
        {
107
            "name": "Lido",
108
            "proportion": "0"
109
        },
110
        {
111
            "name": "MakerPsm",
112
            "proportion": "0"
113
        },
114
        {
115
            "name": "KyberDMM",
116
            "proportion": "0"
117
        },
118
        {
119
            "name": "Smoothy",
120
            "proportion": "0"
121
        },
122
        {
123
            "name": "Component",
124
            "proportion": "0"
125
        },
126
        {
127
            "name": "Saddle",
128
            "proportion": "0"
129
        },
130
        {
131
            "name": "xSigma",
132
            "proportion": "0"
133
        },
134
        {
135
            "name": "Uniswap_V3",
136
            "proportion": "0"
137
        },
138
        {
139
            "name": "Curve_V2",
140
            "proportion": "0"
141
        },
142
        {
143
            "name": "ShibaSwap",
144
            "proportion": "0"
145
        }
146
    ],
147
    "orders": [
148
        {
149
            "makerToken": "0x6b175474e89094c44da98b954eedeac495271d0f",
150
            "takerToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
151
            "makerAmount": "2484996784870669179426",
152
            "takerAmount": "1000000000000000000",
153
            "fillData": {
154
                "tokenAddressPath": [
155
                    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
156
                    "0x6b175474e89094c44da98b954eedeac495271d0f"
157
                ],
158
                "router": "0xf164fc0ec4e93095b804a4795bbe1e041497b92a"
159
            },
160
            "source": "Uniswap_V2",
161
            "sourcePathId": "0x3d17978a401419de71950469cdeec831aeaafc5abbab547a5e79cc2d4c38cce3",
162
            "type": 0
163
        }
164
    ],
165
    "allowanceTarget": "0x0000000000000000000000000000000000000000",
166
    "sellTokenToEthRate": "1",
167
    "buyTokenToEthRate": "2482.11547954119199012"
168
}
Copied!
Supplying a Taker Address
Supply a takerAddress to use an eth_call to perform additional validation, and an accurate gas estimate.
Request
Get
1
https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=1000000000000000000&takerAddress=0xab5801a7d398351b8be11c439e05c5b3259aec9b
Copied!
Response
1
{
2
    "chainId": 1,
3
    "price": "2496.390120385736312458",
4
    "guaranteedPrice": "2471.426219181878949333",
5
    "to": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
6
    "data": "0x3598d8ab0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000085f9edbc2b2a9635d50000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002bc02aaa39b223fe8d0a0e5c4f27ead9083c756cc20001f46b175474e89094c44da98b954eedeac495271d0f000000000000000000000000000000000000000000869584cd00000000000000000000000010000000000000000000000000000000000000110000000000000000000000000000000000000000000000f4d36b6ed161f769fa",
7
    "value": "1000000000000000000",
8
    "gas": "151000",
9
    "estimatedGas": "151000",
10
    "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
11
    "gasPrice": "88000000000",
12
    "protocolFee": "0",
13
    "minimumProtocolFee": "0",
14
    "buyTokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
15
    "sellTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
16
    "buyAmount": "2496390120385736312458",
17
    "sellAmount": "1000000000000000000",
18
    "sources": [
19
        {
20
            "name": "0x",
21
            "proportion": "0"
22
        },
23
        {
24
            "name": "Uniswap",
25
            "proportion": "0"
26
        },
27
        {
28
            "name": "Uniswap_V2",
29
            "proportion": "0"
30
        },
31
        {
32
            "name": "Eth2Dai",
33
            "proportion": "0"
34
        },
35
        {
36
            "name": "Kyber",
37
            "proportion": "0"
38
        },
39
        {
40
            "name": "Curve",
41
            "proportion": "0"
42
        },
43
        {
44
            "name": "Balancer",
45
            "proportion": "0"
46
        },
47
        {
48
            "name": "Balancer_V2",
49
            "proportion": "0"
50
        },
51
        {
52
            "name": "Bancor",
53
            "proportion": "0"
54
        },
55
        {
56
            "name": "mStable",
57
            "proportion": "0"
58
        },
59
        {
60
            "name": "Mooniswap",
61
            "proportion": "0"
62
        },
63
        {
64
            "name": "Swerve",
65
            "proportion": "0"
66
        },
67
        {
68
            "name": "SnowSwap",
69
            "proportion": "0"
70
        },
71
        {
72
            "name": "SushiSwap",
73
            "proportion": "0"
74
        },
75
        {
76
            "name": "Shell",
77
            "proportion": "0"
78
        },
79
        {
80
            "name": "MultiHop",
81
            "proportion": "0"
82
        },
83
        {
84
            "name": "DODO",
85
            "proportion": "0"
86
        },
87
        {
88
            "name": "DODO_V2",
89
            "proportion": "0"
90
        },
91
        {
92
            "name": "CREAM",
93
            "proportion": "0"
94
        },
95
        {
96
            "name": "LiquidityProvider",
97
            "proportion": "0"
98
        },
99
        {
100
            "name": "CryptoCom",
101
            "proportion": "0"
102
        },
103
        {
104
            "name": "Linkswap",
105
            "proportion": "0"
106
        },
107
        {
108
            "name": "Lido",
109
            "proportion": "0"
110
        },
111
        {
112
            "name": "MakerPsm",
113
            "proportion": "0"
114
        },
115
        {
116
            "name": "KyberDMM",
117
            "proportion": "0"
118
        },
119
        {
120
            "name": "Smoothy",
121
            "proportion": "0"
122
        },
123
        {
124
            "name": "Component",
125
            "proportion": "0"
126
        },
127
        {
128
            "name": "Saddle",
129
            "proportion": "0"
130
        },
131
        {
132
            "name": "xSigma",
133
            "proportion": "0"
134
        },
135
        {
136
            "name": "Uniswap_V3",
137
            "proportion": "1"
138
        },
139
        {
140
            "name": "Curve_V2",
141
            "proportion": "0"
142
        },
143
        {
144
            "name": "ShibaSwap",
145
            "proportion": "0"
146
        }
147
    ],
148
    "orders": [
149
        {
150
            "makerToken": "0x6b175474e89094c44da98b954eedeac495271d0f",
151
            "takerToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
152
            "makerAmount": "2496390120385736312458",
153
            "takerAmount": "1000000000000000000",
154
            "fillData": {
155
                "router": "0xe592427a0aece92de3edee1f18e0157c05861564",
156
                "tokenAddressPath": [
157
                    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
158
                    "0x6b175474e89094c44da98b954eedeac495271d0f"
159
                ],
160
                "uniswapPath": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc20001f46b175474e89094c44da98b954eedeac495271d0f"
161
            },
162
            "source": "Uniswap_V3",
163
            "sourcePathId": "0xcb26f3151d130b8a513c634db8a75b30f1ed3ee24a41a578b90efe1de55ac28c",
164
            "type": 0
165
        }
166
    ],
167
    "allowanceTarget": "0x0000000000000000000000000000000000000000",
168
    "sellTokenToEthRate": "1",
169
    "buyTokenToEthRate": "2485.49297930185739314"
170
}
Copied!
If the eth_call fails (because takerAddress cannot complete the transaction), the response will include reasons for the failure.
1
{
2
    "code": 105,
3
    "reason": "IncompleteFillError",
4
    "values": {
5
        "error": 0,
6
        "expectedAssetFillAmount": "10000000",
7
        "actualAssetFillAmount": "0"
8
    }
9
}
Copied!
Wrapping and unwrapping between ETH and WETH
Easily wrap and unwrap between ETH and WETH by requesting a swap quote by setting sellToken and 'buyToken' as either 'WETH' or 'ETH'. The swap quote returned will provide the calldata to directly interact with the WETH9 contract and not with 0x exchange contracts.
Wrap ETH
Request
Get
1
https://api.0x.org/swap/v1/quote?buyToken=ETH&sellToken=WETH&buyAmount=10000000
Copied!
Response
1
{
2
    "chainId": 1,
3
    "price": "1",
4
    "guaranteedPrice": "1",
5
    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
6
    "data": "0x2e1a7d4d0000000000000000000000000000000000000000000000000000000000989680869584cd0000000000000000000000001000000000000000000000000000000000000011000000000000000000000000000000000000000000000087b981bc4361f76bbe",
7
    "value": "0",
8
    "gas": "46000",
9
    "estimatedGas": "46000",
10
    "gasPrice": "104000000000",
11
    "protocolFee": "0",
12
    "minimumProtocolFee": "0",
13
    "buyTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
14
    "sellTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
15
    "buyAmount": "10000000",
16
    "sellAmount": "10000000",
17
    "sources": [],
18
    "orders": [],
19
    "sellTokenToEthRate": "1",
20
    "buyTokenToEthRate": "1",
21
    "allowanceTarget": "0x0000000000000000000000000000000000000000"
22
}
Copied!
Unwrap ETH
Request
Get
1
https://api.0x.org/swap/v1/quote?buyToken=WETH&sellToken=ETH&buyAmount=10000000
Copied!
Response
1
{
2
    "chainId": 1,
3
    "price": "1",
4
    "guaranteedPrice": "1",
5
    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
6
    "data": "0xd0e30db0869584cd0000000000000000000000001000000000000000000000000000000000000011000000000000000000000000000000000000000000000024811cd5d661f76c49",
7
    "value": "10000000",
8
    "gas": "46000",
9
    "estimatedGas": "46000",
10
    "gasPrice": "105000000000",
11
    "protocolFee": "0",
12
    "minimumProtocolFee": "0",
13
    "buyTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
14
    "sellTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
15
    "buyAmount": "10000000",
16
    "sellAmount": "10000000",
17
    "sources": [],
18
    "orders": [],
19
    "sellTokenToEthRate": "1",
20
    "buyTokenToEthRate": "1",
21
    "allowanceTarget": "0x0000000000000000000000000000000000000000"
22
}
Copied!
Ensure RFQ-T liquidity
RFQ-T liquidity can only be accessed if the request supplies a taker address, a permissioned API key via header 0x-api-key, and the query parameter intentOnFilling=true. For more details see the guide here.
Request
Get
1
https://api.0x.org/swap/v1/quote?sellToken=WETH&buyToken=DAI&sellAmount=1000000000000000000&takerAddress=0xffffffffffffffffffffffffffffffffffffffff&intentOnFilling=true
Copied!
Response
1
{
2
    "price": "376.7868259",
3
    "guaranteedPrice": "375.506208585632606933",
4
    "to": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
5
    "data": "0xa6c3bf3300000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000de0b6b3a764000000000000000000000000000000000000000000000000000000000000000007200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000002600000000000000000000000006425bb021dabd5d6b443a1ab47b003a1b7a27d4b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000011000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000051b3ded76a61cee0000000000000000000000000000000000000000000000000003782dace9d900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005f2d826000000000000000000000000000000000000000000000000000000173c9bc22f400000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000005e0000000000000000000000000000000000000000000000000000000000000064000000000000000000000000000000000000000000000000000000000000006400000000000000000000000000000000000000000000000000000000000000024f47261b00000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000000000000000000000000000c47b7094f378e54347e281aab170e8cca69d880a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000145b320b31045e6ad60000000000000000000000000000000000000000000000000de0b6b3a764000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005f2d9dcb7be1c251ac3d8521ea92398740531b31bd13d1e48c182ebb46dfc2360b9f433400000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000003c00000000000000000000000000000000000000000000000000000000000000420000000000000000000000000000000000000000000000000000000000000042000000000000000000000000000000000000000000000000000000000000001c4dc1600f30000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000c47b7094f378e54347e281aab170e8cca69d880a00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000140000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc200000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000036691c4f426eb8f42f150ebde43069a31cb080ad0000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000000000000000000000000000145b320b31045e6ad600000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000020000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000024f47261b0000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000421ca9636d5a84fb4e458816391b3d8860bf4b459f97b8962f8ec1c35d7240cce6d51ad2d55a2dec2562194ec7457d10d73b8f55fcdc144ee21e4211c067251973680200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010400000000000000000000000000000000000000000000000000000000000000869584cd00000000000000000000000010000000000000000000000000000000000000110000000000000000000000000000000000000000000000cef59c5ef35f2d81ac",
6
    "value": "12320000000000000",
7
    "gas": "540000",
8
    "estimatedGas": "450000",
9
    "from": "0xffffffffffffffffffffffffffffffffffffffff",
10
    "gasPrice": "88000000000",
11
    "protocolFee": "12320000000000000",
12
    "minimumProtocolFee": "6160000000000000",
13
    "buyTokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
14
    "sellTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
15
    "buyAmount": "376786825900000000000",
16
    "sellAmount": "1000000000000000000",
17
    "estimatedGasTokenRefund": "0",
18
    "sources": [
19
        {
20
            "name": "0x",
21
            "proportion": "1"
22
        },
23
        {
24
            "name": "Uniswap",
25
            "proportion": "0"
26
        },
27
        {
28
            "name": "Uniswap_V2",
29
            "proportion": "0"
30
        },
31
        {
32
            "name": "Eth2Dai",
33
            "proportion": "0"
34
        },
35
        {
36
            "name": "Kyber",
37
            "proportion": "0"
38
        },
39
        {
40
            "name": "Curve",
41
            "proportion": "0"
42
        },
43
        {
44
            "name": "LiquidityProvider",
45
            "proportion": "0"
46
        },
47
        {
48
            "name": "Balancer",
49
            "proportion": "0"
50
        }
51
    ],
52
    "allowanceTarget": "0xdef1c0ded9bec7f1a1670819833240f027b25eff"
53
}
Copied!
Copy link
Contents
Request
Response
Examples
Simple DAI Buy with WETH
Excluding liquidity sources
Supplying a Taker Address
Wrapping and unwrapping between ETH and WETH
Ensure RFQ-T liquidity