Sign in

v17

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-2580373.5 KB
Quotes

Create Quote

Computes a quote for an intent: token transfers, target executions, and cost breakdown. Returns a pre-ranked routes[] with per-route intentId to pass to POST /intents for execution.

post/intents/route

Headers

x-api-version'2026-01.alps' required

API version. Required; pinned to this document.

x-api-keystring required

API key.

Request body

destinationChainIdnumber required

The ID of the target blockchain

preClaimExecutionsobject

Execution calls to perform before the claim on each origin chain, keyed by chain ID. Max 10 ops per chain, max 5 chains.

destinationGasLimitstring uint256

The gas limit for the target chain executions

Example request

{
  "destinationChainId": 8453,
  "tokenRequests": [
    {
      "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "1000000",
      "balance": "spot"
    }
  ],
  "account": {
    "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
    "setupOps": [
      {
        "to": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "data": "0x..."
      }
    ]
  },
  "destinationExecutions": [
    {
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "value": "0",
      "data": "0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240"
    }
  ],
  "preClaimExecutions": {
    "8453": [
      {
        "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "value": "0",
        "data": "0x"
      }
    ]
  },
  "destinationGasLimit": "100000",
  "recipient": {
    "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
    "setupOps": [
      {
        "to": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "data": "0x..."
      }
    ]
  },
  "options": {
    "settlementLayers": {
      "include": [
        "ECO"
      ]
    },
    "sponsorSettings": {
      "gas": true,
      "bridgeFees": true,
      "swapFees": true
    },
    "feeToken": "USDC"
  }
}

Response

OK

tokenRequirementsobject

Pre-flight token operations the user must perform before submitting this route (approvals, wrapping). Emitted for EOA accounts only.

Example response

{
  "intentOp": {
    "sponsor": "0x8a310b9085faF5d9464D84C3d9a7BE3b28c94531",
    "nonce": "0",
    "targetExecutionNonce": "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": {
            "vt": "0x0101000000000000000000000000000000000000000000000000000000000000",
            "ops": [
              {
                "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "value": "0",
                "data": "0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240"
              }
            ]
          },
          "destinationOps": {
            "vt": "0x0101000000000000000000000000000000000000000000000000000000000000",
            "ops": [
              {
                "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "value": "0",
                "data": "0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240"
              }
            ]
          },
          "qualifier": {
            "settlementContext": {
              "settlementLayer": "INTENT_EXECUTOR",
              "using7579": true,
              "fundingMethod": "NO_FUNDING"
            },
            "encodedVal": "0x..."
          },
          "minGas": "0",
          "swapDestinations": [
            {
              "executions": [
                {
                  "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                  "value": "0",
                  "data": "0xa9059cbb000000000000000000000000579d5631f76126991c00fb8fe5467fa9d49e5f6a00000000000000000000000000000000000000000000000000000000000f4240"
                }
              ]
            }
          ]
        }
      }
    ],
    "serverSignature": "0x...",
    "signedMetadata": {
      "strategy": "ACROSS",
      "schemeId": "v1",
      "tokenPrices": {
        "USDC": 1,
        "WETH": 2000
      },
      "gasPrices": {
        "1": "20000000000",
        "10": "1000000000"
      },
      "opGasParams": {
        "10": {
          "l1BaseFee": "100",
          "l1BlobBaseFee": "100",
          "baseFeeScalar": "100",
          "blobFeeScalar": "100"
        }
      },
      "account": {
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "setupOps": [
          {
            "to": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
            "data": "0x..."
          }
        ]
      },
      "recipient": {
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "setupOps": [
          {
            "to": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
            "data": "0x..."
          }
        ]
      },
      "fees": {
        "sponsorFee": {
          "relayer": 0.0009
        },
        "protocolFees": {
          "0x0000000000000000000000000000000000000000": "1000000"
        },
        "appFee": [
          {
            "feeBps": 100,
            "baseAmount": "10000000",
            "amount": "100000",
            "chainId": 42161,
            "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
          }
        ]
      },
      "executionTokensReceived": [
        "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      ]
    },
    "signedAuthorizations": [
      {
        "chainId": 8453,
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "yParity": 27,
        "r": "0x...",
        "s": "0x..."
      }
    ],
    "recipientSignedAuthorizations": [
      {
        "chainId": 8453,
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "yParity": 27,
        "r": "0x...",
        "s": "0x..."
      }
    ]
  },
  "intentCost": {
    "tokensReceived": [
      {
        "feeBreakdown": {
          "gasFee": "5000",
          "bridgeFee": "2000",
          "protocolFee": "0",
          "swapFee": "50000",
          "settlementFee": "1000",
          "appFee": "2500",
          "hyperCoreActivationFee": "1000000"
        },
        "feesByToken": {
          "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913": {
            "amount": "19989",
            "breakdown": {
              "gasFee": "19987",
              "bridgeFee": "0",
              "protocolFee": "0",
              "swapFee": "0",
              "settlementFee": "2",
              "appFee": "0",
              "hyperCoreActivationFee": "0"
            }
          }
        }
      }
    ],
    "sponsorFee": {
      "relayer": 0.0009
    },
    "appFee": [
      {
        "feeBps": 100,
        "baseAmount": "10000000",
        "amount": "100000",
        "chainId": 42161,
        "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
      }
    ],
    "gasCost": {
      "originChains": [
        {
          "chainId": 8453,
          "gasUSD": 1.2
        }
      ],
      "destination": {
        "chainId": 8453,
        "gasUSD": 1.2
      },
      "totalUSD": 4.15
    },
    "feeBreakdownUSD": {
      "gasFeeUSD": 0.029,
      "bridgeFeeUSD": 0.000015,
      "settlementFeeUSD": 0.000002,
      "appFeeUSD": 0.25,
      "totalFeeUSD": 0.029017
    }
  },
  "tokenRequirements": {
    "8453": {
      "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913": {
        "type": "approval",
        "amount": "1000000",
        "spender": "0x000000000022d473030f116ddee9f6b43ac78ba3"
      }
    }
  }
}