History

Get your own fee event history (tenant-bound)

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.

get/agents/history

Request

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

Query parameters

agentAddressstring

Optional. Must equal the wallet bound to your API key; any other value is rejected with 403 cross_tenant_denied.

limitinteger
offsetinteger

Pagination offset (capped at 10,000 for DoS protection)

metrics'true'

Return aggregate revenue metrics (own wallet only) instead of events

Headers

X-ClawHub-Skillstring
Example:farmdash-signal-architect

ClawHub skill attribution. An installed FarmDash skill sends its canonical skill slug (e.g. farmdash-signal-architect) on every FarmDash API request so anonymous Scout usage can be attributed to the skill that drove it. Optional and analytics-only: absence never blocks a request, and malformed values are ignored. This is a skill identity, never a wallet address, API key, or user ID.

Response

History events or aggregate metrics

OR

Changes

No recorded changes to this operation across all 1 revision of this API.