---
title: "Public leaderboard — server-aggregated per-agent totals"
method: GET
path: "/v1/agent/leaderboard"
tags: ["History"]
---

# Public leaderboard — server-aggregated per-agent totals

`GET /v1/agent/leaderboard`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/leaderboard`
- Auth: none declared

Per-agent aggregate totals (volume, fees, swap count) ranked by
volume, top 50. Computed server-side over fee_events; returns
aggregates ONLY — no raw transactions, tx hashes, or per-event
timestamps. No API key required beyond rate-limiting tiers.

## Query parameters

- `limit` integer

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Aggregated leaderboard entries

- LeaderboardResponse
  - `ok` boolean, required
  - `source` string, required: Always 'fee_events_aggregated' — aggregates only, never raw events
  - `windowDays` integer, nullable
  - `entries` object[], required
    - `address` string, required
    - `totalVolumeUSD` number, required
    - `totalFeeUSD` number, required
    - `swapCount` integer, required

## Other responses

- `402`: Free-tier limit exceeded — x402 payment required
- `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)