---
title: "Get Hyperliquid positions and risk state"
method: GET
path: "/v1/agent/futures/account-state"
tags: ["Account"]
---

# Get Hyperliquid positions and risk state

`GET /v1/agent/futures/account-state`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/futures/account-state`
- Auth: one of:
  - HTTP bearer
  - none

Returns the agent's current positions, margin summary, equity,
liquidation prices, and risk management state. Daily/weekly values are
conservative loss-pressure metrics (rolling closed PnL minus absolute
fill fees plus funding and negative current unrealized PnL only), not
full period returns.
Read-only lookup — no private key required.

## Query parameters

- `agentAddress` string, required

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Account state with risk info

- AccountStateResponse
  - `ok` boolean
  - `account` AccountSummary
    - `equity` string
    - `totalNotionalPosition` string
    - `marginUsed` string
    - `availableMargin` string
    - `aggregateLeverage` string
  - `positions` FuturesPosition[]
    - `coin` string
    - `size` number
    - `side` 'long' | 'short'
    - `entryPrice` number
    - `markPrice` number
    - `unrealizedPnl` number
    - `returnOnEquity` number
    - `leverage` number
    - `leverageType` string
    - `liquidationPrice` number, nullable
    - `marginUsed` number
  - `risk` RiskState
    - `dailyPnl` string
    - `dailyPnlPct` string
    - `weeklyPnl` string
    - `realizedDailyPnl` string
    - `realizedWeeklyPnl` string
    - `unrealizedPnl` string
    - `pnlSource` 'hyperliquid_venue_loss_pressure'
    - `pnlAsOf` integer
    - `pnlMethodology` string
    - `drawdown` string
    - `peakEquity` string
    - `isTradingHalted` boolean
    - `haltReason` string, nullable
    - `isReducedSize` boolean
    - `openPositionCount` integer
  - `guardrails` Guardrails
    - `maxLeverage` integer
    - `maxRiskPerTrade` string
    - `maxPositions` integer
    - `dailyLossLimit` string
    - `weeklyLossLimit` string
    - `maxDrawdown` string
  - `timestamp` integer
  - `warnings` DustStormWarning[]
    - `kind` 'dust_storm', required
    - `message` string, required

## Other responses

- `400`: Invalid parameters
- `402`: Free-tier limit exceeded — x402 payment required

---

[API](https://skmtc.dev/farmdash/apis/farmdash-agent-api.md) · [All operations](https://skmtc.dev/farmdash/apis/farmdash-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/farmdash/apis/farmdash-agent-api/revisions/96310281f58c?raw)