---
title: "Get protocol distribution by chain"
method: GET
path: "/v1/agent/chain-breakdown"
tags: ["Intelligence"]
---

# Get protocol distribution by chain

`GET /v1/agent/chain-breakdown`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/chain-breakdown`
- Auth: one of:
  - HTTP bearer
  - none

Aggregates the protocol directory by blockchain network.
Returns per-chain protocol counts, confirmed airdrops, points programs,
and category coverage.

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Chain breakdown

- ChainBreakdownResponse
  - `tier` 'scout' | 'pioneer' | 'syndicate', required
  - `status` string
  - `message` string
  - `direct_upgrade_url` string, uri
  - `data` object, required
    - `chains` ChainBreakdownItem[]
      - `chain` string
      - `protocol_count` union
        - integer
        - string
      - `pct_of_total` union
        - number
        - string
      - `confirmed_airdrops` union
        - integer
        - string
      - `points_programs` union
        - integer
        - string
      - `categories` string[]
    - `summary` ChainBreakdownSummary
      - `total_chains` integer
      - `total_protocols` union
        - integer
        - string
      - `dominant_chain` string, nullable
      - `dominant_chain_pct` union
        - number
        - string

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