Cross-chain swap API for native Bitcoin, Solana and EVM chains. No API key, no custody.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
For a swap where native BTC is the source, not every token on the destination chain is reachable. Returns which of ravn_tokens's list on `chainId` a BTC venue can actually route to, and how many venues serve each, so you can build a token list that matches what will really quote instead of discovering it one NO_LIQUIDITY at a time. BTC-as-source only — selling a token INTO BTC isn't restricted the same way (nearly any token can be sold into BTC), so this has nothing useful to say about that direction.
The destination chain to check BTC-source coverage on
Your RAVN API key, if you have one — raises your rate limit
For a swap where native BTC is the source, not every token on the destination chain is reachable. Returns which of ravn_tokens's list on `chainId` a BTC venue can actually route to, and how many venues serve each, so you can build a token list that matches what will really quote instead of discovering it one NO_LIQUIDITY at a time. BTC-as-source only — selling a token INTO BTC isn't restricted the same way (nearly any token can be sold into BTC), so this has nothing useful to say about that direction.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Your RAVN API key, if you have one — raises your rate limit |
| chainId* | integer | The destination chain to check BTC-source coverage on |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"chainId"
],
"properties": {
"apiKey": {
"type": "string",
"description": "Your RAVN API key, if you have one — raises your rate limit"
},
"chainId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The destination chain to check BTC-source coverage on"
}
}
}Turns a DEPOSIT-type ravn_execute result (deposit.address + deposit.amount) into a ready-to-sign PSBT, so you don't have to write your own UTXO selection and fee-estimation code. If that result also has a `fee` (an integrator fee RAVN collects beside the deposit), pass its fee.address as feeAddress and fee.amount as feeAmountSats: the PSBT then pays it as a second output of the same transaction, which is the only place RAVN looks for it. Fetches your UTXOs and the current network fee rate from mempool.space (public, no auth). RAVN never sees or touches a private key — sign the returned PSBT with your own wallet and broadcast it yourself. Only one signer is ever needed (unlike PSBT flows that require coordinating signatures across multiple UTXO-holding wallets), because every RAVN BTC-source venue resolves to a plain payment to the deposit address (plus RAVN's fee output, when there is one).
| Argument | Type | Description |
|---|---|---|
| network | string | Defaults to mainnet |
| toAddress* | string | deposit.address from the ravn_execute DEPOSIT result |
| amountSats* | string | deposit.amount from the ravn_execute DEPOSIT result, in satoshis |
| feeAddress | string | fee.address from the ravn_execute DEPOSIT result — REQUIRED whenever that result has a `fee`. RAVN's fee is paid as an extra output of this same transaction; leave it out and the fee is never paid |
| fromAddress* | string | Your Bitcoin address holding the UTXOs to spend — native SegWit (bc1q…) or Taproot (bc1p…) only |
| feeAmountSats | string | fee.amount from the ravn_execute DEPOSIT result, in satoshis — pass together with feeAddress |
| feeRateSatsPerVb | number | Omit to use mempool.space's current halfHourFee estimate |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"fromAddress",
"toAddress",
"amountSats"
],
"properties": {
"network": {
"enum": [
"mainnet",
"testnet"
],
"type": "string",
"description": "Defaults to mainnet"
},
"toAddress": {
"type": "string",
"description": "deposit.address from the ravn_execute DEPOSIT result"
},
"amountSats": {
"type": "string",
"description": "deposit.amount from the ravn_execute DEPOSIT result, in satoshis"
},
"feeAddress": {
"type": "string",
"description": "fee.address from the ravn_execute DEPOSIT result — REQUIRED whenever that result has a `fee`. RAVN's fee is paid as an extra output of this same transaction; leave it out and the fee is never paid"
},
"fromAddress": {
"type": "string",
"description": "Your Bitcoin address holding the UTXOs to spend — native SegWit (bc1q…) or Taproot (bc1p…) only"
},
"feeAmountSats": {
"type": "string",
"description": "fee.amount from the ravn_execute DEPOSIT result, in satoshis — pass together with feeAddress"
},
"feeRateSatsPerVb": {
"type": "number",
"description": "Omit to use mempool.space's current halfHourFee estimate",
"exclusiveMinimum": 0
}
}
}Every chain RAVN lists a token registry for (see ravn_tokens). Static, doesn't change per request, safe to cache instead of hardcoding a chain table.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Your RAVN API key, if you have one — raises your rate limit |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"apiKey": {
"type": "string",
"description": "Your RAVN API key, if you have one — raises your rate limit"
}
}
}Turn a quoteToken from ravn_quote into an execution payload. Returns one of three shapes (executionType): TRANSACTION (sign and broadcast yourself), SIGNATURE (sign, RAVN submits), or DEPOSIT (send the input asset to a given address). RAVN never takes custody of funds — you always sign or send from your own wallet. TRANSACTION and SIGNATURE may also include an `approval` — an ERC-20 approve() you must broadcast and wait to be MINED before the transaction/signature, or it fails (reverts on TRANSACTION; on SIGNATURE the order is accepted and silently never fills). Only present when the sold token needs it — omitted for native-coin sells and already-approved tokens. An `approval.reset` (Ethereum USDT holding a partial allowance) goes first, mined, then the approval. A result with `sandbox: true` is a test: send nothing from it.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Your RAVN API key, if you have one — raises your rate limit |
| quoteToken* | string | The quoteToken returned by ravn_quote |
| refundAddress | string | Late-bound refund recipient if the swap fails, honoured by venues that read one at execution time (Chainflip, Garden, NEAR Intents, Rift). Every other venue, Mayan, Layerswap and RAVN two-hop routes included, fixes the refund address when it prices: one that differs from the refund the quote was priced with is rejected rather than silently ignored. A quote priced without one refunds where it was priced (normally userAddress) at these venues, so a refundAddress here other than userAddress is rejected too, when userAddress is a valid address on the input chain (selling native Bitcoin with no quoted refund, a venue that can execute uses this one). Supply refundAddress on ravn_quote instead |
| destinationAddress | string |
Liveness check across every venue RAVN routes through — call before a swap if you want to know whether a route is degraded ahead of time.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Get a swap quote from RAVN — same-chain or cross-chain, across 18 chains including native (non-wrapped) Bitcoin and Solana as source or destination. Free, no API key or payment required. Returns a quoteToken; pass it to ravn_execute to get a signable/broadcastable execution payload.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Your RAVN API key, if you have one — raises your rate limit |
| timeoutMs | integer | The race's time limit in milliseconds, counted from its start: once it has passed and some venue has priced the swap, slower venues are left out (with none priced yet, the first price ends the wait; a quote with slippage.noMinimum counts only 2000 ms past the limit). Defaults to 6000; a positive integer, clamped to 1000–15000 |
| inputToken* | string | Token contract address, or 0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE for the chain's native coin |
| onlyVenues | array | Race only these venues, e.g. ["bebop"] for an RFQ-only race. Every other venue is left out (including ones RAVN adds later); excludeVenues still applies on top. It covers every venue RAVN routes your funds through: a multi-step route is offered only when its own venue id and every venue in its hops are listed, e.g. ["compose","jupiter","relay"] or ["relay","kyberswap"]. RAVN's stablecoin route also needs 0x_swap beside its hops: it sweeps the leftover. Venues that swap for you may route through other venues of their own choosing, which this can't reach: Layerswap (a Solana token often goes through Jupiter first), Relay, Rift, Across (when it swaps before or after bridging) and Mayan (Jupiter on Solana, other DEXs such as Nordstern on EVM). Same-chain venues only quote same-chain pairs; if none of the named venues can quote you get NO_LIQUIDITY |
Poll the status of a swap by its quoteToken and ref from ravn_execute (statusRef, deposit address, or origin tx hash). Use the quoteToken execute returned — compose rebinds hop 1 onto hop 2's deposit. Status is authoritative where the venue exposes it; a swap the venue can't track reports 'unknown' rather than a guess.
| Argument | Type | Description |
|---|---|---|
| ref* | string | statusRef from ravn_execute when it returned one (always for DEPOSIT and SIGNATURE venues — it is the venue's own tracking key, which is not always the deposit address); otherwise the origin tx hash |
| apiKey | string | Your RAVN API key, if you have one — raises your rate limit |
| txHash | string | The transaction that paid a fee the swap carries, where RAVN can't find it otherwise: a two-hop route's hop-1 tx, or the on-chain transaction that carried an execution's fee.transaction (Rift and private swaps on DEPOSIT; Eco, Layerswap and Mayan routes paying no referrer on TRANSACTION) — on its own, or the batch or relay that included it (not an EIP-5792 batch id or a 4337 userOpHash). Not needed on an Eco or Mayan TRANSACTION with no statusRef when the fee rode in the swap's own transaction and you poll with that hash. Send it on every poll once confirmed; until RAVN can read it, a delivered swap reports 'processing' (up to 15 minutes after execute). Without it nothing is owed on that swap |
| quoteToken* | string | The quoteToken from ravn_quote — the venue is decoded from it |
For a SIGNATURE-type ravn_execute result only: submit the signature(s) you collected (over typedData, and approvalData if present) to actually place the order. RAVN decodes the venue from quoteToken and routes to the right venue-specific submit path — you never touch a per-venue endpoint. Returns a statusRef — pass it to ravn_status as `ref` to poll this swap.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Your RAVN API key, if you have one — raises your rate limit |
| signature* | string | Signature over the typedData from ravn_execute |
| quoteToken* | string | The quoteToken from ravn_quote |
| approvalSignature | string | 0x Gasless only: signature over approvalData, when ravn_execute returned one |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quoteToken",
"signature"
],
"properties": {
"apiKey": {
"type": "string",
"description": "Your RAVN API key, if you have one — raises your rate limit"
},
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]+$",
"description": "Signature over the typedData from ravn_execute"
},
"quoteToken": {
"type": "string",
"description": "The quoteToken from ravn_quote"
},
"approvalSignature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]+$",
"description": "0x Gasless only: signature over approvalData, when ravn_execute returned one"
}
}
}RAVN's own listed token registry for one chain — populate a token picker without hardcoding one. This is "what RAVN knows about and might route", not a per-pair routability guarantee for any specific pair; call ravn_quote to check that.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Your RAVN API key, if you have one — raises your rate limit |
| chainId* | integer | Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"chainId"
],
"properties": {
"apiKey": {
"type": "string",
"description": "Your RAVN API key, if you have one — raises your rate limit"
},
"chainId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status"
}
}
}Resolve an arbitrary token address to its metadata (symbol, name, decimals) via an on-chain read — for a paste-any-address flow, when the token isn't necessarily on ravn_tokens's list.
| Argument | Type | Description |
|---|---|---|
| apiKey | string | Your RAVN API key, if you have one — raises your rate limit |
| address* | string | Token contract address / mint to resolve |
| chainId* | integer | Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"chainId",
"address"
],
"properties": {
"apiKey": {
"type": "string",
"description": "Your RAVN API key, if you have one — raises your rate limit"
},
"address": {
"type": "string",
"description": "Token contract address / mint to resolve"
},
"chainId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status"
}
}
}| Late-bound output recipient, honoured by venues that bind at execution time (Chainflip, Garden, Layerswap, Mayan, NEAR Intents, Rift, RAVN two-hop routes). Every other venue fixes the recipient when it prices: a DIFFERENT address here is rejected rather than silently ignored. Supply destinationAddress on ravn_quote instead, which every venue honours |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quoteToken"
],
"properties": {
"apiKey": {
"type": "string",
"description": "Your RAVN API key, if you have one — raises your rate limit"
},
"quoteToken": {
"type": "string",
"description": "The quoteToken returned by ravn_quote"
},
"refundAddress": {
"type": "string",
"description": "Late-bound refund recipient if the swap fails, honoured by venues that read one at execution time (Chainflip, Garden, NEAR Intents, Rift). Every other venue, Mayan, Layerswap and RAVN two-hop routes included, fixes the refund address when it prices: one that differs from the refund the quote was priced with is rejected rather than silently ignored. A quote priced without one refunds where it was priced (normally userAddress) at these venues, so a refundAddress here other than userAddress is rejected too, when userAddress is a valid address on the input chain (selling native Bitcoin with no quoted refund, a venue that can execute uses this one). Supply refundAddress on ravn_quote instead"
},
"destinationAddress": {
"type": "string",
"description": "Late-bound output recipient, honoured by venues that bind at execution time (Chainflip, Garden, Layerswap, Mayan, NEAR Intents, Rift, RAVN two-hop routes). Every other venue fixes the recipient when it prices: a DIFFERENT address here is rejected rather than silently ignored. Supply destinationAddress on ravn_quote instead, which every venue honours"
}
}
}| inputAmount* | string | Positive integer string, in the input token's smallest unit (no decimals) |
| outputToken* | string | Token contract address, or 0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE for the chain's native coin |
| rankingMode | string | best_output (default) picks the highest net output; fastest picks the quickest-settling quote within slippageBps |
| slippageBps | integer | Max acceptable slippage in basis points. Setting it drops venues that enforce no minimum (today Rift) from the race unless allowNoMinimum is true |
| userAddress* | string | Address the input asset will be sent from |
| confidential | boolean | Settle privately via NEAR Intents' Confidential Intents so the deposit and payout can't be linked on-chain. Through this MCP server only NEAR quotes it (NO_LIQUIDITY if it can't, never a public fallback): RAVN's other private venues aren't offered here — Houdini Swap needs the end user's IP, user-agent and country for its compliance rules, and Hinkal the user's country and two signatures from the paying wallet before it builds, none of which an MCP call carries — use POST /api/v1/quote and /api/v1/execute for them. ~0.3 bps extra on EVM-to-EVM, ~5-8 bps extra when Bitcoin or Solana is a leg, and it can settle slower than a public swap (Bitcoin-source: 13 min public vs 43 min confidential) — read estimatedTimeSeconds before executing |
| inputChainId* | integer | Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status |
| excludeVenues | array | Drop specific venues, e.g. a risk objection to one of them or ravn_health showing it degraded. An excluded venue is used nowhere in the route, including the steps of RAVN's multi-step routes (compose, and relay quotes that carry hops); a multi-step route that needs it isn't offered. Venues that swap for you may route through other venues of their own choosing, which this can't reach: Layerswap (a Solana token often goes through Jupiter first), Relay, Rift, Across (when it swaps before or after bridging) and Mayan (Jupiter on Solana, other DEXs such as Nordstern on EVM). Naming a venue that was never eligible for this pair is a no-op, not an error |
| outputChainId* | integer | Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status |
| refundAddress | string | Where to refund the input asset if the swap fails. Selling native Bitcoin with userAddress set to a Bitcoin address and no refundAddress refunds to userAddress. Well-known sample addresses (e.g. bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh) count as no address: supply the real refund. Otherwise it is required here, at quote time, for a Bitcoin-source Relay or THORChain quote — neither has an execute-time re-bind, so omitting it returns a priced-but-unexecutable preview and supplying it later on ravn_execute is refused. Other BTC-source venues (Garden, Chainflip, Rift, NEAR Intents) support binding this at execute time instead. Validated against the INPUT chain (refunds are paid back on the origin), with the same non-wallet-address check as destinationAddress |
| allowNoMinimum | boolean | Let venues that enforce no minimum (today Rift) race even though slippageBps is set. Their quotes carry slippage.noMinimum true and fill at the venue's own rate: slippageBps does not protect them |
| destinationAddress | string | Where output should land, if different from userAddress. Required here, at quote time, to get an executable quote from Relay (Bitcoin as the source), THORChain (Bitcoin either direction), Across (a Solana-touching route), or Eco (a cross-ecosystem route) — omit it there and you get back a priced-but-unexecutable preview instead (see ravn_quote's executable), not an error. A malformed address, one from the wrong ecosystem, or a known non-wallet address (a RAVN-listed token's mint/contract, this swap's own tokens, the native-coin sentinel, burn addresses, Solana core programs, and via an on-chain lookup a Solana token account or program — the token-account error names the owning wallet, which is the address to use) IS an error here — funds sent there are unrecoverable. Omit the field rather than passing an empty string; an empty string is treated as omitted |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"inputChainId",
"outputChainId",
"inputToken",
"outputToken",
"inputAmount",
"userAddress"
],
"properties": {
"apiKey": {
"type": "string",
"description": "Your RAVN API key, if you have one — raises your rate limit"
},
"timeoutMs": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The race's time limit in milliseconds, counted from its start: once it has passed and some venue has priced the swap, slower venues are left out (with none priced yet, the first price ends the wait; a quote with slippage.noMinimum counts only 2000 ms past the limit). Defaults to 6000; a positive integer, clamped to 1000–15000",
"exclusiveMinimum": 0
},
"inputToken": {
"type": "string",
"description": "Token contract address, or 0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE for the chain's native coin"
},
"onlyVenues": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Race only these venues, e.g. [\"bebop\"] for an RFQ-only race. Every other venue is left out (including ones RAVN adds later); excludeVenues still applies on top. It covers every venue RAVN routes your funds through: a multi-step route is offered only when its own venue id and every venue in its hops are listed, e.g. [\"compose\",\"jupiter\",\"relay\"] or [\"relay\",\"kyberswap\"]. RAVN's stablecoin route also needs 0x_swap beside its hops: it sweeps the leftover. Venues that swap for you may route through other venues of their own choosing, which this can't reach: Layerswap (a Solana token often goes through Jupiter first), Relay, Rift, Across (when it swaps before or after bridging) and Mayan (Jupiter on Solana, other DEXs such as Nordstern on EVM). Same-chain venues only quote same-chain pairs; if none of the named venues can quote you get NO_LIQUIDITY"
},
"inputAmount": {
"type": "string",
"description": "Positive integer string, in the input token's smallest unit (no decimals)"
},
"outputToken": {
"type": "string",
"description": "Token contract address, or 0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE for the chain's native coin"
},
"rankingMode": {
"enum": [
"best_output",
"fastest"
],
"type": "string",
"description": "best_output (default) picks the highest net output; fastest picks the quickest-settling quote within slippageBps"
},
"slippageBps": {
"type": "integer",
"maximum": 5000,
"minimum": 1,
"description": "Max acceptable slippage in basis points. Setting it drops venues that enforce no minimum (today Rift) from the race unless allowNoMinimum is true"
},
"userAddress": {
"type": "string",
"description": "Address the input asset will be sent from"
},
"confidential": {
"type": "boolean",
"description": "Settle privately via NEAR Intents' Confidential Intents so the deposit and payout can't be linked on-chain. Through this MCP server only NEAR quotes it (NO_LIQUIDITY if it can't, never a public fallback): RAVN's other private venues aren't offered here — Houdini Swap needs the end user's IP, user-agent and country for its compliance rules, and Hinkal the user's country and two signatures from the paying wallet before it builds, none of which an MCP call carries — use POST /api/v1/quote and /api/v1/execute for them. ~0.3 bps extra on EVM-to-EVM, ~5-8 bps extra when Bitcoin or Solana is a leg, and it can settle slower than a public swap (Bitcoin-source: 13 min public vs 43 min confidential) — read estimatedTimeSeconds before executing"
},
"inputChainId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status"
},
"excludeVenues": {
"type": "array",
"items": {
"type": "string"
},
"description": "Drop specific venues, e.g. a risk objection to one of them or ravn_health showing it degraded. An excluded venue is used nowhere in the route, including the steps of RAVN's multi-step routes (compose, and relay quotes that carry hops); a multi-step route that needs it isn't offered. Venues that swap for you may route through other venues of their own choosing, which this can't reach: Layerswap (a Solana token often goes through Jupiter first), Relay, Rift, Across (when it swaps before or after bridging) and Mayan (Jupiter on Solana, other DEXs such as Nordstern on EVM). Naming a venue that was never eligible for this pair is a no-op, not an error"
},
"outputChainId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status"
},
"refundAddress": {
"type": "string",
"description": "Where to refund the input asset if the swap fails. Selling native Bitcoin with userAddress set to a Bitcoin address and no refundAddress refunds to userAddress. Well-known sample addresses (e.g. bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh) count as no address: supply the real refund. Otherwise it is required here, at quote time, for a Bitcoin-source Relay or THORChain quote — neither has an execute-time re-bind, so omitting it returns a priced-but-unexecutable preview and supplying it later on ravn_execute is refused. Other BTC-source venues (Garden, Chainflip, Rift, NEAR Intents) support binding this at execute time instead. Validated against the INPUT chain (refunds are paid back on the origin), with the same non-wallet-address check as destinationAddress"
},
"allowNoMinimum": {
"type": "boolean",
"description": "Let venues that enforce no minimum (today Rift) race even though slippageBps is set. Their quotes carry slippage.noMinimum true and fill at the venue's own rate: slippageBps does not protect them"
},
"destinationAddress": {
"type": "string",
"description": "Where output should land, if different from userAddress. Required here, at quote time, to get an executable quote from Relay (Bitcoin as the source), THORChain (Bitcoin either direction), Across (a Solana-touching route), or Eco (a cross-ecosystem route) — omit it there and you get back a priced-but-unexecutable preview instead (see ravn_quote's executable), not an error. A malformed address, one from the wrong ecosystem, or a known non-wallet address (a RAVN-listed token's mint/contract, this swap's own tokens, the native-coin sentinel, burn addresses, Solana core programs, and via an on-chain lookup a Solana token account or program — the token-account error names the owning wallet, which is the address to use) IS an error here — funds sent there are unrecoverable. Omit the field rather than passing an empty string; an empty string is treated as omitted"
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quoteToken",
"ref"
],
"properties": {
"ref": {
"type": "string",
"description": "statusRef from ravn_execute when it returned one (always for DEPOSIT and SIGNATURE venues — it is the venue's own tracking key, which is not always the deposit address); otherwise the origin tx hash"
},
"apiKey": {
"type": "string",
"description": "Your RAVN API key, if you have one — raises your rate limit"
},
"txHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "The transaction that paid a fee the swap carries, where RAVN can't find it otherwise: a two-hop route's hop-1 tx, or the on-chain transaction that carried an execution's fee.transaction (Rift and private swaps on DEPOSIT; Eco, Layerswap and Mayan routes paying no referrer on TRANSACTION) — on its own, or the batch or relay that included it (not an EIP-5792 batch id or a 4337 userOpHash). Not needed on an Eco or Mayan TRANSACTION with no statusRef when the fee rode in the swap's own transaction and you poll with that hash. Send it on every poll once confirmed; until RAVN can read it, a delivered swap reports 'processing' (up to 15 minutes after execute). Without it nothing is owed on that swap"
},
"quoteToken": {
"type": "string",
"description": "The quoteToken from ravn_quote — the venue is decoded from it"
}
}
}