Liquidation records

GET/api/v1/px/liquidationsBearer

PX Discovery & AccountE6 decimal strings throughoutA | B

This account's liquidation history. A non-zero badDebtE6 means the proceeds did not cover the debt and the insurance pool absorbed the shortfall — the record is a fact that already happened, not an open item.

Send Authorization: Bearer <token>. The token is issued by POST /api/v1/auth/verify, and expires after 24h idle or 7d after issuance.

Response

200Liquidation records

liquidationsobject(PxLiquidation)[]
Liquidation records, newest first
liquidationIdstring
Liquidation record id
Example"liquidation_01K5H2M3N7"
questionstringnullable
Market question
Example"Will BTC clos…c 31, 2026?"
marketSlugstringnullable
Market slug
outcomestring
The side that was liquidated, A or B
seizedQuantityE6string
Size seized, as an E6 string
proceedsE6string
Proceeds from the disposal, as an E6 string
debtRepaidE6string
The part of it applied to debt, as an E6 string
penaltyE6string
Liquidation penalty, as an E6 string
badDebtE6string
Bad debt. Non-zero means the proceeds did not cover the debt and the insurance pool absorbed the shortfall
createdAtstringnullable
Time the liquidation happened

Switch status codes in the response example to view errors. For all codes, see the Errors page.

Request

curl -X GET "$BASE_URL/api/v1/px/liquidations" \
  -H "Authorization: Bearer $TOKEN"

Response

Liquidation records

{
  "liquidations": [
    {
      "liquidationId": "liquidation_01K5H2M3N7",
      "question": "Will BTC close above $120,000 on Dec 31, 2026?",
      "marketSlug": null,
      "outcome": "<outcome>",
      "seizedQuantityE6": "<seizedQuantityE6>",
      "proceedsE6": "<proceedsE6>",
      "debtRepaidE6": "<debtRepaidE6>",
      "penaltyE6": "<penaltyE6>",
      "badDebtE6": "<badDebtE6>",
      "createdAt": null
    }
  ]
}

Response

200Liquidation records

liquidationsobject(PxLiquidation)[]
Liquidation records, newest first
liquidationIdstring
Liquidation record id
Example"liquidation_01K5H2M3N7"
questionstringnullable
Market question
Example"Will BTC clos…c 31, 2026?"
marketSlugstringnullable
Market slug
outcomestring
The side that was liquidated, A or B
seizedQuantityE6string
Size seized, as an E6 string
proceedsE6string
Proceeds from the disposal, as an E6 string
debtRepaidE6string
The part of it applied to debt, as an E6 string
penaltyE6string
Liquidation penalty, as an E6 string
badDebtE6string
Bad debt. Non-zero means the proceeds did not cover the debt and the insurance pool absorbed the shortfall
createdAtstringnullable
Time the liquidation happened

Switch status codes in the response example to view errors. For all codes, see the Errors page.