> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strike.markets/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Queue Positions

> Get payout queue information for pending positions

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.strike.markets/positions/0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46/queue-positions"
  ```

  ```javascript JavaScript theme={null}
  const walletAddress = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46";

  const response = await fetch(`https://api.strike.markets/positions/${walletAddress}/queue-positions`);
  const queueInfo = await response.json();

  console.log('Queue information:', queueInfo);
  ```

  ```python Python theme={null}
  import requests

  wallet_address = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46"

  response = requests.get(f'https://api.strike.markets/positions/{wallet_address}/queue-positions')
  queue_info = response.json()

  print('Queue information:', queue_info)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "queuePositions": {
      "12346": "1250.75",
      "12347": "3500.25"
    }
  }
  ```
</ResponseExample>

## 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.

<Note>
  This endpoint does NOT require authentication and provides queue status information for any wallet address.
</Note>

## Path Parameters

<ParamField path="wallet_address" type="string" required>
  Ethereum wallet address to check queue positions for.

  **Format**: 42-character hex string starting with "0x"\
  **Example**: "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46"
</ParamField>

## 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

<ResponseField name="position_id" type="integer">
  The position ID that is in the payout queue
</ResponseField>

<ResponseField name="queue_position_usd" type="number">
  USD amount ahead of this position in the queue
</ResponseField>

<ResponseField name="margin" type="number">
  Original margin amount for this position
</ResponseField>

<ResponseField name="realized_pnl" type="number">
  Realized profit/loss when position was closed
</ResponseField>

<ResponseField name="net_payout" type="number">
  Total amount to be paid out (margin + realized\_pnl)
</ResponseField>

<ResponseField name="position_in_queue" type="integer">
  Numerical position in the payout queue (1 = next to be paid)
</ResponseField>

<ResponseField name="estimated_payout_time" type="string">
  Estimated ISO timestamp when payout will be processed
</ResponseField>

## Error Responses

<ResponseField name="400 Bad Request" type="object">
  Invalid wallet address format

  ```json theme={null}
  {
    "error": 400,
    "message": "Invalid wallet address format"
  }
  ```
</ResponseField>

<ResponseField name="404 Not Found" type="object">
  No queue positions found for this wallet (no pending payouts)

  ```json theme={null}
  {
    "error": 404,
    "message": "No positions in payout queue for this wallet"
  }
  ```
</ResponseField>

## Related Endpoints

* **[Get Positions](/api-reference/positions/get-positions)** - View all positions including those awaiting payout
* **[Close Position](/api-reference/trading/close)** - Close positions (may result in queue placement)
* **[Account Info](/api-reference/account/account-info)** - Check account balance after payouts
* **[Dashboard](/api-reference/account/dashboard)** - Comprehensive view including queue status

<Info>
  Queue positions are processed automatically as treasury funds become available. The system operates 24/7 with no manual intervention required.
</Info>

<Tip>
  If you're frequently in the payout queue, consider smaller position sizes or closing positions during periods of lower network activity.
</Tip>

<Warning>
  Queue positions are estimates based on current conditions. Actual processing times may vary depending on treasury inflows and overall system activity.
</Warning>


## OpenAPI

````yaml GET /positions/{wallet_address}/queue-positions
openapi: 3.1.0
info:
  title: Strike Protocol API
  description: >-
    Strike Protocol is a perpetual futures trading platform that allows users to
    trade with leverage (1-1000x) on various crypto assets. This API provides
    access to trading operations, account management, market data, analytics,
    and user systems.
  version: 1.0.0
  contact:
    name: Strike Protocol
    url: https://strike.markets
  license:
    name: MIT
servers:
  - url: https://api.strike.markets
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /positions/{wallet_address}/queue-positions:
    get:
      summary: Get Queue Positions
      description: Get payout queue information for pending positions
      operationId: getQueuePositions
      parameters:
        - name: wallet_address
          in: path
          required: true
          description: Ethereum wallet address
          schema:
            type: string
            pattern: ^0x[a-fA-F0-9]{40}$
      responses:
        '200':
          description: Queue positions retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  queuePosition:
                    type: integer
                    description: Position in the payout queue
                  usdAhead:
                    type: string
                    description: USD amount ahead in queue
      security: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Strike Protocol API key authentication

````