INTEGRATOR API · BETA
For integrators
Add cross-chain swaps, including native Bitcoin, with one integration. Quote, execute, and track status through a uniform JSON API.
One base URL
app.ravn.exchange/api/v1
Three types
TRANSACTION · SIGNATURE · DEPOSIT
Native BTC
Same loop as EVM and Solana pairs
Base URL
https://app.ravn.exchange/api/v1
Authenticate with x-api-key. Keys are issued by RAVN so usage can be attributed per partner. Request a key via team@ravn.exchange or @ravnexchange. GET /health is public.
Core loop
- 1
POST /quote: best execution route + opaquequoteToken - 2
POST /execute: execution payload tagged byexecutionType - 3
POST /submit-signature: when type is SIGNATURE - 4
GET /status: pending → processing → success (or refunded / failed)
Pricing (API)
| Route | Fee |
|---|---|
| EVM same-chain | 0 bps |
| Solana to Solana | 0 bps |
| EVM cross-chain | 15 bps |
| Cross-ecosystem | 25 bps |
| Native BTC | 30 bps |
Fees appear in every quote (fee.bps / fee.amount) and are invisible to end users. Direct app users pay zero RAVN markup.
Full documentation
Human docs and machine-readable indexes for ChatGPT, Claude, Grok, and other models:
- docs.ravn.exchange/llms.txtCompact docs index for models
- docs.ravn.exchange/llms-full.txtFull docs body for deep integration
- QuickstartEnd-to-end swap in four calls
- Execution typesTRANSACTION · SIGNATURE · DEPOSIT
- API referenceEvery endpoint, request, and response
- AuthenticationKeys, fees, rate limits
- Supported chains and venuesCoverage map
- ErrorsStable machine-readable codes