{"uid":"cap_16eSxXlmLwz_FsGlgtYM7","slug":"farcaster-profile-lookup-a2918b7c","name":"Farcaster Profile Lookup","description":"One-call Farcaster profile fusion. Give one of fid or username and get back the full profile (display name, bio, picture, url, location, socials), the primary Ethereum address, every verified on-chain wallet, the custody address, following and follower and cast counts, and the account age — the fused object that replaces four or five raw hub reads.","url":"https://payai.agentstools.dev/farcaster/profile","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"},"queryParams":{"type":"object","required":[],"properties":{"fid":{"type":"integer","minimum":1,"description":"Farcaster ID (FID), a positive integer"},"username":{"type":"string","description":"Farcaster username (fname or ENS), without the at-sign"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6sNQg5k3CwXtldJYqTFuL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a fused Farcaster profile object including display name, bio, avatar, verified Ethereum wallets, custody address, follower/following/cast counts, and account age from a single FID or username lookup.","exampleAgentPrompt":"Can you pull up the full Farcaster profile for username 'dwr.eth' — I need their bio, avatar, verified Ethereum wallets, and follower count all in one shot.","exampleUseCases":[{"title":"Wallet lookup from Farcaster handle","prompt":"I need to find all the verified Ethereum wallets linked to the Farcaster account with username 'vitalik.eth' — can you get those for me?"},{"title":"Onboarding verification for Web3 app","prompt":"We're onboarding a new user who says their Farcaster FID is 3621 — can you fetch their full profile so I can verify their display name, account age, and custody address?"},{"title":"Influencer research for social campaign","prompt":"I'm evaluating a Farcaster creator with username 'jessepollak' for a partnership — can you pull their follower count, cast count, bio, and how long their account has been active?"}],"resultDescription":"A single fused JSON object containing the user's display name, bio, profile picture URL, website URL, location, social links, primary Ethereum address, all verified on-chain wallet addresses, custody address, follower count, following count, cast count, and account age — consolidating data that would otherwise require four or five separate Farcaster Hub reads.","failureModes":["Neither fid nor username provided — request fails with a missing parameter error","Unknown FID or username — returns not found error","FID below minimum value of 1 — validation error","Network or hub unavailability causing upstream read failures","Ambiguous ENS resolution if username matches multiple identities"],"whenToPreferThis":"Choose this endpoint when you need a complete, consolidated Farcaster identity profile in a single call — especially when you need both social metadata (bio, avatar, follower counts) and on-chain identity data (verified wallets, custody address) together. It replaces multiple raw Farcaster Hub reads and is ideal for agent workflows that need to resolve Web3 identity from a social handle or FID without building custom aggregation logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:55:08.230Z","isFirstParty":false}