{"slug":"app-ravn-exchange-api-v1-x402-quote-eb43c8","title":"RAVN — best-price swap quotes across 20 execution venues and 17 chains, includin","host":"app.ravn.exchange","method":"POST","resource":"https://app.ravn.exchange/api/v1/x402/quote","category":"code","description":"RAVN — best-price swap quotes across 20 execution venues and 17 chains, including native (non-wrapped) Bitcoin as either source or destination. 0% protocol fee, non-custodial. Returns a quoteToken; pass it to POST /execute.","price_listed":0.001,"price_asked":0.001,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1602,"reported_calls_30d":11,"reported_payers_30d":5,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"inputAmount":"1000000000000000000","inputChainId":1,"inputToken":"0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE","outputChainId":8453,"outputToken":"0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE","userAddress":"0x0000000000000000000000000000000000dEaD"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"destinationAddress":{"description":"Where output should land. Required at quote time for a real (executable) quote from Relay (Bitcoin as source or dest), THORChain (Bitcoin either direction), Across (Solana-touching), Eco (cross-ecosystem), or compose (2-hop). Omit it there and you get a preview (QuoteDTO.executable=false).","type":"string"},"excludeVenues":{"description":"Drop specific venues from this race — e.g. a risk objection to one of them. Naming a venue that was never eligible for this pair is a no-op, not an error.","items":{"enum":["rift","0x_gasless","0x_swap","0x_solana","bebop","cow","across","relay","mayan","jupiter","near_intents","garden","chainflip","thorchain","eco","compose","nordstern","flytrade","kyberswap","layerswap"],"type":"string"},"type":"array"},"inputAmount":{"description":"Positive integer string, in the input token's smallest unit","type":"string"},"inputChainId":{"enum":[1,10,56,130,137,324,480,999,143,8453,42161,59144,43114,4663,4217,-1,-2],"type":"number"},"inputToken":{"description":"Token contract address, or the native-token sentinel 0xEeee...EEeE","minLength":1,"type":"string"},"outputChainId":{"enum":[1,10,56,130,137,324,480,999,143,8453,42161,59144,43114,4663,4217,-1,-2],"type":"number"},"outputToken":{"minLength":1,"type":"string"},"quoteSessionId":{"maxLength":64,"type":"string"},"rankingMode":{"description":"Defaults to best_output.","enum":["best_output","fastest"],"type":"string"},"refundAddress":{"description":"Where to refund the input asset if the swap fails. For a Bitcoin-source Relay quote specifically, this must be supplied here, at quote time — Relay has no execute-time re-bind, so omitting it returns a priced-but-unexecutable preview and supplying it later on execute has no effect. Other BTC-source venues (Garden, THORChain, Chainflip, Rift) support binding this at execute time instead.","type":"string"},"sandbox":{"description":"Test the full quote -> execute -> status flow with no real funds and no live venue settlement. The quote itself is still priced live. On /v1/execute, THORChain BTC-source and Chainflip are unsupported (both can incur a real on-chain cost that can't be sandboxed) and every other venue returns realistically-shaped execution data with no funds moved. /v1/submit-signature skips the real venue submission. /v1/status always reports an immediate synthetic success. Sandbox swaps are never metered or billed.","type":"boolean"},"slippageBps":{"maximum":5000,"minimum":1,"type":"integer"},"userAddress":{"minLength":1,"type":"string"}},"required":["inputChainId","outputChainId","inputToken","outputToken","inputAmount","userAddress"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.001,"price_match":true,"latency_ms":1602,"error":null}],"description_full":"RAVN — best-price swap quotes across 20 execution venues and 17 chains, including native (non-wrapped) Bitcoin as either source or destination. 0% protocol fee, non-custodial. Returns a quoteToken; pass it to POST /execute.","last_updated":"2026-09-24T07:37:01.885Z","schemes":["exact"]}