submit

POST

https://api.0x.org/gasless/submit

POST

/gasless/submit

1 import requests
2 
3 url = "https://api.0x.org/gasless/submit"
4 
5 payload = {
6     "chainId": 8453,
7     "trade": {
8         "type": "settler_metatransaction",
9         "eip712": {
10             "types": {
11                 "PermitWitnessTransferFrom": [
12                     {
13                         "name": "permitted",
14                         "type": "TokenPermissions"
15                     },
16                     {
17                         "name": "spender",
18                         "type": "address"
19                     },
20                     {
21                         "name": "nonce",
22                         "type": "uint256"
23                     },
24                     {
25                         "name": "deadline",
26                         "type": "uint256"
27                     },
28                     {
29                         "name": "slippageAndActions",
30                         "type": "SlippageAndActions"
31                     }
32                 ],
33                 "TokenPermissions": [
34                     {
35                         "name": "token",
36                         "type": "address"
37                     },
38                     {
39                         "name": "amount",
40                         "type": "uint256"
41                     }
42                 ],
43                 "EIP712Domain": [
44                     {
45                         "name": "name",
46                         "type": "string"
47                     },
48                     {
49                         "name": "chainId",
50                         "type": "uint256"
51                     },
52                     {
53                         "name": "verifyingContract",
54                         "type": "address"
55                     }
56                 ],
57                 "SlippageAndActions": [
58                     {
59                         "name": "recipient",
60                         "type": "address"
61                     },
62                     {
63                         "name": "buyToken",
64                         "type": "address"
65                     },
66                     {
67                         "name": "minAmountOut",
68                         "type": "uint256"
69                     },
70                     {
71                         "name": "actions",
72                         "type": "bytes[]"
73                     }
74                 ]
75             },
76             "primaryType": "PermitWitnessTransferFrom",
77             "domain": {
78                 "name": "Permit2",
79                 "chainId": 8453,
80                 "verifyingContract": "0x000000000022d473030f116ddee9f6b43ac78ba3"
81             },
82             "message": {
83                 "permitted": {
84                     "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
85                     "amount": "50000000"
86                 },
87                 "spender": "0x5ce929ddb01804bff35b2f5c77b735bdb094aac8",
88                 "nonce": "2241959297937691820908574931991585",
89                 "deadline": "1718672122",
90                 "slippageAndActions": {
91                     "recipient": "0x70a9f34f9b34c64957b9c401a97bfed35b95049e",
92                     "buyToken": "0x50c5725949a6f0c72e6c4a641f24049a917db0cb",
93                     "minAmountOut": "49793430139340757517",
94                     "actions": ["0x0dfeb4190000000000000000000000005ce929ddb01804bff35b2f5c77b735bdb094aac8000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda029130000000000000000000000000000000000000000000000000000000002faf0800000000000000000000000000000000000006e898131631616b1779bad70bc21000000000000000000000000000000000000000000000000000000006670dafa", "0x38c9c147000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000000000000000000000000000000000000000271000000000000000000000000032aed3bce901da12ca8489788f3a99fce1056e1400000000000000000000000000000000000000000000000000000000000000a400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000104a5dcbcdf000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda0291300000000000000000000000050c5725949a6f0c72e6c4a641f24049a917db0cb0000000000000000000000001b55d94b553475e7561fab889bf88fe4f491d29c0000000000000000000000005ce929ddb01804bff35b2f5c77b735bdb094aac8ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000002faf0800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "0x38c9c14700000000000000000000000050c5725949a6f0c72e6c4a641f24049a917db0cb000000000000000000000000000000000000000000000000000000000000001000000000000000000000000050c5725949a6f0c72e6c4a641f24049a917db0cb000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000009f6601854dee374b1bfaf6350ffd27a97309d431000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"]
95                 }
96             }
97         },
98         "signature": {
99             "signatureType": 2,
100             "v": 28,
101             "r": "0xeaad7568c0d17ad9e1043a4dd41ce294ed51792a0fb8bed3a3318f7e1df3ff88",
102             "s": "0x09444d25869d91946d7c26f9e5448c7fea369ba9c90deac1d761261565c487d2"
103         }
104     },
105     "approval": {
106         "type": "permit",
107         "eip712": {
108             "types": {
109                 "EIP712Domain": [
110                     {
111                         "name": "name",
112                         "type": "string"
113                     },
114                     {
115                         "name": "version",
116                         "type": "string"
117                     },
118                     {
119                         "name": "chainId",
120                         "type": "uint256"
121                     },
122                     {
123                         "name": "verifyingContract",
124                         "type": "address"
125                     }
126                 ],
127                 "Permit": [
128                     {
129                         "name": "owner",
130                         "type": "address"
131                     },
132                     {
133                         "name": "spender",
134                         "type": "address"
135                     },
136                     {
137                         "name": "value",
138                         "type": "uint256"
139                     },
140                     {
141                         "name": "nonce",
142                         "type": "uint256"
143                     },
144                     {
145                         "name": "deadline",
146                         "type": "uint256"
147                     }
148                 ]
149             },
150             "domain": {
151                 "name": "USD Coin",
152                 "version": "2",
153                 "chainId": 8453,
154                 "verifyingContract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"
155             },
156             "message": {
157                 "owner": "0x70a9f34f9b34c64957b9c401a97bfed35b95049e",
158                 "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3",
159                 "value": "50000000",
160                 "nonce": 0,
161                 "deadline": "1718669123"
162             },
163             "primaryType": "Permit"
164         },
165         "signature": {
166             "signatureType": 2,
167             "v": 27,
168             "r": "0xa1be4e6177d95f7e634d7cf8f93021b96e5e4f3d4d8605e85204b97d4a4060eb",
169             "s": "0x371e85adcfa9a5d0f53cc9f467a4230305899e4a18c0174466b8da784a4f9c81"
170         }
171     }
172 }
173 headers = {
174     "0x-api-key": "0x-api-key",
175     "0x-version": "v2",
176     "Content-Type": "application/json"
177 }
178 
179 response = requests.post(url, json=payload, headers=headers)
180 
181 print(response.json())

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

Submit a gasless swap

Request

This endpoint expects an object.

chainIdintegerRequired>=0

Chain ID. See here for the list of supported chains

Chain ID. See [here](https://0x.org/docs/developer-resources/supported-chains) for the list of supported chains

tradeobjectRequired

The trade object from the quote endpoint including its signature

approvalobject or nullOptional

The gasless approval object from the quote endpoint including its signature

Response

Successful response

tradeHashstring

The hash for the trade according to EIP-712

The hash for the trade according to [EIP-712](https://eips.ethereum.org/EIPS/eip-712)

typeenum

The transaction type determined by the trade route. This is currently just settler_metatransaction and could expand to more types in the future

Allowed values:

zidstring

The unique ZeroEx identifier of the request

submit

Headers

Request

Response

Errors