Skip to main content
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, with farcaster 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.