# Oracle Swarm Vault - Farcaster Graph Analysis

> Oracle Swarm Vault - Farcaster Graph Analysis is a paid API for AI agents from x402.billionaireorder.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Analyzes a Farcaster user by FID to detect bot farms, measure social graph metrics, and return cluster identity for trust assessment.

## Facts

- Endpoint: POST https://x402.billionaireorder.com/v1/farcaster-graph?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oracle-swarm-vault-farcaster-graph-analysis-f447754c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RQI-cQPIsnKIDz2YypEsI

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 oracle-swarm-vault-farcaster-graph-analysis-f447754c -d '<json body>'
```

Example prompt: Check if Farcaster FID 3 is a bot farm and tell me their follower count, following count, and which social cluster they belong to.

## When to prefer this

Choose this endpoint when you need on-chain micropayment-gated (no API key required) Farcaster social graph analysis, specifically for bot/farm detection and cluster classification. It is ideal for agents operating in Web3 environments that already use x402 USDC payments on Base and need to vet Farcaster accounts for airdrops, partnerships, or sybil resistance.

## Known failure modes

- Invalid or non-existent FID returns empty or error response
- Malformed input_data string causes 400-level error
- Insufficient USDC payment via x402 results in 402 Payment Required
- Chain identifier mismatch may cause routing failure
- Rate limits or temporary service unavailability return 5xx errors

## How this service works

M2M: Input fid or wallet. Output followers, following, clusters, funder_address, is_farm via Neynar. For KOL tracking, airdrop sybil filter, copy-trading vetting. Pay-per-call $0.01 USDC Base eip155:8453

## Output

Returns a JSON object with the queried FID, a boolean is_farm flag indicating bot/farm status, follower and following counts, and a cluster_id hex string representing the user's social graph cluster assignment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "input_data"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain eip155:8453"
  },
  "input_data": {
   "type": "string",
   "description": "Wallet address or input data"
  },
  "agent_ref_hash": {
   "type": "string",
   "description": "Agent ref"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fid": 3,
  "is_farm": false,
  "followers": 12000,
  "following": 300,
  "cluster_id": "0x5c..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oracle-swarm-vault-farcaster-graph-analysis-f447754c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.billionaireorder.com](https://www.zero.xyz/host/x402.billionaireorder.com/llms.txt)