Keep the fill you would have lost

Every venue we race, one call

An aggregator is only as good as the venues it can see. RAVN adds every venue it races behind a single call and returns the whole ranked set, not just a winner. Keep your own routing and use this as the fallback that stops a user leaving.

Where an aggregator runs out

You get the losers too

One quote returns the winner and every route that lost, with output and settlement time on each. Compare it to your own book and take whichever wins.

const quote = await ravn.quote({ /* ...pair... */ });

quote.venue.name;              // 'Chainflip'
quote.output.amount;           // '3180444'  (satoshis)
quote.estimatedTimeSeconds;    // 462
quote.slippage.isFirm;         // true -> quoted number or no settle
quote.gas.usd;                 // '0.02'

// every route that lost, and by how much
for (const alt of quote.alternatives) {
  console.log(alt.venue.name, alt.outputAmount, alt.estimatedTimeSeconds);
}

// drop a venue you have a view on
await ravn.quote({ ...pair, excludeVenues: ['mayan'] });

We rank on net output after gas first. When outputs are close, the faster settlement wins. A firm, gasless route wins if it still beats the rival's worst case.

What you get

Race it against your own book

The quote endpoint needs no key and answers browser calls. Point it at a pair you already price and see what comes back.