Skip to main content
Base URL: https://app.ravn.exchange/api/v1 Prefer to import this into Postman, Insomnia, or an agent framework’s tool loader? Full spec at /openapi.json.

POST /quote

Best-priced route + an opaque quoteToken.

POST /execute

Turn a quoteToken into an execution payload.

POST /submit-signature

Submit a signed order for SIGNATURE venues.

GET /status

Normalized swap status.

GET /tokens/resolve

Resolve any token address to metadata.

GET /tokens/btc-coverage

Which tokens actually route from native BTC.

GET /health

Per-venue liveness.

​
Conventions

  • Envelope: { data, meta } on success, { error: { code, message, details? }, meta } on failure.
  • Headers: every response carries x-request-id and ravn-version.
  • Amounts: strings, in the token’s smallest unit.
  • Native coin: the sentinel 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (Solana native SOL: mint So1111…1112).

​
Chain IDs