Polymarket

Search Polymarket users

Search Polymarket users by name and get their wallet addresses.

GET/v1/polymarket/users
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

A username or part of one.

min 1 chars · max 100 chars

limitintegeroptionalquery

Items per page, 1–50. Default: 10.

≥ 1 · ≤ 50

Response fields
13

Endpoint-specific response payload.

datalookupStatus
string

`found` when the search ran. No match is an empty list.

one of: found, not_found

dataquery
string

The search text.

Matching profiles.

datausers[]wallet
string

Wallet address.

datausers[]name
stringnullable

Chosen username, as Polymarket sends it. Present even when the holder does not show it on their own profile (see `usernamePublic`).

datausers[]usernamePublic
booleannullable

Whether the holder shows the chosen username publicly on their profile.

datausers[]pseudonym
stringnullable

Auto-generated name.

datausers[]image
stringnullable

Profile image URL.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/polymarket/users?query=election" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket users.