Skip to main content
​
proxyWallet
String!
On-chain proxy wallet address used by Polymarket to represent the user.
​
xUsername
String
Self-claimed X (Twitter) username on Polymarket, if set by the user.
​
displayName
String
Display name set by the user on Polymarket.
​
pseudonym
String
Auto-generated pseudonym assigned by Polymarket (e.g. Incompatible-Standoff).
​
profileImageUrl
String
Profile image URL set by the user on Polymarket.
​
verifiedBadge
Boolean
Whether the user has a verified badge on Polymarket.
​
displayUsernamePublic
Boolean
Whether the user has opted to display their username publicly.
​
fetchedAt
Int!
Unix timestamp of when this Polymarket profile was last fetched.

​
Used By

Returned by
  • balances: Returns list of token balances that a wallet has.
  • detailedWalletStats: Returns detailed stats for a wallet.
  • filterNetworkWallets (deprecated): Returns a list of wallets with stats narrowed down to a specific network.
  • filterPairs: Returns a list of pairs based on a variety of filters.
  • filterTokens: Discover, screen, and rank tokens across every supported network using 100+ on-chain signals: trading activity, liquidity, holder behavior, fee economics, and launchpad lifecycle.
  • filterTokenWallets: Returns a list of wallets with stats narrowed down to a specific token.
  • filterWallets: Returns a list of wallets based on a variety of filters.
  • getBars: Returns bar chart data to track price changes over time.
  • getCommunityNotes: Returns community gathered notes.
  • getDetailedPairsStats: Returns bucketed stats for a given token within a list of pairs.
  • getDetailedPairStats: Returns bucketed stats for a given token within a pair.
  • getTokenBars: Returns aggregated bar chart data to track price changes over time.
  • holders: Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.
  • listPairsForToken: Returns a list of pairs containing a given token.
  • listPairsWithMetadataForToken: Returns a list of pair metadata for a token.
  • onBalanceUpdated: Live-streamed balance updates for a given wallet.
  • onFilterTokensUpdated: Live-streamed filter token updates for the current filterTokens result set.
  • onHoldersUpdated: Live-streamed list of wallets that hold a given token. Also has the unique count of holders for that token.
  • onLaunchpadTokenEvent: Live-streamed launchpad token event.
  • onLaunchpadTokenEventBatch: Live-streamed launchpad token events batched (more efficient).
  • onPairMetadataUpdated: Live-streamed stat updates for a given token within a pair.
  • pairMetadata: Returns metadata for a pair of tokens.
  • refreshBalances: Force refreshes the balance for a token in a wallet. EVM only.
  • token: Returns a single token by its address & network id.
  • tokens: Returns a list of tokens by their addresses & network id, with pagination.