{"uid":"cap_Ju3fkdzEn_mKnbBUsoMJ9","slug":"zerion-swap-offers-a42dcd7b","name":"Zerion Swap Offers","description":"Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.","url":"https://api.zerion.io/v1/swap/offers?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","properties":{"sort":{"type":"string","description":"Sort order for the returned offers"},"output[to]":{"type":"string","description":"Recipient wallet address (defaults to the sender)"},"input[from]":{"type":"string","description":"Sender wallet address"},"input[amount]":{"type":"string","description":"Input amount in the token's smallest unit; provide either input[amount] or output[amount]"},"output[amount]":{"type":"string","description":"Output amount in the token's smallest unit; provide either input[amount] or output[amount]"},"input[chain_id]":{"type":"string","description":"Input chain ID"},"input[token_id]":{"type":"string","description":"Input NFT token ID, when swapping an NFT"},"output[chain_id]":{"type":"string","description":"Output chain ID"},"output[token_id]":{"type":"string","description":"Output NFT token ID, when swapping into an NFT"},"slippage_percent":{"type":"number","maximum":3,"minimum":0,"description":"Allowed slippage percent (0–3)"},"input[fungible_id]":{"type":"string","description":"Input token ID — use exactly one of input[fungible_id] or input[asset_address]"},"liquidity_source_id":{"type":"string","description":"Restrict offers to a single liquidity source"},"output[fungible_id]":{"type":"string","description":"Output token ID — use exactly one of output[fungible_id] or output[asset_address]"},"input[asset_address]":{"type":"string","description":"Input token contract address — use exactly one of input[fungible_id] or input[asset_address]"},"output[asset_address]":{"type":"string","description":"Output token contract address — use exactly one of output[fungible_id] or output[asset_address]"},"integrator[beneficiary]":{"type":"string","description":"Fee beneficiary address; same-chain trades only, and must be sent together with integrator[fee_percent]"},"integrator[fee_percent]":{"type":"number","maximum":10,"minimum":0,"description":"Integrator fee percent (0–10); same-chain trades only, and must be sent together with integrator[beneficiary]"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Resource ID."},"type":{"type":"string","description":"Resource type."},"attributes":{"type":"object","description":"Resource attributes; see https://developers.zerion.io"}}},"description":"Array of JSON:API resource objects."},"links":{"type":"object","description":"Self and pagination links."}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"<resource id>","type":"<resource type>","attributes":{}}],"links":{"self":"https://api.zerion.io/v1/..."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_YeXc2Zf_y3IQrD_p6tFRS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns swap offers (quotes) for trading tokens across 40+ chains, comparing liquidity sources for a given input/output token pair and amount.","exampleAgentPrompt":"Get me the best swap offers to trade 1000 USDC for ETH on Ethereum mainnet, with a max slippage of 1%, from my wallet 0xAbC123...","exampleUseCases":[{"title":"Best rate for ETH to USDC swap","prompt":"What are the best swap offers to convert 0.5 ETH into USDC on Ethereum right now? My wallet is 0x1234abcd... and I'm okay with up to 0.5% slippage."},{"title":"Cross-chain token swap quote","prompt":"Find me swap offers to bridge and swap 500 USDC from Arbitrum to MATIC on Polygon — show me what liquidity sources are available and what I'd get out."},{"title":"Comparing DEX prices for DeFi bot","prompt":"Pull all available swap offers to trade 10,000 USDT for WBTC on Ethereum, sorted by best output amount, so I can pick the most efficient route."}],"resultDescription":"A list of swap offer objects, each containing the liquidity source, expected output amount, exchange rate, price impact, and transaction calldata needed to execute the swap. Also includes pagination links.","failureModes":["Missing required input or output token identifiers returns a 400 validation error","Providing both fungible_id and asset_address for the same side returns a 400 conflict error","No liquidity available for the requested pair returns an empty data array","Slippage percent outside 0–3 range returns a 400 validation error","Payment not provided or insufficient returns a 402 Payment Required response","Invalid chain ID returns a 400 error"],"whenToPreferThis":"Use this endpoint when you need to fetch and compare real-time swap quotes across multiple DEX liquidity sources for a given token pair on any of the 40+ supported chains. Prefer this over generic DEX APIs when you want aggregated multi-source offers, cross-chain support, and a pay-per-call x402 model without requiring an API key subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:40:43.967Z","isFirstParty":false,"canonicalSlug":"zerion-swap-offers-a42dcd7b"}