Skip to main content
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.
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.
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.
Yes, on gasless routes (SIGNATURE): the user signs a message and a solver pays the gas. A token approval may still be needed once.
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.
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.
When your fee was paid beside the swap, RAVN confirms that transaction first, for up to 15 minutes after /execute. Keep polling with txHash.
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.
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).
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.