Wallets
Learn how to analyze wallet performance and discover traders with the Codex API
In this recipe we’ll show you how to filter for high-performing wallets, track performance metrics, and build comprehensive wallet analytics across multiple networks.
This data powers the wallet discovery, tracking, and portfolio features on defined.fi:
Discover High-Performing Wallets
Start by implementing a query to help you identify wallets with strong trading performance using a variety of available filters.
Example using the filterWallets endpoint
Example using the filterWallets endpoint
Find Token-Specific Traders
The next method to discover profitable wallets is to query for token-specific performance. Keep an eye out for wallets that appear in multiple query results, as this could be an indicator of strong and consistent performance.
Example using the filterTokenWallets endpoint
Example using the filterTokenWallets endpoint
Get Detailed Wallet Analytics
Once you’ve identified a list of high-performing wallets, or simply wallets of interest, use additional queries to obtain comprehensive performance and trading metrics.
Example using detailedWalletStats endpoint
Example using detailedWalletStats endpoint
Visualize Wallet Activity
An optional step is to query for time-series data that you can use to render performance charts that showcase P&L progression, trading volume, portfolio value over time, and more. Displaying a wallet’s trading activity and performance through a graphic or chart can be a great way to quickly identify patterns and overall trading success (or failure).
Example using walletChart endpoint with a 30-day timeframe
Example using walletChart endpoint with a 30-day timeframe
Example of a PnL graph & 120-Day Wallet Chart on Defined.fi:
Check Current Holdings
Your wallet analysis is not complete without a thorough Portfolio breakdown of all held assets. The next query will find what tokens a wallet currently holds across multiple networks, along with their current USD value.
Example using the balances endpoint
Example using the balances endpoint
Bring Your Results Together
By combining results from multiple wallet endpoints as outlined above, you now have all the pieces necessary to build a comprehensive wallet analysis dashboard and individual wallet portfolios to suit your project’s needs:
Discovery: Use filterWallets to find high-performing wallets
Token Analysis: Use filterTokenWallets for token-specific performance
Deep Dive: Use detailedWalletStats for comprehensive wallet analysis
Visualization: Use walletChart for time-series performance data
Token Holdings: Use balances to see current holdings and USD values
Check out the related wallet endpoints in their respective API reference pages:
filterWallets
filterTokenWallets
detailedWalletStats
walletChart
balances