{"uid":"cap_RKqdCbgws6U3t56L53mpH","slug":"hypernatt-swap-quote-c2e58f12","name":"HYPERNATT Swap Quote","description":"NattSwap cross-chain swap quote (Li.Fi)","url":"https://hypernatt.com/api/m2m/swap/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","required":["fromChain","toChain","fromToken","toToken","fromAmount","fromAddress","toAddress"],"properties":{"toChain":{"type":"string","description":"Destination chain id"},"toToken":{"type":"string"},"slippage":{"type":"string"},"fromChain":{"type":"string","description":"Source chain id (e.g. 8453 for Base)"},"fromToken":{"type":"string"},"toAddress":{"type":"string"},"fromAmount":{"type":"string","description":"Amount in atomic units"},"fromAddress":{"type":"string","description":"Your agent hot wallet (must sign the swap). Not a Hyperliquid vault address. Prefer MCP swap_via_nattswap (free)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"quote":{"tool":"lifi","toAmount":"997500","fromAmount":"1000000","estimatedDurationSeconds":60},"success":true,"execution_readiness":{"next_step":{"message":"Call swap_via_nattswap MCP tool to get execution instructions"},"can_execute":true,"signer_match":true},"wallet_onboarding_v1":{"doc_url":"https://github.com/DIALLOUBE-RESEARCH/hypernatt-terminal/blob/main/docs/swap-agentkit.md"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oaMoAH5xjBoDM-HSUcd53","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Gets a cross-chain token swap quote including estimated output amount and duration via the HYPERNATT neural trading platform","exampleAgentPrompt":"How much USDC will I get if I swap 1,000,000 atomic units of ETH on Base (chain 8453) to USDC on Ethereum (chain 1), sending from 0xAbC...123 to 0xDeF...456, with 0.5% slippage?","exampleUseCases":[{"title":"Portfolio rebalancing across blockchains","prompt":"I want to rebalance my portfolio by moving 5 ETH from Ethereum to Base network as USDC. What will I receive after the cross-chain swap, and how long should I expect it to take?"},{"title":"DeFi yield farming entry position","prompt":"I'm planning to deposit into a Arbitrum yield farm that requires USDC. Can you check how much USDC I'd get if I swap 2 WETH from Ethereum, and what the slippage looks like with a 1% tolerance?"},{"title":"Stablecoin consolidation across chains","prompt":"I have USDC scattered across multiple chains and want to consolidate to Polygon USDC. Quote me swapping 10,000 USDC from Optimism to Polygon USDC, and let me know the output amount and swap duration."}],"resultDescription":"A JSON object with a 'quote' field containing the aggregator tool used (e.g. lifi), the input amount in atomic units, the estimated output token amount in atomic units, and the estimated duration in seconds for the swap to complete; plus a 'success' boolean.","failureModes":["Missing required query parameters (fromChain, toChain, fromToken, toToken, fromAmount, fromAddress, toAddress) returns an error","Invalid chain IDs or unsupported token pairs return a failure response","No liquidity route available between specified tokens/chains","Payment of 0.001 USDC per call not fulfilled via x402 protocol results in 402 error","Invalid wallet addresses return a validation error"],"whenToPreferThis":"Use this endpoint when you need a cross-chain or same-chain token swap quote before executing a trade, especially when routing through LI.FI aggregator on EVM chains. Prefer this over generic DEX APIs when you want a neutral pre-execution price estimate with duration data and are operating within the HYPERNATT agentic trading ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:32:52.751Z","isFirstParty":false}