Quickstart
Swap 1 ETH to SOL end to end in four calls.
Execution types
The one field your integration branches on.
API Reference
Every endpoint, request, and response.
Base URL
- Content type:
application/json - Amounts: always strings, in the token’s smallest unit (wei, lamports, satoshis).
- Native coin: use the sentinel
0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE. For Solana native SOL, use its mintSo1111...1112.
RAVN is in beta. Every call works with no
x-api-key header at all if you just want to poke
around, but get a free key first if you can. It’s instant, no review,
and quadruples your rate limit. See Authentication for the full tier
breakdown. RAVN charges 0 bps on every route, for every tier, by default. The fee is still
shown in every quote, and it is invisible to your end users.Why it is different
Most swap APIs do one thing, an EVM transaction, so their whole surface assumes it. RAVN spans three genuinely different execution models, and every quote resolves to exactly oneexecutionType. Your integration reads that one field and branches. That is the whole contract.
See Supported Chains & Venues for which type each venue returns and when: a few
depend on the source chain or execution mode.
The response envelope
Every response has the same shape.x-request-id and ravn-version headers. Log the requestId and
quote it when you contact support.
