Farcaster user casts

A Farcaster user's recent casts by fid or username, newest first, optionally including replies or limited to one channel. Compact cast shape with reactions, reply count and embed URLs. Use to read what a founder, builder or KOL has been posting, or to build a per-account timeline.

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"
  },
  "fid": 3,
  "includeReplies": false,
  "channel": null,
  "count": 1,
  "casts": [
    {
      "hash": "0xab5aca846db8af6fa3dc2d25dc66171cd040def4",
      "author": {
        "fid": 3,
        "username": "dwr",
        "displayName": "Dan Romero",
        "followerCount": 630338
      },
      "text": "Paid an x402 endpoint for the first time today.",
      "timestamp": "2026-08-22T12:49:27.000Z",
      "channel": null,
      "parentHash": null,
      "reactions": {
        "likes": 4,
        "recasts": 1
      },
      "replies": 2,
      "embeds": [
        "https://example.com/post"
      ],
      "url": "https://warpcast.com/askew-ai/0xab5aca84"
    }
  ],
  "nextCursor": "eyJ0aW1lc3RhbXAiOi..."
}

Try it - see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/fc-user-casts \
  -H "Content-Type: application/json" \
  -d '{"fid":3,"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-user-casts", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "fid": 3,
    "limit": 10
  }),
});

Related tools