v1

latestOpenAPI 3.1.02026-07-265385123.6 KB

User

Get delegations

Retrieve active delegations for a specific subaccount. Shows delegated accounts and their associated permissions.

get/api/v1/delegations

Query parameters

subaccountstring required

Subaccount address

Response

Delegations retrieved successfully

delegated_accountstring required

The address of the delegated account

expiration_time_sinteger nullable

The expiration time in seconds (optional, None means no expiration)

permission_marketstring nullable

The market address when permission_type is "TradePerpsOnMarket", null otherwise

permission_typestring required

The permission type that was granted. Market-scoped grants have permission_type "TradePerpsOnMarket" with the market address in permission_market.

Example response

[
  {
    "delegated_account": "0x123...",
    "expiration_time_s": 1736326800000,
    "permission_market": "0x161b7b3f58327d057ee5824de0c1a4fc4fa3d121b847c138e921a255768a0dca",
    "permission_type": "TradePerpsAllMarkets"
  }
]