# Agent402 Farcaster Trending Channels

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

Returns trending Farcaster channels ranked by cast activity over a configurable time window (1d, 7d, or 30d), sourced from Neynar.

## Facts

- Endpoint: POST https://agent402.tools/api/fc-trending
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-farcaster-trending-channels-68f8366c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__Rp_bJ0X37uVYXQZXWwUw

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-trending-channels-68f8366c -d '<json body>'
```

Example prompt: Show me the top 10 trending Farcaster channels over the last 7 days — I want to see cast counts, follower numbers, and who leads each channel.

## When to prefer this

Use this endpoint when you need real-time trending Farcaster channel data ranked by cast activity, especially for social analytics dashboards, community discovery features, or onchain social monitoring. Prefer it over static channel lists or manual Warpcast browsing when you need programmatic, paginated access with configurable time windows. It is purpose-built for agents operating in the Farcaster/web3 social ecosystem via x402 pay-per-call with no API key required.

## Known failure modes

- Invalid timeWindow enum value returns validation error
- limit outside 1–25 range returns 422
- Malformed or expired cursor may return empty results or error
- Neynar upstream outage may cause 502 or stale cached response
- Insufficient USDC balance for x402 micropayment blocks the call

## How this service works

Trending Farcaster channels ranked by casting activity over 1d, 7d or 30d, with cast counts for all three windows, follower and member counts, and the channel lead. Cached 60 s. Use to spot where attention is moving on Farcaster right now, then pull the feed with fc-channel-feed.

## Output

A JSON object containing an array of trending Farcaster channel objects, each with channel ID, name, Warpcast URL, image URL, cast counts broken down by 1d/7d/30d windows, member count, follower count, lead user profile, moderator FIDs, creation date, description, and public casting status. Also includes pagination cursor (nextCursor), total count, the active time window, fetch timestamp, and rate limit metadata (limit, remaining, resetAt).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 25,
   "minimum": 1,
   "description": "Results per page (default 10)."
  },
  "cursor": {
   "type": "string",
   "description": "Opaque pagination cursor from a previous call's nextCursor."
  },
  "timeWindow": {
   "enum": [
    "1d",
    "7d",
    "30d"
   ],
   "type": "string",
   "description": "Ranking window (default 1d)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "cached": false,
  "source": "neynar",
  "channels": [
   {
    "id": "base",
    "url": "https://warpcast.com/~/channel/base",
    "lead": {
     "fid": 12142,
     "username": "base.base.eth",
     "displayName": "Base",
     "followerCount": 194536
    },
    "name": "Base",
    "imageUrl": "https://warpcast.com/~/channel-images/base.png",
    "castCount": {
     "1d": 120,
     "7d": 800,
     "30d": 3100
    },
    "createdAt": "2023-08-17T19:23:11.150Z",
    "parentUrl": "https://onchainsummer.xyz",
    "description": "Bringing the world onchain - a community of builders on Base",
    "memberCount": 813,
    "followerCount": 481202,
    "moderatorFids": [
     12142,
     15211,
     99
    ],
    "publicCasting": false,
    "pinnedCastHash": null
   }
  ],
  "fetchedAt": "2026-08-22T13:19:12.000Z",
  "rateLimit": {
   "limit": 300,
   "resetAt": "2026-08-22T13:20:00.000Z",
   "remaining": 299
  },
  "nextCursor": "eyJ0aW1lc3RhbXAiOi...",
  "timeWindow": "1d"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-farcaster-trending-channels-68f8366c/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)