RAVN
Cross-chain swap API for native Bitcoin, Solana and EVM chains. No API key, no custody.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~6,562토큰 (도구 정의)
~6.8 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 5.13%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"ravn": {
"url": "https://app.ravn.exchange/api/mcp"
}
}
}원격 엔드포인트
https://app.ravn.exchange/api/mcpstreamable-http할 수 있는 일
도구 목록
도구 (10)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢ravn_quote(inputChainId, outputChainId, inputToken, outputToken, inputAmount, ...)
Get a swap quote from RAVN — same-chain or cross-chain, across 17 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.
입력 스키마
{
"type": "object",
"properties": {
"inputChainId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 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"
},
"outputChainId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 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"
},
"inputToken": {
"type": "string",
"description": "Token contract address, or 0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE for the chain's native coin"
},
"outputToken": {
"type": "string",
"description": "Token contract address, or 0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE for the chain's native coin"
},
"inputAmount": {
"type": "string",
"description": "Positive integer string, in the input token's smallest unit (no decimals)"
},
"userAddress": {
"type": "string",
"description": "Address the input asset will be sent from"
},
"destinationAddress": {
"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": "string"
},
"refundAddress": {
"description": "Where to refund the input asset if the swap fails. 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 has no effect. Other BTC-source venues (Garden, Chainflip, Rift) 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",
"type": "string"
},
"slippageBps": {
"description": "Max acceptable slippage in basis points",
"type": "integer",
"minimum": 1,
"maximum": 5000
},
"rankingMode": {
"description": "best_output (default) picks the highest net output; fastest picks the quickest-settling quote within slippageBps",
"type": "string",
"enum": [
"best_output",
"fastest"
]
},
"excludeVenues": {
"description": "Drop specific venues from this race, e.g. a risk objection to one of them or ravn_health showing it degraded. Naming a venue that was never eligible for this pair is a no-op, not an error",
"type": "array",
"items": {
"type": "string"
}
},
"confidential": {
"description": "Settle privately via NEAR Intents' Confidential Intents so the deposit and payout can't be linked on-chain. Only NEAR quotes it (NO_LIQUIDITY if it can't, never a public fallback). ~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",
"type": "boolean"
},
"apiKey": {
"description": "Your RAVN API key, if you have one — raises your rate limit",
"type": "string"
}
},
"required": [
"inputChainId",
"outputChainId",
"inputToken",
"outputToken",
"inputAmount",
"userAddress"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"quoteToken": {
"type": "string",
"description": "Opaque token — pass to ravn_execute"
},
"venue": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"routeType": {
"type": "string"
},
"input": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"output": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"fee": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"executable": {
"type": "boolean",
"description": "False = preview-only price, priced against a placeholder destination/refund address. ravn_execute will fail with QUOTE_NOT_EXECUTABLE — request a fresh quote with destinationAddress/refundAddress supplied instead"
},
"slippage": {
"anyOf": [
{
"type": "object",
"properties": {
"bps": {
"type": "number"
},
"isFirm": {
"type": "boolean"
},
"guaranteedMin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"bps",
"isFirm",
"guaranteedMin"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Null when the venue reports no slippage bound"
},
"gas": {
"anyOf": [
{
"type": "object",
"properties": {
"native": {
"type": "string"
},
"nativeSymbol": {
"type": "string"
},
"usd": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"estimated": {
"type": "boolean"
}
},
"required": [
"native",
"nativeSymbol",
"usd",
"estimated"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The native gas the user must hold; null on gasless venues"
},
"inputUsd": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "USD value of the input amount, same price source as gas.usd. Null when the token can't be priced"
},
"outputUsd": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "USD value of the output amount. Compare against inputUsd for price impact"
},
"estimatedTimeSeconds": {
"type": "number"
},
"estimatedTimeIsGuess": {
"type": "boolean",
"description": "True when the venue didn't report a time for this quote"
},
"expiresAt": {
"type": "number"
},
"hops": {
"description": "2-hop / dest-call: the venues actually used. Sign hop 1; hop 2 is a unique deposit",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Every other venue that raced and produced a usable quote, best output first. Each has its own quoteToken to pass to ravn_execute instead. Empty when no other venue could serve this pair, or when a route was excluded via excludeVenues"
}
},
"required": [
"quoteToken",
"venue",
"routeType",
"input",
"output",
"fee",
"executable",
"slippage",
"gas",
"inputUsd",
"outputUsd",
"estimatedTimeSeconds",
"estimatedTimeIsGuess",
"expiresAt",
"alternatives"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟡ravn_execute(quoteToken, destinationAddress, refundAddress, apiKey)
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.
입력 스키마
{
"type": "object",
"properties": {
"quoteToken": {
"type": "string",
"description": "The quoteToken returned by ravn_quote"
},
"destinationAddress": {
"description": "Late-bound output recipient, honoured by venues that bind at execution time (Chainflip, Garden, Layerswap, Mayan, NEAR Intents, Rift, 2-hop). 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": "string"
},
"refundAddress": {
"description": "Late-bound refund recipient if the swap fails, honoured by the same venues as destinationAddress. Every other venue fixes the refund address when it prices, and a DIFFERENT one here is rejected rather than silently ignored; supply refundAddress on ravn_quote instead",
"type": "string"
},
"apiKey": {
"description": "Your RAVN API key, if you have one — raises your rate limit",
"type": "string"
}
},
"required": [
"quoteToken"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"executionType": {
"type": "string",
"enum": [
"DEPOSIT",
"TRANSACTION",
"SIGNATURE"
]
},
"approval": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"transaction": {
"description": "TRANSACTION only",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"typedData": {
"description": "SIGNATURE only",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"approvalData": {
"description": "SIGNATURE only, 0x Gasless: a second EIP-712 payload some venues need signed for the approval itself",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"submit": {
"description": "SIGNATURE only: { url, payload? } — POST the signed payload(s) to ravn_status's ref via /api/v1/submit-signature",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"deposit": {
"description": "DEPOSIT only",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"quoteToken": {
"type": "string",
"description": "Pass to ravn_submit_signature and ravn_status. On compose this is the post-bind token from execute, not the original quote token"
},
"statusRef": {
"description": "Poll ravn_status with this. Always set for DEPOSIT and compose; TRANSACTION otherwise uses the origin tx hash",
"type": "string"
}
},
"required": [
"executionType",
"quoteToken"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟡ravn_submit_signature(quoteToken, signature, approvalSignature, apiKey)
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.
입력 스키마
{
"type": "object",
"properties": {
"quoteToken": {
"type": "string",
"description": "The quoteToken from ravn_quote"
},
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]+$",
"description": "Signature over the typedData from ravn_execute"
},
"approvalSignature": {
"description": "0x Gasless only: signature over approvalData, when ravn_execute returned one",
"type": "string",
"pattern": "^0x[0-9a-fA-F]+$"
},
"apiKey": {
"description": "Your RAVN API key, if you have one — raises your rate limit",
"type": "string"
}
},
"required": [
"quoteToken",
"signature"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"statusRef": {
"type": "string",
"description": "Pass to ravn_status as `ref` to poll this swap"
},
"venue": {
"type": "string"
}
},
"required": [
"statusRef",
"venue"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟢ravn_status(quoteToken, ref, apiKey)
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; Jupiter is the one live venue that reports 'unknown' honestly rather than guessing.
입력 스키마
{
"type": "object",
"properties": {
"quoteToken": {
"type": "string",
"description": "The quoteToken from ravn_quote — the venue is decoded from it"
},
"ref": {
"type": "string",
"description": "deposit address (DEPOSIT venues) or statusRef (SIGNATURE venues) from ravn_execute"
},
"apiKey": {
"description": "Your RAVN API key, if you have one — raises your rate limit",
"type": "string"
}
},
"required": [
"quoteToken",
"ref"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"venue": {
"type": "string"
},
"venueStatus": {
"type": "string"
},
"tracking": {
"description": "Present instead of venueStatus when this venue has no live tracker yet",
"type": "string",
"const": "unavailable"
},
"deliveredAmount": {
"description": "Actual delivered output, in the output token's smallest unit, when the venue exposes it",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"txHash": {
"description": "The destination-chain tx that paid the user out, when the venue names one. Only populated once status is terminal (success/refunded/failed), never while still in flight",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"venue"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟢ravn_health
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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"degraded"
]
},
"venues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"healthy": {
"type": "boolean"
}
},
"required": [
"id",
"name",
"healthy"
],
"additionalProperties": false
}
}
},
"required": [
"status",
"venues"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟢ravn_tokens(chainId, apiKey)
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.
입력 스키마
{
"type": "object",
"properties": {
"chainId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 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"
},
"apiKey": {
"description": "Your RAVN API key, if you have one — raises your rate limit",
"type": "string"
}
},
"required": [
"chainId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"name": {
"type": "string"
},
"address": {
"type": "string"
},
"decimals": {
"type": "number"
},
"chainId": {
"type": "number"
},
"isNative": {
"type": "boolean"
},
"logoUrl": {
"type": "string"
}
},
"required": [
"symbol",
"name",
"address",
"decimals",
"chainId",
"isNative"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟢ravn_tokens_resolve(chainId, address, apiKey)
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.
입력 스키마
{
"type": "object",
"properties": {
"chainId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 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"
},
"address": {
"type": "string",
"description": "Token contract address / mint to resolve"
},
"apiKey": {
"description": "Your RAVN API key, if you have one — raises your rate limit",
"type": "string"
}
},
"required": [
"chainId",
"address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"token": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"name": {
"type": "string"
},
"address": {
"type": "string"
},
"decimals": {
"type": "number"
},
"chainId": {
"type": "number"
},
"isNative": {
"type": "boolean"
},
"logoUrl": {
"type": "string"
}
},
"required": [
"symbol",
"name",
"address",
"decimals",
"chainId",
"isNative"
],
"additionalProperties": false
}
},
"required": [
"token"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟢ravn_btc_coverage(chainId, apiKey)
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.
입력 스키마
{
"type": "object",
"properties": {
"chainId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The destination chain to check BTC-source coverage on"
},
"apiKey": {
"description": "Your RAVN API key, if you have one — raises your rate limit",
"type": "string"
}
},
"required": [
"chainId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"chainId": {
"type": "number",
"description": "Echoes the requested chain"
},
"filtered": {
"type": "boolean",
"description": "False means the upstream venue lists couldn't be reached right now — coverage is empty and the answer is unknown, not 'nothing routes'. Treat like an outage: don't filter your token list on it"
},
"coverage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
},
"description": "Lowercased token address to the number of BTC venues (1-3) that route to it from native Bitcoin. Tokens no venue serves are omitted, not listed at 0"
}
},
"required": [
"chainId",
"filtered",
"coverage"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟢ravn_chains(apiKey)
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.
입력 스키마
{
"type": "object",
"properties": {
"apiKey": {
"description": "Your RAVN API key, if you have one — raises your rate limit",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"chainId": {
"type": "number"
},
"name": {
"type": "string"
},
"shortName": {
"type": "string"
},
"nativeCurrency": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"symbol": {
"type": "string"
},
"decimals": {
"type": "number"
}
},
"required": [
"name",
"symbol",
"decimals"
],
"additionalProperties": false
},
"explorerUrl": {
"type": "string"
},
"logoUrl": {
"type": "string"
}
},
"required": [
"chainId",
"name",
"shortName",
"nativeCurrency",
"explorerUrl"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"requestId": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"requestId",
"version"
],
"additionalProperties": false
}
},
"required": [
"error",
"meta"
],
"additionalProperties": false
}
]
}🟢ravn_btc_prepare_send(fromAddress, toAddress, amountSats, feeRateSatsPerVb, network)
Turns a DEPOSIT-type ravn_execute result (depositAddress + depositAmount) into a ready-to-sign PSBT, so you don't have to write your own UTXO selection and fee-estimation code. 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 single-recipient payment.
입력 스키마
{
"type": "object",
"properties": {
"fromAddress": {
"type": "string",
"description": "Your Bitcoin address holding the UTXOs to spend — native SegWit (bc1q…) or Taproot (bc1p…) only"
},
"toAddress": {
"type": "string",
"description": "depositAddress from ravn_execute"
},
"amountSats": {
"type": "string",
"description": "depositAmount from ravn_execute, in satoshis"
},
"feeRateSatsPerVb": {
"description": "Omit to use mempool.space's current halfHourFee estimate",
"type": "number",
"exclusiveMinimum": 0
},
"network": {
"description": "Defaults to mainnet",
"type": "string",
"enum": [
"mainnet",
"testnet"
]
}
},
"required": [
"fromAddress",
"toAddress",
"amountSats"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"psbtBase64": {
"type": "string"
},
"inputCount": {
"type": "number"
},
"totalInputSats": {
"type": "string"
},
"feeRateSatsPerVb": {
"type": "number"
},
"estimatedFeeSats": {
"type": "string"
},
"changeSats": {
"type": "string"
}
},
"required": [
"psbtBase64",
"inputCount",
"totalInputSats",
"feeRateSatsPerVb",
"estimatedFeeSats",
"changeSats"
],
"additionalProperties": false
}
]
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 10개
검증됨버전이 기록되지 않음도구 10개