Documentation Index
Fetch the complete documentation index at: https://docs.codex.io/llms.txt
Use this file to discover all available pages before exploring further.
This endpoint requires a Growth or Enterprise plan. Learn more.
This query is deprecated. Use filterWallets instead
Returns
See NetworkWalletFilterConnection
Show Properties
Show Properties
The list of wallets matching the filter parameters.
See NetworkWalletFilterResult
Show Properties
Show Properties
The wallet address
The network ID of the wallet
The unix timestamp for the first transaction from this wallet
The unix timestamp for the last transaction from this wallet
The native token balance of the wallet
The labels associated with the wallet
Manual or proposal-derived identity vocabulary (e.g. WHALE, KOL). Distinct from behavioral
labels.Volume in USD in the past day
Total volume in USD in the past day including all tokens
Realized profit in USD in the past day
Average profit in USD per trade in the past day
Average swap amount in USD in the past day
Realized profit percentage in the past day
Average hold period, in seconds, for positions sold during the past day. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
Number of swaps in the past day
Total number of swaps in the past day including all tokens
Number of unique tokens traded in the past day
Win rate in the past day
Volume in USD in the past week
Total volume in USD in the past week including all tokens
Realized profit in USD in the past week
Average profit in USD per trade in the past week
Average swap amount in USD in the past week
Realized profit percentage in the past week
Average hold period, in seconds, for positions sold during the past week. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
Number of swaps in the past week
Total number of swaps in the past week including all tokens
Number of unique tokens traded in the past week
Win rate in the past week
Volume in USD in the past 30 days
Total volume in USD in the past 30 days including all tokens
Realized profit in USD in the past 30 days
Average profit in USD per trade in the past 30 days
Average swap amount in USD in the past 30 days
Realized profit percentage in the past 30 days
Average hold period, in seconds, for positions sold during the past 30 days. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
Number of swaps in the past 30 days
Total number of swaps in the past 30 days including all tokens
Number of unique tokens traded in the past 30 days
Win rate in the past 30 days
Volume in USD in the past year
Total volume in USD in the past year including all tokens
Realized profit in USD in the past year
Average profit in USD per trade in the past year
Average swap amount in USD in the past year
Realized profit percentage in the past year
Average hold period, in seconds, for positions sold during the past year. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
Number of swaps in the past year
Total number of swaps in the past year including all tokens
Number of unique tokens traded in the past year
Win rate in the past year
The scammer score for the wallet.
The bot score for the wallet.
The backfill state of the wallet.
See WalletAggregateBackfillState
Show Properties
Show Properties
Historical stats calculations for this wallet have been successfully processed
Historical stats calculations for this wallet are being processed
Historical stats calculations were started, then canceled for this wallet. It may have been flagged as a bot
Historical stats calculations have been blocked for this wallet. It may have been flagged as a bot
Historical stats calculations for this wallet are queued and will be processed soon
Historical stats calculations for this wallet have not been started, nor attempted
The wallet identity and profile data
See Wallet
Show Properties
Show Properties
Identity labels describing what this wallet is (e.g. CEX, DEX, bridge, team)
Resolved profile avatar URL (best available source)
A human-readable display name for the wallet
Twitter/X numeric ID
Twitter/X username
Telegram numeric ID
Telegram username
Website URL
Discord numeric ID
Discord username
GitHub numeric ID
GitHub username
Farcaster numeric ID
Farcaster username
A community-contributed description of the wallet
Ethos credibility score (0-2800, higher = more trustworthy)
Ethos credibility tier (1-10)
Ethos Network verification status
Source of identity data (e.g. ethos, manual, polymarket-backfill)
When identity data was last updated (unix timestamp)
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
Show Properties
Show Properties
On-chain proxy wallet address used by Polymarket to represent the user.
Self-claimed X (Twitter) username on Polymarket, if set by the user.
Display name set by the user on Polymarket.
Auto-generated pseudonym assigned by Polymarket (e.g. Incompatible-Standoff).
Profile image URL set by the user on Polymarket.
Whether the user has a verified badge on Polymarket.
Whether the user has opted to display their username publicly.
Unix timestamp of when this Polymarket profile was last fetched.
The number of wallets returned.
Where in the list the server started when returning items.
Arguments
See FilterNetworkWalletsInput
Show Properties
Show Properties
The network ID to filter wallets for
A set of filters to apply.
See WalletNetworkFilters
Show Properties
Show Properties
The unix timestamp for the last transaction from this wallet.
See NumberFilter
The unix timestamp for the first transaction from this wallet.
See NumberFilter
Volume in USD in the past day
See NumberFilter
Total volume in USD in the past day including all tokens
See NumberFilter
Realized profit in USD in the past day
See NumberFilter
Average profit in USD per trade in the past day
See NumberFilter
Average swap amount in USD in the past day
See NumberFilter
Realized profit percentage in the past day
See NumberFilter
Average hold period, in seconds, for positions sold during the past day. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
See NumberFilter
Number of swaps in the past day
See NumberFilter
Total number of swaps in the past day including all tokens
See NumberFilter
Number of unique tokens traded in the past day
See NumberFilter
Win rate in the past day
See NumberFilter
Volume in USD in the past week
See NumberFilter
Total volume in USD in the past week including all tokens
See NumberFilter
Realized profit in USD in the past week
See NumberFilter
Average profit in USD per trade in the past week
See NumberFilter
Average swap amount in USD in the past week
See NumberFilter
Realized profit percentage in the past week
See NumberFilter
Average hold period, in seconds, for positions sold during the past week. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
See NumberFilter
Number of swaps in the past week
See NumberFilter
Total number of swaps in the past week including all tokens
See NumberFilter
Number of unique tokens traded in the past week
See NumberFilter
Win rate in the past week
See NumberFilter
Volume in USD in the past 30 days
See NumberFilter
Total volume in USD in the past 30 days including all tokens
See NumberFilter
Realized profit in USD in the past 30 days
See NumberFilter
Average profit in USD per trade in the past 30 days
See NumberFilter
Average swap amount in USD in the past 30 days
See NumberFilter
Realized profit percentage in the past 30 days
See NumberFilter
Average hold period, in seconds, for positions sold during the past 30 days. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
See NumberFilter
Number of swaps in the past 30 days
See NumberFilter
Total number of swaps in the past 30 days including all tokens
See NumberFilter
Number of unique tokens traded in the past 30 days
See NumberFilter
Win rate in the past 30 days
See NumberFilter
Volume in USD in the past year
See NumberFilter
Total volume in USD in the past year including all tokens
See NumberFilter
Realized profit in USD in the past year
See NumberFilter
Average profit in USD per trade in the past year
See NumberFilter
Average swap amount in USD in the past year
See NumberFilter
Realized profit percentage in the past year
See NumberFilter
Average hold period, in seconds, for positions sold during the past year. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
See NumberFilter
Number of swaps in the past year
See NumberFilter
Total number of swaps in the past year including all tokens
See NumberFilter
Number of unique tokens traded in the past year
See NumberFilter
Win rate in the past year
See NumberFilter
The native token balance of the wallet.
See NumberFilter
The scammer score for the wallet. Indicates the likelihood of the wallet being a scammer. Zero being not a scammer and 100 being a definite scammer.
See NumberFilter
The bot score for the wallet. Indicates the likelihood of the wallet being a bot. Zero being not a bot and 100 being a definite bot.
See NumberFilter
Ethos credibility score (0-2800)
See NumberFilter
Filter by whether the wallet has a Twitter/X account
Filter by whether the wallet has a Discord account
Filter by whether the wallet has a Telegram account
Filter by whether the wallet has a Farcaster account
Filter by whether the wallet has a GitHub account
Filter by whether the wallet has a display name set
Filter by whether the wallet has any linked social account
A list of wallet addresses to filter by.
Exclude wallets with these labels. See
WalletLabel for possible values.Include wallets with these labels. See
WalletLabel for possible values.A list of ranking attributes to apply.
See WalletNetworkRanking
Show Properties
Show Properties
The attribute to rank wallets by.
See WalletNetworkRankingAttribute
Show Properties
Show Properties
Average hold period, in seconds, for positions sold during the past day.
Average hold period, in seconds, for positions sold during the past week.
Average hold period, in seconds, for positions sold during the past 30 days.
Average hold period, in seconds, for positions sold during the past year.
The direction to apply to the ranking attribute.
See RankingDirection
The maximum number of wallets to return.
Where in the list the server should start when returning items. Use
count+offset from the previous query to request the next page of results.