Overview
Get comprehensive dashboard data for a wallet address, combining account information, position data, performance analytics, and points balance in a single response. This endpoint provides everything needed to build a complete user dashboard.This endpoint does NOT require authentication and provides a consolidated view of all account-related data.
Path Parameters
Ethereum wallet address to retrieve dashboard data for.Format: 42-character hex string starting with “0x”
Example: “0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46”
Example: “0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46”
Response Fields
Amount available for immediate withdrawal (in USD)
Array of currently open positions with real-time calculations
Array of closed positions waiting in payout queue
Array of fully settled positions (completed or liquidated)
Current reward points balance for the wallet address
Dashboard Metrics
Trading Performance
Total Volume
Total PnL
Win Rate
Account Health
Margin Utilization
Available Capital
Use Cases
Comprehensive Account Overview
- Single API call: Get all account data at once
- Dashboard building: Perfect for user dashboard interfaces
- Performance tracking: Monitor trading performance over time
- Risk management: Assess overall account health
Portfolio Management
- Position monitoring: Track all open positions and their performance
- Balance management: Monitor available vs. reserved funds
- Historical performance: Review past trading results
- Points tracking: Monitor loyalty program status
Analytics and Reporting
- Performance metrics: Calculate key trading statistics
- Risk assessment: Evaluate account risk exposure
- Progress tracking: Monitor improvement over time
- Goal setting: Set targets based on current performance
Error Responses
Invalid wallet address format
Wallet address not found in system (no activity)
Usage Examples
Basic Dashboard Data
Current Position Summary
Performance Analytics
Risk Assessment
Dashboard Widgets
Account Summary Widget
Active Positions Widget
Performance Chart Data
Best Practices
Data Refresh Strategy
- Real-time updates: Refresh after trading operations
- Polling frequency: Update every 30-60 seconds for active dashboards
- Selective updates: Use specific endpoints for frequent updates
- Error handling: Gracefully handle API failures
UI Implementation
- Loading states: Show placeholders while data loads
- Error states: Handle cases where data is unavailable
- Performance: Cache data appropriately to reduce API calls
- Responsive design: Adapt dashboard layout to screen size
Data Visualization
- Balance charts: Show balance trends over time
- PnL visualization: Display profit/loss patterns
- Position status: Clear indicators for position health
- Risk metrics: Visual risk level indicators
Performance Considerations
Caching Strategy
Optimized Updates
For frequently changing data (like unrealized PnL), consider:- Using WebSocket connections for real-time updates
- Updating only specific sections instead of entire dashboard
- Implementing incremental updates for large position lists
Related Endpoints
This endpoint combines data from:- Account Balances - Balance and transaction data
- Get Positions - Position information
- Analytics - Performance calculations
Use this endpoint for initial dashboard loads, then use specific endpoints for frequent updates to reduce bandwidth and improve performance.
Dashboard data provides a snapshot at request time. For real-time trading applications, consider implementing WebSocket connections or frequent polling for critical metrics.
Path Parameters
Ethereum wallet address