---
title: "Get catalog protocol directory (discovery heuristic scores)"
method: GET
path: "/v1/agent/protocols"
tags: ["Intelligence"]
---

# Get catalog protocol directory (discovery heuristic scores)

`GET /v1/agent/protocols`

## Request

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

Returns the curated FarmDash protocol catalog with EDITORIAL discovery
heuristic scores. These are NOT live Trail Heat: values derive from
static catalog TVL strings, status labels and hand-curated flags
(methodology catalog-editorial-v1). The canonical quantitative Trail
Scout tier: top 3 spotlight protocols with 100% unmasked quantitative scores (30 req/day).
Pioneer/Syndicate: full dataset for the current FarmDash protocol registry (81 protocols at this build).

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Protocol dataset

- ProtocolsResponse
  - `tier` 'scout' | 'pioneer' | 'syndicate', required
  - `count` integer, required
  - `data` ProtocolItem[], required
    - `protocol_name` string
    - `discovery_heuristic_score` union: Catalog editorial heuristic (methodology catalog-editorial-v1). NOT live Trail Heat — canonical quantitative scores live at /v1/trail-heat.
      - number
      - string: Encrypted for scout tier
    - `discovery_methodology` string
    - `sybil_risk` string
    - `tvl` string
    - `category` 'Perps' | 'Lending' | 'Dex' | 'L2' | 'Bridge' | 'Restaking' | 'HyperEVM' | 'Infra' | 'Wallet' | 'Testnet'
    - `status` 'Confirmed Airdrop' | 'Points Program' | 'Speculative'
    - `chains` string[]
    - `recommended_agent_deploy_link` string, uri
  - `status` string
  - `message` string
  - `direct_upgrade_url` string, uri
  - `total_protocols_available` integer

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