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

# private/liquidate

> Bids on an open liquidation auction. Names the bidder's own subaccount, the account being auctioned, the fraction of it to absorb as a whole percent (a multiple of 0.01), and a signed limit price. The limit is compared against the discounted price of the whole remaining account — the quote's estimated_bid_price — not against the cash the bid actually moves, and it is negative for an insolvent auction where the security module pays the bidder. The realized fill is capped at the auction's current maximum proportion, so it can land below the requested percent. Quote the auction first with public/get_live_auctions or the auctions.watch channel: both the price and the fraction on offer move with wall-clock and with the account's mark.



## OpenAPI

````yaml /openapi.json post /private/liquidate
openapi: 3.1.0
info:
  title: Derive v3 API
  version: 0.2.0
  description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST.
servers:
  - url: https://api.derive.xyz/v3
    description: Production (HTTP POST base)
  - url: https://testnet.api.derive.xyz/v3
    description: Testnet (HTTP POST base)
security: []
tags:
  - name: Subaccounts
    description: >-
      List, inspect, and label subaccounts, portfolios, positions, and
      collateral.
  - name: Session Keys
    description: Register, edit, and list delegated signing keys.
  - name: Account
    description: Wallet-level account information and settings.
  - name: Orderbook
    description: Place, replace, cancel, and query orders, trigger orders, and algos.
  - name: RFQ
    description: 'Request-for-quote: send RFQs, quote, and execute block trades.'
  - name: Liquidations
    description: >-
      Open a Dutch auction against a breaching subaccount, quote the auctions
      running right now, bid on them, and review past ones.
  - name: Vault Shareholders
    description: >-
      Deposit into and withdraw from vaults, and track shares, requests, and
      performance.
  - name: Vault Curators
    description: >-
      Create and operate curated vaults: settle deposit and withdrawal requests,
      and manage vault metadata.
  - name: History
    description: >-
      Per-account historical records: orders, trades, transfers, and
      settlements.
  - name: Market Maker Protection
    description: Configure, read, and reset market-maker protection.
  - name: Transfers & Withdrawals
    description: Move collateral between subaccounts, to other wallets, and on-chain.
  - name: Onchain Actions
    description: >-
      L1 onchain actions submitted via OnchainActionManager: register deposit
      addresses, list pending deposits, and inspect onchain action history.
  - name: System
    description: Rate limits and transaction lookups.
  - name: Market Data
    description: Instruments, currencies, tickers, and market-wide feeds.
  - name: Maker Scoring
    description: Maker programs, score breakdowns, and detailed scoring snapshots.
  - name: Referrals
    description: Referral codes and program performance.
  - name: Other
    description: Uncategorized.
paths:
  /private/liquidate:
    post:
      tags:
        - Liquidations
      summary: private/liquidate
      description: >-
        Bids on an open liquidation auction. Names the bidder's own subaccount,
        the account being auctioned, the fraction of it to absorb as a whole
        percent (a multiple of 0.01), and a signed limit price. The limit is
        compared against the discounted price of the whole remaining account —
        the quote's estimated_bid_price — not against the cash the bid actually
        moves, and it is negative for an insolvent auction where the security
        module pays the bidder. The realized fill is capped at the auction's
        current maximum proportion, so it can land below the requested percent.
        Quote the auction first with public/get_live_auctions or the
        auctions.watch channel: both the price and the fraction on offer move
        with wall-clock and with the account's mark.
      operationId: private_liquidate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrivateLiquidateRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateLiquidateResponse'
        default:
          description: JSON-RPC error (see Error Codes)
components:
  schemas:
    PrivateLiquidateRequest:
      type: object
      required:
        - liquidate_subaccount_id
        - nonce
        - percent_of_acc
        - price_limit
        - signature
        - signature_expiry_sec
        - signer
        - subaccount_id
      properties:
        liquidate_subaccount_id:
          description: Subaccount being liquidated.
          type: integer
          format: uint64
          minimum: 0
        nonce:
          type: integer
          format: int64
        percent_of_acc:
          description: >-
            Fraction of the account to liquidate (`"1.0"` = 100%), decimal
            string or JSON number. Must be a whole percent, i.e. a multiple of
            `"0.01"`.
          type: string
          format: decimal
        price_limit:
          description: Signed limit price (`"0"` opts out), decimal string or JSON number.
          type: string
          format: decimal
        signature:
          type: string
        signature_expiry_sec:
          type: integer
          format: uint64
          minimum: 0
        signer:
          type: string
        subaccount_id:
          description: Bidder subaccount.
          type: integer
          format: uint64
          minimum: 0
    PrivateLiquidateResponse:
      type: object
      required:
        - op_uuid
        - operation_id
      properties:
        op_uuid:
          type: string
        operation_id:
          type: integer
          format: uint64
          minimum: 0

````

## Related topics

- [Rate Limits](/rate-limits.md)
- [Changelog](/changelog.md)
- [public/get_live_auctions](/api-reference/liquidations/publicget_live_auctions.md)