---
title: "Find active session for an agent"
method: GET
path: "/v1/agent/session"
tags: ["Session"]
---

# Find active session for an agent

`GET /v1/agent/session`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/session`
- Auth: HTTP bearer

## Query parameters

- `agentAddress` string, required

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Session lookup result

- object
  - `ok` boolean
  - `session` AgentSession
    - `id` string
    - `agentAddress` string
    - `status` 'active' | 'paused' | 'halted' | 'expired'
    - `delegation` DelegationRecord
      - `ownerAddress` string
      - `apiWalletAddress` string
      - `verified` boolean
      - `verifiedAt` string, date-time, nullable
    - `autopilot` AutopilotConfig
      - `strategies` string[]
      - `assets` string[]
      - `maxEquityPct` number
      - `rebalanceIntervalMin` integer
      - `autoCompound` boolean
      - `riskPreference` 'conservative' | 'balanced' | 'aggressive'
      - `riskSentinel` RiskSentinelConfig
        - `minHealthFactor` number
        - `minLiquidationBufferPct` number
        - `maxStablecoinDepegPct` number
      - `executionAlpha` ExecutionAlphaConfig
        - `mevSafetyMode` 'strict' | 'balanced'
        - `maxQuoteDecayBps` number
        - `maxGasUsdPerAction` number
        - `requirePositiveNetEdge` boolean
        - `minNetEdgeUsd` number
    - `activePositions` TrackedPosition[]
      - `coin` string
      - `side` 'long' | 'short'
      - `entryPrice` number
      - `size` number
      - `leverage` number
      - `stopLoss` number, nullable
      - `takeProfit` number, nullable
      - `openedAt` string, date-time
      - `strategy` string
      - `unrealizedPnl` number
    - `sessionPnl` number
    - `peakEquity` number
    - `tradeCount` integer
    - `lastHeartbeat` string, date-time
    - `createdAt` string, date-time
    - `expiresAt` string, date-time
    - `agentMeta` AgentMeta
      - `name` string
      - `version` string
      - `framework` string
      - `capabilities` string[]

## Other responses

- `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)