Get Started with Gasless API

About Gasless API

Gasless API allows developers to create the smoothest trading experience in DeFi by abstracting away the complexities related to approvals, allowances, and swaps for their users.

Enabling Gasless API in your app allows you to:

build more intuitive user interfaces and user flows in your applications
improve your conversion funnel drop-offs due to insufficient gas, and
set yourself up to easily onboard the next wave of users into Web3.

Make sure to read Understanding Gasless API for an in-depth understanding of how it works, key terms, and technical flow charts for how to implement in-app.

Try It Out

Example Code

Follow along locally with the example code: https://github.com/0xProject/0x-examples/tree/main/gasless-v2-headless-example

Playground

Try this code example directly in your browser—no installation needed!

Gasless Swaps in 4 Steps

Get a 0x API key
Get an indicative price using /gasless/price
Get a firm quote using /gasless/quote
Submit the transaction using /gasless/submit

a. Sign the gasless approval object (if applicable)

b. Sign the trade object

c. Split the signatures

d. Package signed objects into a format that can be POST to /submit

e. Compute trade hash
Check the trade status using /gasless/status/{tradeHash}

Checkout the Gasless API Runnable Headless Example to see these steps in action

0. Before You Begin

Get a 0x API Key

Every call to a 0x API must include a 0x API key. Get one from the 0x Dashboard.

Enable Gasless API from your dashboard

You will be able to enable Gasless API in your app from “App Settings” in your 0x dashboard. You can enable it for any active apps you have (see screenshot).

CreateAppScreen

1. Fetch Price

Use /gasless/price to get the indicative price. This is used when the user is just browsing for the price they could receive on the specified asset pair, but they are not ready to submit the quote yet.

This endpoint responds with pricing information, but the response does not contain a full 0x order, so it does not constitute a full transaction that can be submitted to the Ethereum network (you must use /gasless/quote for this). Think of /price as the the “read-only” version of /quote.

Example Request

Here is an example indicative price request to sell 100 USDC for WETH using /price on Base (8453):

https://api.0x.org/gasless/price                      // Request an indicative price
?sellToken=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 // Sell USDC
&sellAmount=100000000                                 // Sell amount 100 USDC (6 decimals)
&buyToken=0x4200000000000000000000000000000000000006  // Buy WETH
&takerAddress=$USER_TAKER_ADDRESS                     // Address that will make the trade
--header '0x-api-key: [API_KEY]'                      // Replace with your own API key
--header '0x-version: v2'                             // API version

Sample cURL Request

$ curl --request GET \
>   --url 'https://api.0x.org/gasless/price?chainId=8453&sellToken=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913&buyToken=0x4200000000000000000000000000000000000006&sellAmount=100000&taker=<TAKER_ADDRESS>' \
>   --header '0x-api-key: <API_KEY>'
$   --header '0x-version: v2'

Example Response

You will see a response like this

1 {
2   "blockNumber": "17225085",
3   "buyAmount": "24516376467802",
4   "buyToken": "0x4200000000000000000000000000000000000006",
5   "fees": {
6     "integratorFee": null,
7     "zeroExFee": {
8       "amount": "150",
9       "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
10       "type": "volume"
11     },
12     "gasFee": {
13       "amount": "16279",
14       "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
15       "type": "gas"
16     }
17   },
18   "issues": {
19     "allowance": {
20       "actual": "0",
21       "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3"
22     },
23     "balance": null,
24     "simulationIncomplete": false,
25     "invalidSourcesPassed": []
26   },
27   "liquidityAvailable": true,
28   "minBuyAmount": "24442827338399",
29   "route": {
30     "fills": [
31       {
32         "from": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
33         "to": "0x4200000000000000000000000000000000000006",
34         "source": "PancakeSwap_V2",
35         "proportionBps": "10000"
36       }
37     ],
38     "tokens": [
39       {
40         "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
41         "symbol": "USDC"
42       },
43       {
44         "address": "0x4200000000000000000000000000000000000006",
45         "symbol": "WETH"
46       }
47     ]
48   },
49   "sellAmount": "99850",
50   "sellToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
51   "target": "0xca11bde05977b3631167028862be2a173976ca11",
52   "zid": "0x0428a9c5f42998e4e00237fe"
53 }

2. Fetch Quote

When the user has found a price they are happy with and are ready to fill a quote, they should request a firm quote from Gasless API using the /gasless/quote endpoint.

Quotes expire in ~ 30s in order to ensure freshness. Make sure to take this into account when building your app with a timer and/or automatic refresh.

Example Request

Here is an example to fetch a firm quote to sell 100 USDC (supports Permit) for WETH (does not support Permit) using /quote on Polygon (137):

https://api.0x.org/gasless/quote                       // Request a fiirm quote
?sellToken=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913  // Sell USDC
&sellAmount=100000000                                  // Sell amount 100 USDC (6 decimals)
&buyToken=0x4200000000000000000000000000000000000006   // Buy WETH
&takerAddress=$USER_TAKER_ADDRESS                      // Address that will make the trade
--header '0x-api-key: [API_KEY]'                       // Replace with your own API key
--header '0x-version: v2'                              // API version

Sample Request

$ curl --request GET
$ https://api.0x.org/gasless/quote?chainId=137&buyToken=0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270&sellToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&sellAmount=10000000&taker=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&swapFeeBps=10&swapFeeRecipient=0xa8aac589a67ecfade31efde49a062cc21d68a64e&swapFeeToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&tradeSurplusRecipient=0xa8aac589a67ecfade31efde49a062cc21d68a64e
$ --header '0x-api-key: YOUR_API_KEY'
$ --header '0x-version: v2'

Example Response

You will see a response like this

1 {
2   "approval": {
3     "type": "permit",
4     "hash": "0xbf16458c9666dea26c2c810a64a5e9525d3fe79790038cd86a50608ae2dcd764",
5     "eip712": {
6       "types": {
7         "EIP712Domain": [
8           {
9             "name": "name",
10             "type": "string"
11           },
12           {
13             "name": "version",
14             "type": "string"
15           },
16           {
17             "name": "verifyingContract",
18             "type": "address"
19           },
20           {
21             "name": "salt",
22             "type": "bytes32"
23           }
24         ],
25         "Permit": [
26           {
27             "name": "owner",
28             "type": "address"
29           },
30           {
31             "name": "spender",
32             "type": "address"
33           },
34           {
35             "name": "value",
36             "type": "uint256"
37           },
38           {
39             "name": "nonce",
40             "type": "uint256"
41           },
42           {
43             "name": "deadline",
44             "type": "uint256"
45           }
46         ]
47       },
48       "domain": {
49         "name": "USD Coin (PoS)",
50         "version": "1",
51         "verifyingContract": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
52         "salt": "0x0000000000000000000000000000000000000000000000000000000000000089"
53       },
54       "message": {
55         "owner": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
56         "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3",
57         "value": "115792089237316195423570985008687907853269984665640564039457584007913129639935",
58         "nonce": 0,
59         "deadline": "1720478400"
60       },
61       "primaryType": "Permit"
62     }
63   },
64   "blockNumber": "59125336",
65   "buyAmount": "19821286934697663036",
66   "buyToken": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
67   "fees": {
68     "integratorFee": {
69       "amount": "10000",
70       "token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
71       "type": "volume"
72     },
73     "zeroExFee": {
74       "amount": "15000",
75       "token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
76       "type": "volume"
77     },
78     "gasFee": {
79       "amount": "11585",
80       "token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
81       "type": "gas"
82     }
83   },
84   "issues": {
85     "allowance": {
86       "actual": "0",
87       "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3"
88     },
89     "balance": null,
90     "simulationIncomplete": false,
91     "invalidSourcesPassed": []
92   },
93   "liquidityAvailable": true,
94   "minBuyAmount": "19761823073893570047",
95   "route": {
96     "fills": [
97       {
98         "from": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
99         "to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
100         "source": "Dfyn",
101         "proportionBps": "250"
102       },
103       {
104         "from": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
105         "to": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
106         "source": "Uniswap_V3",
107         "proportionBps": "9750"
108       },
109       {
110         "from": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
111         "to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
112         "source": "WOOFi_V2",
113         "proportionBps": "9306"
114       },
115       {
116         "from": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
117         "to": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
118         "source": "Uniswap_V3",
119         "proportionBps": "444"
120       },
121       {
122         "from": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
123         "to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
124         "source": "Uniswap_V3",
125         "proportionBps": "444"
126       }
127     ],
128     "tokens": [
129       {
130         "address": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
131         "symbol": "USDC"
132       },
133       {
134         "address": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
135         "symbol": "USDC"
136       },
137       {
138         "address": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
139         "symbol": "WETH"
140       },
141       {
142         "address": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
143         "symbol": "WMATIC"
144       }
145     ]
146   },
147   "sellAmount": "9975000",
148   "sellToken": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
149   "target": "0xca11bde05977b3631167028862be2a173976ca11",
150   "trade": {
151     "type": "settler_metatransaction",
152     "hash": "0x102c2f33fb20988e171393bc5d7a497705a69b57e6d3116337b0b254adf481a7",
153     "eip712": {
154       "types": {
155         "PermitWitnessTransferFrom": [
156           {
157             "name": "permitted",
158             "type": "TokenPermissions"
159           },
160           {
161             "name": "spender",
162             "type": "address"
163           },
164           {
165             "name": "nonce",
166             "type": "uint256"
167           },
168           {
169             "name": "deadline",
170             "type": "uint256"
171           },
172           {
173             "name": "slippageAndActions",
174             "type": "SlippageAndActions"
175           }
176         ],
177         "TokenPermissions": [
178           {
179             "name": "token",
180             "type": "address"
181           },
182           {
183             "name": "amount",
184             "type": "uint256"
185           }
186         ],
187         "SlippageAndActions": [
188           {
189             "name": "recipient",
190             "type": "address"
191           },
192           {
193             "name": "buyToken",
194             "type": "address"
195           },
196           {
197             "name": "minAmountOut",
198             "type": "uint256"
199           },
200           {
201             "name": "actions",
202             "type": "bytes[]"
203           }
204         ],
205         "EIP712Domain": [
206           {
207             "name": "name",
208             "type": "string"
209           },
210           {
211             "name": "chainId",
212             "type": "uint256"
213           },
214           {
215             "name": "verifyingContract",
216             "type": "address"
217           }
218         ]
219       },
220       "domain": {
221         "name": "Permit2",
222         "chainId": 137,
223         "verifyingContract": "0x000000000022d473030f116ddee9f6b43ac78ba3"
224       },
225       "message": {
226         "permitted": {
227           "token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
228           "amount": "10000000"
229         },
230         "spender": "0xf9332450385291b6dce301917af6905e28e8f35f",
231         "nonce": "2241959297937691820908574931991585",
232         "deadline": "1720478100",
233         "slippageAndActions": {
234           "recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
235           "buyToken": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
236           "minAmountOut": "19761823073893570047",
237           "actions": [
238             "0x0dfeb419000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa8417400000000000000000000000000000000000000000000000000000000009896800000000000000000000000000000000000006e898131631616b1779bad70bc2100000000000000000000000000000000000000000000000000000000668c6994",
239             "0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000b0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000009f6601854dee374b1bfaf6350ffd27a97309d431000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
240             "0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb000000000000000000000000a8aac589a67ecfade31efde49a062cc21d68a64e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
241             "0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000009f6601854dee374b1bfaf6350ffd27a97309d431000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
242             "0x103b48be000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa8417400000000000000000000000000000000000000000000000000000000000000fa000000000000000000000000d776c65b2a7a5832b4172742bf8c40cc062c678e0000000000000000000000000000000000000000000000000000000000001e000000000000000000000000000000000000000000000000000000000000000000",
243             "0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c2791bca1f2de4661ed88a30c99a7a9449aa84174000000643c499c542cef5e3811e1192ce70d8cc03d5c33590000000000000000000000000000000000000000",
244             "0x38c9c1470000000000000000000000003c499c542cef5e3811e1192ce70d8cc03d5c335900000000000000000000000000000000000000000000000000000000000025490000000000000000000000004c4af8dbc524681930a27b2f1af5bcc8062e6fb7000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000c47dc203820000000000000000000000003c499c542cef5e3811e1192ce70d8cc03d5c33590000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf127000000000000000000000000000000000000000000000000000000000008da4f70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000005e01d320e95133d80dd59a2191c95728fa69036d00000000000000000000000000000000000000000000000000000000",
245             "0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c3c499c542cef5e3811e1192ce70d8cc03d5c3359000000647ceb23fd6bc0add59e62ac25578270cff1b9f6190000000000000000000000000000000000000000",
246             "0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c7ceb23fd6bc0add59e62ac25578270cff1b9f619000001f40d500b1d8e8ef31e21c99d1db9a6444d3adf12700000000000000000000000000000000000000000",
247             "0xc876d21d000000000000000000000000a8aac589a67ecfade31efde49a062cc21d68a64e0000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf1270000000000000000000000000000000000000000000000001136817746ac32f00"
248           ]
249         }
250       },
251       "primaryType": "PermitWitnessTransferFrom"
252     }
253   }
254 }

Response Details

If liquidity is available, 2 objects may be returned:

approval: This is the “approval” object which contains the necessary information to process a gasless approval. See the quote response for an example.
- If a gasless approval is possible, this object includes all the required information to process it.
- If a gasless approval is not possible, this object will be null, and you must use the standard approval flow to set a token allowance. NEVER SET AN ALLOWANCE ON THE SETTLER CONTRACT.
- You can also see all the token addresses that support gasless approvals with the /gasless-approval-tokens endpoint.
trade: This is the “trade” object which contains the necessary information to process a gasless trade. See the quote response here.

3. Submit Transaction

When user accepts the quote and wants to submit the trade, use /gasless/submit to send both signatures back along with the payload from /gasless/quote.

In order to submit the trade, we must complete the following:

Example Request

$ curl -X POST '<https://api.0x.org/gasless/submit>' --header '0x-api-key: <API_KEY>' --header '0x-version: v2' --data '{
>  "trade": {
>    "type": "settler_metatransaction", // this is trade.type from the /quote endpoint
>    "eip712": { /* this is trade.eip712 from the /quote endpoint */ },
>    "signature": {
>      "v": 28,
>      "r": "0xeaad7568c0d17ad9e1043a4dd41ce294ed51792a0fb8bed3a3318f7e1df3ff88",
>      "s": "0x09444d25869d91946d7c26f9e5448c7fea369ba9c90deac1d761261565c487d2",
>      "signatureType": 2
>     }
>   },
>  "approval":{
>      "type": "permit", // this is approval.type from the /quote endpoint
>      "eip712": {/* this is approval.eip712 from the /quote endpoint */},
>      "signature": {
>        "v": 27,
>        "r": "0xa1be4e6177d95f7e634d7cf8f93021b96e5e4f3d4d8605e85204b97d4a4060eb",
>        "s": "0x371e85adcfa9a5d0f53cc9f467a4230305899e4a18c0174466b8da784a4f9c81",
>        "signatureType": 2
>     }
>   }
> }'

Example Response

1 {
2   "tradeHash": "0xcb3285b35c024fca76037bea9ea4cb68645fed3bdd84030956577de2f1592aa9",
3   "type": "settler_metatransaction",
4   "zid": "0x111111111111111111111111"
5 }

4. Check Trade Status

Once the user has signed, split, and submitted both signatures - gasless approval (if applicable) and gasless trade - and a tradeHash is returned from /submit, you can poll /gasless/status/{tradeHash} to check the status of the trade.

Example Request

$ curl '<https://api.0x.org/gasless/status/0x955f2009cc0fafa4f37de4ff5220a3d9028b4cf47f66bbeb09a916cc09fefbc7>' \\
> --header '0x-api-key: <API_KEY>' --header '0x-version: v2'

Example Response

1 // succeeded means it has been included in a block
2 checks:  {
3   status: "succeeded",
4   transactions: [
5     {
6       hash: "0xc619aae86b1fbbb7418ab09cd849a21e4f0c07a316f87ec991ee6639fec67f5b",
7       timestamp: 1721085056563,
8     }
9   ],
10   zid: "0xd480bf2cca5769626b4549c7",
11 }
12 
13 // confirmed means it has at least 3 confirmations onchain
14 checks:  {
15   status: "confirmed",
16   transactions: [
17     {
18       hash: "0xc619aae86b1fbbb7418ab09cd849a21e4f0c07a316f87ec991ee6639fec67f5b",
19       timestamp: 1721085056563,
20     }
21   ],
22   zid: "0x67e11e02ba701a762e58ebe4",
23 }

If you receive an error response, see the /status response in the Gasless API reference

Once the trade is successful, you can display the transaction confirmation to your user.

Gasless Approval Tokens

Use /gasless/gasless-approval-tokens to get token addresses that support gasless approvals on each chain.

Gasless Chains

Use /gasless/chains to get a list of supported chains for gasless.

About Gasless API

Gasless API allows developers to create the smoothest trading experience in DeFi by abstracting away the complexities related to approvals, allowances, and swaps for their users.

Enabling Gasless API in your app allows you to:

build more intuitive user interfaces and user flows in your applications
improve your conversion funnel drop-offs due to insufficient gas, and
set yourself up to easily onboard the next wave of users into Web3.

Make sure to read Understanding Gasless API for an in-depth understanding of how it works, key terms, and technical flow charts for how to implement in-app.

Try It Out

Example Code

Follow along locally with the example code: https://github.com/0xProject/0x-examples/tree/main/gasless-v2-headless-example

Playground

Try this code example directly in your browser—no installation needed!

Gasless Swaps in 4 Steps

Get a 0x API key
Get an indicative price using /gasless/price
Get a firm quote using /gasless/quote
Submit the transaction using /gasless/submit

a. Sign the gasless approval object (if applicable)

b. Sign the trade object

c. Split the signatures

d. Package signed objects into a format that can be POST to /submit

e. Compute trade hash
Check the trade status using /gasless/status/{tradeHash}

Checkout the Gasless API Runnable Headless Example to see these steps in action

0. Before You Begin

Get a 0x API Key

Every call to a 0x API must include a 0x API key. Get one from the 0x Dashboard.

Enable Gasless API from your dashboard

You will be able to enable Gasless API in your app from “App Settings” in your 0x dashboard. You can enable it for any active apps you have (see screenshot).

CreateAppScreen

1. Fetch Price

Example Request

Here is an example indicative price request to sell 100 USDC for WETH using /price on Base (8453):

https://api.0x.org/gasless/price                      // Request an indicative price
?sellToken=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 // Sell USDC
&sellAmount=100000000                                 // Sell amount 100 USDC (6 decimals)
&buyToken=0x4200000000000000000000000000000000000006  // Buy WETH
&takerAddress=$USER_TAKER_ADDRESS                     // Address that will make the trade
--header '0x-api-key: [API_KEY]'                      // Replace with your own API key
--header '0x-version: v2'                             // API version

Sample cURL Request

$ curl --request GET \
>   --url 'https://api.0x.org/gasless/price?chainId=8453&sellToken=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913&buyToken=0x4200000000000000000000000000000000000006&sellAmount=100000&taker=<TAKER_ADDRESS>' \
>   --header '0x-api-key: <API_KEY>'
$   --header '0x-version: v2'

Example Response

You will see a response like this

1 {
2   "blockNumber": "17225085",
3   "buyAmount": "24516376467802",
4   "buyToken": "0x4200000000000000000000000000000000000006",
5   "fees": {
6     "integratorFee": null,
7     "zeroExFee": {
8       "amount": "150",
9       "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
10       "type": "volume"
11     },
12     "gasFee": {
13       "amount": "16279",
14       "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
15       "type": "gas"
16     }
17   },
18   "issues": {
19     "allowance": {
20       "actual": "0",
21       "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3"
22     },
23     "balance": null,
24     "simulationIncomplete": false,
25     "invalidSourcesPassed": []
26   },
27   "liquidityAvailable": true,
28   "minBuyAmount": "24442827338399",
29   "route": {
30     "fills": [
31       {
32         "from": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
33         "to": "0x4200000000000000000000000000000000000006",
34         "source": "PancakeSwap_V2",
35         "proportionBps": "10000"
36       }
37     ],
38     "tokens": [
39       {
40         "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
41         "symbol": "USDC"
42       },
43       {
44         "address": "0x4200000000000000000000000000000000000006",
45         "symbol": "WETH"
46       }
47     ]
48   },
49   "sellAmount": "99850",
50   "sellToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
51   "target": "0xca11bde05977b3631167028862be2a173976ca11",
52   "zid": "0x0428a9c5f42998e4e00237fe"
53 }

2. Fetch Quote

When the user has found a price they are happy with and are ready to fill a quote, they should request a firm quote from Gasless API using the /gasless/quote endpoint.

Quotes expire in ~ 30s in order to ensure freshness. Make sure to take this into account when building your app with a timer and/or automatic refresh.

Example Request

Here is an example to fetch a firm quote to sell 100 USDC (supports Permit) for WETH (does not support Permit) using /quote on Polygon (137):

https://api.0x.org/gasless/quote                       // Request a fiirm quote
?sellToken=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913  // Sell USDC
&sellAmount=100000000                                  // Sell amount 100 USDC (6 decimals)
&buyToken=0x4200000000000000000000000000000000000006   // Buy WETH
&takerAddress=$USER_TAKER_ADDRESS                      // Address that will make the trade
--header '0x-api-key: [API_KEY]'                       // Replace with your own API key
--header '0x-version: v2'                              // API version

Sample Request

$ curl --request GET
$ https://api.0x.org/gasless/quote?chainId=137&buyToken=0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270&sellToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&sellAmount=10000000&taker=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&swapFeeBps=10&swapFeeRecipient=0xa8aac589a67ecfade31efde49a062cc21d68a64e&swapFeeToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&tradeSurplusRecipient=0xa8aac589a67ecfade31efde49a062cc21d68a64e
$ --header '0x-api-key: YOUR_API_KEY'
$ --header '0x-version: v2'

Example Response

You will see a response like this

1 {
2   "approval": {
3     "type": "permit",
4     "hash": "0xbf16458c9666dea26c2c810a64a5e9525d3fe79790038cd86a50608ae2dcd764",
5     "eip712": {
6       "types": {
7         "EIP712Domain": [
8           {
9             "name": "name",
10             "type": "string"
11           },
12           {
13             "name": "version",
14             "type": "string"
15           },
16           {
17             "name": "verifyingContract",
18             "type": "address"
19           },
20           {
21             "name": "salt",
22             "type": "bytes32"
23           }
24         ],
25         "Permit": [
26           {
27             "name": "owner",
28             "type": "address"
29           },
30           {
31             "name": "spender",
32             "type": "address"
33           },
34           {
35             "name": "value",
36             "type": "uint256"
37           },
38           {
39             "name": "nonce",
40             "type": "uint256"
41           },
42           {
43             "name": "deadline",
44             "type": "uint256"
45           }
46         ]
47       },
48       "domain": {
49         "name": "USD Coin (PoS)",
50         "version": "1",
51         "verifyingContract": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
52         "salt": "0x0000000000000000000000000000000000000000000000000000000000000089"
53       },
54       "message": {
55         "owner": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
56         "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3",
57         "value": "115792089237316195423570985008687907853269984665640564039457584007913129639935",
58         "nonce": 0,
59         "deadline": "1720478400"
60       },
61       "primaryType": "Permit"
62     }
63   },
64   "blockNumber": "59125336",
65   "buyAmount": "19821286934697663036",
66   "buyToken": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
67   "fees": {
68     "integratorFee": {
69       "amount": "10000",
70       "token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
71       "type": "volume"
72     },
73     "zeroExFee": {
74       "amount": "15000",
75       "token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
76       "type": "volume"
77     },
78     "gasFee": {
79       "amount": "11585",
80       "token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
81       "type": "gas"
82     }
83   },
84   "issues": {
85     "allowance": {
86       "actual": "0",
87       "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3"
88     },
89     "balance": null,
90     "simulationIncomplete": false,
91     "invalidSourcesPassed": []
92   },
93   "liquidityAvailable": true,
94   "minBuyAmount": "19761823073893570047",
95   "route": {
96     "fills": [
97       {
98         "from": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
99         "to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
100         "source": "Dfyn",
101         "proportionBps": "250"
102       },
103       {
104         "from": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
105         "to": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
106         "source": "Uniswap_V3",
107         "proportionBps": "9750"
108       },
109       {
110         "from": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
111         "to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
112         "source": "WOOFi_V2",
113         "proportionBps": "9306"
114       },
115       {
116         "from": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
117         "to": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
118         "source": "Uniswap_V3",
119         "proportionBps": "444"
120       },
121       {
122         "from": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
123         "to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
124         "source": "Uniswap_V3",
125         "proportionBps": "444"
126       }
127     ],
128     "tokens": [
129       {
130         "address": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
131         "symbol": "USDC"
132       },
133       {
134         "address": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
135         "symbol": "USDC"
136       },
137       {
138         "address": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
139         "symbol": "WETH"
140       },
141       {
142         "address": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
143         "symbol": "WMATIC"
144       }
145     ]
146   },
147   "sellAmount": "9975000",
148   "sellToken": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
149   "target": "0xca11bde05977b3631167028862be2a173976ca11",
150   "trade": {
151     "type": "settler_metatransaction",
152     "hash": "0x102c2f33fb20988e171393bc5d7a497705a69b57e6d3116337b0b254adf481a7",
153     "eip712": {
154       "types": {
155         "PermitWitnessTransferFrom": [
156           {
157             "name": "permitted",
158             "type": "TokenPermissions"
159           },
160           {
161             "name": "spender",
162             "type": "address"
163           },
164           {
165             "name": "nonce",
166             "type": "uint256"
167           },
168           {
169             "name": "deadline",
170             "type": "uint256"
171           },
172           {
173             "name": "slippageAndActions",
174             "type": "SlippageAndActions"
175           }
176         ],
177         "TokenPermissions": [
178           {
179             "name": "token",
180             "type": "address"
181           },
182           {
183             "name": "amount",
184             "type": "uint256"
185           }
186         ],
187         "SlippageAndActions": [
188           {
189             "name": "recipient",
190             "type": "address"
191           },
192           {
193             "name": "buyToken",
194             "type": "address"
195           },
196           {
197             "name": "minAmountOut",
198             "type": "uint256"
199           },
200           {
201             "name": "actions",
202             "type": "bytes[]"
203           }
204         ],
205         "EIP712Domain": [
206           {
207             "name": "name",
208             "type": "string"
209           },
210           {
211             "name": "chainId",
212             "type": "uint256"
213           },
214           {
215             "name": "verifyingContract",
216             "type": "address"
217           }
218         ]
219       },
220       "domain": {
221         "name": "Permit2",
222         "chainId": 137,
223         "verifyingContract": "0x000000000022d473030f116ddee9f6b43ac78ba3"
224       },
225       "message": {
226         "permitted": {
227           "token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
228           "amount": "10000000"
229         },
230         "spender": "0xf9332450385291b6dce301917af6905e28e8f35f",
231         "nonce": "2241959297937691820908574931991585",
232         "deadline": "1720478100",
233         "slippageAndActions": {
234           "recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
235           "buyToken": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
236           "minAmountOut": "19761823073893570047",
237           "actions": [
238             "0x0dfeb419000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa8417400000000000000000000000000000000000000000000000000000000009896800000000000000000000000000000000000006e898131631616b1779bad70bc2100000000000000000000000000000000000000000000000000000000668c6994",
239             "0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000b0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000009f6601854dee374b1bfaf6350ffd27a97309d431000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
240             "0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb000000000000000000000000a8aac589a67ecfade31efde49a062cc21d68a64e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
241             "0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000009f6601854dee374b1bfaf6350ffd27a97309d431000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
242             "0x103b48be000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa8417400000000000000000000000000000000000000000000000000000000000000fa000000000000000000000000d776c65b2a7a5832b4172742bf8c40cc062c678e0000000000000000000000000000000000000000000000000000000000001e000000000000000000000000000000000000000000000000000000000000000000",
243             "0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c2791bca1f2de4661ed88a30c99a7a9449aa84174000000643c499c542cef5e3811e1192ce70d8cc03d5c33590000000000000000000000000000000000000000",
244             "0x38c9c1470000000000000000000000003c499c542cef5e3811e1192ce70d8cc03d5c335900000000000000000000000000000000000000000000000000000000000025490000000000000000000000004c4af8dbc524681930a27b2f1af5bcc8062e6fb7000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000c47dc203820000000000000000000000003c499c542cef5e3811e1192ce70d8cc03d5c33590000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf127000000000000000000000000000000000000000000000000000000000008da4f70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000005e01d320e95133d80dd59a2191c95728fa69036d00000000000000000000000000000000000000000000000000000000",
245             "0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c3c499c542cef5e3811e1192ce70d8cc03d5c3359000000647ceb23fd6bc0add59e62ac25578270cff1b9f6190000000000000000000000000000000000000000",
246             "0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c7ceb23fd6bc0add59e62ac25578270cff1b9f619000001f40d500b1d8e8ef31e21c99d1db9a6444d3adf12700000000000000000000000000000000000000000",
247             "0xc876d21d000000000000000000000000a8aac589a67ecfade31efde49a062cc21d68a64e0000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf1270000000000000000000000000000000000000000000000001136817746ac32f00"
248           ]
249         }
250       },
251       "primaryType": "PermitWitnessTransferFrom"
252     }
253   }
254 }

Response Details

If liquidity is available, 2 objects may be returned:

approval: This is the “approval” object which contains the necessary information to process a gasless approval. See the quote response for an example.
- If a gasless approval is possible, this object includes all the required information to process it.
- If a gasless approval is not possible, this object will be null, and you must use the standard approval flow to set a token allowance. NEVER SET AN ALLOWANCE ON THE SETTLER CONTRACT.
- You can also see all the token addresses that support gasless approvals with the /gasless-approval-tokens endpoint.
trade: This is the “trade” object which contains the necessary information to process a gasless trade. See the quote response here.

3. Submit Transaction

When user accepts the quote and wants to submit the trade, use /gasless/submit to send both signatures back along with the payload from /gasless/quote.

In order to submit the trade, we must complete the following:

Example Request

$ curl -X POST '<https://api.0x.org/gasless/submit>' --header '0x-api-key: <API_KEY>' --header '0x-version: v2' --data '{
>  "trade": {
>    "type": "settler_metatransaction", // this is trade.type from the /quote endpoint
>    "eip712": { /* this is trade.eip712 from the /quote endpoint */ },
>    "signature": {
>      "v": 28,
>      "r": "0xeaad7568c0d17ad9e1043a4dd41ce294ed51792a0fb8bed3a3318f7e1df3ff88",
>      "s": "0x09444d25869d91946d7c26f9e5448c7fea369ba9c90deac1d761261565c487d2",
>      "signatureType": 2
>     }
>   },
>  "approval":{
>      "type": "permit", // this is approval.type from the /quote endpoint
>      "eip712": {/* this is approval.eip712 from the /quote endpoint */},
>      "signature": {
>        "v": 27,
>        "r": "0xa1be4e6177d95f7e634d7cf8f93021b96e5e4f3d4d8605e85204b97d4a4060eb",
>        "s": "0x371e85adcfa9a5d0f53cc9f467a4230305899e4a18c0174466b8da784a4f9c81",
>        "signatureType": 2
>     }
>   }
> }'

Example Response

1 {
2   "tradeHash": "0xcb3285b35c024fca76037bea9ea4cb68645fed3bdd84030956577de2f1592aa9",
3   "type": "settler_metatransaction",
4   "zid": "0x111111111111111111111111"
5 }

4. Check Trade Status

Example Request

$ curl '<https://api.0x.org/gasless/status/0x955f2009cc0fafa4f37de4ff5220a3d9028b4cf47f66bbeb09a916cc09fefbc7>' \\
> --header '0x-api-key: <API_KEY>' --header '0x-version: v2'

Example Response

1 // succeeded means it has been included in a block
2 checks:  {
3   status: "succeeded",
4   transactions: [
5     {
6       hash: "0xc619aae86b1fbbb7418ab09cd849a21e4f0c07a316f87ec991ee6639fec67f5b",
7       timestamp: 1721085056563,
8     }
9   ],
10   zid: "0xd480bf2cca5769626b4549c7",
11 }
12 
13 // confirmed means it has at least 3 confirmations onchain
14 checks:  {
15   status: "confirmed",
16   transactions: [
17     {
18       hash: "0xc619aae86b1fbbb7418ab09cd849a21e4f0c07a316f87ec991ee6639fec67f5b",
19       timestamp: 1721085056563,
20     }
21   ],
22   zid: "0x67e11e02ba701a762e58ebe4",
23 }

If you receive an error response, see the /status response in the Gasless API reference

Once the trade is successful, you can display the transaction confirmation to your user.

Gasless Approval Tokens

Use /gasless/gasless-approval-tokens to get token addresses that support gasless approvals on each chain.

Gasless Chains

Use /gasless/chains to get a list of supported chains for gasless.

$	curl --request GET \
>	--url 'https://api.0x.org/gasless/price?chainId=8453&sellToken=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913&buyToken=0x4200000000000000000000000000000000000006&sellAmount=100000&taker=<TAKER_ADDRESS>' \
>	--header '0x-api-key: <API_KEY>'
$	--header '0x-version: v2'

1	{
2	"blockNumber": "17225085",
3	"buyAmount": "24516376467802",
4	"buyToken": "0x4200000000000000000000000000000000000006",
5	"fees": {
6	"integratorFee": null,
7	"zeroExFee": {
8	"amount": "150",
9	"token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
10	"type": "volume"
11	},
12	"gasFee": {
13	"amount": "16279",
14	"token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
15	"type": "gas"
16	}
17	},
18	"issues": {
19	"allowance": {
20	"actual": "0",
21	"spender": "0x000000000022d473030f116ddee9f6b43ac78ba3"
22	},
23	"balance": null,
24	"simulationIncomplete": false,
25	"invalidSourcesPassed": []
26	},
27	"liquidityAvailable": true,
28	"minBuyAmount": "24442827338399",
29	"route": {
30	"fills": [
31	{
32	"from": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
33	"to": "0x4200000000000000000000000000000000000006",
34	"source": "PancakeSwap_V2",
35	"proportionBps": "10000"
36	}
37	],
38	"tokens": [
39	{
40	"address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
41	"symbol": "USDC"
42	},
43	{
44	"address": "0x4200000000000000000000000000000000000006",
45	"symbol": "WETH"
46	}
47	]
48	},
49	"sellAmount": "99850",
50	"sellToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
51	"target": "0xca11bde05977b3631167028862be2a173976ca11",
52	"zid": "0x0428a9c5f42998e4e00237fe"
53	}

$	curl --request GET
$	https://api.0x.org/gasless/quote?chainId=137&buyToken=0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270&sellToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&sellAmount=10000000&taker=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&swapFeeBps=10&swapFeeRecipient=0xa8aac589a67ecfade31efde49a062cc21d68a64e&swapFeeToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&tradeSurplusRecipient=0xa8aac589a67ecfade31efde49a062cc21d68a64e
$	--header '0x-api-key: YOUR_API_KEY'
$	--header '0x-version: v2'

1	{
2	"approval": {
3	"type": "permit",
4	"hash": "0xbf16458c9666dea26c2c810a64a5e9525d3fe79790038cd86a50608ae2dcd764",
5	"eip712": {
6	"types": {
7	"EIP712Domain": [
8	{
9	"name": "name",
10	"type": "string"
11	},
12	{
13	"name": "version",
14	"type": "string"
15	},
16	{
17	"name": "verifyingContract",
18	"type": "address"
19	},
20	{
21	"name": "salt",
22	"type": "bytes32"
23	}
24	],
25	"Permit": [
26	{
27	"name": "owner",
28	"type": "address"
29	},
30	{
31	"name": "spender",
32	"type": "address"
33	},
34	{
35	"name": "value",
36	"type": "uint256"
37	},
38	{
39	"name": "nonce",
40	"type": "uint256"
41	},
42	{
43	"name": "deadline",
44	"type": "uint256"
45	}
46	]
47	},
48	"domain": {
49	"name": "USD Coin (PoS)",
50	"version": "1",
51	"verifyingContract": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
52	"salt": "0x0000000000000000000000000000000000000000000000000000000000000089"
53	},
54	"message": {
55	"owner": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
56	"spender": "0x000000000022d473030f116ddee9f6b43ac78ba3",
57	"value": "115792089237316195423570985008687907853269984665640564039457584007913129639935",
58	"nonce": 0,
59	"deadline": "1720478400"
60	},
61	"primaryType": "Permit"
62	}
63	},
64	"blockNumber": "59125336",
65	"buyAmount": "19821286934697663036",
66	"buyToken": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
67	"fees": {
68	"integratorFee": {
69	"amount": "10000",
70	"token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
71	"type": "volume"
72	},
73	"zeroExFee": {
74	"amount": "15000",
75	"token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
76	"type": "volume"
77	},
78	"gasFee": {
79	"amount": "11585",
80	"token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
81	"type": "gas"
82	}
83	},
84	"issues": {
85	"allowance": {
86	"actual": "0",
87	"spender": "0x000000000022d473030f116ddee9f6b43ac78ba3"
88	},
89	"balance": null,
90	"simulationIncomplete": false,
91	"invalidSourcesPassed": []
92	},
93	"liquidityAvailable": true,
94	"minBuyAmount": "19761823073893570047",
95	"route": {
96	"fills": [
97	{
98	"from": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
99	"to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
100	"source": "Dfyn",
101	"proportionBps": "250"
102	},
103	{
104	"from": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
105	"to": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
106	"source": "Uniswap_V3",
107	"proportionBps": "9750"
108	},
109	{
110	"from": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
111	"to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
112	"source": "WOOFi_V2",
113	"proportionBps": "9306"
114	},
115	{
116	"from": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
117	"to": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
118	"source": "Uniswap_V3",
119	"proportionBps": "444"
120	},
121	{
122	"from": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
123	"to": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
124	"source": "Uniswap_V3",
125	"proportionBps": "444"
126	}
127	],
128	"tokens": [
129	{
130	"address": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
131	"symbol": "USDC"
132	},
133	{
134	"address": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
135	"symbol": "USDC"
136	},
137	{
138	"address": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
139	"symbol": "WETH"
140	},
141	{
142	"address": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
143	"symbol": "WMATIC"
144	}
145	]
146	},
147	"sellAmount": "9975000",
148	"sellToken": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
149	"target": "0xca11bde05977b3631167028862be2a173976ca11",
150	"trade": {
151	"type": "settler_metatransaction",
152	"hash": "0x102c2f33fb20988e171393bc5d7a497705a69b57e6d3116337b0b254adf481a7",
153	"eip712": {
154	"types": {
155	"PermitWitnessTransferFrom": [
156	{
157	"name": "permitted",
158	"type": "TokenPermissions"
159	},
160	{
161	"name": "spender",
162	"type": "address"
163	},
164	{
165	"name": "nonce",
166	"type": "uint256"
167	},
168	{
169	"name": "deadline",
170	"type": "uint256"
171	},
172	{
173	"name": "slippageAndActions",
174	"type": "SlippageAndActions"
175	}
176	],
177	"TokenPermissions": [
178	{
179	"name": "token",
180	"type": "address"
181	},
182	{
183	"name": "amount",
184	"type": "uint256"
185	}
186	],
187	"SlippageAndActions": [
188	{
189	"name": "recipient",
190	"type": "address"
191	},
192	{
193	"name": "buyToken",
194	"type": "address"
195	},
196	{
197	"name": "minAmountOut",
198	"type": "uint256"
199	},
200	{
201	"name": "actions",
202	"type": "bytes[]"
203	}
204	],
205	"EIP712Domain": [
206	{
207	"name": "name",
208	"type": "string"
209	},
210	{
211	"name": "chainId",
212	"type": "uint256"
213	},
214	{
215	"name": "verifyingContract",
216	"type": "address"
217	}
218	]
219	},
220	"domain": {
221	"name": "Permit2",
222	"chainId": 137,
223	"verifyingContract": "0x000000000022d473030f116ddee9f6b43ac78ba3"
224	},
225	"message": {
226	"permitted": {
227	"token": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
228	"amount": "10000000"
229	},
230	"spender": "0xf9332450385291b6dce301917af6905e28e8f35f",
231	"nonce": "2241959297937691820908574931991585",
232	"deadline": "1720478100",
233	"slippageAndActions": {
234	"recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
235	"buyToken": "0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270",
236	"minAmountOut": "19761823073893570047",
237	"actions": [
238	"0x0dfeb419000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa8417400000000000000000000000000000000000000000000000000000000009896800000000000000000000000000000000000006e898131631616b1779bad70bc2100000000000000000000000000000000000000000000000000000000668c6994",
239	"0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000b0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000009f6601854dee374b1bfaf6350ffd27a97309d431000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
240	"0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb000000000000000000000000a8aac589a67ecfade31efde49a062cc21d68a64e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
241	"0x38c9c1470000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000000f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000009f6601854dee374b1bfaf6350ffd27a97309d431000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
242	"0x103b48be000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa8417400000000000000000000000000000000000000000000000000000000000000fa000000000000000000000000d776c65b2a7a5832b4172742bf8c40cc062c678e0000000000000000000000000000000000000000000000000000000000001e000000000000000000000000000000000000000000000000000000000000000000",
243	"0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c2791bca1f2de4661ed88a30c99a7a9449aa84174000000643c499c542cef5e3811e1192ce70d8cc03d5c33590000000000000000000000000000000000000000",
244	"0x38c9c1470000000000000000000000003c499c542cef5e3811e1192ce70d8cc03d5c335900000000000000000000000000000000000000000000000000000000000025490000000000000000000000004c4af8dbc524681930a27b2f1af5bcc8062e6fb7000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000c47dc203820000000000000000000000003c499c542cef5e3811e1192ce70d8cc03d5c33590000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf127000000000000000000000000000000000000000000000000000000000008da4f70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f0000000000000000000000005e01d320e95133d80dd59a2191c95728fa69036d00000000000000000000000000000000000000000000000000000000",
245	"0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c3c499c542cef5e3811e1192ce70d8cc03d5c3359000000647ceb23fd6bc0add59e62ac25578270cff1b9f6190000000000000000000000000000000000000000",
246	"0x8d68a156000000000000000000000000f9332450385291b6dce301917af6905e28e8f35f000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c7ceb23fd6bc0add59e62ac25578270cff1b9f619000001f40d500b1d8e8ef31e21c99d1db9a6444d3adf12700000000000000000000000000000000000000000",
247	"0xc876d21d000000000000000000000000a8aac589a67ecfade31efde49a062cc21d68a64e0000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf1270000000000000000000000000000000000000000000000001136817746ac32f00"
248	]
249	}
250	},
251	"primaryType": "PermitWitnessTransferFrom"
252	}
253	}
254	}

$	curl -X POST '<https://api.0x.org/gasless/submit>' --header '0x-api-key: <API_KEY>' --header '0x-version: v2' --data '{
>	"trade": {
>	"type": "settler_metatransaction", // this is trade.type from the /quote endpoint
>	"eip712": { /* this is trade.eip712 from the /quote endpoint */ },
>	"signature": {
>	"v": 28,
>	"r": "0xeaad7568c0d17ad9e1043a4dd41ce294ed51792a0fb8bed3a3318f7e1df3ff88",
>	"s": "0x09444d25869d91946d7c26f9e5448c7fea369ba9c90deac1d761261565c487d2",
>	"signatureType": 2
>	}
>	},
>	"approval":{
>	"type": "permit", // this is approval.type from the /quote endpoint
>	"eip712": {/* this is approval.eip712 from the /quote endpoint */},
>	"signature": {
>	"v": 27,
>	"r": "0xa1be4e6177d95f7e634d7cf8f93021b96e5e4f3d4d8605e85204b97d4a4060eb",
>	"s": "0x371e85adcfa9a5d0f53cc9f467a4230305899e4a18c0174466b8da784a4f9c81",
>	"signatureType": 2
>	}
>	}
>	}'

1	{
2	"tradeHash": "0xcb3285b35c024fca76037bea9ea4cb68645fed3bdd84030956577de2f1592aa9",
3	"type": "settler_metatransaction",
4	"zid": "0x111111111111111111111111"
5	}

$	curl '<https://api.0x.org/gasless/status/0x955f2009cc0fafa4f37de4ff5220a3d9028b4cf47f66bbeb09a916cc09fefbc7>' \\
>	--header '0x-api-key: <API_KEY>' --header '0x-version: v2'

1	// succeeded means it has been included in a block
2	checks: {
3	status: "succeeded",
4	transactions: [
5	{
6	hash: "0xc619aae86b1fbbb7418ab09cd849a21e4f0c07a316f87ec991ee6639fec67f5b",
7	timestamp: 1721085056563,
8	}
9	],
10	zid: "0xd480bf2cca5769626b4549c7",
11	}
12
13	// confirmed means it has at least 3 confirmations onchain
14	checks: {
15	status: "confirmed",
16	transactions: [
17	{
18	hash: "0xc619aae86b1fbbb7418ab09cd849a21e4f0c07a316f87ec991ee6639fec67f5b",
19	timestamp: 1721085056563,
20	}
21	],
22	zid: "0x67e11e02ba701a762e58ebe4",
23	}