{"uid":"cap_itBfOqO509Y54aCmAXaII","slug":"agent402-farcaster-channel-feed-75012d0d","name":"Agent402 Farcaster Channel Feed","description":"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.","url":"https://agent402.tools/api/fc-channel-feed","method":"POST","headers":{},"bodySchema":{"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)."}}},"responseSchema":{"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}},"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_CXpimYjr_dp9bpx-aF1ni","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":"Fetches a paginated feed of recent casts (posts) from one or more Farcaster channels, with options to include or exclude recasts and replies","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Monitor Web3 community chatter","prompt":"Show me the last 25 posts from the 'base' and 'ethereum' Farcaster channels combined — skip replies but include recasts — so I can see what the community is talking about right now."},{"title":"Paginate through channel history","prompt":"I already fetched the first page of the 'zora' Farcaster channel — here's my cursor: 'eyJ0aW1lc3RhbXAiOi...'. Grab the next 50 casts for me, replies excluded."},{"title":"Track engagement on niche channel","prompt":"Fetch the 10 most recent casts from the 'degen' Farcaster channel, including replies, and tell me which ones have the most likes and recasts."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:52:59.340Z","isFirstParty":false}