{"uid":"cap_4T1s4fxDNM2j63EHDg8t3","slug":"agent-proxy-alchemy-com-538c774b","name":"Alchemy Swap Allowance Holder Firm Quote","description":"Get the firm quote for a swap using Allowance Holder to set allowances","url":"https://agent-proxy.alchemy.com/v1/x402/86b0ec6d1d0b3dc0/swap-allowance-holder-quote/","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"object","required":["zid","fees","mode","route","issues","buyToken","buyAmount","sellToken","sellAmount","blockNumber","transaction","minBuyAmount","tokenMetadata","allowanceTarget","totalNetworkFee","liquidityAvailable"],"properties":{"zid":{"type":"string"},"fees":{"type":"object","required":["gasFee","zeroExFee","integratorFee","integratorFees"],"properties":{"gasFee":{"type":"null"},"zeroExFee":{"type":"object","required":["type","token","amount"],"properties":{"type":{"type":"string"},"token":{"type":"string"},"amount":{"type":"string"}}},"integratorFee":{"type":"null"},"integratorFees":{"type":"null"}}},"mode":{"type":"string"},"route":{"type":"object","required":["fills","tokens"],"properties":{"fills":{"type":"array","items":{"type":"object","required":["to","from","source","proportionBps"],"properties":{"to":{"type":"string"},"from":{"type":"string"},"source":{"type":"string"},"proportionBps":{"type":"string"}}}},"tokens":{"type":"array","items":{"type":"object","required":["symbol","address"],"properties":{"symbol":{"type":"string"},"address":{"type":"string"}}}}}},"issues":{"type":"object","required":["balance","allowance","invalidSourcesPassed","simulationIncomplete"],"properties":{"balance":{"type":"object","required":["token","actual","expected"],"properties":{"token":{"type":"string"},"actual":{"type":"string"},"expected":{"type":"string"}}},"allowance":{"type":"object","required":["actual","spender"],"properties":{"actual":{"type":"string"},"spender":{"type":"string"}}},"invalidSourcesPassed":{"type":"array","items":{"type":"unknown"}},"simulationIncomplete":{"type":"boolean"}}},"buyToken":{"type":"string"},"buyAmount":{"type":"string"},"sellToken":{"type":"string"},"sellAmount":{"type":"string"},"blockNumber":{"type":"string"},"transaction":{"type":"object","required":["to","gas","data","value","gasPrice"],"properties":{"to":{"type":"string"},"gas":{"type":"string"},"data":{"type":"string"},"value":{"type":"string"},"gasPrice":{"type":"string"}}},"minBuyAmount":{"type":"string"},"tokenMetadata":{"type":"object","required":["buyToken","sellToken"],"properties":{"buyToken":{"type":"object","required":["buyTaxBps","sellTaxBps","transferTaxBps"],"properties":{"buyTaxBps":{"type":"string"},"sellTaxBps":{"type":"string"},"transferTaxBps":{"type":"string"}}},"sellToken":{"type":"object","required":["buyTaxBps","sellTaxBps","transferTaxBps"],"properties":{"buyTaxBps":{"type":"string"},"sellTaxBps":{"type":"string"},"transferTaxBps":{"type":"string"}}}}},"allowanceTarget":{"type":"string"},"totalNetworkFee":{"type":"string"},"liquidityAvailable":{"type":"boolean"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"taker":"0x1234567890123456789012345678901234567890","chainId":1,"buyToken":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","sellToken":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","sellAmount":"1000000000000000000"}}},"response":{"zid":"0xa0d39c15dd9653718bf03b1c","fees":{"gasFee":null,"zeroExFee":{"type":"volume","token":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","amount":"2496468"},"integratorFee":null,"integratorFees":null},"mode":"exact-in","route":{"fills":[{"to":"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599","from":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","source":"Uniswap_V3","proportionBps":"10000"},{"to":"0xdac17f958d2ee523a2206206994597c13d831ec7","from":"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599","source":"Uniswap_V3","proportionBps":"10000"},{"to":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","from":"0xdac17f958d2ee523a2206206994597c13d831ec7","source":"Metric","proportionBps":"10000"}],"tokens":[{"symbol":"WETH","address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"symbol":"WBTC","address":"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"},{"symbol":"USDT","address":"0xdac17f958d2ee523a2206206994597c13d831ec7"},{"symbol":"USDC","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}]},"issues":{"balance":{"token":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","actual":"100000000000","expected":"1000000000000000000"},"allowance":{"actual":"0","spender":"0x0000000000001ff3684f28c67538d4d072c22734"},"invalidSourcesPassed":[],"simulationIncomplete":false},"buyToken":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","buyAmount":"1661813535","sellToken":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","sellAmount":"1000000000000000000","blockNumber":"25277499","transaction":{"to":"0x0000000000001ff3684f28c67538d4d072c22734","gas":"593802","data":"0x2213bc0b0000000000000000000000007f54f05635d15cde17a49502fedb9d1803a3be8a000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000007f54f05635d15cde17a49502fedb9d1803a3be8a00000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000008641fff991f0000000000000000000000001234567890123456789012345678901234567890000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4800000000000000000000000000000000000000000000000000000000620f4f0300000000000000000000000000000000000000000000000000000000000000a0a0d39c15dd9653718bf03b1c0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000500000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000026000000000000000000000000000000000000000000000000000000000000003800000000000000000000000000000000000000000000000000000000000000580000000000000000000000000000000000000000000000000000000000000064000000000000000000000000000000000000000000000000000000000000001843036d6a60000000000000000000000007f54f05635d15cde17a49502fedb9d1803a3be8a000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006a2798940000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000016000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000001f4fffd8963efd1fc6a506488495d951d5263988d252260fac5e5542a773aa44fbcfedf7c193bc2c59900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e48d68a1560000000000000000000000007f54f05635d15cde17a49502fedb9d1803a3be8a00000000000000000000000000000000000000000000000000000000000027100000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000402260fac5e5542a773aa44fbcfedf7c193bc2c599000001f400000000000000000000000000000001000276a4dac17f958d2ee523a2206206994597c13d831ec70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001c438c9c147000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec70000000000000000000000000000000000000000000000000000000000002710000000000000000000000000cb41c10c6414acbea022c7662df4005dd8fbef91000000000000000000000000000000000000000000000000000000000000006400000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e44a878c1c0000000000000000000000009c9fd348505a7202fd819d8cb5003248d920d2790000000000000000000000007f54f05635d15cde17a49502fedb9d1803a3be8a00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000594760c8000000000000000000000000000000000000000000000000000000006a2798940000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008434ee90ca000000000000000000000000f5c4f3dc02c3fb9279495a8fef7b0741da956157000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb480000000000000000000000000000000000000000000000000000000063337070000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000012438c9c147000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000000000000000000000000000000000000000000f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000044a9059cbb000000000000000000000000ad01c20d5886137e056775af56915de824c8fce50000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","value":"0","gasPrice":"167597715"},"minBuyAmount":"1645170435","tokenMetadata":{"buyToken":{"buyTaxBps":"0","sellTaxBps":"0","transferTaxBps":"0"},"sellToken":{"buyTaxBps":"0","sellTaxBps":"0","transferTaxBps":"0"}},"allowanceTarget":"0x0000000000001ff3684f28c67538d4d072c22734","totalNetworkFee":"99519858362430","liquidityAvailable":true}},"exampleRequest":{"taker":"0x1234567890123456789012345678901234567890","chainId":1,"buyToken":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","sellToken":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","sellAmount":"1000000000000000000"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JDERuFTogAA5DtJ-zzghw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a firm, executable quote for a token swap using the Allowance Holder contract to manage spending allowances","exampleAgentPrompt":"What's the firm quote to swap 1 ETH for USDC using the Allowance Holder — I need the exact committed price I'll get, not just an estimate.","exampleUseCases":null,"resultDescription":"A firm, executable swap quote including exact input/output token amounts, price, routing details, and allowance holder contract information needed to execute the swap on-chain.","failureModes":["Invalid or unsupported token pair returns error","Insufficient liquidity for the requested swap amount","Missing required query parameters such as token addresses or amounts","Payment of $0.01 USDC not provided results in 402 Payment Required","Stale quote if market moves before execution","Network or chain ID mismatch in parameters"],"whenToPreferThis":"Use this endpoint when you need a committed, firm swap quote (not just an indicative price) before executing a token swap, specifically when using the Allowance Holder pattern to set spending approvals. Choose this over the indicative price endpoint when you need a guaranteed rate to present to a user before transaction signing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:38:25.356Z","isFirstParty":false}