Polymarket API reference / Gamma API
GET/profiles/user_address/{user_address}

Get public profile by user address

Base URL
https://gamma-api.polymarket.com
Auth
Public, no key
Rate limit
4,000 req / 10s (400 per second)
Limit applies to
Gamma API general

Parameters

NameInTypeRequiredDescription
user_addresspathstringyes

Example

curl -X GET "https://gamma-api.polymarket.com/profiles/user_address/<user_address>"

Response fields

FieldTypeDescription
idstring
namestring
userinteger
referralstring
createdByinteger
updatedByinteger
createdAtstring
updatedAtstring
utmSourcestring
utmMediumstring
utmCampaignstring
utmContentstring
utmTermstring
walletActivatedboolean
pseudonymstring
displayUsernamePublicboolean
profileImagestring
biostring
proxyWalletstring
profileImageOptimizedobject
isCloseOnlyboolean
isCertReqboolean
certReqDatestring

Responses

StatusMeaning
200Profile
404Not found
Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.