Skip to main content
Base URL: https://app.ravn.exchange/api/v1

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 /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

ChainIDChainID
Ethereum1Base8453
Optimism10Arbitrum42161
BNB Chain56Linea59144
Unichain130Avalanche43114
Polygon137Robinhood4663
zkSync324Bitcoin-1
World Chain480Solana-2
HyperEVM999