{"uid":"cap_9m1ZsNsm71QdZgca1SR4F","slug":"ravn-cross-chain-swap-quote-830137e7","name":"RAVN Cross-Chain Swap Quote","description":"RAVN — best-price swap quotes across 12 execution venues and 16 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","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"inputToken":{"type":"string","minLength":1,"description":"Token contract address, or the native-token sentinel 0xEeee...EEeE"},"inputAmount":{"type":"string","description":"Positive integer string, in the input token's smallest unit"},"outputToken":{"type":"string","minLength":1},"rankingMode":{"enum":["best_output","fastest"],"type":"string","description":"Defaults to best_output."},"slippageBps":{"type":"integer","maximum":5000,"minimum":1},"userAddress":{"type":"string","minLength":1},"inputChainId":{"enum":[1,10,56,130,137,324,480,999,143,8453,42161,59144,43114,4663,-1,-2],"type":"number"},"excludeVenues":{"type":"array","items":{"enum":["rift","0x_gasless","bebop","cow","across","relay","mayan","jupiter","near_intents","garden","chainflip","thorchain","eco"],"type":"string"},"description":"Drop specific venues from this race — e.g. a risk objection to one of them. Naming a venue that was never eligible for this pair is a no-op, not an error."},"outputChainId":{"enum":[1,10,56,130,137,324,480,999,143,8453,42161,59144,43114,4663,-1,-2],"type":"number"},"refundAddress":{"type":"string","description":"Where to refund the input asset if the swap fails. For a Bitcoin-source Relay quote specifically, this must be supplied here, at quote time — Relay has no execute-time re-bind, so omitting it returns a priced-but-unexecutable preview and supplying it later on execute has no effect. Other BTC-source venues (Garden, THORChain, Chainflip, Rift) support binding this at execute time instead."},"destinationAddress":{"type":"string","description":"Where output should land. For a Solana-touching Across quote or a cross-ecosystem Eco quote, this must be supplied here, at quote time — omitting it returns a priced-but-unexecutable preview (see QuoteDTO.executable), since neither venue supports fixing the destination after quoting."}}},"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-09-15T18:32:15.752Z","isFirstParty":false}