Execute API

Look up an address

Get the intent behind an executable address.

GEThttps://api.execute.cash/v1/address/{address}Public

Wallets and apps call this with an address a user is about to pay, recompute the address from the intent, and show what paying it will do.

Path

addressaddress: The executable address: 0x and 40 hex characters, in any case.
Example0x3a9012C8bbDA720CE9C94458f8753965dFB6455a

Response

The same body Create an address returned: address, factory, intent and terms.

200 OK

{
  "address": "0x3a9012C8bbDA720CE9C94458f8753965dFB6455a",
  "factory": "0x6D85B9706D8f076cB8A9fEA37d70Fcb8D22C2952",
  "intent": {
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000000000",
    "calls": [
      {
        "target": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "function": "approve(address spender, uint256 amount)",
        "args": [
          "0xbeef0e0834849aCC03f0089F01f4F1Eeb06873C9",
          "1000000000"
        ]
      },
      {
        "target": "0xbeef0e0834849aCC03f0089F01f4F1Eeb06873C9",
        "function": "deposit(uint256 assets, address receiver)",
        "args": [
          "1000000000",
          "0xc80d2a01247aD9e11D1Ab45B5AcE404B416aF086"
        ]
      }
    ],
    "expirationTimestamp": 1790671800,
    "recovery": "0xc80d2a01247aD9e11D1Ab45B5AcE404B416aF086",
    "salt": "0x4b7ef6dd50ef7570851a0abfbf121fa35edfcdd5f83d07e6bc275547447ec004",
    "chainId": 8453
  },
  "terms": "0x000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913…"
}

Why you can trust it

Unforgeable. A wrong intent derives a different address, so the answer can be checked against the address itself. See Verify an executable address.
Immutable. An address’s intent never changes, so responses carry Cache-Control: public, max-age=31536000, immutable, and can be cached and mirrored.
Public. Knowing the address is enough. Its intent goes onchain anyway, in the execution’s calldata.

Errors

Status	Code	When
404	`not_found`	Execute has no intent for this address: an ordinary account, or one made with the contracts directly.
400	`invalid_request`	The path isn’t an address.

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "Execute has no intent for this address",
    "issues": []
  }
}