# RAVN

> RAVN integrator API: cross-chain swaps for native Bitcoin, EVM, and Solana. Parallel venue routing for best execution. Non-custodial. Always the canonical asset.

- [RAVN Integrator API](https://docs.ravn.exchange/introduction.md): One integration to swap any asset across any chain. EVM, Solana, and native Bitcoin.
- [How It Works](https://docs.ravn.exchange/how-it-works.md): One quote across every venue, delivered as the canonical asset.
- [Use Cases](https://docs.ravn.exchange/use-cases.md): What teams build on RAVN.
- [Supported Chains & Venues](https://docs.ravn.exchange/supported.md): Every chain RAVN swaps across, and the venues it routes through.
- [Security Model](https://docs.ravn.exchange/security.md): Non-custodial by design. You always receive the real token, never a wrapped copy.
- [FAQ](https://docs.ravn.exchange/faq.md): Common questions about the RAVN Integrator API.
- [Quickstart](https://docs.ravn.exchange/quickstart.md): Swap 1 ETH to SOL end to end.
- [Sandbox Mode](https://docs.ravn.exchange/sandbox-mode.md): Test the full quote to execute to status flow with no real funds and no live venue settlement.
- [Authentication](https://docs.ravn.exchange/authentication.md): API keys, fees, and rate limits.
- [Pricing](https://docs.ravn.exchange/pricing.md): Retail stays 0 bps. Integrators can set their own swap fee and get paid their share automatically.
- [Settlement Webhooks](https://docs.ravn.exchange/webhooks.md): Get pushed a notification when a swap reaches a terminal state, on top of polling /status.
- [Get an API key](https://docs.ravn.exchange/tools/get-api-key.md): Instant, no review. 4x your rate limit and put your project on the map.
- [Execution Types](https://docs.ravn.exchange/execution-types.md): The one field your integration branches on.
- [Overview](https://docs.ravn.exchange/api-reference/overview.md): The RAVN Integrator API surface.
- [POST & PATCH /v1/keys](https://docs.ravn.exchange/api-reference/keys.md): Create a self-serve API key, then set your own swap fee, payout addresses, and settlement webhook.
- [POST /quote](https://docs.ravn.exchange/api-reference/quote.md): Get the best-priced route for a swap.
- [POST /execute](https://docs.ravn.exchange/api-reference/execute.md): Turn a quote into an actionable execution payload.
- [POST /submit-signature](https://docs.ravn.exchange/api-reference/submit-signature.md): Submit a signed order for SIGNATURE venues.
- [GET /status](https://docs.ravn.exchange/api-reference/status.md): Normalized swap status.
- [GET /chains](https://docs.ravn.exchange/api-reference/chains.md): Every chain RAVN lists a token registry for.
- [GET /tokens](https://docs.ravn.exchange/api-reference/tokens-list.md): RAVN's own listed token registry for a chain.
- [GET /tokens/resolve](https://docs.ravn.exchange/api-reference/tokens.md): Resolve any token address to metadata.
- [GET /tokens/btc-coverage](https://docs.ravn.exchange/api-reference/btc-coverage.md): Which tokens on a chain actually route from native Bitcoin.
- [GET /health](https://docs.ravn.exchange/api-reference/health.md): Per-venue liveness.
- [OpenAPI spec](https://docs.ravn.exchange/api-reference/openapi.md): Machine-readable spec for every endpoint above, importable into Postman, Insomnia, or any agent framework's tool loader.
- [Errors](https://docs.ravn.exchange/errors.md): Predictable, machine-readable error codes.
- [SDKs & Widget](https://docs.ravn.exchange/sdks/overview.md): Four ways to integrate beyond raw HTTP, from a typed client to a drop-in widget.
- [@ravnexchange/sdk](https://docs.ravn.exchange/sdks/core.md): Typed client for /api/v1, quote, execute, submit-signature, and status.
- [ravnexchange (Python)](https://docs.ravn.exchange/sdks/python.md): Typed Python client for /api/v1, quote, execute, submit-signature, status, tokens, and chains.
- [@ravnexchange/react](https://docs.ravn.exchange/sdks/react.md): Hooks for dapps building their own swap UI on top of @ravnexchange/sdk.
- [Embedding the widget](https://docs.ravn.exchange/sdks/widget.md): Drop-in swap UI in an iframe, using the wallet your page already has connected.
- [Theming the widget](https://docs.ravn.exchange/sdks/widget-theming.md): Match the embedded widget's colors, corner radius, and font to your product, no CSS, previewed live in the Playground.
- [AI Agents](https://docs.ravn.exchange/ai-agents/overview.md): Three ways for an AI agent to swap through RAVN: a free MCP server, pay-per-call x402 endpoints, or the plain REST API.
- [MCP Server](https://docs.ravn.exchange/ai-agents/mcp-server.md): Connect Claude, Cursor, or any MCP client to RAVN's quote/execute/status loop, free, no API key required.
- [x402 Payments](https://docs.ravn.exchange/ai-agents/x402-payments.md): Pay-per-call access to RAVN's quote and execute endpoints, no API key, no signup, priced in USDC.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.