Superform Agentic Access
Superform exposes 66 API operations that an AI agent could call, of which 8 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.
By consequence: 58 read, 4 write, and 4 physical.
Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.
By consequence
Highest-consequence actions
The physical and safety-critical operations an agent could invoke — the ones that most warrant scoped tokens, tight TTLs, and escalation. Full per-operation contracts are in the source below.
| Method | Path | Consequence | Human-in-loop |
|---|---|---|---|
| POST | /deposit/calculate | physical | conditional |
| POST | /deposit/start | physical | conditional |
| POST | /withdraw/calculate | physical | conditional |
| POST | /withdraw/start | physical | conditional |
Source
Agentic Access
generated: '2026-07-21'
method: generated
source: openapi/superform-openapi-original.json
description: Recommended x-agentic-access execution contracts, classified heuristically from
the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind
audience per deployment. See research/curity/agentic-governance/.
summary:
operations: 66
by_action_class:
connected: 58
acting: 8
by_consequence:
read: 58
physical: 4
write: 4
human_in_the_loop_required: 0
operations:
- path: /
method: get
operationId: health-check
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /address/type/{address}
method: get
operationId: address-type
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /checks/address/vault
method: get
operationId: vault-type
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /deployment
method: get
operationId: deployment-details
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /deposit/calculate
method: post
operationId: deposit-calculate
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /deposit/start
method: post
operationId: deposit-start
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /explorer/galxe/blast/{user}
method: get
operationId: user-blast-galxe-eligibility
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /explorer/galxe/crossChainTransaction/{user}
method: get
operationId: user-cross-chain-galxe-eligibility
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /explorer/galxe/multiVault/{user}
method: get
operationId: user-multi-vault-galxe-eligibility
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /explorer/galxe/sameChainTransaction/{user}
method: get
operationId: user-same-chain-galxe-eligibility
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /explorer/transactionAmount/{txHash}
method: get
operationId: get-transaction-amount
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /health/db
method: get
operationId: health-check-db
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /health/debank
method: get
operationId: health-check-debank
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /health/ipfs
method: get
operationId: health-check-ipfs
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /health/llama
method: get
operationId: health-check-llama
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /health/rpc
method: get
operationId: health-check-rpc
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /health/socket
method: get
operationId: health-check-socket
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /health/subgraph
method: get
operationId: health-check-subgraph
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /migrate/start
method: post
operationId: migrate-transaction
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /migrate/user-vault-shares/{user_address}
method: get
operationId: migrate-user-balances
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /protocol/{id}
method: get
operationId: get-protocol
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /protocol/{id}/stats
method: get
operationId: protocol-stats
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /protocolRewards/claim/{chain_id}/{user}
method: get
operationId: claim-rewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /protocolRewards/claimable/{user}
method: get
operationId: get-claimable-rewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /protocolRewards/earning/{user}
method: get
operationId: get-user-earning-rewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /protocolRewards/userBalance/historical/vault/{vault_id}
method: get
operationId: vault-user-historic-balances
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /protocolRewards/userBalance/historical/{protocol_id}
method: get
operationId: protocol-user-historic-balances
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /protocols
method: get
operationId: get-protocols-all
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /rebalancing/calculate
method: post
operationId: rebalancing-calculate
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /rebalancing/start
method: post
operationId: rebalancing-start
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /rewards/leaderboard
method: get
operationId: get-season-3-rewards-leaderboard-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /rewards/opportunities
method: get
operationId: get-season-3-rewards-opportunities-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /rewards/referrals/code
method: get
operationId: get-season-3-referral-code-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /rewards/referrals/redeem
method: get
operationId: redeem-season-3-referral-code-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /rewards/sources/{user_address}
method: get
operationId: get-season-3-rewards-sources-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /rewards/summary/{user_address}
method: get
operationId: get-season-3-rewards-summary-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /simulator/superform/{superform_id}
method: get
operationId: get-simulation
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /stats/superform
method: get
operationId: get-superform-tvl-volume-stats
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /stats/tvl/vault/{vault_id}
method: get
operationId: get-vault-superform-tvl
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /superpositions/{superform_id}/price
method: get
operationId: superposition-price
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /superrewards/exploration/leaderboard/cred/{user}
method: get
operationId: get-relative-cred-leaderboard-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /superrewards/exploration/leaderboard/protocols
method: get
operationId: get-protocol-leaderboard-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /superrewards/exploration/leaderboard/tvl/{user}
method: get
operationId: get-relative-tvl-leaderboard-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /superrewards/exploration/summary
method: get
operationId: get-exploration-dashboard-summary-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /superrewards/exploration/{user}
method: get
operationId: get-exploration-dashboard-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /superrewards/referrals/redeem/{referralCode}
method: get
operationId: redeem-referral-code-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /supported
method: get
operationId: supported
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /supported/chains
method: get
operationId: supported-chains
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /supported/withdrawable-tokens
method: get
operationId: supported-withdrawable-tokens
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /supported/yield-types
method: get
operationId: supported-yield-types
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /token-distribution/balance/{user}
method: get
operationId: get-reward-token-balance
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /token-distribution/claim/{user}
method: get
operationId: start-piggy-token-claim
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /token-distribution/slop-bucket/start/deposit/{user}
method: get
operationId: start-slop-bucket-deposit
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /token-distribution/slop-bucket/start/harvest/{user}
method: get
operationId: start-slop-bucket-claim
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /token-distribution/slop-bucket/start/withdraw/{user}
method: get
operationId: start-slop-bucket-withdraw
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /token-distribution/{user}
method: get
operationId: get-token-distribution
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /token/balances/{address}
method: get
operationId: token-balances
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /token/superpositions/balances/{address}
method: get
operationId: superpositions-balances
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /user/portfolio/{address}
method: get
operationId: user-balances
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /user/referral/code
method: get
operationId: get-referral-code-superrewards
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /vault
method: post
operationId: add-vault
x-agentic-access:
action-class: acting
consequence: write
subject: required
audience: null
token:
max-ttl: 900
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /vault/data/historical/{vaultOrSuperformIDs}
method: get
operationId: get-historical-vault-data
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /vault/{vaultOrSuperformIDOrContractAddress}
method: get
operationId: get-vault-data
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /vaults
method: get
operationId: get-all-vaults
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /withdraw/calculate
method: post
operationId: withdraw-calculate
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /withdraw/start
method: post
operationId: withdraw-start
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required