RAVN

Admitted input schema

{
  "type": "object",
  "properties": {
    "destinationAddress": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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)."
    },
    "excludeVenues": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 4096,
        "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"
        ]
      },
      "minItems": 0,
      "maxItems": 100,
      "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."
    },
    "inputAmount": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Positive integer string, in the input token's smallest unit"
    },
    "inputChainId": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "enum": [
        1,
        10,
        56,
        130,
        137,
        324,
        480,
        999,
        143,
        8453,
        42161,
        59144,
        43114,
        4663,
        4217,
        -1,
        -2
      ]
    },
    "inputToken": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Token contract address, or the native-token sentinel 0xEeee...EEeE"
    },
    "outputChainId": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "enum": [
        1,
        10,
        56,
        130,
        137,
        324,
        480,
        999,
        143,
        8453,
        42161,
        59144,
        43114,
        4663,
        4217,
        -1,
        -2
      ]
    },
    "outputToken": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    },
    "quoteSessionId": {
      "type": "string",
      "minLength": 0,
      "maxLength": 64
    },
    "rankingMode": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "best_output",
        "fastest"
      ],
      "description": "Defaults to best_output."
    },
    "refundAddress": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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."
    },
    "sandbox": {
      "type": "boolean",
      "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."
    },
    "slippageBps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000
    },
    "userAddress": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    }
  },
  "required": [
    "inputChainId",
    "outputChainId",
    "inputToken",
    "outputToken",
    "inputAmount",
    "userAddress"
  ],
  "additionalProperties": false
}