Overview
Get payout queue information for positions that have been closed but are waiting for settlement. When the protocol treasury has insufficient funds to immediately pay out closed positions, they are placed in a First-In-First-Out (FIFO) payout queue.This endpoint does NOT require authentication and provides queue status information for any wallet address.
Path Parameters
Ethereum wallet address to check queue positions for.Format: 42-character hex string starting with “0x”
Example: “0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46”
Example: “0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46”
Response Structure
The response is a dictionary where each key is a position ID (as string) and the value contains queue information for that specific position.Queue Entry Properties
The position ID that is in the payout queue
USD amount ahead of this position in the queue
Original margin amount for this position
Realized profit/loss when position was closed
Total amount to be paid out (margin + realized_pnl)
Numerical position in the payout queue (1 = next to be paid)
Estimated ISO timestamp when payout will be processed
Payout Queue Mechanics
How the Queue Works
Position Closure
When you close a position:- PnL Calculation: System calculates your profit/loss
- Payout Amount: Determines net amount owed to you
- Treasury Check: Verifies if treasury has sufficient funds
- Settlement Type: Immediate payout or queue placement
Queue Placement
Positions enter the queue when:- Treasury insufficient: Not enough funds for immediate payout
- Large payouts: Significant wins that exceed available treasury
- High volume periods: Multiple large payouts occurring simultaneously
Processing Order
Queue operates on First-In-First-Out (FIFO) basis:- Position 1: Next to be paid when funds are available
- Position 2: Second in line
- Position N: Your position number in the queue
Treasury Management
Funding Sources
Treasury receives funds from:- Trading fees: Collected from all position operations
- Liquidation proceeds: Assets from liquidated positions
- Protocol revenue: Various protocol fee streams
- Emergency reserves: Additional funds if needed
Payout Processing
- Continuous monitoring: System checks treasury balance regularly
- Automatic processing: Pays queue positions as funds become available
- Batch payments: May process multiple queue positions simultaneously
- No manual intervention: Fully automated payout system
Queue Status Information
Queue Position
Your position number indicates:- Position 1: You’re next to be paid
- Position 2-5: High priority, typically paid within hours
- Position 6-20: Medium priority, usually paid within 24 hours
- Position 20+: Lower priority, may take longer depending on treasury flow
USD Ahead
The amount ahead of you represents:- Total payouts: Sum of all payouts before yours in the queue
- Treasury requirement: How much the treasury needs before your turn
- Processing indicator: Helps estimate payout timing
Estimated Processing Time
While not guaranteed, typical processing times:- 0-1000 USD ahead: Usually within 1-6 hours
- 1000-5000 USD ahead: Typically 6-24 hours
- 5000-20000 USD ahead: Usually 1-3 days
- 20000+ USD ahead: May take longer, depends on treasury inflow
Use Cases
Payout Tracking
- Monitor progress: Track your position in the queue
- Estimate timing: Get rough idea of when you’ll be paid
- Plan finances: Know when funds will be available
- Set expectations: Understand payout delays are temporary
User Communication
- Status updates: Inform users about their queue position
- Progress indicators: Show movement through the queue
- Transparency: Provide clear information about payout status
- Education: Explain why some payouts are delayed
System Monitoring
- Queue length: Monitor overall queue health
- Treasury status: Understand protocol liquidity
- Processing rate: Track how quickly queue moves
- Anomaly detection: Identify unusual queue buildup
Error Responses
Invalid wallet address format
No queue positions found for this wallet (no pending payouts)
Usage Examples
Check Queue Status
Monitor Queue Progress
Queue Progress Visualization
Queue Analytics
Integration Best Practices
User Experience
- Clear communication: Explain what queue position means
- Regular updates: Check queue status periodically
- Progress indicators: Show visual progress through queue
- Realistic expectations: Don’t promise specific timeframes
Error Handling
- Handle 404s gracefully: Not being in queue is often good news
- Network resilience: Implement retry logic for failed requests
- User feedback: Provide clear error messages
- Fallback states: Show appropriate UI when data unavailable
Performance
- Reasonable polling: Don’t check too frequently (30-60 seconds minimum)
- Cache briefly: Queue positions don’t change rapidly
- Batch requests: If checking multiple wallets, space out requests
- Error backoff: Reduce frequency if errors occur
Queue System Transparency
Why Queues Exist
- Capital efficiency: Allows leverage without requiring full backing
- Risk management: Prevents treasury depletion during high volume
- Fairness: FIFO ensures fair processing order
- Sustainability: Maintains protocol health during volatile periods
Queue Processing
- Automated: No manual intervention required
- Continuous: Processes 24/7 as funds become available
- Fair: Strictly first-in-first-out ordering
- Reliable: Guaranteed payout, just potentially delayed
Monitoring and Transparency
- Public data: Queue positions are transparent and verifiable
- Real-time updates: Status changes immediately reflect in API
- No favoritism: All users processed in strict order
- Predictable: Treasury inflows follow consistent patterns
Related Endpoints
- Get Positions - View all positions including those awaiting payout
- Close Position - Close positions (may result in queue placement)
- Account Info - Check account balance after payouts
- Dashboard - Comprehensive view including queue status
Queue positions are processed automatically as treasury funds become available. The system operates 24/7 with no manual intervention required.
If you’re frequently in the payout queue, consider smaller position sizes or closing positions during periods of lower network activity.
Queue positions are estimates based on current conditions. Actual processing times may vary depending on treasury inflows and overall system activity.
Path Parameters
Ethereum wallet address