For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SupportDiscordGo to dashboard
HomeDocsAPI ReferenceLiquidity IntegrationChangelog
HomeDocsAPI ReferenceLiquidity IntegrationChangelog
    • API Overview
  • EVM APIs
      • GETgetPrice (Allowance Holder)
      • GETgetQuote (Allowance Holder)
      • GETgetPrice (Permit2)
      • GETgetQuote (Permit2)
      • GETgetChains
  • Solana Swap APIs
  • Cross-Chain APIs
LogoLogo
Contact SupportDiscordGo to dashboard
EVM APIsSwap

getQuote (Permit2)

||View as Markdown|
GET
https://api.0x.org/swap/permit2/quote
GET
/swap/permit2/quote
$curl -G https://api.0x.org/swap/permit2/quote \
>     -H "0x-api-key: 0x-api-key" \
>     -H "0x-version: v2" \
>     -d chainId=1 \
>     -d buyToken=0xdac17f958d2ee523a2206206994597c13d831ec7 \
>     -d sellToken=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 \
>     -d sellAmount=100000000 \
>     -d taker=0x70a9f34f9b34c64957b9c401a97bfed35b95049e
1{
2  "allowanceTarget": "0x000000000022d473030f116ddee9f6b43ac78ba3",
3  "blockNumber": null,
4  "buyAmount": null,
5  "buyToken": "0xdac17f958d2ee523a2206206994597c13d831ec7",
6  "fees": {
7    "integratorFee": null,
8    "integratorFees": [
9      {
10        "amount": null,
11        "token": "string",
12        "type": "volume"
13      }
14    ],
15    "zeroExFee": null,
16    "gasFee": null
17  },
18  "issues": {
19    "allowance": {
20      "actual": null,
21      "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3"
22    },
23    "balance": {
24      "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
25      "actual": null,
26      "expected": null
27    },
28    "simulationIncomplete": false,
29    "invalidSourcesPassed": []
30  },
31  "liquidityAvailable": true,
32  "minBuyAmount": null,
33  "mode": "exact-in",
34  "route": {
35    "fills": [
36      {
37        "from": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
38        "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
39        "source": "SolidlyV3",
40        "proportionBps": null
41      }
42    ],
43    "tokens": [
44      {
45        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
46        "symbol": "USDC"
47      },
48      {
49        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
50        "symbol": "USDT"
51      }
52    ]
53  },
54  "sellAmount": null,
55  "sellToken": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
56  "tokenMetadata": {
57    "buyToken": {
58      "buyTaxBps": null,
59      "sellTaxBps": null,
60      "transferTaxBps": null
61    },
62    "sellToken": {
63      "buyTaxBps": null,
64      "sellTaxBps": null,
65      "transferTaxBps": null
66    }
67  },
68  "totalNetworkFee": null,
69  "zid": "0x111111111111111111111111",
70  "permit2": {
71    "type": "Permit2",
72    "hash": "0xab0c8909f2f8daed2891abb5e93762c65787e0067ef2ab9184bb635ad0f3df51",
73    "eip712": {
74      "types": {
75        "PermitTransferFrom": [
76          {
77            "name": "permitted",
78            "type": "TokenPermissions"
79          },
80          {
81            "name": "spender",
82            "type": "address"
83          },
84          {
85            "name": "nonce",
86            "type": "uint256"
87          },
88          {
89            "name": "deadline",
90            "type": "uint256"
91          }
92        ],
93        "TokenPermissions": [
94          {
95            "name": "token",
96            "type": "address"
97          },
98          {
99            "name": "amount",
100            "type": "uint256"
101          }
102        ],
103        "EIP712Domain": [
104          {
105            "name": "name",
106            "type": "string"
107          },
108          {
109            "name": "chainId",
110            "type": "uint256"
111          },
112          {
113            "name": "verifyingContract",
114            "type": "address"
115          }
116        ]
117      },
118      "domain": {
119        "name": "Permit2",
120        "chainId": 1,
121        "verifyingContract": "0x000000000022d473030f116ddee9f6b43ac78ba3"
122      },
123      "message": {
124        "permitted": {
125          "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
126          "amount": "100000000"
127        },
128        "spender": "0x7f6cee965959295cc64d0e6c00d99d6532d8e86b",
129        "nonce": "2241959297937691820908574931991575",
130        "deadline": "1718669420"
131      },
132      "primaryType": "PermitTransferFrom"
133    }
134  },
135  "transaction": {
136    "to": "0x7f6cee965959295cc64d0e6c00d99d6532d8e86b",
137    "data": "0x1fff991f00000000000000000000000070a9f34f9b34c64957b9c401a97bfed35b95049e000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec70000000000000000000000000000000000000000000000000000000005e72fea00000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001c00000000000000000000000000000000000000000000000000000000000000144c1fb425e0000000000000000000000007f6cee965959295cc64d0e6c00d99d6532d8e86b000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb480000000000000000000000000000000000000000000000000000000005f5e1000000000000000000000000000000000000006e898131631616b1779bad70bc17000000000000000000000000000000000000000000000000000000006670d06c00000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000041ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000016438c9c147000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4800000000000000000000000000000000000000000000000000000000000027100000000000000000000000006146be494fee4c73540cb1c5f87536abf1452500000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000084c31b8d7a0000000000000000000000007f6cee965959295cc64d0e6c00d99d6532d8e86b00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000005f5e10000000000000000000000000000000000000000000000000000000001000276a40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
138    "gas": null,
139    "gasPrice": null,
140    "value": null
141  }
142}
Get the firm quote for a swap using Permit2 to set allowances
Was this page helpful?
Previous

getPrice (Permit2)

Next

getChains

Built with

Headers

0x-api-keystringRequired
Visit dashboard.0x.org to get your API Key
0x-versionstringRequired
API version

Query parameters

chainIdintegerRequired
Chain ID. See [here](https://docs.0x.org/docs/introduction/supported-chains) for the list of supported chains
buyTokenstringRequiredformat: "^0x(?!0{40})[a-fA-F0-9]{40}$"
The contract address of the token to buy
sellTokenstringRequiredformat: "^0x(?!0{40})[a-fA-F0-9]{40}$"
The contract address of the token to sell
sellAmountstringOptional

The amount of sellToken in sellToken base units to sell

buyAmountstringOptional

The exact amount of buyToken in buyToken base units to buy

takerstringRequiredformat: "^0x[a-fA-F0-9]{40}$"

The address which holds the sellToken balance and has the allowance set for the swap

txOriginstringOptionalformat: "^0x[a-fA-F0-9]{40}$"

The address of the external account that started the transaction. This is only needed if taker is a smart contract.

recipientstringOptionalformat: "^0x[a-fA-F0-9]{40}$"

The address to receive the buyToken. If not provided, defaults to the taker address. Not supported for wrap/unwrap operations.

swapFeeRecipientstringOptionalformat: "^\s*0x[a-fA-F0-9]{40}(\s*,\s*0x[a-fA-F0-9]{40})*\s*$"

The wallet address to receive the specified trading fees (supports single or multiple comma-separated values). You must also specify the swapFeeBps in the request to use this feature. When multiple values are provided, must match length of swapFeeBps.

swapFeeBpsstringOptionalformat: "^\s*\d+(\s*,\s*\d+)*\s*$"
The amount in Bps of the `swapFeeToken` to charge and deliver to the `swapFeeRecipient` (supports single or multiple comma-separated values). You must also specify the `swapFeeRecipient` in the request to use this feature. For security, this field has a default limit of 1000 Bps. If your application requires a higher value, please reach out to us.
swapFeeTokenstringOptionalformat: "^\s*0x(?!0{40})[a-fA-F0-9]{40}(\s*,\s*0x(?!0{40})[a-fA-F0-9]{40})*\s*$"
The contract address of the token to receive trading fees in (supports single or multiple comma-separated values). Each token must be set to the value of either the `buyToken` or the `sellToken`. If omitted, the fee token will be determined by 0x with preference to stablecoins and highly liquid assets. You must also specify the `swapFeeRecipient` and `swapFeeBps` to charge integrator fees. When multiple values are provided, must match length of `swapFeeBps`.
tradeSurplusRecipientstringOptionalformat: "^0x[a-fA-F0-9]{40}$"
The address to receive any trade surplus. If specified, this address will receive trade surplus when applicable. Otherwise, the taker will receive the surplus. This feature is only available to selected integrators on a custom pricing plan. In other cases, the surplus will be collected by 0x. For assistance with a custom plan, please contact support.
tradeSurplusMaxBpsintegerOptional1-10000

The maximum trade surplus (positive slippage) that can be collected in Bps of the buy amount. If not provided, defaults to 10000 (100%). Must be used together with tradeSurplusRecipient.

gasPricestringOptional

The target gas price (in wei) for the swap transaction. If not provided, the default value is based on the 0x gas price oracle

slippageBpsintegerOptional0-10000

The maximum acceptable slippage of the buyToken in Bps. If this parameter is set to 0, no slippage will be tolerated. If not provided, the default slippage tolerance is 100Bps

slippagePpmintegerOptional0-1000000

The maximum acceptable slippage of the buyToken in parts-per-million (PPM). Mutually exclusive with slippageBps. e.g. 3000 PPM = 30 BPS = 0.30%.

excludedSourcesstringOptional

Liquidity sources e.g. Uniswap_V3, SushiSwap, 0x_RFQ to exclude from the provided quote. See https://api.0x.org/sources?chainId=<chain_id> with the desired chain’s ID for a full list of sources. Separate multiple sources with a comma

sellEntireBalanceenumOptionalDefaults to false
If set to `true`, the taker's entire `sellToken` balance will be sold during trade execution. The `sellAmount` should be the maximum estimated value, as close as possible to the actual taker's balance to ensure the best routing. Selling more than the `sellAmount` may cause the trade to revert. This feature is designed for cases where the precise sell amount is determined during execution. Learn more [here](https://docs.0x.org/docs/0x-swap-api/additional-topics/sell-entire-balance).
Allowed values:
wrapUnwrapModeany or enumOptional

Controls how native wrap/unwrap trades are executed. direct calls the wrapped-native token contract directly. settler routes wrap/unwrap through Settler or Allowance Holder for compatibility. Ignored for non-wrap/unwrap swaps. If omitted, direct mode is used.

Response

Successful response
object
OR
object

Errors

400
Bad Request Error
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error

Chain ID. See here for the list of supported chains

The amount in Bps of the swapFeeToken to charge and deliver to the swapFeeRecipient (supports single or multiple comma-separated values). You must also specify the swapFeeRecipient in the request to use this feature. For security, this field has a default limit of 1000 Bps. If your application requires a higher value, please reach out to us.

The contract address of the token to receive trading fees in (supports single or multiple comma-separated values). Each token must be set to the value of either the buyToken or the sellToken. If omitted, the fee token will be determined by 0x with preference to stablecoins and highly liquid assets. You must also specify the swapFeeRecipient and swapFeeBps to charge integrator fees. When multiple values are provided, must match length of swapFeeBps.

If set to true, the taker’s entire sellToken balance will be sold during trade execution. The sellAmount should be the maximum estimated value, as close as possible to the actual taker’s balance to ensure the best routing. Selling more than the sellAmount may cause the trade to revert. This feature is designed for cases where the precise sell amount is determined during execution. Learn more here.