Skip to main content
String!
WalletCategory
See WalletCategory
Int
WalletFunding
See WalletFunding
[String!]
Identity labels describing what this wallet is (e.g. CEX, DEX, bridge, team)
String
Resolved profile avatar URL (best available source)
String
A human-readable display name for the wallet
String
Twitter/X numeric ID
String
Twitter/X username
String
Telegram numeric ID
String
Telegram username
String
Website URL
String
Discord numeric ID
String
Discord username
String
GitHub numeric ID
String
GitHub username
String
Farcaster numeric ID
String
Farcaster username
String
A community-contributed description of the wallet
Int
Ethos credibility score (0-2800, higher = more trustworthy)
String
Ethos credibility tier (1-10)
Boolean
Ethos Network verification status
String
Source of identity data (e.g. ethos, manual, polymarket-backfill)
Int
When identity data was last updated (unix timestamp)
WalletPolymarketProfile
Raw Polymarket profile data when this wallet is a Polymarket proxy. Polymarket takes priority over contributed/ethos for resolved displayName, twitterUsername, and avatarUrl. See WalletPolymarketProfile
Int
Total number of tokens created by this wallet across all networks (where the creator is known).
Int
Total number of launchpad tokens migrated (graduated) by this wallet across all networks.

Used By

Returned by
  • balances: Returns list of token balances that a wallet has.
  • categoryTokens: Returns the tokens assigned to a category (including its subcategories), with optional filterTokens-style filters and rankings applied.
  • 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, persisting the result so subsequent balances queries reflect it. Supports contract tokens (<tokenAddress>:<networkId>, EVM only) and native token balances (native:<networkId>, EVM, Solana, and Starknet). Entries that cannot be refreshed (e.g. an unreachable network) are omitted from the response rather than erroring.
  • token: Returns a single token by its address & network id.
  • tokens: Returns a list of tokens by their addresses & network id, with pagination.
  • tokenTopTraders: Returns a list of top traders for a given token.