Reverse Farcaster lookup
Reverse lookups
Reverse Farcaster lookup
GET /v1/reverse/farcaster/
GET
Reverse Farcaster lookup
Finds every wallet linked to a Farcaster username. Costs 2 credits.
Because Farcaster coverage is complete, this is the most reliable lookup in the API. An empty result means the username genuinely has no addresses attached, not that we have not indexed it yet.
Path parameters
string
required
1 to 20 characters, lowercase letters, numbers and underscores. Input is lowercased before matching.
Request
Response
Identical in shape to the reverse X lookup, withfarcaster always present instead of twitter, and meta.username instead of meta.handle.
array
Matching wallets, at most 100 per request.
object
Several wallets per account
Multiple results are the normal case here, more so than on X. A Farcaster account has one custody address plus any number of verified addresses, and all of them are indexed. A single active account returning three or four wallets is unremarkable. The same 100-result cap and lack of pagination apply. See one handle, many wallets.Errors
INVALID_USERNAME, plus the standard errors.