{"uid":"cap_gf9cF47Mm4ESG_JVbf9sQ","slug":"ravn-cross-chain-swap-execution-7349a331","name":"RAVN Cross-Chain Swap Execution","description":"RAVN cross-chain swap execution, incl. native Bitcoin as source or destination","url":"https://app.ravn.exchange/api/v1/x402/execute","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"quoteToken":{"type":"string","minLength":1,"description":"Token returned from POST /api/v1/quote"},"refundAddress":{"type":"string","description":"Late-bound refund recipient, for venues that support binding it at execution time. Does NOT apply to a Bitcoin-source Relay quote — Relay bakes the refund address in at quote time, so this is silently ignored for those; supply refundAddress on the quote call instead."},"destinationAddress":{"type":"string","description":"Late-bound output recipient, for venues that support binding it at execution time (e.g. NEAR Intents, Garden, Chainflip, Rift). Does NOT apply to Relay, Across, Eco, or THORChain — those fix the recipient at quote time with no execute-time re-bind, so this is silently ignored for them; supply destinationAddress on the quote call instead."}}},"responseSchema":{"type":"json","example":{"data":{"deposit":{"amount":"150000","address":"bc1q..."},"statusRef":"bc1q...","executionType":"DEPOSIT"}}},"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_pUf8srGbB8n7VpZZLKtAu","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":"Executes a cross-chain token swap via RAVN, returning a deposit address and status reference, with native Bitcoin supported as source or destination","exampleAgentPrompt":"Execute a RAVN cross-chain swap of 0.01 BTC from Bitcoin to USDC on Ethereum, sending the output to my Ethereum address 0xABC123.","exampleUseCases":[{"title":"Bitcoin to stablecoin bridge","prompt":"I want to swap 0.05 BTC from my Bitcoin wallet into USDC on Ethereum — use RAVN to execute the swap and give me the deposit address I should send my BTC to."},{"title":"EVM token to native Bitcoin","prompt":"Execute a cross-chain swap of 200 USDC from Ethereum to native Bitcoin, sending the BTC to my address bc1qxyz... — I need the deposit instructions so I can send the USDC now."},{"title":"Automated agent treasury rebalancing","prompt":"Our agent treasury needs to move 500 USDC from Polygon to Bitcoin; execute the RAVN swap and return the deposit address and status reference so we can track the transfer."}],"resultDescription":"Returns a JSON object containing a deposit object with the amount (in smallest denomination) and address to send funds to, a statusRef for tracking the swap, and an executionType field (e.g. DEPOSIT) indicating how to proceed with the swap.","failureModes":["Invalid or unsupported token pair — swap route not available between specified chains","Malformed recipient or deposit address — returns error if address format is wrong for the destination chain","Amount below minimum or above maximum supported swap size","Quote expired — if the execution relies on a prior quote that has timed out","Insufficient liquidity for the requested swap pair","Payment failure — $0.01 USDC x402 payment not received or rejected"],"whenToPreferThis":"Choose this endpoint when you need to actually execute a cross-chain swap (not just get a quote), especially when native Bitcoin is involved as either the source or destination asset. Prefer RAVN over generic bridges when you need deposit-address-based swap execution compatible with agentic payment flows via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:38:19.176Z","isFirstParty":false}