Agent Wallets

Delegate trading access without transferring account ownership

Agent Wallets let you delegate trading permissions on a Perpetuals account to another wallet without giving up ownership of the account itself. This is useful for bots, automation, or managing permissions across an organization, while keeping a primary wallet as the account's admin.

How it works

Each Perpetuals account is controlled by an admin capability. With Agent Wallets, the admin wallet can grant an assistant-level permissions to a second wallet (the agent). The agent wallet can then execute supported trading actions on behalf of that account. The agent is able to perform all actions except for withdrawing collateral and granting of or revoking other agent wallets.

Why use Agent Wallets

• Run automated strategies from a dedicated wallet

• Separate signing keys for risk management

• Keep long-term treasury/admin wallet isolated from execution

• Revoke permissions instantly if needed

We recommend to always use an agent wallet for any type of automation (i.e., do not reuse your treasury/admin wallet).

Grant an Agent Wallet

To grant an agent wallet, submit a transaction from the account admin wallet and specify:

• The accountId

• The recipient wallet address that should receive agent permissions

After confirmation, that recipient wallet can trade on the account within assistant-level permissions.

Revoke an Agent Wallet

To revoke an agent wallet, submit a transaction from the account admin wallet and specify:

• The accountId

• The accountCapId of the assistant capability to revoke After confirmation, the revoked wallet immediately loses its delegated permissions.

API Endpoints

For programmatic integrations, use:

• POST /api/perpetuals/account/transactions/grant-agent-wallet

• POST /api/perpetuals/account/transactions/revoke-agent-wallet