{"uid":"cap__Rp_bJ0X37uVYXQZXWwUw","slug":"agent402-farcaster-trending-channels-68f8366c","name":"Agent402 Farcaster Trending Channels","description":"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.","url":"https://agent402.tools/api/fc-trending","method":"POST","headers":{},"bodySchema":{"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)."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wxXVF4cT3TiD75GuJLOLw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns trending Farcaster channels ranked by cast activity over a configurable time window (1d, 7d, or 30d), sourced from Neynar.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Daily onchain social briefing","prompt":"What are the top 5 trending Farcaster channels from the past 24 hours? Give me their names, cast counts, and follower totals."},{"title":"Weekly community growth report","prompt":"Fetch the 25 most active Farcaster channels over the last 7 days so I can track which communities are growing fastest week over week."},{"title":"Monthly channel landscape analysis","prompt":"Pull the top 20 trending Farcaster channels for the past 30 days — I want to compare their cast volumes and member counts to understand the broader ecosystem."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:50:28.027Z","isFirstParty":false}