{"uid":"cap_9m1ZsNsm71QdZgca1SR4F","slug":"ravn-cross-chain-swap-quote-830137e7","name":"RAVN Cross-Chain Swap Quote","description":"RAVN — best-price swap quotes across 20 execution venues and 18 chains, including native (non-wrapped) Bitcoin as either source or destination. 0% protocol fee, non-custodial. Returns a quoteToken; pass it to POST /execute.","url":"https://app.ravn.exchange/api/v1/x402/quote?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sandbox":{"type":"boolean"},"timeoutMs":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"inputToken":{"type":"string","minLength":1},"onlyVenues":{"type":"array","items":{"enum":["rift","0x_gasless","0x_swap","0x_solana","bebop","cow","across","relay","mayan","jupiter","near_intents","garden","chainflip","thorchain","eco","compose","nordstern","flytrade","kyberswap","layerswap","houdini","okx","hinkal","routefun","metric"],"type":"string"},"minItems":1},"inputAmount":{"type":"string"},"outputToken":{"type":"string","minLength":1},"rankingMode":{"enum":["best_output","fastest"],"type":"string"},"slippageBps":{"type":"integer","maximum":5000,"minimum":1},"userAddress":{"type":"string","minLength":1},"confidential":{"type":"boolean"},"inputChainId":{"enum":[1,10,56,130,137,324,480,999,143,8453,42161,59144,43114,4663,4217,5042,-1,-2],"type":"number"},"excludeVenues":{"type":"array","items":{"enum":["rift","0x_gasless","0x_swap","0x_solana","bebop","cow","across","relay","mayan","jupiter","near_intents","garden","chainflip","thorchain","eco","compose","nordstern","flytrade","kyberswap","layerswap","houdini","okx","hinkal","routefun","metric"],"type":"string"}},"outputChainId":{"enum":[1,10,56,130,137,324,480,999,143,8453,42161,59144,43114,4663,4217,5042,-1,-2],"type":"number"},"refundAddress":{"type":"string"},"allowNoMinimum":{"type":"boolean"},"clientTimezone":{"type":"string","maxLength":64},"quoteSessionId":{"type":"string","maxLength":64},"destinationAddress":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"fee":{"bps":0,"amount":"0"},"input":{"token":{"symbol":"ETH","chainId":1,"decimals":18,"isNative":true},"amount":"1000000000000000000"},"venue":{"id":"mayan","name":"Mayan"},"output":{"token":{"symbol":"ETH","chainId":8453,"decimals":18,"isNative":true},"amount":"999534824840543000"},"expiresAt":1786374968171,"routeType":"EVM_CROSS_CHAIN","quoteToken":"eyJ2ZW51ZUlkIjoi...","estimatedTimeSeconds":3}}},"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_g0QX9v_qLA0Bi24czWBbu","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":"Returns a quoted price and route for a cross-chain token swap, including native Bitcoin as source or destination","exampleAgentPrompt":"Give me a RAVN quote for swapping 1 ETH on Ethereum (chain 1) to native ETH on Base (chain 8453) — I want to see the output amount, fees, and which bridge venue it'll use.","exampleUseCases":[{"title":"Bridge ETH from Ethereum to Base","prompt":"What's the RAVN quote for swapping 1 ETH from Ethereum mainnet to ETH on Base? Show me the expected output amount, the fee, and how long it'll take."},{"title":"Quote native Bitcoin as destination","prompt":"I want to swap 500 USDC on Arbitrum to native Bitcoin — can you get me a cross-chain quote from RAVN showing the BTC output amount and estimated bridge time?"},{"title":"Compare cross-chain swap costs before executing","prompt":"Before I do the swap, get me a RAVN quote for converting 2 ETH on Ethereum to USDC on Solana so I can see the fees in basis points and which venue it routes through."}],"resultDescription":"A JSON object containing the quoted output token amount, input token details (symbol, chainId, decimals, isNative), output token details, fee in basis points and absolute amount, the routing venue (id and name, e.g. Mayan), route type (e.g. EVM_CROSS_CHAIN), a signed quoteToken string to use for execution, estimated completion time in seconds, and an expiry timestamp.","failureModes":["Unsupported token pair or chain combination returns an error or empty route","Quote expires quickly (expiresAt timestamp); using a stale quoteToken in execution will fail","Invalid chainId or token symbol returns a validation error","Liquidity unavailable for the requested pair at the given amount","Network congestion may cause slow quote response or timeout"],"whenToPreferThis":"Use this endpoint when you need a real-time cross-chain swap quote that supports native Bitcoin as either source or destination — a capability most bridge aggregators lack. It is the required first step before calling RAVN's swap execution endpoint, since the returned quoteToken is needed to authorize the actual trade. Prefer this over generic DEX quote APIs when the swap involves non-EVM chains or native BTC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:31:12.840Z","isFirstParty":false,"canonicalSlug":"ravn-cross-chain-swap-quote-830137e7"}