Intents

Create Intent

Submits a quoted intent for execution. Takes the intentId from POST /quotes (routes[].intentId) plus signatures (origin, destination, optionally target-execution) and optional EIP-7702 authorizations.

post/intent-operations

Headers

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

API version. Required; pinned to this document.

x-api-keystring required

API key.

Request body

Example request

{
  "signedIntentOp": {
    "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"
          }
        ]
      },
      "sponsorSettings": {
        "gas": true
      },
      "executionTokensReceived": [
        "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      ]
    },
    "signedAuthorizations": [
      {
        "chainId": 8453,
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "yParity": 27,
        "r": "0x...",
        "s": "0x..."
      }
    ],
    "recipientSignedAuthorizations": [
      {
        "chainId": 8453,
        "address": "0x579d5631f76126991c00fb8fe5467fa9d49e5f6a",
        "yParity": 27,
        "r": "0x...",
        "s": "0x..."
      }
    ],
    "destinationSignature": "0x...",
    "targetExecutionSignature": "0x...",
    "originSignatures": [
      "0x...",
      "0x..."
    ]
  }
}

Response

Example response

{
  "result": {
    "id": "6288024828617617176235460836311142252483529646664720691654196790232050827264"
  }
}

Changes

Changed in 11 of the 17 revisions of this API.443539

Jun 25, 20263656a04f8c421See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 8, 2026618cc05f65ca1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
Apr 20, 202671e21fa054d511See the full diff
- ▲
  removed subschema #1 subschema #2 from the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-removed
- ○
  added subschema #1 subschema #2 subschema #7 to the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-added
Apr 14, 20260448a66290a81176See the full diff
- ▲
  removed subschema #1 subschema #2 subschema #5 from the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/BNB
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/ETH
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/HYPE
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/MockUSD
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/POL
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/S
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/USDC
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/USDT
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/USDT0
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WBNB
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WETH
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WHYPE
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WPOL
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WS
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WXPL
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/XDAI
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/XPL
  request-property-removed
- ○
  added the new optional header request parameter x-api-version
  new-optional-request-parameter
- ○
  added the new optional request property signedIntentOp/signedMetadata/account/mockSignature
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/signedMetadata/preClaimExecutions
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/signedMetadata/recipient/mockSignature
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/signedMetadata/schemeId
  new-optional-request-property
- ○
  added subschema #1 subschema #2 subschema #5 subschema #6 to the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-added
Mar 9, 20262ac6a126892a615See the full diff
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/BNB
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/HYPE
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/MockUSD
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/WBNB
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/WHYPE
  new-required-request-property
- ▲
  removed subschema #1 subschema #4 subschema #5 subschema #6 from the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-removed
- ●
  removed the request property signedIntentOp/signedMetadata/quotes
  request-property-removed
- ○
  added the new optional request property signedIntentOp/elements/items/mandate/swapDestinations
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/elements/items/swapOrigins
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/targetExecutionNonce
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/targetExecutionSignature
  new-optional-request-property
- ○
  added subschema #1 subschema #4 subschema #5 to the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-added
Feb 20, 2026bba71848b93a192See the full diff
- ▲
  removed subschema #1 from the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-removed
- ●
  removed the request property signedIntentOp/elements/items/mandate/swapDestinations
  request-property-removed
- ●
  removed the request property signedIntentOp/elements/items/swapOrigins
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/BNB
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/HYPE
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/MockUSD
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WBNB
  request-property-removed
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WHYPE
  request-property-removed
- ●
  removed the request property signedIntentOp/targetExecutionNonce
  request-property-removed
- ●
  removed the request property signedIntentOp/targetExecutionSignature
  request-property-removed
- ○
  added the new optional request property signedIntentOp/signedMetadata/quotes
  new-optional-request-property
- ○
  added subschema #1 subschema #6 to the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-added
Feb 17, 2026d812d9a0631e615See the full diff
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/BNB
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/HYPE
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/MockUSD
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/WBNB
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/WHYPE
  new-required-request-property
- ▲
  removed subschema #1 subschema #6 from the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-removed
- ●
  removed the request property signedIntentOp/signedMetadata/quotes
  request-property-removed
- ○
  added the new optional request property signedIntentOp/elements/items/mandate/swapDestinations
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/elements/items/swapOrigins
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/targetExecutionNonce
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/targetExecutionSignature
  new-optional-request-property
- ○
  added subschema #1 to the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-added
Jan 22, 2026bba71848b93a14See the full diff
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/WS
  new-required-request-property
- ○
  added the new optional request property signedIntentOp/signedMetadata/executionTokensReceived
  new-optional-request-property
- ○
  added the new optional request property signedIntentOp/signedMetadata/fees/protocolFees
  new-optional-request-property
- ○
  the allocator request property default value changed from 0x22376d253286450b3622270345cccc564c2a5c9b to 0xc7732071e3a1be6cfce6d13bb05699a31a457679
  request-property-default-value-changed
- ○
  the allocator request property default value changed from 0x22376d253286450b3622270345cccc564c2a5c9b to 0xc7732071e3a1be6cfce6d13bb05699a31a457679
  request-property-default-value-changed
Jan 12, 2026e286a9bef614216See the full diff
- ▲
  removed subschema #1 subschema #5 from the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-removed
- ▲
  the signedIntentOp/originSignatures/items/ request property type/format changed from string/ to /
  request-property-type-changed
- ●
  removed the request property signedIntentOp/elements/items/mandate/v
  request-property-removed
- ○
  the request property signedIntentOp/signedMetadata/quotes became optional
  request-property-became-optional
- ○
  the allocator request property default value changed from 0x1fcaa96c3aa5bbb0af8d89211cc8954c170d5903 to 0x22376d253286450b3622270345cccc564c2a5c9b
  request-property-default-value-changed
- ○
  the allocator request property default value changed from 0x1fcaa96c3aa5bbb0af8d89211cc8954c170d5903 to 0x22376d253286450b3622270345cccc564c2a5c9b
  request-property-default-value-changed
- ○
  added subschema #1 subschema #2 to the signedIntentOp/originSignatures/items/ request property oneOf list
  request-property-one-of-added
- ○
  added subschema #1 subschema #5 subschema #6 to the signedIntentOp/elements/items/mandate/qualifier/settlementContext request property oneOf list
  request-property-one-of-added
- ○
  removed the pattern ^0x[a-fA-F0-9]*$ from the request property signedIntentOp/originSignatures/items/
  request-property-pattern-removed
Dec 10, 20254b8579036470511See the full diff
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/USDT
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/USDT0
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/WXPL
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/XDAI
  new-required-request-property
- ▲
  added the new required request property signedIntentOp/signedMetadata/tokenPrices/XPL
  new-required-request-property
- ●
  removed the request property signedIntentOp/signedMetadata/tokenPrices/WS
  request-property-removed
- ○
  added the new optional request property signedIntentOp/recipientSignedAuthorizations
  new-optional-request-property

Full history (11 revisions)