delegatorSummary - HyperCore Info Endpoint
Get comprehensive delegation summary for a delegator on Hyperliquid. Track staking positions, rewards, and validator relationships.
Get comprehensive delegation summary for a delegator, including staking positions, rewards, and validator relationships.
The live response is a flat object with delegated, undelegated, totalPendingWithdrawal, and nPendingWithdrawals.
Authenticate HyperCore Info requests by sending your Dwellir API key in the x-api-key header to https://api-hyperliquid-mainnet-info.n.dwellir.com/info.
When to Use This Endpoint
The delegatorSummary endpoint is essential for:
- Staking Portfolio — View all delegations for a delegator
- Rewards Tracking — Monitor staking rewards across validators
- Delegation Analysis — Analyze delegation strategy and distribution
- Validator Selection — Evaluate current validator relationships
Common Use Cases
1. View Staking Portfolio
Display all delegations for a user:
async function viewStakingPortfolio(userAddress) {
const summary = await getDelegatorSummary(userAddress);
console.log('=== Staking Portfolio ===\n');
console.log(`Delegated: ${summary.delegated}`);
console.log(`Undelegated: ${summary.undelegated}`);
console.log(`Pending withdrawals: ${summary.nPendingWithdrawals}`);
if (parseFloat(summary.delegated) === 0) {
console.log('No active delegations');
}
}
// Usage
await viewStakingPortfolio('0x420a4ed7b6bb361da586868adec2f2bb9ab75e66');2. Track Delegation Changes
Monitor changes in delegation status:
async function trackDelegations(userAddress) {
const summary = await getDelegatorSummary(userAddress);
return {
delegated: summary.delegated,
undelegated: summary.undelegated,
hasActiveDelegations: parseFloat(summary.delegated) > 0,
timestamp: new Date().toISOString()
};
}
// Usage
const status = await trackDelegations('0x420a4ed7b6bb361da586868adec2f2bb9ab75e66');
console.log('Delegation status:', status);3. Build Staking Dashboard
Create a comprehensive staking dashboard:
async function getStakingDashboard(userAddress) {
try {
const summary = await getDelegatorSummary(userAddress);
return {
status: 'success',
delegated: summary.delegated,
undelegated: summary.undelegated,
totalPendingWithdrawal: summary.totalPendingWithdrawal,
nPendingWithdrawals: summary.nPendingWithdrawals,
lastUpdated: new Date().toISOString()
};
} catch (error) {
return {
status: 'error',
error: error.message
};
}
}4. Compare Delegation Strategies
Analyze delegation distribution:
async function analyzeDelegationStrategy(userAddress) {
const summary = await getDelegatorSummary(userAddress);
const analysis = {
delegated: summary.delegated,
undelegated: summary.undelegated,
delegationStatus: parseFloat(summary.delegated) > 0 ? 'active' : 'inactive'
};
console.log('Delegation Analysis:', analysis);
return analysis;
}Best Practices
- Validate addresses — Ensure user addresses are valid Ethereum addresses
- Cache data — Cache delegation data for several minutes to reduce API calls
- Handle empty states — Account for users with no delegations
- Monitor regularly — Track delegation changes for portfolio management
- Implement pagination — For users with many delegations, display in batches
Related Endpoints
- delegations — Get detailed staking delegation information
- validatorL1Votes — Get validator voting information
- clearinghouseState — Get account trading state
- userFees — Get user fee information
Access real-time Hyperliquid delegation data with Dwellir's HyperCore Info Endpoint. Get your API key →
delegations
Get detailed staking delegation information for a user on Hyperliquid. Track validators, amounts, rewards, and delegation history.
exchangeStatus
Monitor Hyperliquid exchange health and status with real-time timestamps. Essential for health checks, data freshness verification, and maintenance monitoring.