> ## 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 liquidated positions of account

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

`GET /v1/liquidations`




## OpenAPI

````yaml orderly.openapi get /v1/liquidations
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/liquidations:
    get:
      tags:
        - private
      summary: Get liquidated positions of account
      description: |
        **Limit: 10 requests per 1 second per IP address**

        `GET /v1/liquidations`
      parameters:
        - name: symbol
          in: query
          description: ''
          required: false
          example: ''
          schema:
            type: string
        - name: start_t
          in: query
          description: ''
          required: false
          example: ''
          schema:
            type: number
        - name: end_t
          in: query
          description: ''
          required: false
          example: ''
          schema:
            type: number
        - name: page
          in: query
          description: start from 1
          required: false
          example: ''
          schema:
            type: number
        - name: size
          in: query
          description: ''
          required: false
          example: ''
          schema:
            type: number
        - name: sort_by
          in: query
          description: '`liquidation_id`/`time`'
          required: false
          example: ''
          schema:
            type: string
        - name: liquidation_id
          in: query
          description: return the designed liquidation_id only
          required: false
          example: ''
          schema:
            type: number
        - $ref: '#/components/parameters/orderly_timestamp'
        - $ref: '#/components/parameters/orderly_account_id'
        - $ref: '#/components/parameters/orderly_key'
        - $ref: '#/components/parameters/orderly_signature'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiquidationsResponse'
      deprecated: false
components:
  parameters:
    orderly_timestamp:
      name: orderly-timestamp
      in: header
      description: Timestamp of the signed request in milliseconds.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: '1649920583000'
    orderly_account_id:
      name: orderly-account-id
      in: header
      description: Account ID of the authenticated account.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: 6.858456565150415e+75
    orderly_key:
      name: orderly-key
      in: header
      description: Public orderly key used to sign the request.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: ed25519:8tm7dnKYkSc3FzgPuJaw1wztr79eeZpN35nHW5pL5XhX
    orderly_signature:
      name: orderly-signature
      in: header
      description: Signature of the request payload generated with the orderly key.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: >-
        dG4bkKiqG0dUYLzViRZkvbI6Sy239JxAdNMIBxFZ4w030Jofr0ORV06GHtvXZkaZaWUXE+XAU3fnzKN/5fDeBQ==
  schemas:
    LiquidationsResponse:
      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:
                      liquidation_id:
                        type: number
                        example: 101
                      timestamp:
                        type: number
                        example: 1663313562090
                      transfer_amount_to_insurance_fund:
                        type: number
                        example: 0
                      margin_ratio:
                        type: number
                        example: 0.10436069
                      account_mmr:
                        type: number
                        example: 0.012
                      position_notional:
                        type: number
                        example: 28.415534
                      collateral_value:
                        type: number
                        example: 2.965465
                      positions_by_perp:
                        type: array
                        items:
                          type: object
                          required:
                            - total_position
                            - abs_insurance_fund_fee
                            - abs_liquidation_fee
                            - cost_position_transfer
                            - insurance_fund_fee
                            - liquidator_fee
                            - position_qty
                            - symbol
                            - transfer_price
                          properties:
                            total_position:
                              type: number
                              example: 41.6
                            mark_price:
                              type: number
                              example: 123400
                            symbol:
                              type: string
                              example: PERP_BTC_USDC
                            position_qty:
                              type: number
                              example: 0.00017
                            liquidator_fee:
                              type: number
                              example: 0.006
                            cost_position_transfer:
                              type: number
                              example: 21.002786
                            transfer_price:
                              type: number
                              example: 123545.8
                            insurance_fund_fee:
                              type: number
                              example: 0.006
                            abs_insurance_fund_fee:
                              type: number
                              example: 0.126017
                            abs_liquidator_fee:
                              type: number
                              example: 0.252034
    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

````