Farcaster trending channels
$0.004 per call · USDC via x402 ·
POST /api/fc-trendingTrending 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.
Input
| Field | Type | Description |
|---|---|---|
timeWindow | string | Ranking window (default 1d). |
limit | integer | Results per page (default 10). |
cursor | string | Opaque pagination cursor from a previous call's nextCursor. |
Example output
{
"source": "neynar",
"fetchedAt": "2026-08-22T13:19:12.000Z",
"cached": false,
"rateLimit": {
"limit": 300,
"remaining": 299,
"resetAt": "2026-08-22T13:20:00.000Z"
},
"timeWindow": "1d",
"count": 1,
"channels": [
{
"id": "base",
"name": "Base",
"description": "Bringing the world onchain - a community of builders on Base",
"parentUrl": "https://onchainsummer.xyz",
"imageUrl": "https://warpcast.com/~/channel-images/base.png",
"followerCount": 481202,
"memberCount": 813,
"publicCasting": false,
"createdAt": "2023-08-17T19:23:11.150Z",
"lead": {
"fid": 12142,
"username": "base.base.eth",
"displayName": "Base",
"followerCount": 194536
},
"moderatorFids": [
12142,
15211,
99
],
"pinnedCastHash": null,
"url": "https://warpcast.com/~/channel/base",
"castCount": {
"1d": 120,
"7d": 800,
"30d": 3100
}
}
],
"nextCursor": "eyJ0aW1lc3RhbXAiOi..."
}
Try it - see the 402 challenge (free)
curl -i -X POST https://agent402.tools/api/fc-trending \
-H "Content-Type: application/json" \
-d '{"timeWindow":"1d","limit":10}'
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/fc-trending", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"timeWindow": "1d",
"limit": 10
}),
});
Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).
Related tools
Extract article
$0.010 ·
POST /api/extractExtract the main article content from any public URL as clean markdown. Returns title, byline, excerpt, word count, and …
try in playground →Page metadata
$0.002 ·
GET /api/metaFetch page metadata for a URL: title, description, OpenGraph, Twitter cards, canonical URL, favicon.
try in playground →Browser render
$0.02 ·
POST /api/renderRender a page in a real headless Chromium browser (JavaScript executed), then extract the main content as clean markdown…
try in playground →