Skip to main content
Shops every eligible venue and returns the best price plus an opaque quoteToken to pass to /execute.

​
Request

​
inputChainId
integer
required
Origin chain ID.
​
outputChainId
integer
required
Destination chain ID.
​
inputToken
string
required
Contract address / mint, or the native sentinel.
​
outputToken
string
required
Contract address / mint, or the native sentinel.
​
inputAmount
string
required
Positive integer in the token’s smallest unit.
​
userAddress
string
required
The sender’s address.
​
destinationAddress
string
Recipient on the destination chain. Required for cross-ecosystem swaps.
​
refundAddress
string
Where refunds go on failure.
​
slippageBps
integer
1–5000. Omit for the venue default.
curl -s -X POST https://app.ravn.exchange/api/v1/quote \
  -H 'content-type: application/json' -d '{
    "inputChainId": -2, "outputChainId": 1,
    "inputToken": "So11111111111111111111111111111111111111112",
    "outputToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "inputAmount": "100000000000",
    "userAddress": "SoYourUser",
    "destinationAddress": "0xYourUser"
  }'

​
Response

​
quoteToken
string
Opaque handle — pass to /execute verbatim. Do not parse. Expires.
​
venue
object
{ id, name } of the winning venue.
​
routeType
string
e.g. CROSS_ECOSYSTEM, EVM_CROSS_CHAIN.
​
input
object
{ token, amount }.
​
output
object
{ token, amount } — the expected output.
​
fee
object
{ bps, amount, token } — the applied integrator fee.
​
slippage
object
{ bps, isFirm, guaranteedMin } or null.
​
gas
object
Native gas the user must hold, or null (gasless).
​
estimatedTimeSeconds
integer
​
expiresAt
integer
Epoch ms when the quote expires.
{
  "data": {
    "quoteToken": "…opaque…",
    "venue": { "id": "near_intents", "name": "NEAR Intents" },
    "routeType": "CROSS_ECOSYSTEM",
    "input":  { "token": { }, "amount": "100000000000" },
    "output": { "token": { }, "amount": "18985000" },
    "fee":    { "bps": 25, "amount": "47462", "token": { } },
    "estimatedTimeSeconds": 42,
    "expiresAt": 1750000000000
  }
}
Returns 404 NO_LIQUIDITY when no venue can serve the pair/amount.