---
title: "Get your own fee event history (tenant-bound)"
method: GET
path: "/agents/history"
tags: ["History"]
---

# Get your own fee event history (tenant-bound)

`GET /agents/history`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/agents/history`
- Auth: HTTP bearer

Returns paginated swap fee events owned by the wallet bound to your
API key. Requires a Pioneer or Syndicate bearer key; anonymous and
scout callers receive 401 authentication_required. The query is
always forced to the authenticated wallet — any `agentAddress` that
differs from it returns 403 cross_tenant_denied.
Use `?metrics=true` for aggregate revenue metrics for your own wallet.
For the public leaderboard view (server-aggregated totals only, no
raw transactions), use GET /v1/agent/leaderboard.

## Query parameters

- `agentAddress` string
- `limit` integer
- `offset` integer
- `metrics` 'true'

## Headers

- `X-ClawHub-Skill` string

## Response `200`

History events or aggregate metrics

- union
  - HistoryResponse
    - `events` FeeEvent[], required
      - `id` string, uuid
      - `created_at` string, date-time
      - `protocol` 'lifi' | 'relay': Swap quote provider. Automatic routing compares all healthy compatible providers (LI.FI, Relay; 0x paused until reinstated); force one with ?protocol= (deterministic, never silent fallback).
      - `from_token` string
      - `to_token` string
      - `volume_usd` number
      - `fee_bps` integer
      - `fee_usd` number
      - `agent_address` string
      - `tx_hash` string, nullable
      - `settlement_status` 'pending' | 'confirmed' | 'expired' | 'legacy'
      - `chain_id` integer
    - `total` integer, required
    - `limit` integer, required
    - `offset` integer, required
  - RevenueMetrics
    - `totalFeeUSD` number, required
    - `totalVolumeUSD` number, required
    - `totalSwaps` integer, required
    - `activeAgents` integer, required

## Other responses

- `401`: Authentication required — bind a Pioneer/Syndicate API key
- `402`: Free-tier limit exceeded — x402 payment required
- `403`: Cross-tenant denial — agentAddress does not match the authenticated wallet
- `429`: Rate limit exceeded

---

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