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

# Get positions

> get positions

**Limit: 30 requests per 10 seconds per user**

<ResponseExample>
  ```bash theme={null}
  {
      "success": true,
      "data": {
          "positions": [
              {
                  "symbol": "PERP_BTC_USDT",
                  "holding": "1.0234",
                  "positionSide": "BOTH",
                  "pendingLongQty": "0.0",
                  "pendingShortQty": "0.0",
                  "settlePrice": "27903.2",
                  "averageOpenPrice": "27903.2",
                  "pnl24H": "0.0",
                  "fee24H": "0.0",
                  "markPrice": "27903.2",
                  "estLiqPrice": "0.0",
                  "adlQuantile": 1,
                  "timestamp": 1696663260695
              },
              ...
          ]
      },
      "timestamp": 1696663264324
  }

  ```
</ResponseExample>


## OpenAPI

````yaml GET /v3/futures/positions
openapi: 3.0.2
info:
  title: Swagger Petstore - OpenAPI 3.0
  description: >-
    This is a sample Pet Store Server based on the OpenAPI 3.0 specification. 
    You can find out more about

    Swagger at [http://swagger.io](http://swagger.io). In the third iteration of
    the pet store, we've switched to the design first approach!

    You can now help us improve the API whether it's by making changes to the
    definition itself or to the code.

    That way, with time, we can improve the API in general, and expose some of
    the new features in OAS3.


    Some useful links:

    - [The Pet Store
    repository](https://github.com/swagger-api/swagger-petstore)

    - [The source API definition for the Pet
    Store](https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml)
  termsOfService: http://swagger.io/terms/
  contact:
    name: API Team
    email: apiteam@swagger.io
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.0.19
servers:
  - url: https://api.woox.io/
security: []
externalDocs:
  description: Find out more about Swagger
  url: http://swagger.io
paths:
  /v3/futures/positions:
    get:
      description: get positions
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
            example: abcdef123456
          description: ''
        - name: x-api-signature
          in: header
          required: true
          schema:
            type: string
            example: signaturestring
          description: ''
        - name: x-api-timestamp
          in: header
          required: true
          schema:
            type: string
            example: '1718943200000'
          description: ''
        - name: symbol
          in: query
          description: Symbol name
          required: true
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPositionsResponse'
      security: []
components:
  schemas:
    GetPositionsResponse:
      allOf:
        - $ref: '#/components/schemas/CommonResponse'
        - type: object
          properties:
            data:
              type: object
              properties:
                rows:
                  type: array
                  items:
                    type: object
                    properties:
                      symbol:
                        type: string
                        description: The trading pair symbol, e.g., PERP_BTC_USDT.
                      holding:
                        type: string
                        description: >-
                          The current holding quantity of the asset in the
                          position.
                      positionSide:
                        type: string
                        description: >-
                          The position side, such as 'BOTH' for a long and short
                          position.
                        enum:
                          - BOTH
                          - LONG
                          - SHORT
                      pendingLongQty:
                        type: string
                        description: The pending quantity for a long position.
                      pendingShortQty:
                        type: string
                        description: The pending quantity for a short position.
                      settlePrice:
                        type: string
                        description: The price at which the position will be settled.
                      averageOpenPrice:
                        type: string
                        description: The average price at which the position was opened.
                      pnl24H:
                        type: string
                        description: >-
                          The profit and loss (PnL) for the position in the last
                          24 hours.
                      fee24H:
                        type: string
                        description: The total fee for the position in the last 24 hours.
                      markPrice:
                        type: string
                        description: The mark price of the position.
                      estLiqPrice:
                        type: string
                        description: The estimated liquidation price of the position.
                      adlQuantile:
                        type: integer
                        description: The ADL quantile, a risk management factor.
                      timestamp:
                        type: integer
                        format: int64
                        description: >-
                          The timestamp of the position data in Unix epoch time
                          (milliseconds).
    CommonResponse:
      type: object
      properties:
        success:
          type: boolean
          description: 'true'
        timestamp:
          type: integer
          description: timestamp

````