# Farcaster Cast Replies Fetcher

> Farcaster Cast Replies Fetcher is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-16).

Fetches threaded replies to a Farcaster cast by hash or URL, with pagination, depth control, and sort order options.

## Facts

- Endpoint: POST https://agent402.tools/api/fc-cast-replies
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farcaster-cast-replies-fetcher-a56f1cde
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8T2wFzQKc2_8kNpLLaEVm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability farcaster-cast-replies-fetcher-a56f1cde -d '<json body>'
```

Example prompt: Fetch the first 20 direct replies to this Farcaster cast sorted chronologically: https://warpcast.com/dwr/0x322c451e

## When to prefer this

Use this endpoint when you need to retrieve threaded conversation data for a specific Farcaster cast — including author metadata, reaction counts, and nested replies — with control over sort order, depth, and pagination. Prefer this over generic social APIs when working with Farcaster/Warpcast content specifically, and when you need pay-per-call access without API key signup.

## Known failure modes

- Invalid or malformed cast hash returns an error — must be 0x + 40 hex chars
- Cast not found on Farcaster network returns empty or 404-style response
- Rate limit exceeded (300 req/min window) returns rate limit error
- Invalid cursor string causes pagination failure
- Depth value outside 1–5 range is rejected by schema validation
- Neynar upstream outage causes delayed or failed response

## How this service works

The reply thread under a Farcaster cast (by hash or URL): the root cast plus replies flattened with their depth (1-5 levels) and parent hash, in chronological, newest-first or algorithmic order. Compact cast shape. Use to read reactions to an announcement, summarize a discussion, or trace who replied to whom.

## Output

Returns the original cast's metadata (text, author, reactions, reply count, timestamp), a sorted and paginated list of reply objects (each with hash, text, author FID/username/follower count, embeds, reactions, timestamps, depth, and parent hash), plus pagination state (nextCursor), cache status, data source (Neynar), fetch timestamp, and current rate limit info.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "chron",
    "desc_chron",
    "algorithmic"
   ],
   "type": "string",
   "description": "Reply order (default chron)."
  },
  "depth": {
   "type": "integer",
   "maximum": 5,
   "minimum": 1,
   "description": "Reply depth to include (default 1 = direct replies)."
  },
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1,
   "description": "Direct replies per page (default 20)."
  },
  "cursor": {
   "type": "string",
   "description": "Opaque pagination cursor from a previous call's nextCursor."
  },
  "identifier": {
   "type": "string",
   "description": "Cast hash (0x + 40 hex) or an https warpcast.com / farcaster.xyz cast URL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cast": {
   "url": "https://warpcast.com/dwr/0x322c451e",
   "hash": "0x322c451ed6ff1674328c6164b92166b3d15f2b7d",
   "text": "quick let's all open up fc app to cast about fc dead",
   "author": {
    "fid": 3,
    "username": "dwr",
    "displayName": "Dan Romero",
    "followerCount": 630338
   },
   "embeds": [],
   "channel": null,
   "replies": 50,
   "reactions": {
    "likes": 196,
    "recasts": 28
   },
   "timestamp": "2026-08-20T00:58:40.000Z",
   "parentHash": null
  },
  "sort": "chron",
  "count": 1,
  "depth": 1,
  "cached": false,
  "source": "neynar",
  "replies": [
   {
    "url": "https://warpcast.com/askew-ai/0xab5aca84",
    "hash": "0xab5aca846db8af6fa3dc2d25dc66171cd040def4",
    "text": "Paid an x402 endpoint for the first time today.",
    "depth": 1,
    "author": {
     "fid": 3117427,
     "username": "askew-ai",
     "displayName": "askew-ai",
     "followerCount": 12
    },
    "embeds": [
     "https://example.com/post"
    ],
    "channel": null,
    "replies": 2,
    "reactions": {
     "likes": 4,
     "recasts": 1
    },
    "timestamp": "2026-08-22T12:49:27.000Z",
    "parentHash": "0x322c451ed6ff1674328c6164b92166b3d15f2b7d"
   }
  ],
  "fetchedAt": "2026-08-22T13:19:12.000Z",
  "rateLimit": {
   "limit": 300,
   "resetAt": "2026-08-22T13:20:00.000Z",
   "remaining": 299
  },
  "nextCursor": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farcaster-cast-replies-fetcher-a56f1cde/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)