# Agent402 Farcaster Cast Lookup

> Agent402 Farcaster Cast Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Fetch full metadata for a Farcaster cast by hash or Warpcast URL, including author, engagement stats, embeds, and channel.

## Facts

- Endpoint: POST https://agent402.tools/api/fc-cast
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-farcaster-cast-lookup-3ec23663
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EU4F9RWuhd7WLcbSuHyWb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-farcaster-cast-lookup-3ec23663 -d '<json body>'
```

Example prompt: Can you pull up the details for this Farcaster cast — https://warpcast.com/dwr/0x322c451e — I want to know the text, how many likes it got, and who posted it.

## When to prefer this

Choose this endpoint when you need to retrieve structured metadata for a specific Farcaster cast by its hash or Warpcast/Farcaster URL, without needing a Neynar API key or any signup — payment is per-call via USDC over x402. Prefer this over direct Neynar API calls when operating as an autonomous agent with a wallet identity, or when you need a frictionless, keyless lookup for one-off or low-volume cast resolution tasks.

## Known failure modes

- Invalid or malformed cast hash returns an error — hash must be 0x followed by 40 hex characters
- Cast not found on Farcaster returns a null or error response
- Rate limit exhausted — the rateLimit.remaining field will show 0 and resetAt indicates when quota refreshes
- Malformed Warpcast URL that doesn't resolve to a valid cast will fail to fetch
- Upstream Neynar API outage may cause fetch failures or delayed responses

## How this service works

Fetch one Farcaster cast by hash or warpcast.com / farcaster.xyz URL. Returns the compact cast: author (fid, username, follower count), text, timestamp, channel, parent hash, likes, recasts, reply count, embed URLs. Use to resolve a shared link, verify a quote, or enrich a cast hash from another tool.

## Output

Returns a JSON object containing the cast's full text, URL, hash, author details (FID, username, display name, follower count), embed list, channel, reply/like/recast counts, timestamp, parent hash, and whether the result was served from cache. Also includes rate limit info and the upstream data source (Neynar).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "identifier": {
   "type": "string",
   "description": "Cast hash (0x + 40 hex) or an https warpcast.com / farcaster.xyz cast URL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cast": {
   "url": "https://warpcast.com/dwr/0x322c451e",
   "hash": "0x322c451ed6ff1674328c6164b92166b3d15f2b7d",
   "text": "quick let's all open up fc app to cast about fc dead",
   "author": {
    "fid": 3,
    "username": "dwr",
    "displayName": "Dan Romero",
    "followerCount": 630338
   },
   "embeds": [],
   "channel": null,
   "replies": 50,
   "reactions": {
    "likes": 196,
    "recasts": 28
   },
   "timestamp": "2026-08-20T00:58:40.000Z",
   "parentHash": null
  },
  "cached": false,
  "source": "neynar",
  "fetchedAt": "2026-08-22T13:19:12.000Z",
  "rateLimit": {
   "limit": 300,
   "resetAt": "2026-08-22T13:20:00.000Z",
   "remaining": 299
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-farcaster-cast-lookup-3ec23663/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)