Cross-Chain Swap API for Wallets and Apps

Quick answer

The RAVN Integrator API gives your wallet, dapp or agent cross-chain swaps without wiring up every venue. Ask for a quote, get the best route and a quoteToken, execute, then poll status.

Base URL: https://app.ravn.exchange/api/v1
Auth: none. 30 requests a minute per IP without a key. A free, self-serve key in x-api-key raises that.

Core endpoints

• POST /quoteThe best route, a quoteToken, and the routes that lost
• POST /executeWhat the user signs or sends
• POST /submit-signatureSigned orders for SIGNATURE routes
• GET /statusOne status format for every venue
• GET /tokens/resolveAny contract address on a supported chain
• GET /healthWhich venues are live right now

Full reference: docs.ravn.exchange and for integrators.

Three execution types

• TRANSACTION: the user signs and broadcasts.
• SIGNATURE: the user signs a message, and RAVN submits it.
• DEPOSIT: the user sends funds to a venue address. Common for native BTC.

Amounts are strings in the smallest unit (wei, lamports, satoshis). RAVN never holds user funds.

What routes you get

• Native BTC in either direction, raced across Relay, NEAR Intents, THORChain, Chainflip and Rift.
• Solana through venues like Jupiter Ultra, Relay and NEAR Intents.
• Same-chain EVM swaps with RFQ venues like 0x Gasless, Bebop and CoW.
• EVM cross-chain through Across, Relay and Mayan.
• HyperEVM and Robinhood Chain, whenever a venue quotes the pair.

See supported chains and tokens for the full map.

Fees for integrators

You set your own fee, from 0 to 100 bps. RAVN keeps a fixed 40% of what you collect. App swaps stay at 0 bps, permanently.

How an integration works

1. POST /quote with origin, destination, amount and the recipient address.
2. Show what the user receives, the costs and the ETA.
3. POST /execute with the quoteToken, then branch on executionType.
4. Collect the signature or prompt the deposit.
5. Poll GET /status until it succeeds, fails or refunds.