Farcaster cast volume · FC Cast Metrics

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://agent402.tools/api/fc-cast-metrics", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "interval": "7d",
    "q": "x402"
  }),
});
const data = await res.json();

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

{
  "authorFid": null,
  "bucketCount": 168,
  "buckets": [
    {
      "count": 1,
      "start": "2026-08-15T15:00:00.000Z"
    },
    {
      "count": 7,
      "start": "2026-08-15T16:00:00.000Z"
    }
  ],
  "cached": false,
  "channel": null,
  "fetchedAt": "2026-08-22T13:19:12.000Z",
  "interval": "7d",
  "query": "x402",
  "rateLimit": {
    "limit": 300,
    "remaining": 299,
    "resetAt": "2026-08-22T13:20:00.000Z"
  },
  "resolutionSeconds": 3600,
  "source": "neynar",
  "total": 42
}