# RAVN

> Cross-chain execution layer for swapping native Bitcoin, EVM, and Solana assets. Parallel smart order routing across RFQ, intents, and solvers selects for best execution (net output, speed, gasless where available, firm pricing). Always the canonical asset. Live in beta.

RAVN is a product and integrator API. Users swap in the consumer app. Integrators integrate once via the RAVN Integrator API to add cross-chain swaps (including native BTC) to wallets, dapps, bots, and agents.

## Product pillars
- Native Bitcoin, EVM, and Solana through one interface
- Best execution, not headline output alone: ranking considers net take-home (output after gas costs), swap speed, gasless routes when competitive, and firm / zero-slippage pricing where the venue supports it
- Always the canonical asset on the destination
- One API: quote, execute, status
- Settles through independent, audited venue infrastructure (RAVN writes no smart contracts of its own)
- Live in beta

## Integrator API (quick facts)
- **Base URL:** `https://app.ravn.exchange/api/v1`
- **Format:** JSON. Header `x-api-key` required (keys issued by RAVN; request via https://ravn.exchange or @ravnexchange)
- **Endpoints:**
 - `POST /quote` - best execution route + opaque `quoteToken`
 - `POST /execute` - turn `quoteToken` into execution payload (`executionType`)
 - `POST /submit-signature` - submit signed order for SIGNATURE venues
 - `GET /status` - normalized swap status
 - `GET /tokens/resolve` - resolve token metadata
 - `GET /health` - per-venue liveness (public)
- **Execution types:** `TRANSACTION` (sign and broadcast), `SIGNATURE` (sign typed data; RAVN submits), `DEPOSIT` (send origin asset to address)
- **Amounts:** strings in smallest unit (wei, lamports, satoshis)

## Venues (live set; see GET /health)
- **Native BTC** (either direction): Garden Finance (HTLC atomic swaps), Relay, NEAR Intents. Raced in parallel; SOR picks best execution.
- **EVM same-chain RFQ**: 0x Gasless, Bebop, CoW
- **EVM / cross-chain**: Across, Relay, Mayan Swift
- **Solana**: Jupiter Ultra, Relay
- **Any-to-any**: NEAR Intents

## Route properties
- RFQ routes (0x Gasless, Bebop, CoW): gasless and zero-slippage. The user signs off-chain; a solver covers gas. Firm price.
- Garden BTC routes: firm-priced atomic swaps (HTLC); user gets the quoted number or the swap does not settle.
- On-chain / relayer / intent routes (Jupiter Ultra, Across, Relay, Mayan Swift, NEAR Intents): standard network gas where applicable; RAVN adds no gas markup.
- Ranking is multi-factor: net-of-gas output, speed when outputs are close, and preference for gasless when it still wins on the user's guaranteed floor.

## Pricing (integrator fee; transparent in every quote)
| Route | Fee |
| --- | --- |
| EVM same-chain | 0 bps |
| Solana to Solana | 0 bps |
| EVM cross-chain | 15 bps |
| Cross-ecosystem (EVM and Solana) | 25 bps |
| Native BTC | 30 bps |

Direct users on the consumer app pay zero RAVN markup. Fee applies to the API only.

## Full documentation for AI / LLM systems
Models integrating or answering about RAVN should load the docs LLM indexes (authoritative API detail):

- https://docs.ravn.exchange/llms.txt
- https://docs.ravn.exchange/llms-full.txt

### Docs index (Mintlify markdown sources)
- [Introduction](https://docs.ravn.exchange/introduction.md): Integrator API overview
- [How it works](https://docs.ravn.exchange/how-it-works.md): Parallel quoting across venues
- [Use cases](https://docs.ravn.exchange/use-cases.md): What teams build on RAVN
- [Supported chains and venues](https://docs.ravn.exchange/supported.md): Chains and routing venues
- [Security model](https://docs.ravn.exchange/security.md): Settlement and custody model
- [FAQ](https://docs.ravn.exchange/faq.md): Common integrator questions
- [Quickstart](https://docs.ravn.exchange/quickstart.md): End-to-end swap flow
- [Authentication](https://docs.ravn.exchange/authentication.md): API keys, fees, rate limits
- [Execution types](https://docs.ravn.exchange/execution-types.md): TRANSACTION / SIGNATURE / DEPOSIT
- [Pricing](https://docs.ravn.exchange/pricing.md): Route-based fees
- [Errors](https://docs.ravn.exchange/errors.md): Machine-readable error codes
- [API overview](https://docs.ravn.exchange/api-reference/overview.md)
- [POST /quote](https://docs.ravn.exchange/api-reference/quote.md)
- [POST /execute](https://docs.ravn.exchange/api-reference/execute.md)
- [POST /submit-signature](https://docs.ravn.exchange/api-reference/submit-signature.md)
- [GET /status](https://docs.ravn.exchange/api-reference/status.md)
- [GET /tokens/resolve](https://docs.ravn.exchange/api-reference/tokens.md)
- [GET /health](https://docs.ravn.exchange/api-reference/health.md)

## Marketing site pages
- [Homepage](https://ravn.exchange/): Product overview
- [How it works](https://ravn.exchange/how-it-works): Routing and best-execution architecture
- [For integrators](https://ravn.exchange/for-integrators): API map and docs links
- [Blog](https://ravn.exchange/blog): Guides on native BTC ↔ SOL / EVM / stables, best execution, and venue rails
- [How to swap BTC to SOL](https://ravn.exchange/blog/swap-btc-to-sol): Native Bitcoin to canonical Solana SOL
- [How to swap SOL to BTC](https://ravn.exchange/blog/swap-sol-to-btc): Solana to native Bitcoin
- [How to swap BTC to ETH without wrapping](https://ravn.exchange/blog/swap-btc-to-eth): Native BTC to canonical ETH
- [How to swap BTC ↔ USDC](https://ravn.exchange/blog/swap-btc-usdc): Bitcoin and USDC both directions
- [Native BTC swaps without wrapping](https://ravn.exchange/blog/native-btc-swaps-without-wrapping): Real Bitcoin vs wBTC/cbBTC, canonical delivery
- [Best execution is not the best headline rate](https://ravn.exchange/blog/best-execution-not-headline-rate): Net-of-gas ranking, slippage floors, gasless RFQ
- [Garden Finance on RAVN](https://ravn.exchange/blog/garden-finance-native-btc-htlc): HTLC native BTC venue, firm solver quotes
- [Relay on RAVN](https://ravn.exchange/blog/relay-multi-chain-native-btc): Multi-chain relayer and native BTC
- [NEAR Intents on RAVN](https://ravn.exchange/blog/near-intents-any-to-any): Any-to-any deposit intents
- [Jupiter Ultra on RAVN](https://ravn.exchange/blog/jupiter-ultra-solana-routing): Solana best-path routing
- [Across on RAVN](https://ravn.exchange/blog/across-intent-cross-chain): Intent-based cross-chain settlement
- [Mayan Swift on RAVN](https://ravn.exchange/blog/mayan-swift-cross-chain): Cross-chain intent auction
- [RFQ gasless on RAVN](https://ravn.exchange/blog/rfq-gasless-0x-bebop-cow): 0x Gasless, Bebop, CoW
- [Security](https://ravn.exchange/security): Settlement model
- [FAQ](https://ravn.exchange/faq): Product FAQ
- [App](https://app.ravn.exchange): Beta swap app
- [Docs](https://docs.ravn.exchange): Integrator documentation

## Status
RAVN is live in beta as of mid-2026.

## Contact
- Email: team@ravn.exchange
- X (product): https://x.com/ravnexchange
- X (founder): https://x.com/0xMuninn