Skip to main content
POST
/
quotes
Create Quote
curl --request POST \
  --url https://v1.orchestrator.rhinestone.dev/quotes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "destinationChainId": "eip155:42161",
  "tokenRequests": [
    {
      "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "1000000"
    }
  ],
  "account": {
    "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
    "accountType": "GENERIC",
    "setupOps": [
      {
        "to": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "data": "0x..."
      }
    ],
    "mockSignatures": {},
    "delegations": {}
  },
  "destinationExecutions": [
    {
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "value": "0",
      "data": "0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240"
    }
  ],
  "preClaimExecutions": {
    "eip155:8453": [
      {
        "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "value": "0",
        "data": "0x"
      }
    ]
  },
  "destinationGasLimit": "100000",
  "accountAccessList": {
    "chainIds": [
      "eip155:42161"
    ],
    "tokens": [
      "<string>"
    ],
    "chainTokens": {},
    "chainTokenAmounts": {},
    "exclude": {
      "chainIds": [
        "eip155:42161"
      ],
      "tokens": [
        "<string>"
      ],
      "chainTokens": {}
    }
  },
  "options": {
    "settlementLayers": [
      "ECO"
    ],
    "sponsorSettings": {
      "gas": true,
      "bridgeFees": true,
      "swapFees": true
    },
    "feeToken": "USDC"
  }
}
'
{
  "routes": [
    {
      "intentId": "<string>",
      "expiresAt": 1733493192,
      "estimatedFillTime": {
        "seconds": 3
      },
      "settlementLayer": "RELAY",
      "signData": {
        "origin": [
          {
            "domain": {
              "name": "<string>",
              "version": "<string>",
              "chainId": "eip155:42161",
              "verifyingContract": "<string>",
              "salt": "<string>"
            },
            "types": {},
            "primaryType": "PermitBatchWitnessTransferFrom",
            "message": {}
          }
        ],
        "destination": {
          "domain": {
            "name": "<string>",
            "version": "<string>",
            "chainId": "eip155:42161",
            "verifyingContract": "<string>",
            "salt": "<string>"
          },
          "types": {},
          "primaryType": "PermitBatchWitnessTransferFrom",
          "message": {}
        },
        "targetExecution": {
          "domain": {
            "name": "<string>",
            "version": "<string>",
            "chainId": "eip155:42161",
            "verifyingContract": "<string>",
            "salt": "<string>"
          },
          "types": {},
          "primaryType": "PermitBatchWitnessTransferFrom",
          "message": {}
        }
      },
      "cost": {
        "input": [
          {
            "chainId": "eip155:42161",
            "tokenAddress": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
            "symbol": "USDC",
            "decimals": 6,
            "price": {
              "usd": 1
            },
            "amount": "1050000"
          }
        ],
        "output": [
          {
            "chainId": "eip155:42161",
            "tokenAddress": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
            "symbol": "USDC",
            "decimals": 6,
            "price": {
              "usd": 1
            },
            "amount": "1050000"
          }
        ],
        "fees": {
          "total": {
            "usd": 0.029
          },
          "breakdown": {
            "gas": {
              "usd": 0.029
            },
            "bridge": {
              "usd": 0.029
            },
            "protocol": {
              "usd": 0.029
            },
            "swap": {
              "usd": 0.029
            },
            "settlement": {
              "usd": 0.029
            }
          }
        }
      },
      "tokenRequirements": {},
      "bridgeFill": {
        "destinationChainId": "eip155:42161",
        "type": "OFT"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rhinestone.dev/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
x-api-key
string
required

Rhinestone API key

​
x-api-version
string

API version (YYYY-MM.name). Will become required in a future release.

Pattern: ^\d{4}-\d{2}\.[a-z0-9]+$
Example:

"2026-01.alps"

​
x-feature-flags
string

Body

application/json

Body

​
destinationChainId
string
required

The ID of the target blockchain

Pattern: ^eip155:\d+$
Example:

"eip155:42161"

​
tokenRequests
object[]
required

A list of token requested on the target chain

​
account
object
required

Account details

​
destinationExecutions
object[]

Execution calls on the target chain.

​
preClaimExecutions
object

Execution calls to perform before the claim on each origin chain, keyed by chain ID. Max 10 ops per chain, max 5 chains. Object keyed by CAIP-2 chain identifier (e.g. eip155:42161).

Example:
{
  "eip155:8453": [
    {
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "value": "0",
      "data": "0x"
    }
  ]
}
​
destinationGasLimit
string<uint256>

The gas limit for the target chain executions

Example:

"100000"

​
accountAccessList
object

Account access list specifying which chains and tokens an account may access

​
recipient
object
​
options
object

Intent options

Example:
{
  "settlementLayers": ["ECO"],
  "sponsorSettings": {
    "gas": true,
    "bridgeFees": true,
    "swapFees": true
  },
  "feeToken": "USDC"
}

Response

200

Response body for POST /quotes on the blanc API version

​
routes
object[]
required

Pre-ranked route candidates (first entry is the recommended route)