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.
Returns
See DetailedWalletStats
Show Properties
Show Properties
The wallet address
The last transaction timestamp
The network breakdown
See NetworkBreakdown
Show Properties
Show Properties
The network ID
The native token balance
The stats for the last day
See WindowedWalletStats
Show Properties
Show Properties
The wallet address
The network ID
The start timestamp
The end timestamp
The last transaction timestamp
The stats related to currency
See WindowedDetailedCurrencyWalletStats
Show Properties
Show Properties
The volume in USD
The volume in USD including tokens sold for which we do not have a price
The cost of tokens held in the wallet
The cost of tokens sold during the period
The realized profit in USD
The average profit in USD per trade
The average swap amount in USD
The realized profit percentage
The stats related to non-currency
See WindowedDetailedNonCurrencyWalletStats
Show Properties
Show Properties
The number of swaps
The number of unique tokens
The number of wins
The number of losses
Average hold period, in seconds, for positions sold during the window. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells in the window.
The stats for the last week
See WindowedWalletStats
Show Properties
Show Properties
The wallet address
The network ID
The start timestamp
The end timestamp
The last transaction timestamp
The stats related to currency
See WindowedDetailedCurrencyWalletStats
Show Properties
Show Properties
The volume in USD
The volume in USD including tokens sold for which we do not have a price
The cost of tokens held in the wallet
The cost of tokens sold during the period
The realized profit in USD
The average profit in USD per trade
The average swap amount in USD
The realized profit percentage
The stats related to non-currency
See WindowedDetailedNonCurrencyWalletStats
Show Properties
Show Properties
The number of swaps
The number of unique tokens
The number of wins
The number of losses
Average hold period, in seconds, for positions sold during the window. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells in the window.
The stats for the last 30 days
See WindowedWalletStats
Show Properties
Show Properties
The wallet address
The network ID
The start timestamp
The end timestamp
The last transaction timestamp
The stats related to currency
See WindowedDetailedCurrencyWalletStats
Show Properties
Show Properties
The volume in USD
The volume in USD including tokens sold for which we do not have a price
The cost of tokens held in the wallet
The cost of tokens sold during the period
The realized profit in USD
The average profit in USD per trade
The average swap amount in USD
The realized profit percentage
The stats related to non-currency
See WindowedDetailedNonCurrencyWalletStats
Show Properties
Show Properties
The number of swaps
The number of unique tokens
The number of wins
The number of losses
Average hold period, in seconds, for positions sold during the window. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells in the window.
The stats for the last year
See WindowedWalletStats
Show Properties
Show Properties
The wallet address
The network ID
The start timestamp
The end timestamp
The last transaction timestamp
The stats related to currency
See WindowedDetailedCurrencyWalletStats
Show Properties
Show Properties
The volume in USD
The volume in USD including tokens sold for which we do not have a price
The cost of tokens held in the wallet
The cost of tokens sold during the period
The realized profit in USD
The average profit in USD per trade
The average swap amount in USD
The realized profit percentage
The stats related to non-currency
See WindowedDetailedNonCurrencyWalletStats
Show Properties
Show Properties
The number of swaps
The number of unique tokens
The number of wins
The number of losses
Average hold period, in seconds, for positions sold during the window. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells in the window.
The labels associated with the wallet
The likelihood of the wallet being a scammer
The likelihood of the wallet being a bot
The stats for the last day
See WindowedWalletStats
Show Properties
Show Properties
The wallet address
The network ID
The start timestamp
The end timestamp
The last transaction timestamp
The stats related to currency
See WindowedDetailedCurrencyWalletStats
Show Properties
Show Properties
The volume in USD
The volume in USD including tokens sold for which we do not have a price
The cost of tokens held in the wallet
The cost of tokens sold during the period
The realized profit in USD
The average profit in USD per trade
The average swap amount in USD
The realized profit percentage
The stats related to non-currency
See WindowedDetailedNonCurrencyWalletStats
Show Properties
Show Properties
The number of swaps
The number of unique tokens
The number of wins
The number of losses
Average hold period, in seconds, for positions sold during the window. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells in the window.
The stats for the last week
See WindowedWalletStats
Show Properties
Show Properties
The wallet address
The network ID
The start timestamp
The end timestamp
The last transaction timestamp
The stats related to currency
See WindowedDetailedCurrencyWalletStats
Show Properties
Show Properties
The volume in USD
The volume in USD including tokens sold for which we do not have a price
The cost of tokens held in the wallet
The cost of tokens sold during the period
The realized profit in USD
The average profit in USD per trade
The average swap amount in USD
The realized profit percentage
The stats related to non-currency
See WindowedDetailedNonCurrencyWalletStats
Show Properties
Show Properties
The number of swaps
The number of unique tokens
The number of wins
The number of losses
Average hold period, in seconds, for positions sold during the window. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells in the window.
The stats for the last 30 days
See WindowedWalletStats
Show Properties
Show Properties
The wallet address
The network ID
The start timestamp
The end timestamp
The last transaction timestamp
The stats related to currency
See WindowedDetailedCurrencyWalletStats
Show Properties
Show Properties
The volume in USD
The volume in USD including tokens sold for which we do not have a price
The cost of tokens held in the wallet
The cost of tokens sold during the period
The realized profit in USD
The average profit in USD per trade
The average swap amount in USD
The realized profit percentage
The stats related to non-currency
See WindowedDetailedNonCurrencyWalletStats
Show Properties
Show Properties
The number of swaps
The number of unique tokens
The number of wins
The number of losses
Average hold period, in seconds, for positions sold during the window. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells in the window.
The stats for the last year
See WindowedWalletStats
Show Properties
Show Properties
The wallet address
The network ID
The start timestamp
The end timestamp
The last transaction timestamp
The stats related to currency
See WindowedDetailedCurrencyWalletStats
Show Properties
Show Properties
The volume in USD
The volume in USD including tokens sold for which we do not have a price
The cost of tokens held in the wallet
The cost of tokens sold during the period
The realized profit in USD
The average profit in USD per trade
The average swap amount in USD
The realized profit percentage
The stats related to non-currency
See WindowedDetailedNonCurrencyWalletStats
Show Properties
Show Properties
The number of swaps
The number of unique tokens
The number of wins
The number of losses
Average hold period, in seconds, for positions sold during the window. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells in the window.
The wallet record
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 network specific stats
See NetworkWalletStats
This field is deprecated. Use networkBreakdown instead
Arguments
Example
Test this query in the Explorer →{
detailedWalletStats(
input: { walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }
) {
walletAddress
lastTransactionAt
labels
scammerScore
botScore
statsDay30 {
statsUsd {
volumeUsd
realizedProfitUsd
realizedProfitPercentage
averageProfitUsdPerTrade
}
statsNonCurrency {
swaps
uniqueTokens
wins
losses
}
}
networkBreakdown {
networkId
nativeTokenBalance
}
wallet {
address
firstFunding {
fundedByAddress
fundedAt
}
}
}
}
Usage Guidelines
- Query using
input: { walletAddress }with a wallet address from any supported network - Stats are available in multiple time windows:
statsDay1,statsWeek1,statsDay30,statsYear1 statsUsdcontains USD-denominated metrics (volume, profit, averages)statsNonCurrencycontains count metrics (swaps, unique tokens, wins/losses)networkBreakdownshows per-network stats and native token balances- Use
wallet.firstFundingto see where initial funds came from
Troubleshooting Tips
What does realizedProfitPercentage represent?
What does realizedProfitPercentage represent?
realizedProfitPercentage is the profit as a percentage of the cost basis for tokens sold during the time window. A value of 0.5 means 50% profit on tokens sold.What's the difference between wins and losses?
What's the difference between wins and losses?
A “win” is a trade where the wallet sold tokens for more than they paid. A “loss” is a trade where they sold for less. These counts help assess trading skill independent of dollar amounts.
What do the labels indicate?
What do the labels indicate?
Labels categorize wallets by behavior patterns (e.g., “smart_money”, “bot”, “sniper”). Use these to quickly identify wallet types without analyzing all stats.
Why might networkBreakdown be empty?
Why might networkBreakdown be empty?
networkBreakdown only includes networks where the wallet has had trading activity on tracked DEXs. A wallet with only transfers or holdings won’t appear in the breakdown.What is firstFunding used for?
What is firstFunding used for?
firstFunding shows the first wallet that funded this address and when. This helps trace wallet origins and identify potential wallet clusters or funding patterns.Related Recipes
- Wallets: Analyze wallet performance, discover top traders, and build portfolio views