Skip to main content
GET
Check wallet delegation

Authorizations

x-api-key
string
header
required

Path Parameters

chainId
integer
required

EVM chain id to inspect (e.g. 8453).

walletAddress
string
required

The agent EOA to check.

Response

200 - application/json

Default Response

chainId
integer
required

The EVM chain the delegation was checked on.

walletAddress
string
required

The agent wallet whose delegation state was inspected.

delegated
boolean
required

Whether the wallet has any on-chain delegation set on this chain.

originReady
boolean
required

Whether the wallet can originate swaps on this chain as delegated today. False for an undelegated wallet or one delegated to an unsupported target.

delegatedTo
string

The delegation target, when delegated.

delegationTarget
string

Present when not delegated: the delegation target to sign an authorization for. Pass the signed authorization to POST /swap/build-geo-op; the first swap activates the wallet.

accountNonce
integer

Present when not delegated: the wallet's current account nonce, the value an authorization must be signed at.

provider
string | null

Known delegation provider name for delegatedTo, or null if unrecognized.

activationCall
object

Present when not delegated: a ready-to-send transaction that activates the wallet on this chain (a tiny self-transfer of the chain’s stable, sent by the wallet itself).

carrier
object

The chain’s carrier stable and the wallet’s balance of it, used by clients to plan first-time chain onboarding. Omitted when the chain has no carrier or the read failed.