Skip to main content
GET
/
api
/
v2
/
perp
/
account
GET /api/v2/perp/account — Account state (balances, margin)
curl --request GET \
  --url https://api.shuriken.trade/api/v2/perp/account \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "accountValue": "<string>",
    "spotBalances": [
      {
        "coin": "<string>",
        "hold": "<string>",
        "total": "<string>"
      }
    ],
    "withdrawable": "<string>"
  },
  "requestId": "<string>",
  "pagination": {
    "hasMore": true,
    "limit": 1,
    "page": 1,
    "total": 1
  }
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <jwt> for user auth or Authorization: Bearer sk_{keyId}_{secret} for API key auth.

Query Parameters

wallet_id
string

Wallet ID (uses default HL wallet if omitted)

Response

200 - application/json

Account state

V2 success response envelope

data
object
required
requestId
string
required
pagination
object

Page-based pagination info (per RFC)