# Agent402 Farcaster Channel Feed

> Agent402 Farcaster Channel Feed is a paid API for AI agents from agent402.tools, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Fetches a paginated feed of recent casts (posts) from one or more Farcaster channels, with options to include or exclude recasts and replies

## Facts

- Endpoint: POST https://agent402.tools/api/fc-channel-feed
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-farcaster-channel-feed-75012d0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_itBfOqO509Y54aCmAXaII

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 agent402-farcaster-channel-feed-75012d0d -d '<json body>'
```

Example prompt: Pull the latest 50 casts from the 'base' Farcaster channel, including recasts but not replies, and show me the author usernames, text, and engagement counts.

## When to prefer this

Choose this endpoint when you need structured, paginated Farcaster channel feed data with rich engagement metadata (likes, recasts, reply counts) in a single pay-per-call, no-signup call. Prefer it over direct Neynar API access when you want to avoid API key management and pay only for what you use via USDC micropayments. It is especially useful for agents aggregating multiple channels simultaneously (up to 10) or monitoring decentralized social activity in the Web3/crypto community.

## Known failure modes

- Missing both 'channel' and 'channels' fields returns a validation error — exactly one is required
- Invalid or unknown channel ID returns an empty cast array or 404-style error
- Expired or malformed pagination cursor returns an error or restarts from the beginning
- Requesting more than 100 results per page is rejected by schema validation
- Rate limit exhausted — rateLimit.remaining reaches 0 before resetAt, subsequent calls fail until reset
- Payment failure (insufficient USDC balance) blocks the call at the x402 layer before the API is reached

## How this service works

Latest casts in one or more Farcaster channels (e.g. base, farcaster, ethereum), newest first, with optional replies. Compact cast shape with author, reactions, reply count and embed URLs. Cached 60 s per identical request. Use to watch a community, sample what builders are posting, or feed a digest.

## Output

Returns a JSON object containing an array of casts (each with URL, hash, text, author details including FID/username/follower count, embeds, channel, reply count, like/recast reactions, and timestamp), total count, pagination cursor for the next page, source attribution (Neynar), fetch timestamp, and rate-limit metadata (limit, remaining, reset time).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Results per page (default 25)."
  },
  "cursor": {
   "type": "string",
   "description": "Opaque pagination cursor from a previous call's nextCursor."
  },
  "channel": {
   "type": "string",
   "description": "Channel id (e.g. base). One of channel/channels required."
  },
  "channels": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 10,
   "description": "Up to 10 channel ids merged into one feed."
  },
  "withRecasts": {
   "type": "boolean",
   "description": "Include recasts (default true)."
  },
  "withReplies": {
   "type": "boolean",
   "description": "Include replies (default false)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "casts": [
   {
    "url": "https://warpcast.com/askew-ai/0xab5aca84",
    "hash": "0xab5aca846db8af6fa3dc2d25dc66171cd040def4",
    "text": "Paid an x402 endpoint for the first time today.",
    "author": {
     "fid": 3117427,
     "username": "askew-ai",
     "displayName": "askew-ai",
     "followerCount": 12
    },
    "embeds": [
     "https://example.com/post"
    ],
    "channel": "base",
    "replies": 2,
    "reactions": {
     "likes": 4,
     "recasts": 1
    },
    "timestamp": "2026-08-22T12:49:27.000Z",
    "parentHash": null
   }
  ],
  "count": 1,
  "cached": false,
  "source": "neynar",
  "channels": [
   "base"
  ],
  "fetchedAt": "2026-08-22T13:19:12.000Z",
  "rateLimit": {
   "limit": 300,
   "resetAt": "2026-08-22T13:20:00.000Z",
   "remaining": 299
  },
  "nextCursor": "eyJ0aW1lc3RhbXAiOi...",
  "withRecasts": true,
  "withReplies": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-farcaster-channel-feed-75012d0d/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)