Back to Browse
RAVN Cross-Chain Swap Execution
x402
RAVN Cross-Chain Swap Execution is a paid API for AI agents from app.ravn.exchange, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).
Executes a cross-chain token swap via RAVN, returning a deposit address and status reference, with native Bitcoin supported as source or destination
Price / call$0.01
Success—
StatusUnknown
How this service works
RAVN cross-chain swap execution, incl. native Bitcoin as source or destination
Output
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.
Example use cases
Bitcoin to stablecoin bridge
“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.”
EVM token to native Bitcoin
“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.”
Automated agent treasury rebalancing
“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.”
Technical details
Endpoint
POSThttps://app.ravn.exchange/api/v1/x402/executeWhen to prefer
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.
Side effects
- 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
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| quoteToken | string | Token returned from POST /api/v1/quote |
| refundAddress | string | 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 | string | 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. |
Output
Schema · Response
{
"type": "json",
"example": {
"data": {
"deposit": {
"amount": "150000",
"address": "bc1q..."
},
"statusRef": "bc1q...",
"executionType": "DEPOSIT"
}
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"