Position Management
Get Queue Positions
Get payout queue information for pending positions
GET
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
Error Responses
Invalid wallet address format
No queue positions found for this wallet (no pending payouts)
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.