Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.
GET
/
perps
/
liquidations
GET /perps/liquidations: Liquidation History
curl --request GET \ --url https://partner-api.bravadotrade.com/perps/liquidations
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.
Detected liquidations, oldest first. Every row carries its evidence class — confirmed, inferred or unknown — so you can tell a liquidation observed directly from one reconstructed from account state. Fields that cannot be determined are null, never 0 or false. Detection covers the gated account-snapshot universe only. Part of the Perps Data product; scope analytics.read.
GET https://partner-api.bravadotrade.com/perps/liquidations
A comma-separated subset of confirmed, inferred, unknown. Defaults to all three. unknown is never hidden, so a subset that omits it still returns unknown rows. An unrecognised value is refused with 400 invalid_evidence.
Size closed by the liquidation, or null when indeterminate — never 0. Related sizing fields (fill_size, size_before, size_after) follow the same null-not-zero rule, as do the price and equity fields (entry_price, fill_price, mark_before, mark_extreme, equity_before_usd, equity_after_usd, equity_drop_usd, liq_price_est, notional_usd) and the fee fields (liq_fee_bps, expected_liq_fee_usd, fill_fee_usd).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bravado","colors":{"primary":"#27d79f","light":"#27d79f","dark":"#27d79f"},"logo":{"light":"https://mintcdn.com/bravado/Rx5I6GxmyLNQx0kC/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=Rx5I6GxmyLNQx0kC\u0026q=85\u0026s=22dde9c0ee0fdbd8f91ce9429a54b905","dark":"https://mintcdn.com/bravado/Rx5I6GxmyLNQx0kC/logo/wordmark-dark.svg?fit=max\u0026auto=format\u0026n=Rx5I6GxmyLNQx0kC\u0026q=85\u0026s=baf2da339f0bb40af6bf80b5c8a3d8d2"},"favicon":"https://mintcdn.com/bravado/tvw-FuJ3KxnqXT6G/favicon.png?fit=max\u0026auto=format\u0026n=tvw-FuJ3KxnqXT6G\u0026q=85\u0026s=58549544d9393681903e0f24686da2c4","api":{"mdx":{"server":"https://partner-api.bravadotrade.com"}},"navbar":{"links":[{"href":"mailto:support@bravadotrade.com","label":"Support"},{"href":"https://console.bravadotrade.com/login","label":"Log in"}],"primary":{"type":"button","label":"Create account","href":"https://console.bravadotrade.com/signup"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bravado","hasAudioNarration":false,"actualSubdomain":"bravado","customDomains":["docs.bravadotrade.com"],"gitSource":{"type":"github","owner":"bravado-trade","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae2a0c540368de574dc3cee","collectionId":"1e6d737b-73ad-4745-8275-1b46fa0ad060","liveDeploymentHistoryId":"6ae2a0c540368de574dc3cee","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae2adfa71d312d7bc32ffd9","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Trade API","count":85},{"language":"default","tag":"Data API","count":42},{"language":"default","tag":"Endpoints (OpenAPI)","count":33},{"language":"default","tag":"Trader analytics","count":20},{"language":"default","tag":"Resources","count":20},{"language":"default","tag":"Perps","count":18},{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"Get Started","count":16},{"language":"default","tag":"Reference","count":14},{"language":"default","tag":"Market Data","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"html.dark{--gray-950:27 27 29;--gray-900:32 32 32;--gray-800:48 48 48;--gray-400:143 143 143}html.dark #background-color{background-color:#1b1b1d!important}html.dark #navbar-transition{background-color:#202020!important;border-color:#303030!important}#navbar .nav-logo{height:36px!important}#content-container .card div:has(>img[src^=\"/logo/\"]),#content-container .card img[src^=\"/logo/\"]{width:44px!important;height:44px!important;max-width:none!important;border-radius:10px}#sidebar{border-right:1px solid #303030}html.dark #sidebar{background:#161617}html.dark body::before{content:\"\";position:fixed;inset:0 auto 0 0;width:max(320px,calc((100vw - 1472px)/2 + 320px));background:#161617;z-index:0;pointer-events:none}html.dark #sidebar div[class*=sticky][class*=h-8]{background-image:linear-gradient(to bottom,#161617 0,rgba(22,22,23,0) 100%)!important}html.dark #sidebar div[class*=\"--scroll-area-fade-size\"]{padding-left:14px;margin-left:-14px}#sidebar a[aria-current=page]{box-shadow:0 0 12px rgba(39,215,159,.25),0 0 3px rgba(39,215,159,.15);border-radius:8px}html.dark #sidebar a[aria-current=page]{background:#2a2a2d}#assistant-entry,#assistant-entry-mobile,.chat-assistant-floating-input,.chat-assistant-sheet{display:none!important}div:has(>#search-bar-entry){flex-grow:1.25}"}],"page":{"pagePath":"api/perps-data/liquidations","slug":"/api/perps-data/liquidations","pageMetadata":{"title":"GET /perps/liquidations: Liquidation History","sidebarTitle":"GET /liquidations","api":"GET /perps/liquidations","description":"Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.","href":"/api/perps-data/liquidations"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[`Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use `,_jsx(_components.a,{href:`/authentication-examples`,children:`request signing examples`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Detected liquidations, `,_jsx(_components.strong,{children:`oldest first`}),`. Every row carries its `,_jsx(_components.code,{children:`evidence`}),` class — `,_jsx(_components.code,{children:`confirmed`}),`, `,_jsx(_components.code,{children:`inferred`}),` or `,_jsx(_components.code,{children:`unknown`}),` — so you can tell a liquidation observed directly from one reconstructed from account state. Fields that cannot be determined are `,_jsx(_components.code,{children:`null`}),`, never `,_jsx(_components.code,{children:`0`}),` or `,_jsx(_components.code,{children:`false`}),`. Detection covers the `,_jsx(_components.strong,{children:`gated account-snapshot universe only`}),`. Part of the `,_jsx(_components.a,{href:`/products/perps-data`,children:`Perps Data`}),` product; scope `,_jsx(_components.code,{children:`analytics.read`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET https://partner-api.bravadotrade.com/perps/liquidations`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`from`,type:`string`,required:true,id:`param-from`,children:_jsx(_components.p,{children:`Start of the window. Accepts RFC3339, unix seconds or unix milliseconds.`})}),`\n`,_jsx(ParamField,{query:`to`,type:`string`,required:true,id:`param-to`,children:_jsxs(_components.p,{children:[`End of the window. Same formats as `,_jsx(_components.code,{children:`from`}),`. The window may span at most `,_jsx(_components.strong,{children:`31 days`}),`; a wider range is refused with `,_jsx(_components.code,{children:`400 range_too_large`}),`.`]})}),`\n`,_jsx(ParamField,{query:`instrument`,type:`string`,id:`param-instrument`,children:_jsxs(_components.p,{children:[`Only liquidations on this instrument, by its venue-native id. Matches `,_jsx(_components.code,{children:`[A-Za-z0-9._-]{1,32}`}),`. Omit for all instruments.`]})}),`\n`,_jsx(ParamField,{query:`address`,type:`string`,id:`param-address`,children:_jsxs(_components.p,{children:[`Only liquidations for this account. A 40-hex address, with or without the `,_jsx(_components.code,{children:`0x`}),` prefix.`]})}),`\n`,_jsx(ParamField,{query:`evidence`,type:`string`,id:`param-evidence`,children:_jsxs(_components.p,{children:[`A comma-separated subset of `,_jsx(_components.code,{children:`confirmed`}),`, `,_jsx(_components.code,{children:`inferred`}),`, `,_jsx(_components.code,{children:`unknown`}),`. Defaults to all three. `,_jsx(_components.code,{children:`unknown`}),` is never hidden, so a subset that omits it still returns `,_jsx(_components.code,{children:`unknown`}),` rows. An unrecognised value is refused with `,_jsx(_components.code,{children:`400 invalid_evidence`}),`.`]})}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`200`,id:`param-limit`,children:_jsxs(_components.p,{children:[`Rows per page, `,_jsx(_components.code,{children:`1`}),`–`,_jsx(_components.code,{children:`1000`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Liquidations in `,_jsx(_components.code,{children:`data`}),`, oldest first, each with its evidence class. When `,_jsx(_components.code,{children:`has_more`}),` is `,_jsx(_components.code,{children:`true`}),`, page forward by passing `,_jsx(_components.code,{children:`next_from_ms`}),` back as `,_jsx(_components.code,{children:`from`}),`.`]}),`\n`,_jsx(ResponseField,{name:`data`,type:`array`,id:`param-data`,children:_jsxs(Expandable,{title:`Liquidation fields`,children:[_jsx(ResponseField,{name:`liq_id`,type:`string`,id:`param-liq-id`,children:_jsx(_components.p,{children:`Stable id for the detected liquidation.`})}),_jsx(ResponseField,{name:`detected_ts_ms`,type:`integer`,id:`param-detected-ts-ms`,children:_jsxs(_components.p,{children:[`When the liquidation was detected, in unix milliseconds (`,_jsx(_components.code,{children:`detected_ts`}),` in seconds).`]})}),_jsx(ResponseField,{name:`instrument`,type:`string`,id:`param-instrument-1`,children:_jsx(_components.p,{children:`The instrument liquidated, by its venue-native id.`})}),_jsx(ResponseField,{name:`venue`,type:`string`,id:`param-venue`,children:_jsx(_components.p,{children:`The venue.`})}),_jsx(ResponseField,{name:`address`,type:`string`,id:`param-address-1`,children:_jsx(_components.p,{children:`The liquidated account.`})}),_jsx(ResponseField,{name:`evidence`,type:`string`,id:`param-evidence-1`,children:_jsxs(_components.p,{children:[`How the liquidation was established: `,_jsx(_components.code,{children:`confirmed`}),` (observed directly), `,_jsx(_components.code,{children:`inferred`}),` (reconstructed from account state), or `,_jsx(_components.code,{children:`unknown`}),`.`]})}),_jsx(ResponseField,{name:`position_side`,type:`string | null`,id:`param-position-side`,children:_jsxs(_components.p,{children:[`The side liquidated, or `,_jsx(_components.code,{children:`null`}),` when it cannot be determined — never a guessed value.`]})}),_jsx(ResponseField,{name:`closed_size`,type:`string | null`,id:`param-closed-size`,children:_jsxs(_components.p,{children:[`Size closed by the liquidation, or `,_jsx(_components.code,{children:`null`}),` when indeterminate — never `,_jsx(_components.code,{children:`0`}),`. Related sizing fields (`,_jsx(_components.code,{children:`fill_size`}),`, `,_jsx(_components.code,{children:`size_before`}),`, `,_jsx(_components.code,{children:`size_after`}),`) follow the same null-not-zero rule, as do the price and equity fields (`,_jsx(_components.code,{children:`entry_price`}),`, `,_jsx(_components.code,{children:`fill_price`}),`, `,_jsx(_components.code,{children:`mark_before`}),`, `,_jsx(_components.code,{children:`mark_extreme`}),`, `,_jsx(_components.code,{children:`equity_before_usd`}),`, `,_jsx(_components.code,{children:`equity_after_usd`}),`, `,_jsx(_components.code,{children:`equity_drop_usd`}),`, `,_jsx(_components.code,{children:`liq_price_est`}),`, `,_jsx(_components.code,{children:`notional_usd`}),`) and the fee fields (`,_jsx(_components.code,{children:`liq_fee_bps`}),`, `,_jsx(_components.code,{children:`expected_liq_fee_usd`}),`, `,_jsx(_components.code,{children:`fill_fee_usd`}),`).`]})}),_jsx(ResponseField,{name:`adl`,type:`boolean | null`,id:`param-adl`,children:_jsxs(_components.p,{children:[`Whether the liquidation was an auto-deleverage, or `,_jsx(_components.code,{children:`null`}),` when indeterminate.`]})}),_jsx(ResponseField,{name:`change_kind`,type:`string`,id:`param-change-kind`,children:_jsxs(_components.p,{children:[`The kind of position change observed (`,_jsx(_components.code,{children:`fills_source`}),` records where the fills came from; `,_jsx(_components.code,{children:`rule_version`}),` the detection rule).`]})})]})}),`\n`,_jsx(ResponseField,{name:`completeness`,type:`object`,id:`param-completeness`,children:_jsx(_components.p,{children:`What the detection could and could not observe over the window.`})}),`\n`,_jsx(ResponseField,{name:`has_more`,type:`boolean`,id:`param-has-more`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when more rows remain beyond this page.`]})}),`\n`,_jsx(ResponseField,{name:`next_from_ms`,type:`integer`,id:`param-next-from-ms`,children:_jsxs(_components.p,{children:[`Present when `,_jsx(_components.code,{children:`has_more`}),` is `,_jsx(_components.code,{children:`true`}),`. Pass it back as `,_jsx(_components.code,{children:`from`}),` to read the next page.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`example`,children:`Example`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -G`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://partner-api.bravadotrade.com/perps/liquidations`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-BRAVADO-API-KEY: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$BRAVADO_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-BRAVADO-TIMESTAMP: \u003cunix-ms>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-BRAVADO-SIGNATURE: \u003csignature-for-this-request>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` from=2026-10-01T00:00:00Z`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` to=2026-10-02T00:00:00Z`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` evidence=confirmed,inferred`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response (abbreviated)`,numberOfLines:`33`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`33`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"liq_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6:0xef3990a7:1759276920000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"detected_ts_ms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1759276920000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"instrument\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"venue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"polymarket\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0xef3990a7c8fa92d84dce0e7816ca3410820c1d36\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"evidence\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"confirmed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"position_side\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"long\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"closed_size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12.50\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"notional_usd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1125375.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"adl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"change_kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"liquidation\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"liq_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6:0x7c80413d:1759277500000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"detected_ts_ms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1759277500000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"instrument\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"venue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"polymarket\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x7c80413d2b9a1f5e6d3c4b2a1908f7e6d5c4b3a2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"evidence\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"inferred\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"position_side\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"closed_size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"notional_usd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"adl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"change_kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"liquidation\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completeness\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"observed_universe_only\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"has_more\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"next_from_ms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1759363200000`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api/perps-data/skew`,children:`Long/short skew`}),` — positioning over the same observed account universe.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/products/perps-data`,children:`Perps Data overview`}),` — the product, its credential and shared conventions.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"GET /perps/liquidations: Liquidation History","sidebarTitle":"GET /liquidations","api":"GET /perps/liquidations","description":"Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.","href":"/api/perps-data/liquidations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Query Parameters","slug":"query-parameters","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]},{"title":"Example","slug":"example","depth":3,"children":[]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"GET /perps/liquidations: Liquidation History","path":"/perps/liquidations","servers":[{"url":"https://partner-api.bravadotrade.com"}],"method":"get","request":{"security":[],"parameters":{"query":{"from":{"schema":[{"type":"string","description":"Start of the window. Accepts RFC3339, unix seconds or unix milliseconds.","required":true}]},"to":{"schema":[{"type":"string","description":"End of the window. Same formats as `from` . The window may span at most 31 days ; a wider range is refused with `400 range_too_large` .","required":true}]},"instrument":{"schema":[{"type":"string","description":"Only liquidations on this instrument, by its venue-native id. Matches `[A-Za-z0-9._-]{1,32}` . Omit for all instruments."}]},"address":{"schema":[{"type":"string","description":"Only liquidations for this account. A 40-hex address, with or without the `0x` prefix."}]},"evidence":{"schema":[{"type":"string","description":"A comma-separated subset of `confirmed` , `inferred` , `unknown` . Defaults to all three. `unknown` is never hidden, so a subset that omits it still returns `unknown` rows. An unrecognised value is refused with `400 invalid_evidence` ."}]},"limit":{"schema":[{"type":"integer","description":"Rows per page, `1` – `1000` ."}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data":[{"type":"array","items":[{"type":"object","properties":{"liq_id":[{"type":"string","description":"Stable id for the detected liquidation."}],"detected_ts_ms":[{"type":"integer","description":"When the liquidation was detected, in unix milliseconds ( `detected_ts` in seconds)."}],"instrument":[{"type":"string","description":"The instrument liquidated, by its venue-native id."}],"venue":[{"type":"string","description":"The venue."}],"address":[{"type":"string","description":"The liquidated account."}],"evidence":[{"type":"string","description":"How the liquidation was established: `confirmed` (observed directly), `inferred` (reconstructed from account state), or `unknown` ."}],"position_side":[{"type":"object","properties":{},"description":"The side liquidated, or `null` when it cannot be determined — never a guessed value."}],"closed_size":[{"type":"object","properties":{},"description":"Size closed by the liquidation, or `null` when indeterminate — never `0` . Related sizing fields ( `fill_size` , `size_before` , `size_after` ) follow the same null-not-zero rule, as do the price and equity fields ( `entry_price` , `fill_price` , `mark_before` , `mark_extreme` , `equity_before_usd` , `equity_after_usd` , `equity_drop_usd` , `liq_price_est` , `notional_usd` ) and the fee fields ( `liq_fee_bps` , `expected_liq_fee_usd` , `fill_fee_usd` )."}],"adl":[{"type":"object","properties":{},"description":"Whether the liquidation was an auto-deleverage, or `null` when indeterminate."}],"change_kind":[{"type":"string","description":"The kind of position change observed ( `fills_source` records where the fills came from; `rule_version` the detection rule)."}]}}]}],"completeness":[{"type":"object","properties":{},"description":"What the detection could and could not observe over the window."}],"has_more":[{"type":"boolean","description":"`true` when more rows remain beyond this page."}],"next_from_ms":[{"type":"integer","description":"Present when `has_more` is `true` . Pass it back as `from` to read the next page."}]}}],"examples":{"example":{"value":{"data":[{"liq_id":"\u003cstring>","detected_ts_ms":123,"instrument":"\u003cstring>","venue":"\u003cstring>","address":"\u003cstring>","evidence":"\u003cstring>","position_side":{},"closed_size":{},"adl":{},"change_kind":"\u003cstring>"}],"completeness":{},"has_more":true,"next_from_ms":123}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"bravado","siteName":"Bravado","title":"GET /perps/liquidations: Liquidation History - Bravado","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T02:22:59.781Z","originalFileLocation":"api/perps-data/liquidations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bravado\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"GET /perps/liquidations: Liquidation History - Bravado\">\u003cmeta data-mint-head property=\"og:description\" content=\"Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bravado\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bravadotrade.com/api/perps-data/liquidations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bravado.mintlify.app/_mintlify/api/og/v2?division=Perps+data\u0026amp;title=GET+%2Fperps%2Fliquidations%3A+Liquidation+History\u0026amp;description=Detected+Polymarket+Perps+liquidations%2C+oldest+first%2C+each+carrying+its+evidence+class.+Indeterminate+fields+are+null%2C+never+a+fabricated+zero.+Scope+analytics.\u0026amp;theme=6ef03862924bac3b2ce4fcae\u0026amp;signature=c4b00273c25c7f23cd867d02988da9973d912edb09d3441bca449d7faf73a700\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"GET /perps/liquidations: Liquidation History - Bravado\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bravado.mintlify.app/_mintlify/api/og/v2?division=Perps+data\u0026amp;title=GET+%2Fperps%2Fliquidations%3A+Liquidation+History\u0026amp;description=Detected+Polymarket+Perps+liquidations%2C+oldest+first%2C+each+carrying+its+evidence+class.+Indeterminate+fields+are+null%2C+never+a+fabricated+zero.+Scope+analytics.\u0026amp;theme=6ef03862924bac3b2ce4fcae\u0026amp;signature=c4b00273c25c7f23cd867d02988da9973d912edb09d3441bca449d7faf73a700\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bravado/cV2vl76asp5Coaf3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bravado\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#27d79f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bravadotrade.com/api/perps-data/liquidations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/perps-data/liquidations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bravadotrade.com/#organization\",\"name\":\"Bravado\",\"url\":\"https://docs.bravadotrade.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bravado/Rx5I6GxmyLNQx0kC/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=Rx5I6GxmyLNQx0kC\u0026q=85\u0026s=22dde9c0ee0fdbd8f91ce9429a54b905\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bravadotrade.com#website\",\"name\":\"Bravado\",\"url\":\"https://docs.bravadotrade.com\",\"publisher\":{\"@id\":\"https://docs.bravadotrade.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bravadotrade.com/api/perps-data/liquidations#webpage\",\"url\":\"https://docs.bravadotrade.com/api/perps-data/liquidations\",\"name\":\"GET /perps/liquidations: Liquidation History\",\"description\":\"Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.\",\"dateModified\":\"2026-10-29T02:22:59.781Z\",\"isPartOf\":{\"@id\":\"https://docs.bravadotrade.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bravadotrade.com/api/perps-data/liquidations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bravadotrade.com/api/perps-data/liquidations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Perps data\",\"item\":\"https://docs.bravadotrade.com/products/perps-data\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GET /perps/liquidations: Liquidation History\",\"item\":\"https://docs.bravadotrade.com/api/perps-data/liquidations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bravadotrade.com/api/perps-data/liquidations#apireference\",\"headline\":\"GET /perps/liquidations: Liquidation History\",\"name\":\"GET /perps/liquidations: Liquidation History\",\"description\":\"Detected Polymarket Perps liquidations, oldest first, each carrying its evidence class. Indeterminate fields are null, never a fabricated zero. Scope analytics.read.\",\"url\":\"https://docs.bravadotrade.com/api/perps-data/liquidations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bravadotrade.com/api/perps-data/liquidations#webpage\"},\"dateModified\":\"2026-10-29T02:22:59.781Z\",\"publisher\":{\"@id\":\"https://docs.bravadotrade.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bravadotrade.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bravado\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Bravado","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/introduction"}]},{"tab":"Data API","groups":[{"group":"Data API","pages":[{"title":"Data API: Trader Analytics and Combos Data","sidebarTitle":"Overview","icon":{"name":"chart-line","library":"lucide"},"href":"/products/data-api"}]},{"group":"Kalshi market data","pages":[{"title":"Kalshi native market data","sidebarTitle":"Kalshi current data","href":"/api/market-data/kalshi-native"},{"title":"Kalshi current liquidity","sidebarTitle":"Kalshi liquidity","href":"/api/market-data/kalshi-liquidity"},{"title":"Captured Kalshi order-book history","sidebarTitle":"Kalshi order-book history","href":"/api/market-data/kalshi-history"}]},{"group":"Trader analytics","pages":[{"title":"Data API: Trader Analytics Reference","sidebarTitle":"Overview","icon":{"name":"book-open","library":"lucide"},"href":"/api/analytics/overview"},{"title":"GET /healthz: Data API Liveness Probe","sidebarTitle":"/healthz","api":"GET /trader-analytics/healthz","href":"/api/analytics/healthz"},{"title":"GET /leaderboard: PnL Leaderboard","sidebarTitle":"/leaderboard","api":"GET /trader-analytics/leaderboard","href":"/api/analytics/leaderboard"},{"title":"GET /leaderboard/volume: Polymarket Volume Leaderboard","sidebarTitle":"/leaderboard/volume","api":"GET /trader-analytics/leaderboard/volume","href":"/api/analytics/leaderboard-volume"},{"title":"GET /traders/{address}: Trader Profile Summary","sidebarTitle":"/traders/{address}","api":"GET /trader-analytics/traders/{address}","href":"/api/analytics/trader"},{"title":"GET /traders/{address}/pnl: Cumulative PnL Time Series","sidebarTitle":"/traders/{address}/pnl","api":"GET /trader-analytics/traders/{address}/pnl","href":"/api/analytics/trader-pnl"},{"title":"GET /traders/{address}/positions: All Positions","sidebarTitle":"/traders/{address}/positions","api":"GET /trader-analytics/traders/{address}/positions","href":"/api/analytics/trader-positions"},{"title":"GET /traders/{address}/positions/active: Open Positions","sidebarTitle":"/traders/{address}/positions/active","api":"GET /trader-analytics/traders/{address}/positions/active","href":"/api/analytics/trader-positions-active"},{"title":"GET /traders/{address}/positions/closed: Closed Positions","sidebarTitle":"/traders/{address}/positions/closed","api":"GET /trader-analytics/traders/{address}/positions/closed","href":"/api/analytics/trader-positions-closed"},{"title":"GET /positions: Positions Across All Wallets","sidebarTitle":"/positions","api":"GET /trader-analytics/positions","href":"/api/analytics/positions"},{"title":"GET /traders/{address}/trades: Trade Log","sidebarTitle":"/traders/{address}/trades","api":"GET /trader-analytics/traders/{address}/trades","href":"/api/analytics/trader-trades"},{"title":"GET /traders/{address}/categories: Per-Category Breakdown","sidebarTitle":"/traders/{address}/categories","api":"GET /trader-analytics/traders/{address}/categories","href":"/api/analytics/trader-categories"},{"title":"GET /traders/{address}/usdc-balance: On-Chain USDC Balance","sidebarTitle":"/traders/{address}/usdc-balance","api":"GET /trader-analytics/traders/{address}/usdc-balance","href":"/api/analytics/trader-usdc-balance"},{"title":"GET /traders/{address}/statements: Full PMWAS Statement","sidebarTitle":"/traders/{address}/statements","api":"GET /trader-analytics/traders/{address}/statements","href":"/api/analytics/trader-statements"},{"title":"GET /traders/{address}/statements/r1: R1 Dispositions","sidebarTitle":"/traders/{address}/statements/r1","api":"GET /trader-analytics/traders/{address}/statements/r1","href":"/api/analytics/trader-statements-r1"},{"title":"GET /traders/{address}/metrics: Performance Metrics (R5/R6/R7)","sidebarTitle":"/traders/{address}/metrics","api":"GET /trader-analytics/traders/{address}/metrics","href":"/api/analytics/trader-metrics"},{"title":"GET /traders/{address}/reconciliation: R8 Certificate","sidebarTitle":"/traders/{address}/reconciliation","api":"GET /trader-analytics/traders/{address}/reconciliation","href":"/api/analytics/trader-reconciliation"},{"title":"GET /traders/{address}/tax-report: Per-Year Tax Summary","sidebarTitle":"/traders/{address}/tax-report","api":"GET /trader-analytics/traders/{address}/tax-report","href":"/api/analytics/trader-tax-report"},{"title":"GET /trades: Trade Log by Query Parameter","sidebarTitle":"/trades","api":"GET /trader-analytics/trades","href":"/api/analytics/trades"},{"title":"GET /entity/{owner}: Multi-Wallet Entity Rollup","sidebarTitle":"/entity/{owner}","api":"GET /trader-analytics/entity/{owner}","href":"/api/analytics/entity"}]},{"group":"Combos Data","pages":[{"title":"Combos Data API: Polymarket Combos Market Data","sidebarTitle":"Overview","icon":{"name":"layers","library":"lucide"},"href":"/api/combos-data/overview"},{"title":"GET /v2/data/combos: List Combos","sidebarTitle":"/combos","api":"GET /v2/data/combos","href":"/api/combos-data/list"},{"title":"GET /v2/data/combos/trades: Combo Trades","sidebarTitle":"/combos/trades","api":"GET /v2/data/combos/trades","href":"/api/combos-data/trades"},{"title":"GET /v2/data/combos/{combo_id}: Combo Detail","sidebarTitle":"/combos/{combo_id}","api":"GET /v2/data/combos/{combo_id}","href":"/api/combos-data/combo"},{"title":"GET /v2/data/combos/stats: Combo Stats","sidebarTitle":"/combos/stats","api":"GET /v2/data/combos/stats","href":"/api/combos-data/stats"},{"title":"GET /v2/data/combos/leaderboard: Combo Traders","sidebarTitle":"/combos/leaderboard","api":"GET /v2/data/combos/leaderboard","href":"/api/combos-data/leaderboard"}]},{"group":"Perps data","pages":[{"title":"Perps Data: Polymarket Perpetual-Futures Market Data","sidebarTitle":"Overview","icon":{"name":"trending-up","library":"lucide"},"href":"/products/perps-data"},{"title":"GET /perps/funding/history: Funding History","sidebarTitle":"GET /funding/history","api":"GET /perps/funding/history","href":"/api/perps-data/funding-history"},{"title":"GET /perps/funding/compare: Funding Comparison","sidebarTitle":"GET /funding/compare","api":"GET /perps/funding/compare","href":"/api/perps-data/funding-compare"},{"title":"GET /perps/oi/history: Open-Interest History","sidebarTitle":"GET /oi/history","api":"GET /perps/oi/history","href":"/api/perps-data/oi-history"},{"title":"GET /perps/basis: Mark, Index and Basis","sidebarTitle":"GET /basis","api":"GET /perps/basis","href":"/api/perps-data/basis"},{"title":"GET /perps/skew: Long/Short Account Skew","sidebarTitle":"GET /skew","api":"GET /perps/skew","description":"Long and short account counts, exact contract sums and concentration for a Polymarket Perps instrument, point-in-time or as a series of 1-minute bars, over the observed account universe. Scope analytics.read.","href":"/api/perps-data/skew"},{"title":"GET /perps/liquidations: Liquidation History","sidebarTitle":"GET /liquidations","api":"GET /perps/liquidations","href":"/api/perps-data/liquidations"}]},{"group":"By venue","pages":[{"title":"Data API on Polymarket","sidebarTitle":"Data API","description":"Wallet-level PnL, leaderboards, trade logs, and tax statements for any Polymarket address, derived from on-chain Polygon settlement.","icon":{"name":"chart-line","library":"lucide"},"href":"/markets/polymarket/data-api"},{"title":"Data API on Predict.fun","sidebarTitle":"Data API","icon":{"name":"chart-line","library":"lucide"},"href":"/markets/predict-fun/data-api"}]},{"group":"Guides","pages":[{"title":"How to Build a Polymarket PnL Leaderboard","sidebarTitle":"Build a PnL leaderboard","icon":{"name":"trophy","library":"lucide"},"href":"/guides/pnl-leaderboard"},{"title":"How to Generate a US Tax Statement for Polymarket Trading","sidebarTitle":"Generate a tax statement","icon":{"name":"receipt","library":"lucide"},"href":"/guides/us-tax-statement"}]}]},{"tab":"Market Data","pages":[{"title":"Market Data","href":"/products/market-data"}]},{"tab":"Trade API","pages":[{"title":"Trade API","href":"/products/trade-api"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/products/mcp-server"}]},{"tab":"Resources","pages":[{"title":"Resources","href":"/reference/errors"}]}]},"title":"GET /perps/liquidations: Liquidation History - Bravado","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js"]}