GET/public-profile

Get public profile by wallet 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

Name	In	Type	Required	Description
address	query	string	yes	The wallet address (proxy wallet or user address)

Example

curl -X GET "https://gamma-api.polymarket.com/public-profile?address=<address>"

Response fields

Field	Type	Description
createdAt	string	ISO 8601 timestamp of when the profile was created
proxyWallet	string	The proxy wallet address
profileImage	string	URL to the profile image
displayUsernamePublic	boolean	Whether the username is displayed publicly
bio	string	Profile bio
pseudonym	string	Auto-generated pseudonym
name	string	User-chosen display name
users	object[]	Array of associated user objects
xUsername	string	X (Twitter) username
verifiedBadge	boolean	Whether the profile has a verified badge

Responses

Status	Meaning
200	Public profile information
400	Invalid address format
404	Profile not 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.