> ## 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. # public/get_live_auctions > Returns every liquidation auction open right now, each priced for a maximal bid at the moment of the response: the cash a bid would cost, the largest fraction of the account it could take, the account's mark-to-market value, the expected discount profit, and the balances on offer. Takes no parameters. This is the polling counterpart to the auctions.watch channel and carries the same values; both a solvent auction's price and the fraction on offer move with wall-clock and with the account's mark, so a quote is only good for the instant it was taken. ## OpenAPI ````yaml /openapi.json post /public/get_live_auctions 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: /public/get_live_auctions: post: tags: - Liquidations summary: public/get_live_auctions description: >- Returns every liquidation auction open right now, each priced for a maximal bid at the moment of the response: the cash a bid would cost, the largest fraction of the account it could take, the account's mark-to-market value, the expected discount profit, and the balances on offer. Takes no parameters. This is the polling counterpart to the auctions.watch channel and carries the same values; both a solvent auction's price and the fraction on offer move with wall-clock and with the account's mark, so a quote is only good for the instant it was taken. operationId: public_get_live_auctions requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EmptyRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/PublicGetLiveAuctionsResponse' default: description: JSON-RPC error (see Error Codes) components: schemas: EmptyRequest: description: >- This method takes no parameters; send an empty object `{}`. Braced rather than a unit struct so schemars emits `{"type": "object"}`: a unit struct emits `null`, which contradicts the line above and forced every generated client to cast around the params type. type: object PublicGetLiveAuctionsResponse: type: object required: - auctions properties: auctions: type: array items: $ref: '#/components/schemas/LiveAuction' LiveAuction: description: >- One ongoing auction, priced for a maximal bid at `timestamp`. The price decays with wall-clock and moves with the account's mark-to-market, so a quote is only good for the instant it was taken. type: object required: - estimated_bid_price - estimated_discount_pnl - estimated_mtm - estimated_percent_bid - margin_type - min_price_limit - subaccount_balances - subaccount_id - timestamp properties: currency: description: Only set when the auctioned account is not on standard margin. type: - string - 'null' estimated_bid_price: description: >- Discounted mark value of the whole account, not scaled by the bid percent. Negative for an insolvent auction, where the bidder is paid. type: string estimated_discount_pnl: description: >- Profit relative to `estimated_mtm` if the bid fills at `estimated_percent_bid` and `estimated_bid_price`. type: string estimated_mtm: description: >- Undiscounted mark value of the whole account, net of cash already paid in by earlier bidders. type: string estimated_percent_bid: description: The largest fraction of the account a bid can take right now. type: string margin_type: description: >- Bid from an account on the same margin type to avoid unsupported-currency and max-account-size errors. type: string min_price_limit: description: >- Cash required to buy `estimated_percent_bid` of the account — the `price_limit` to pass to `private/liquidate`. Scale it down in proportion if bidding less. type: string subaccount_balances: description: >- Balance per asset name. A bid acquires `estimated_percent_bid` of each. type: object additionalProperties: type: string subaccount_id: type: integer format: uint64 minimum: 0 timestamp: description: Milliseconds since epoch at which this quote was priced. type: integer format: int64 ```` ## Related topics - [private/liquidate](/api-reference/liquidations/privateliquidate.md) - [public/get_all_live_instruments](/api-reference/market-data/publicget_all_live_instruments.md) - [Auctions watch](/api-reference/channels/auctionswatch.md)