Documentation

Getting Started

PerpsTracker is designed to be intuitive and easy to use. Here's how to get started:

1. Choose Your View

PerpsTracker offers several views to analyze trader performance:

• Overview: Quick snapshot of top traders across all timeframes
• Leaderboard: Detailed rankings with sortable columns and filters
• Live Trades: Real-time trade feed with advanced filtering
• Trader Profiles: In-depth analysis of individual traders

2. Select a Timeframe

Most features allow you to filter by timeframe:

• 24 Hours: Best for identifying short-term opportunities and day traders
• 7 Days: Reveals weekly trends and swing traders
• 30 Days: Shows monthly performance and consistent strategies
• 365 Days: Identifies long-term successful traders and strategies

Overview Page

The Overview page provides a quick snapshot of the top traders across all timeframes in one view.

Most Consistent Traders

This special section shows traders who appear in ALL timeframes (24h, 7d, 30d, and 365d), indicating truly consistent performance rather than lucky streaks.

• Average Rank: Mean rank across all timeframes
• Average Score: Mean performance score
• Total PnL: Combined profit/loss across all positions
• Individual Ranks: Specific rank in each timeframe

Timeframe Cards

Each timeframe card displays:

• Total number of active traders
• Total trading volume
• Cumulative PnL
• Top traders (configurable: 5, 10, 20, 50, or 100)

Using the Overview Page

1. Use the "Show per timeframe" dropdown to adjust how many traders are displayed
2. Click on any trader's wallet address to view their detailed profile
3. Click "View All →" on any timeframe card to see the full leaderboard
4. Use the "Show" dropdown in the Consistent Traders section to adjust the list size

Leaderboard

The Leaderboard is your primary tool for analyzing and comparing trader performance.

Features

• Timeframe Selection: Switch between 24h, 7d, 30d, and 365d
• Sortable Columns: Click any column header to sort (click again to reverse)
• Trader Count Filter: Show top 20, 50, 100, 250, or all traders
• Search: Find specific traders by wallet address (Pro/Elite)
• Export: Download data as CSV (Pro/Elite)

Leaderboard Columns Explained

Live Trades Feed (Elite Only)

Watch perpetual futures trades happen in real-time with comprehensive filtering options. This feature is exclusive to Elite subscribers.

Feed Controls

• Auto-Refresh: Toggle automatic updates (default: ON, 5-second interval)
• Refresh Interval: Adjust update frequency (1s, 5s, 10s, 30s, 60s)
• Manual Refresh: Click "Refresh Now" to update immediately

Filtering Options

1. Position Type Filter

• All Positions: Show both longs and shorts
• Long Only: Show only long positions (bullish)
• Short Only: Show only short positions (bearish)

2. Timeframe Filter

Filter trades by how recent they are:

• Last 5 minutes
• Last 30 minutes
• Last 1 hour
• Last 4 hours
• Last 12 hours
• Last 24 hours (default)

3. Trader Rank Filter (Elite Only)

Focus on trades from top-performing traders:

• All Traders: Show trades from all active traders
• Top 10: Only show trades from top 10 ranked traders
• Top 50: Only show trades from top 50 ranked traders
• Top 100: Only show trades from top 100 ranked traders
• Top 250: Only show trades from top 250 ranked traders

4. From Leaderboard Filter (Elite Only)

Select which leaderboard to use for rank filtering:

• None: No leaderboard filtering (shows all traders)
• 24 Hours: Use 24h leaderboard rankings
• 7 Days: Use 7d leaderboard rankings
• 30 Days: Use 30d leaderboard rankings
• 365 Days: Use 365d leaderboard rankings

Trade Information

Each trade displays:

• Timestamp: When the trade occurred (in your local time)
• Trader: Wallet address (click to view profile)
• Action: OPEN or CLOSE position
• Side: LONG (bullish) or SHORT (bearish)
• Token: The asset being traded (e.g., SOL, BTC, ETH)
• Size: Position size in USD
• Collateral: Margin amount used
• Leverage: Multiplier applied to the position
• Fee: Transaction fee in SOL
• Signature: Blockchain transaction ID (click to view on Solscan)

Understanding the Stats Panel

The stats panel updates in real-time based on your filters:

• Total Trades: Number of trades matching your filters
• Long Positions: Count of bullish positions
• Short Positions: Count of bearish positions
• Active Traders: Number of unique wallets in the filtered set

Compare Traders (Pro/Elite)

The Compare Traders feature allows you to analyze up to 5 traders side-by-side with comprehensive visual charts and detailed metrics. This feature is available to Pro and Elite subscribers.

Getting Started

1. Access the Compare Page: Navigate to Platform → Compare Traders from the navigation menu
2. Add Traders: Enter wallet addresses to add traders to your comparison (up to 5)
3. Select Timeframe: Choose a timeframe (24h, 7d, 30d, or 365d) for analysis
4. Review Charts: Analyze the 9 comparison charts to understand trader differences

Comparison Charts

The Compare Traders feature includes 9 interactive charts for comprehensive analysis:

1. Total PnL Comparison

Bar chart showing each trader's total profit/loss for the selected timeframe. Quickly identify the most profitable traders.

2. Win Rate Comparison

Bar chart comparing win rates across traders. Higher win rates indicate more consistent profitability.

3. ROI Comparison

Return on Investment comparison showing capital efficiency. Identifies traders who maximize returns relative to their capital usage.

4. Volume Comparison

Total trading volume comparison showing trading activity levels across traders.

5. Sharpe Ratio Comparison

Risk-adjusted return metric comparison. Higher Sharpe ratios indicate better returns per unit of risk taken.

6. Trade Count Comparison

Number of trades executed by each trader. Shows trading frequency and activity patterns.

7. Average Leverage Comparison

Mean leverage used by each trader. Reveals risk appetite and trading style differences.

8. Cumulative PnL Over Time

Line chart showing profit/loss progression over time for all compared traders. Visualizes performance trends and consistency.

9. Performance Radar Chart

Multi-dimensional radar chart displaying normalized metrics (PnL, Win Rate, ROI, Sharpe, Volume) for holistic comparison.

Using the Comparison Data

• Identify Strengths: See which traders excel in specific metrics
• Compare Risk Profiles: Use Sharpe ratio and leverage to understand risk-taking
• Track Consistency: Cumulative PnL chart reveals who maintains steady performance
• Holistic View: Radar chart provides an at-a-glance overall comparison

Trader Watchlist (Pro & Elite)

The Watchlist feature lets Pro and Elite subscribers track specific traders of interest, add personal notes, and quickly access their profiles. Build your curated list of up to 50 traders to monitor.

Adding Traders to Your Watchlist

There are multiple ways to add traders to your watchlist:

• From the Watchlist Page: Enter a wallet address directly and click "Add to Watchlist"
• From Trader Profiles: Click the "Add to Watchlist" button on any trader's profile page
• From Leaderboard: Use the watchlist icon next to trader entries

Managing Your Watchlist

• View All Tracked Traders: Access your complete watchlist from Platform → Watchlist
• Add Notes: Include personal notes for each trader (e.g., "Great at BTC shorts", "High leverage style")
• Quick Profile Access: Click any watchlisted trader to view their full profile
• Remove Traders: Easily remove traders you no longer want to track

Watchlist Information

Your watchlist displays key information for each tracked trader:

• Wallet Address: Truncated address with copy functionality
• Your Notes: Personal notes you've added about the trader
• Date Added: When you added this trader to your watchlist
• Quick Actions: View profile, edit notes, or remove from watchlist

Use Cases

1. Track Successful Traders: Monitor top performers you want to learn from
2. Research Candidates: Build a list of traders to analyze before copy trading
3. Strategy Analysis: Group traders by strategy type with notes
4. Market Sentiment: Watch how top traders react to market conditions

Trader Profiles

Click any wallet address throughout the site to view detailed trader analytics.

Profile Sections

Performance Summary

View key metrics across all timeframes in one place:

• Leaderboard rankings for each timeframe
• Color-coded badges showing performance level
• Total PnL, volume, and ROI for each period
• Win rates and Sharpe ratios

Detailed Statistics

Comprehensive metrics for each timeframe:

• Total trades and win rate
• Average leverage and maximum leverage
• Profit factor and risk metrics
• Average trade size and duration

Trading History

View all historical trades with:

• Sortable columns
• Filter by position type (long/short)
• Links to blockchain transactions
• Export capability (Pro/Elite)

Understanding Metrics

Detailed explanations of all performance metrics used on PerpsTracker.

PnL (Profit and Loss)

The total profit or loss in USD for the period. Calculated as the sum of all closed position results.

• Positive (Green): Net profit
• Negative (Red): Net loss

Volume

Total value of all positions opened (in USD). Higher volume indicates more active trading but doesn't necessarily mean better performance.

Win Rate

Percentage of trades that were profitable. Formula: (Winning Trades / Total Trades) × 100

• Above 60%: Very good
• 50-60%: Good
• Below 50%: May still be profitable if winners are larger than losers

ROI (Return on Investment)

Percentage return relative to capital deployed. Formula: (Total PnL / Total Collateral Used) × 100

ROI shows how efficiently a trader uses their capital. A trader with high ROI but low PnL might be capital-efficient but small-scale.

Sharpe Ratio

Risk-adjusted return metric. Higher is better. Formula: (Average Return - Risk-Free Rate) / Standard Deviation of Returns

• Above 2.0: Excellent risk-adjusted returns
• 1.0-2.0: Good risk-adjusted returns
• Below 1.0: Poor risk-adjusted returns

A Sharpe ratio of 2.0 means the trader earns 2 units of return for every unit of risk taken.

Average Leverage

Mean leverage used across all positions. Indicates risk appetite and trading style.

• 1-5x: Conservative
• 5-20x: Moderate
• Above 20x: Aggressive

Filtering & Sorting

PerpsTracker provides powerful filtering and sorting capabilities across all pages.

Leaderboard Sorting

Click any column header to sort the leaderboard:

• First click: Sort ascending
• Second click: Sort descending
• Default: Sorted by rank (best to worst)

Combined Filtering (Pro/Elite)

On the Live Trades page, you can combine multiple filters for powerful analysis:

Example Use Cases:

1. Tracking Top Daily Traders:
   • Leaderboard: 24 Hours
   • Rank: Top 10
   • Timeframe: Last 4 hours
   • Position: All
2. Finding Long-Term Short Bias:
   • Leaderboard: 365 Days
   • Rank: Top 50
   • Position: Short Only
   • Timeframe: Last 24 hours
3. Monitoring Recent Activity from Best Traders:
   • Leaderboard: 7 Days
   • Rank: Top 25
   • Timeframe: Last 30 minutes

Custom Alerts & Webhooks (Elite Only) COMING SOON

Elite users will be able to set up custom alerts and webhooks based on trading activity and performance metrics. This feature is currently in development.

Planned Alert Types

1. Trade Alerts

Get notified when specific traders open or close positions:

• Track specific wallet addresses
• Filter by position size (e.g., positions over $100k)
• Filter by leverage (e.g., positions using 10x+ leverage)
• Filter by token (e.g., only BTC or ETH trades)

2. Leaderboard Change Alerts

Monitor leaderboard movements:

• New traders entering top 10/50/100
• Significant rank changes (e.g., jumped 20+ positions)
• Traders falling out of top rankings

3. Performance Alerts

Set thresholds for performance metrics:

• Win rate crosses above/below threshold
• PnL reaches specific amount
• Sharpe ratio changes

Telegram Integration COMING SOON

Elite users will be able to receive alerts via Telegram:

1. Generate API key from your dashboard
2. Connect Telegram bot using provided instructions
3. Configure alert preferences and conditions
4. Receive instant notifications when conditions are met

API Access (Elite Only)

Elite subscribers get full API access for building custom tools and automated trading systems.

What You Can Do

• Query real-time leaderboard data
• Access historical trading data
• Retrieve individual trader statistics
• Get live trade feeds programmatically
• Set up webhooks for real-time notifications
• Export data for analysis and backtesting

Getting Your API Key

1. Subscribe to Elite plan
2. Log in to your account dashboard
3. Navigate to API Settings
4. Click "Generate New API Key"
5. Securely store your key (it's only shown once)

Rate Limits

Elite API access includes dual-layer rate limiting:

• Burst Limit: Maximum requests per second (prevents instant spikes)
• Sustained Limit: Maximum requests per minute (controls average usage)

For full API documentation with endpoints, parameters, and examples, visit the API Documentation page.

Best Practices

Get the most out of PerpsTracker with these recommended practices.

For Learning and Improvement

1. Focus on Consistent Traders: Use the "Most Consistent Traders" section to find traders who perform well across all timeframes
2. Study Multiple Metrics: Don't just look at PnL. Analyze Sharpe ratio, win rate, and leverage to understand the complete picture
3. Track Over Time: Follow specific traders across different market conditions to see how they adapt
4. Learn from Losses: Study what happened when top traders had losing streaks

For Active Trading

1. Use Live Trades for Timing: Watch when top traders are entering/exiting to get market timing insights
2. Check Multiple Timeframes: Confirm trends across 24h, 7d, and 30d leaderboards
3. Monitor Leverage Changes: Increasing leverage among top traders may indicate strong conviction
4. Set Up Alerts: (Elite) Get notified when top traders make significant moves

For Research and Analysis

1. Export Data Regularly: (Pro/Elite) Download historical data for trend analysis
2. Compare Across Assets: See which tokens top traders prefer
3. Analyze Position Sizing: Study how top traders size their positions relative to their capital
4. Track Sector Trends: Notice when top traders shift focus between assets

Common Pitfalls to Avoid

• Blindly Copying Trades: Top traders may have different risk tolerance, capital, and goals
• Only Looking at Short Timeframes: 24h leaders might just be lucky. Check longer timeframes
• Ignoring Risk Metrics: High PnL with terrible Sharpe ratio means unsustainable risk-taking
• Overtrading Based on Live Feed: Not every trade you see is worth following