Skip to main content
Every swap is three steps: quote it, execute it to get what the wallet signs, then track it until it’s final. No API key is needed to try it. Get a free key when you want a higher rate limit or your own fee.

1. Get a quote

You get the best route across every venue, the expected output and a quoteToken. The addresses above are placeholders: nobody holds their keys, so never send funds to them.

2. Execute and track

Pass the quoteToken to /execute. It returns exactly what the wallet must sign or send, tagged by executionType. Then poll /status until the swap is final. Both scripts below swap from an EVM wallet. Save one as quickstart.mjs, run npm install viem (plus @ravnexchange/sdk for the first), then PRIVATE_KEY=0x… SOL_DESTINATION=<your Solana address> node quickstart.mjs.
Add sandbox: true to the quote to run the whole flow without moving funds: both scripts then sign and send nothing. See Sandbox mode.
Poll every swap until it’s final. It’s how RAVN confirms the swap, and only confirmed swaps earn your fee. Always use the quoteToken that /execute returned for the calls after it.

Next

Earn on every swap

Put your fee on top of every swap. You keep 60% of it.

Execution types

What to do with each answer, on every chain.

API reference

Every endpoint and field.

Widget

A ready-made swap UI instead.