Get Polymarket user
Get a Polymarket user's public profile and headline statistics by wallet or username.
Headers
Get your API keyAPI key (`sfk_...`)
Wallet address (0x and 40 hex digits) or username. A username costs one more lookup to find the wallet.
min 1 chars · max 64 chars · pattern: ^(?:0x[0-9a-fA-F]{40}|@?[A-Za-z0-9][A-Za-z0-9._-]{0,62})$
Endpoint-specific response payload.
`not_found` when no profile or trading history exists for the wallet or username.
one of: found, not_found
The public profile of a wallet.
Wallet address.
Chosen username. Null when hidden or never set.
Auto-generated name.
Profile bio.
Profile image URL.
When the profile was created (ISO-8601, UTC).
Whether Polymarket verified the profile.
Whether the chosen username is shown publicly.
Fee tier, for example `Tier 0`.
Linked X (Twitter) handle.
Headline statistics for a wallet.
Polymarket's headline trade count for the profile. It is a different counter from the one in the profit and loss breakdown.
Largest single win in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Times the profile page was viewed.
When the wallet first traded (ISO-8601, UTC).
All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
All-time realized profit in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Current value of open positions, US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/users/0x56687bf447db6ffa42ffe2204a05edaa20f55839" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket user.