Social Fetch
Start for freeStart free
Polymarket hub

Polymarket Users Search API

Find trader profiles by username, with the wallet behind each one.

GET /v1/polymarket/users

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/polymarket/users searches profiles by query, a username or part of one. data.users carries wallet, name, usernamePublic, pseudonym and image for each hit. limit is 1 to 50 and defaults to 10.

No match is a found answer with an empty list. To turn a hit into a profile and statistics, pass its wallet to GET /v1/polymarket/users/{walletOrUsername}. For a name search across events and tags too, use the general search route.

Polymarket Users Search API FAQ

How is this different from the general search?

This route searches profiles only and returns a short list of wallets. The general search route can search events, tags and profiles together and pages by number. Use this route when you only need people.

Why does a hit have a name but usernamePublic false?

Polymarket sends the chosen username on some rows even when the holder does not show it on their profile. usernamePublic tells you not to display it. Use pseudonym instead when the flag is false.

How do I get more than 50 hits?

The route caps at 50 per request and does not expose a cursor. Refine the query with a longer fragment. If you need a wallet's full record, use the user route once you have picked the hit.

What does lookupStatus mean on this route?

found means the object or list was returned. not_found means no matching object exists. HTTP 200 only means the request finished, so branch on data.lookupStatus before storing a row.

How much does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Polymarket endpoints