Get Intent Route

Retrieves the route token transfers and target executions based on the provided user address and intent.

POST /intents/route

Get Intent Route

cURL

curl --request POST \
  --url https://v1.orchestrator.rhinestone.dev/intents/route \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "destinationChainId": 8453,
  "tokenRequests": [
    {
      "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "1000000"
    }
  ],
  "account": {
    "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
    "accountType": "smartAccount",
    "setupOps": [
      {
        "to": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "data": "0x..."
      }
    ],
    "mockSignature": "<string>",
    "delegations": {}
  },
  "destinationExecutions": [
    {
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "value": "0",
      "data": "0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240"
    }
  ],
  "preClaimExecutions": {
    "8453": [
      {
        "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "value": "0",
        "data": "0x"
      }
    ]
  },
  "destinationGasUnits": "100000",
  "accountAccessList": {
    "chainIds": [
      1
    ],
    "tokens": [
      "<string>"
    ],
    "chainTokens": {},
    "exclude": {
      "chainIds": [
        1
      ],
      "tokens": [
        "<string>"
      ],
      "chainTokens": {}
    }
  },
  "options": {
    "topupCompact": true,
    "settlementLayers": [
      "ECO"
    ],
    "sponsorSettings": {
      "gasSponsored": true,
      "bridgeFeesSponsored": true,
      "swapFeesSponsored": true
    },
    "feeToken": "USDC"
  }
}
'

200

{
  "intentOp": {
    "sponsor": "0x8a310b9085faF5d9464D84C3d9a7BE3b28c94531",
    "nonce": "0",
    "expires": "1733493192",
    "elements": [
      {
        "arbiter": "0x8a310b9085faF5d9464D84C3d9a7BE3b28c94531",
        "chainId": "1",
        "idsAndAmounts": [
          [
            "1",
            "1000000"
          ],
          [
            "2",
            "2000000"
          ]
        ],
        "spendTokens": [
          [
            "1",
            "1000000"
          ],
          [
            "2",
            "2000000"
          ]
        ],
        "mandate": {
          "recipient": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
          "tokenOut": [
            [
              "1",
              "1000000"
            ],
            [
              "2",
              "2000000"
            ]
          ],
          "destinationChainId": "8453",
          "fillDeadline": "1733493192",
          "preClaimOps": "<unknown>",
          "destinationOps": "<unknown>",
          "qualifier": {
            "settlementContext": {
              "settlementLayer": "INTENT_EXECUTOR",
              "using7579": true,
              "fundingMethod": "NO_FUNDING",
              "gasRefund": {
                "overhead": 123,
                "exchangeRate": 123,
                "token": "<string>"
              },
              "prefundAmount": 123,
              "bridgeFill": {
                "destinationChainId": 123,
                "type": "OFT"
              }
            },
            "encodedVal": "0x..."
          },
          "minGas": "0",
          "swapDestinations": [
            {
              "tokenIn": "<string>",
              "amountIn": 123,
              "amountOut": 123,
              "slippage": 123,
              "quoter": "<string>",
              "executions": [
                {
                  "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                  "value": "0",
                  "data": "0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240",
                  "senderAddressPlaceholder": "<string>",
                  "recipientAddressPlaceholder": "<string>"
                }
              ],
              "outputDecimals": 123,
              "outputSymbol": "<string>"
            }
          ]
        },
        "swapOrigins": {}
      }
    ],
    "serverSignature": "0x...",
    "signedMetadata": {
      "tokenPrices": {
        "USDC": 1,
        "WETH": 2000
      },
      "gasPrices": {
        "1": "20000000000",
        "10": "1000000000"
      },
      "opGasParams": {
        "10": {
          "l1BaseFee": "100",
          "l1BlobBaseFee": "100",
          "baseFeeScalar": "100",
          "blobFeeScalar": "100"
        }
      },
      "account": {
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "accountContext": {},
        "accountType": "smartAccount",
        "setupOps": [
          {
            "to": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
            "data": "0x..."
          }
        ],
        "emissaryConfig": {
          "validatorAddress": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
          "emissaryAddress": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
          "emissaryEnable": {
            "allocatorSig": "0x...",
            "userSig": "0x..."
          },
          "settings": {
            "allocator": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a"
          }
        },
        "mockSignature": "<string>",
        "requiredDelegations": {}
      },
      "schemeId": "v1",
      "recipient": {
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "accountContext": {},
        "accountType": "smartAccount",
        "setupOps": [
          {
            "to": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
            "data": "0x..."
          }
        ],
        "emissaryConfig": {
          "validatorAddress": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
          "emissaryAddress": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
          "emissaryEnable": {
            "allocatorSig": "0x...",
            "userSig": "0x..."
          },
          "settings": {
            "allocator": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a"
          }
        },
        "mockSignature": "<string>",
        "requiredDelegations": {}
      },
      "fees": {
        "sponsorFee": {
          "relayer": 0.0009,
          "protocol": 0
        },
        "protocolFees": {
          "0x0000000000000000000000000000000000000000": "1000000"
        }
      },
      "executionTokensReceived": [
        "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      ],
      "preClaimExecutions": {}
    },
    "targetExecutionNonce": "0",
    "signedAuthorizations": [
      {
        "chainId": 8453,
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "nonce": "0",
        "yParity": 27,
        "r": "0x...",
        "s": "0x..."
      }
    ],
    "recipientSignedAuthorizations": [
      {
        "chainId": 8453,
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "nonce": "0",
        "yParity": 27,
        "r": "0x...",
        "s": "0x..."
      }
    ]
  },
  "intentCost": {
    "hasFulfilledAll": true,
    "tokensSpent": {},
    "tokensReceived": [
      {
        "tokenAddress": "<string>",
        "amountSpent": 123,
        "targetAmount": 123,
        "fee": 123,
        "feeBreakdown": {
          "gasFee": "5000",
          "bridgeFee": "2000",
          "protocolFee": "0",
          "swapFee": "50000",
          "settlementFee": "1000"
        },
        "feesByToken": {
          "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913": {
            "amount": "19989",
            "breakdown": {
              "gasFee": "19987",
              "bridgeFee": "0",
              "protocolFee": "0",
              "swapFee": "0",
              "settlementFee": "2"
            }
          }
        },
        "hasFulfilled": true
      }
    ],
    "sponsorFee": {
      "relayer": 0.0009,
      "protocol": 0
    },
    "gasCost": {
      "originChains": [
        {
          "chainId": 8453,
          "gasUSD": 1.2
        }
      ],
      "destination": {
        "chainId": 8453,
        "gasUSD": 1.2
      },
      "totalUSD": 4.15
    },
    "feeBreakdownUSD": {
      "gasFeeUSD": 0.029,
      "bridgeFeeUSD": 0.000015,
      "protocolFeeUSD": 0,
      "swapFeeUSD": 0,
      "settlementFeeUSD": 0.000002,
      "totalFeeUSD": 0.029017
    }
  },
  "tokenRequirements": {}
}

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 · number · required

The ID of the target blockchain

Required range: x >= 0

Example:

8453

tokenRequests · object[] · required

A list of token requested on the target chain

Option 1

Option 2

Show child attributes

account · object · required

Account details

Show child attributes

destinationExecutions · object[]

Execution calls on the target chain.

Show child attributes

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.

Show child attributes

Example:

{
  "8453": [
    {
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "value": "0",
      "data": "0x"
    }
  ]
}

destinationGasUnits · integer<int64>

The gas limit for the target chain executions

Example:

"100000"

accountAccessList · object

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

object

object[]

Show child attributes

recipient · object

Account details

Show child attributes

options · object

Intent options

Show child attributes

Example:

{
  "topupCompact": true,
  "settlementLayers": ["ECO"],
  "sponsorSettings": {
    "gasSponsored": true,
    "bridgeFeesSponsored": true,
    "swapFeesSponsored": true
  },
  "feeToken": "USDC"
}

Response

200

application/json

200

Successfully retrieved the route

intentOp · object · required

The order bundle containing multi-chain execution details with pricing metadata

Show child attributes

intentCost · object · required

Option 1

Option 2

Show child attributes

tokenRequirements · object

Token requirements for the intent to pass. For EOAs only.

Show child attributes