Get Polymarket wallet profile
Returns the public profile (image and display name) for a Polymarket wallet.
Returns the public profile (image and display name) for a Polymarket wallet. Accepts either a wallet address (proxy or signer EOA) or a Polymarket username. Exactly one of the two must be supplied — passing both returns 400.
When address is the underlying signer EOA, the endpoint resolves it to the deterministic proxy address and returns the proxy's profile, with signer echoing the input.
When username is supplied, the endpoint resolves it to the wallet via Polymarket's profile search. Match is case-insensitive and exact: a query of Theo resolves the user literally named theo but does not resolve theo46 or Theo47. A leading @ is accepted (and stripped) as a convenience for callers used to Twitter-style handles. signer is always null on the username path. Profiles that don't exist (or only match fuzzily) return 404.
Authorization
BearerAuth In: header
Query Parameters
Wallet address to look up. May be a Polymarket proxy address or the underlying signer EOA — the endpoint resolves either form. Must match ^0x[a-fA-F0-9]{40}$. Mixed-case input is accepted and lowercased in the response. Mutually exclusive with username; exactly one of the two is required.
^0x[a-fA-F0-9]{40}$Polymarket display name to look up. Match is case-insensitive and exact against the user's stored name (so Car, car, and CAR all resolve, but Theo does not match Theo47). A leading @ is accepted and stripped before the lookup. Mutually exclusive with address; exactly one of the two is required. Example: Car.
1 <= lengthResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/polymarket/wallet"{ "address": "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b", "signer": null, "profile_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-501613.png", "display_name": "Car"}