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

# Get positions under liquidation

> **Limit: 10 requests per 1 second per IP address**

`GET /v1/public/liquidation`

Returns a list of positions that are currently being liquidated. These are positions where the margin has dropped below the maintenance margin requirement and are in the process of being closed by the liquidation engine.




## OpenAPI

````yaml orderly.openapi get /v1/public/liquidation
openapi: 3.0.1
info:
  title: EVM
  description: ''
  version: 1.0.0
servers:
  - url: https://api.orderly.org
    description: Mainnet
  - url: https://testnet-api.orderly.org
    description: Testnet
security: []
tags:
  - name: public
  - name: private
paths:
  /v1/public/liquidation:
    get:
      tags:
        - public
      summary: Get positions under liquidation
      description: >
        **Limit: 10 requests per 1 second per IP address**


        `GET /v1/public/liquidation`


        Returns a list of positions that are currently being liquidated. These
        are positions where the margin has dropped below the maintenance margin
        requirement and are in the process of being closed by the liquidation
        engine.
      parameters:
        - name: start_t
          in: query
          description: >-
            start time range that you wish to query, noted that the time stamp
            is a 13-digits timestamp.
          required: false
          example: ''
          schema:
            type: number
        - name: end_t
          in: query
          description: >-
            end time range that you wish to query, noted that the time stamp is
            a 13-digits timestamp.
          required: false
          example: ''
          schema:
            type: number
        - name: page
          in: query
          description: the page you wish to query. start from 1
          required: false
          example: ''
          schema:
            type: integer
        - name: size
          in: query
          description: 'Default: 60'
          required: false
          example: ''
          schema:
            type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiquidationResponse'
      deprecated: false
components:
  schemas:
    LiquidationResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          required:
            - data
          properties:
            data:
              type: object
              required:
                - meta
                - rows
              properties:
                meta:
                  $ref: '#/components/schemas/PaginationMeta'
                rows:
                  type: array
                  items:
                    type: object
                    properties:
                      timestamp:
                        type: integer
                        example: 1685298157704
                      type:
                        type: string
                        example: liquidated
                      liquidation_id:
                        type: integer
                        example: 1730
                      positions_by_perp:
                        type: array
                        items:
                          type: object
                          properties:
                            symbol:
                              type: string
                              example: PERP_BTC_USDC
                            position_qty:
                              type: number
                              example: -0.22457
                            liquidator_fee:
                              type: number
                              example: 0.015
    BasicResponse:
      required:
        - success
      type: object
      properties:
        success:
          description: Indicates whether the request was successful.
          type: boolean
          example: true
        timestamp:
          description: Server timestamp in milliseconds.
          type: integer
          example: 1702989203989
    PaginationMeta:
      required:
        - current_page
        - records_per_page
        - total
      type: object
      properties:
        total:
          type: integer
          example: 9
        records_per_page:
          type: integer
          example: 25
        current_page:
          type: integer
          example: 1
          description: start from 1

````