Skip to main content
GET
Reverse X lookup
Finds every wallet linked to an X handle. Costs 2 credits. This runs the graph backwards, and it answers a question most wallet tooling cannot: given a person, what do they hold?

Path parameters

string
required
1 to 15 characters, letters, numbers and underscores. A leading @ is accepted and stripped. Case-insensitive.

Request

Response

array
Matching wallets, at most 100 per request. Each entry carries wallet, an always-present twitter object, and whichever of ens_name, farcaster, lens, github and sources apply, plus a flat quality_score.
object
quality_score here is a flat number, unlike the nested quality object on single lookup. Same scale, different shape.

One handle, many wallets

Multiple results are normal, not a bug. People keep a hot wallet and a vault, and the same handle can be attested from several addresses. The endpoint returns at most 100 wallets and there is no pagination. When truncated is true you are seeing an arbitrary 100 of a larger set, with no way to reach the rest. total_count still reports the true total, so you can at least detect it. If you are hitting truncation regularly, email help@walletlink.social.

Errors

INVALID_HANDLE, plus the standard errors. No matches is not an error: data is [] with total_count: 0 at HTTP 200.