Agent402 / tools / fc-trending

Farcaster trending channels

$0.004 per call · USDC via x402 · POST /api/fc-trending

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.

TRY IN PLAYGROUND →

Input

FieldTypeDescription
timeWindowstringRanking window (default 1d).
limitintegerResults per page (default 10).
cursorstringOpaque 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/extract

Extract 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/meta

Fetch page metadata for a URL: title, description, OpenGraph, Twitter cards, canonical URL, favicon.

try in playground →

Browser render

$0.02 · POST /api/render

Render a page in a real headless Chromium browser (JavaScript executed), then extract the main content as clean markdown…

try in playground →