Skip to main content
GET /v3/polymarket/profiles/{address}
Returns normalized public profile information from Polymarket for an EOA address.

​
Path parameters

ParameterTypeRequiredDescription
addressstringYesEOA address

​
Example

curl "https://api.polynode.dev/v3/polymarket/profiles/0xC3579b0C908F43d50C63951A30C6f72fCEA4F6A0" \
  -H "x-api-key: pn_live_..."

{
  "address": "0xc3579b0c908f43d50c63951a30c6f72fcea4f6a0",
  "proxy_wallet": "0xf6d30d58add6c6814d1b086ec543a16ab6cc9a31",
  "username": "alice123",
  "pseudonym": "Glistening-Risk",
  "display_username_public": true,
  "profile_image": null,
  "x_username": null,
  "verified_badge": false,
  "source": "polymarket"
}

​
Response fields

FieldTypeDescription
addressstringEOA address requested, lowercase
proxy_walletstring or nullPolymarket wallet address returned by Gamma
usernamestring or nullPublic profile username
pseudonymstring or nullPolymarket-generated pseudonym
display_username_publicboolean or nullWhether the username is public
profile_imagestring or nullProfile image URL if present
x_usernamestring or nullLinked X username if present
verified_badgeboolean or nullPolymarket verified badge state
sourcestringpolymarket

​
Errors

StatusCodeMeaning
400invalid_addressAddress is not a valid EVM address
404profile_not_foundPolymarket did not return a public profile
429rate_limitedProfile-specific rate limit exceeded
502upstream_unavailablePolymarket/Gamma profile lookup failed