Farcaster cast volume

Cast volume over time for a search query: how many Farcaster casts matched per bucket across the last 1d, 7d, 30d, 90d or 180d (hourly or daily buckets), optionally limited to one author or channel, plus the total. Cached 60 s. Use to chart mention volume for a token, product or event and detect spikes.

TRY IN PLAYGROUND →

Input

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"
  },
  "query": "x402",
  "interval": "7d",
  "authorFid": null,
  "channel": null,
  "resolutionSeconds": 3600,
  "total": 42,
  "bucketCount": 168,
  "buckets": [
    {
      "start": "2026-08-15T15:00:00.000Z",
      "count": 1
    },
    {
      "start": "2026-08-15T16:00:00.000Z",
      "count": 7
    }
  ]
}

Try it - see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/fc-cast-metrics \
  -H "Content-Type: application/json" \
  -d '{"q":"x402","interval":"7d"}'

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-cast-metrics", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "q": "x402",
    "interval": "7d"
  }),
});

Related tools