# PreFlight Farcaster Counterparty Identity Check

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

Looks up a Farcaster user profile by username or FID, returning identity, social graph stats, and verified wallet addresses for pre-trade counterparty due diligence.

## Facts

- Endpoint: GET https://meryol-agenticmarket-x402.hf.space/farcaster/%7Bquery%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/preflight-farcaster-counterparty-identity-check-d0cd65c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZQFWWOEhcTIRUUXrTcT_D

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 preflight-farcaster-counterparty-identity-check-d0cd65c3
```

Example prompt: Before I send any tokens, look up the Farcaster profile for username 'dwr' — I need their verified wallet addresses, custody address, FID, and follower count to confirm this is a real, established account.

## When to prefer this

Use this endpoint when you need to resolve a Farcaster social identity to on-chain wallet addresses, verify that a counterparty is a real Farcaster user with social graph credibility, or perform pre-trade identity due diligence on someone you encountered on Farcaster. Prefer over raw on-chain lookups when you have a username rather than an address.

## Known failure modes

- Username or FID not found on Farcaster — returns empty or 404-style response
- Farcaster API rate limit or upstream outage — returns 5xx error
- Malformed query parameter — may return empty result or error
- User exists but has no verified addresses — verifications array is empty
- Payment not processed — x402 payment required error before data is returned

## How this service works

Pre-trade & pre-sign checks for autonomous agents: everything an agent verifies BEFORE signing a transaction — token due diligence, calldata red-flag decoding, oracle freshness, holder concentration, bridge routing with executable calldata, cross-venue perp funding, gas and price sanity checks. EVM chains: Ethereum, Base, Arbitrum, Optimism.

## Output

Returns a JSON object with the user's FID, username, display name, bio, profile picture URL, follower count, following count, custody address, and an array of verified on-chain wallet addresses. Notes array may contain flags or warnings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bio": "Working on Farcaster",
  "fid": 3,
  "input": "dwr",
  "notes": [],
  "pfp_url": "https://...",
  "username": "dwr",
  "display_name": "Dan Romero",
  "verifications": [
   "0x..."
  ],
  "follower_count": 60000,
  "custody_address": "0x...",
  "following_count": 120
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/preflight-farcaster-counterparty-identity-check-d0cd65c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meryol-agenticmarket-x402.hf.space](https://www.zero.xyz/host/meryol-agenticmarket-x402.hf.space/llms.txt)
