# Farcaster Identity Lookup

> Farcaster Identity Lookup is a paid API for AI agents from meryol-payai.hf.space, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Resolves a Farcaster username, FID, or 0x address to full profile metadata including social stats, custody address, and verified wallets

## Facts

- Endpoint: GET https://meryol-payai.hf.space/farcaster/:query
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farcaster-identity-lookup-fb0fec36
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wivfBJOlAtWoV8MM6QLp9

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 farcaster-identity-lookup-fb0fec36
```

Example prompt: Can you look up the Farcaster profile for username 'dwr' and tell me their verified wallet addresses, follower count, and bio?

## When to prefer this

Use this endpoint when an agent needs to resolve a Farcaster social identity to on-chain wallet addresses, or when verifying counterparty identity in a social-aware crypto workflow. Ideal for pre-trade or pre-payment checks where you want to confirm the social reputation and wallet ownership of a Farcaster user. Prefer over generic ENS or on-chain lookups when the user's identity is anchored in the Farcaster social graph.

## Known failure modes

- Username or FID not found — returns 404 or empty result
- Invalid query format (e.g. malformed address) — returns 400 error
- Farcaster hub unavailable — returns 503 or timeout
- User has no verified addresses — verified addresses array is empty
- Rate limiting or payment failure — returns 402 payment required

## How this service works

Counterparty identity check via Farcaster: pass username (no @) or FID integer. Returns FID, username, display name, bio, pfp URL, follower / following counts, custody address, and verified 0x addresses. Identity primitive for social-aware agents.

## Output

Returns a JSON object containing the user's FID (integer), username, display name, bio text, profile picture URL, follower count, following count, custody address (0x), and an array of verified Ethereum addresses linked to the account.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "query": "dwr"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "username, fid, or 0x address"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "fid",
      "username"
     ]
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farcaster-identity-lookup-fb0fec36/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meryol-payai.hf.space](https://www.zero.xyz/host/meryol-payai.hf.space/llms.txt)