For integrators
Add cross-chain swaps, including native Bitcoin, with one integration. Quote, execute, and track status through a uniform JSON API. Overview: cross-chain swap API guide.
Base URL
https://app.ravn.exchange/api/v1
No API key required. Every endpoint works anonymously, rate-limited per IP — start with the quickstart curl and integrate before you talk to anyone. Want a higher limit and your project attributed in our usage tracking? Grab a free key — instant, no review, no call. Pass it as x-api-key. GET /health is always public, and CORS is enabled everywhere, so browser-side dapps can call the API directly.
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 | 0 bps |
| Cross-ecosystem | 0 bps |
| Native BTC | 0 bps |
RAVN takes 0 bps on every route. Quotes still carry fee.bps and fee.amount so integrators can read them programmatically. Direct app users pay zero RAVN markup.
AI agents
Three ways for an agent to swap through RAVN, same 0% fees and same fields on all three. Full guide: AI agents on RAVN.
- AI agents overviewThree ways in, which one to use
- MCP serverFree, no signup, for Claude and Cursor
- x402 paymentsPay-per-call in USDC, no signup, no API key
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/.well-known/llms-full.txtFull docs body for deep integration
- docs.ravn.exchange/llms-full.txtSame full dump (CDN path; may lag a few hours after deploys)
- QuickstartEnd-to-end swap in four calls
- Execution typesTRANSACTION · SIGNATURE · DEPOSIT
- API referenceEvery endpoint, request, and response
- OpenAPI specImport into Postman, Insomnia, or an agent framework
- AuthenticationKeys, fees, rate limits
- Pricing0 bps every route, fee object on quotes
- Supported chains and venuesCoverage map
- ErrorsStable machine-readable codes