{"uid":"cap_BKSGemYYMcNUw6k3quRlZ","slug":"meryol-agenticmarket-x402-hf-space-f0b68446","name":"Farcaster User Lookup","description":"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.","url":"https://meryol-agenticmarket-x402.hf.space/farcaster/:query","method":"GET","headers":{},"bodySchema":{"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"]}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"query":"dwr"}}},"response":{"bio":"Interested in technology and other stuff.","fid":3,"input":"dwr","notes":[],"pfp_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original","username":"dwr","display_name":"Dan Romero","verifications":[],"follower_count":344838,"custody_address":null,"following_count":77}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BUKA-yqnyqtwFkGUmyVAC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a Farcaster identity (username, FID, or 0x address) and returns full profile metadata including social graph counts and verified addresses.","exampleAgentPrompt":"What's the Farcaster profile for username dwr — give me their FID, bio, follower count, and any verified wallet addresses.","exampleUseCases":null,"resultDescription":"Returns a JSON object with FID (integer), username, display name, bio, profile picture URL, follower count, following count, custody address, and an array of verified 0x Ethereum addresses. If the user is not found, counts and string fields are null and notes contains 'user_not_found'.","failureModes":["User not found: all fields return null and notes includes 'user_not_found' — happens when the username/FID/address doesn't exist on Farcaster","Invalid query format: malformed 0x address or non-existent FID may return null profile","Payment failure: x402 payment of $0.002 USDC not processed, request blocked","Rate limiting: too many requests in quick succession may be throttled","Network error: upstream Farcaster hub unavailable, returns error or empty response"],"whenToPreferThis":"Use this endpoint when you need to resolve any Farcaster identity — username, FID, or Ethereum address — into a full social profile with verified wallet links. Ideal for social-aware agents that need to bridge onchain wallet addresses to Farcaster social identity, or vice versa. Prefer this over ENS resolution when the social graph context (followers, bio, pfp) matters, not just address mapping.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:59.311Z","isFirstParty":false}