Is RAVN custodial? Does it use bridges?
Is RAVN custodial? Does it use bridges?
No custody: the user signs or sends directly to the venue. RAVN runs no bridge of its own, and
the user always receives the real token, never a wrapped copy (unless they asked for one, like
WBTC). NEAR Intents holds the deposit as a matching token on NEAR for the minutes its swap takes;
leave it out with
excludeVenues: ["near_intents"] if you’d rather.Do I need an API key?
Do I need an API key?
No. Every call works without one, at 30 requests a minute per IP. A free
key raises that to 120 and lets you charge your own fee.
How do fees work?
How do fees work?
You put your own fee on top of every swap, up to 1%. RAVN shares it with you: you keep 60%, RAVN
40% (a few venues take their own cut first). RAVN adds no fee of its own. See
Pricing and Collecting your fee.
Can users swap without gas?
Can users swap without gas?
Yes, on gasless routes (
SIGNATURE): the user signs a message and a solver pays the gas. A token
approval may still be needed once.Why is my quote executable: false?
Why is my quote executable: false?
It was priced without an address the venue needs. Quote again with
destinationAddress (and
refundAddress when selling BTC from a non-Bitcoin userAddress). /execute names the missing
one in details.missing.Why did /execute return QUOTE_EXPIRED?
Why did /execute return QUOTE_EXPIRED?
The quote passed
expiresAt and, priced again, no longer met its minimum. Quote again. Execute
soon after quoting, and send an Idempotency-Key so a retry doesn’t build twice.A delivered swap still says processing
A delivered swap still says processing
When your fee was paid beside the swap, RAVN confirms that transaction first, for up to 15
minutes after
/execute. Keep polling with txHash./status keeps saying not_found
/status keeps saying not_found
Normal for the first minutes: the venue hasn’t seen the swap yet. If it stays, check you’re
polling with the
quoteToken from /execute and the right ref.Selling a wallet's whole native balance fails
Selling a wallet's whole native balance fails
The swap needs gas on top of what it sends. When the execution has
transaction.gasLimit,
leave gasLimit × the max fee per gas unspent (plus the L1 fee on OP-stack chains).How do I get help?
How do I get help?
Every response has a
requestId (also the x-request-id header). Send it with your question
via ravn.exchange or @ravnexchange, and we
can trace the exact request.
