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

# Claim liquidated positions

> **Limit: 5 requests per 1 second**

`POST /v1/liquidation`




## OpenAPI

````yaml orderly.openapi post /v1/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/liquidation:
    post:
      tags:
        - private
      summary: Claim liquidated positions
      description: |
        **Limit: 5 requests per 1 second**

        `POST /v1/liquidation`
      parameters:
        - $ref: '#/components/parameters/orderly_timestamp'
        - $ref: '#/components/parameters/orderly_account_id'
        - $ref: '#/components/parameters/orderly_key'
        - $ref: '#/components/parameters/orderly_signature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiquidationBody'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostLiquidationResponse'
      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:
    LiquidationBody:
      required:
        - limit_price
        - liquidation_id
        - ratio_qty_request
      type: object
      properties:
        liquidation_id:
          type: integer
        ratio_qty_request:
          type: integer
        extra_liquidation_ratio:
          type: integer
        limit_price:
          type: object
          required:
            - symbol
          description: >-
            Liquidator’s instruction to let the system reject the liquidation
            claim if the following condition applies: if position_qty > 0,
            reject if mark_price > limit_price; if position_qty < 0, reject if
            mark_price < limit_price
          properties:
            symbol:
              type: number
              description: The limit price for each symbol in the liquidation claim
        symbols:
          type: object
          required:
            - ratio_qty_request
            - symbol
          description: For high risk tiers only
          properties:
            ratio_qty_request:
              type: number
              description: >-
                Field dedicated to high risk symbols liquidations type only
                (symbols with liquidation tier = 2), where a liquidator can
                specific the ratio he wish to liquidates per symbol
            symbol:
              type: string
              description: >-
                Only relevant if this is a liquidation of type high tier
                (symbols with liquidation tier = 2)
    PostLiquidationResponse:
      allOf:
        - $ref: '#/components/schemas/BasicResponse'
        - type: object
          required:
            - data
          properties:
            data:
              type: object
              required:
                - liquidation_id
                - positions_by_perp
                - timestamp
                - type
              properties:
                liquidation_id:
                  type: integer
                timestamp:
                  type: number
                type:
                  type: string
                  description: OR "claim"
                positions_by_perp:
                  type: array
                  items:
                    $ref: '#/components/schemas/PerpPosition'
    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
    PerpPosition:
      type: object
      properties:
        symbol:
          type: string
          example: PERP_BTC_USDC
        abs_liquidator_fee:
          type: number
          example: 1.152279
        cost_position_transfer:
          type: number
          example: 21.002786
        liquidator_fee:
          type: number
          example: 0.006
        position_qty:
          type: number
          example: 0.00017
        transfer_price:
          type: number
          example: 123545.8

````