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.
OHLC of open interest in contracts for one instrument, bucketed at the interval you pick, plus the closing USD notional of each bucket. When the venue published no USD value for a bucket, oi_usd_close is null and carries its provenance — it is never a fabricated 0. Part of the Perps Data product; scope analytics.read.
GET https://partner-api.bravadotrade.com/perps/oi/history
{"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/oi-history","slug":"/api/perps-data/oi-history","pageMetadata":{"title":"GET /perps/oi/history: Open-Interest History","sidebarTitle":"GET /oi/history","api":"GET /perps/oi/history","description":"OHLC of Polymarket Perps open interest in contracts, plus the closing USD notional per bucket, at the interval you pick. Scope analytics.read.","href":"/api/perps-data/oi-history"},"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: \"OHLC of Polymarket Perps open interest in contracts, plus the closing USD notional per bucket, at the interval you pick. 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:[`OHLC of open interest in `,_jsx(_components.strong,{children:`contracts`}),` for one instrument, bucketed at the interval you pick, plus the closing `,_jsx(_components.strong,{children:`USD notional`}),` of each bucket. When the venue published no USD value for a bucket, `,_jsx(_components.code,{children:`oi_usd_close`}),` is `,_jsx(_components.code,{children:`null`}),` and carries its provenance — it is never a fabricated `,_jsx(_components.code,{children:`0`}),`. 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/oi/history`})}),`\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:`instrument`,type:`string`,required:true,id:`param-instrument`,children:_jsxs(_components.p,{children:[`The instrument, by its venue-native id (for example `,_jsx(_components.code,{children:`6`}),`) or its canonical symbol (for example `,_jsx(_components.code,{children:`BTC`}),`). Matches `,_jsx(_components.code,{children:`[A-Za-z0-9._-]{1,32}`}),`.`]})}),`\n`,_jsx(ParamField,{query:`interval`,type:`string`,id:`param-interval`,children:_jsxs(_components.p,{children:[`Bucket size: one of `,_jsx(_components.code,{children:`1m`}),`, `,_jsx(_components.code,{children:`5m`}),`, `,_jsx(_components.code,{children:`15m`}),`, `,_jsx(_components.code,{children:`1h`}),`, `,_jsx(_components.code,{children:`4h`}),`, `,_jsx(_components.code,{children:`1d`}),`. The interval sets the maximum window, below.`]})}),`\n`,_jsx(ParamField,{query:`venue`,type:`string`,id:`param-venue`,children:_jsxs(_components.p,{children:[`One of `,_jsx(_components.code,{children:`polymarket`}),`, `,_jsx(_components.code,{children:`binance`}),`, `,_jsx(_components.code,{children:`bybit`}),`, `,_jsx(_components.code,{children:`hyperliquid`}),`. Omit for the default. Polymarket is the covered venue.`]})}),`\n`,_jsx(ParamField,{query:`from`,type:`string`,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`,id:`param-to`,children:_jsxs(_components.p,{children:[`End of the window. Same formats as `,_jsx(_components.code,{children:`from`}),`. The maximum window depends on `,_jsx(_components.code,{children:`interval`}),` (below); a wider range is refused with `,_jsx(_components.code,{children:`400 range_too_large`}),`.`]})}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`1000`,id:`param-limit`,children:_jsxs(_components.p,{children:[`Rows per page, `,_jsx(_components.code,{children:`1`}),`–`,_jsx(_components.code,{children:`5000`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The maximum window is set by `,_jsx(_components.code,{children:`interval`}),`: `,_jsx(_components.code,{children:`1m`}),` → 1 day, `,_jsx(_components.code,{children:`5m`}),` → 7 days, `,_jsx(_components.code,{children:`15m`}),` → 21 days, `,_jsx(_components.code,{children:`1h`}),` → 90 days, `,_jsx(_components.code,{children:`4h`}),` → 180 days, `,_jsx(_components.code,{children:`1d`}),` → 400 days.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Bars in `,_jsx(_components.code,{children:`data`}),`, one per interval, oldest first. When `,_jsx(_components.code,{children:`has_more`}),` is `,_jsx(_components.code,{children:`true`}),`, page forward by passing `,_jsx(_components.code,{children:`next_from_s`}),` (unix `,_jsx(_components.strong,{children:`seconds`}),`) back as `,_jsx(_components.code,{children:`from`}),`.`]}),`\n`,_jsx(ResponseField,{name:`instrument`,type:`string`,id:`param-instrument-1`,children:_jsx(_components.p,{children:`The instrument the bars are for.`})}),`\n`,_jsx(ResponseField,{name:`interval`,type:`string`,id:`param-interval-1`,children:_jsx(_components.p,{children:`The bucket size actually used.`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`array`,id:`param-data`,children:_jsxs(Expandable,{title:`Bar fields`,children:[_jsx(ResponseField,{name:`ts`,type:`integer`,id:`param-ts`,children:_jsx(_components.p,{children:`The bar’s boundary timestamp.`})}),_jsx(ResponseField,{name:`oi_open`,type:`string`,id:`param-oi-open`,children:_jsx(_components.p,{children:`Open interest in contracts at the start of the bar.`})}),_jsx(ResponseField,{name:`oi_high`,type:`string`,id:`param-oi-high`,children:_jsx(_components.p,{children:`Highest open interest in the bar.`})}),_jsx(ResponseField,{name:`oi_low`,type:`string`,id:`param-oi-low`,children:_jsx(_components.p,{children:`Lowest open interest in the bar.`})}),_jsx(ResponseField,{name:`oi_close`,type:`string`,id:`param-oi-close`,children:_jsx(_components.p,{children:`Open interest in contracts at the close of the bar.`})}),_jsx(ResponseField,{name:`oi_usd_close`,type:`string | null`,id:`param-oi-usd-close`,children:_jsxs(_components.p,{children:[`Closing open interest expressed in USD notional. `,_jsx(_components.code,{children:`null`}),` when the venue published no USD value for the bar — never a fabricated `,_jsx(_components.code,{children:`0`}),`.`]})}),_jsx(ResponseField,{name:`oi_usd_provenance`,type:`string`,id:`param-oi-usd-provenance`,children:_jsxs(_components.p,{children:[`Where `,_jsx(_components.code,{children:`oi_usd_close`}),` came from, and why it is `,_jsx(_components.code,{children:`null`}),` when it is.`]})}),_jsx(ResponseField,{name:`ticks`,type:`integer`,id:`param-ticks`,children:_jsx(_components.p,{children:`How many source observations the bar aggregates.`})})]})}),`\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_s`,type:`integer`,id:`param-next-froms`,children:_jsxs(_components.p,{children:[`Present when `,_jsx(_components.code,{children:`has_more`}),` is `,_jsx(_components.code,{children:`true`}),`. Unix `,_jsx(_components.strong,{children:`seconds`}),` — 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:`8`,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:`8`,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/oi/history`}),_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:` instrument=BTC`}),_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:` interval=1h`}),_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`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response (abbreviated)`,numberOfLines:`28`,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:`28`,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:` \"instrument\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BTC\"`}),_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:` \"interval\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1h\"`}),_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:` \"ts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1759276800`}),_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:` \"oi_open\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12500.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:` \"oi_high\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12980.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:` \"oi_low\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12410.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:` \"oi_close\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12760.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:` \"oi_usd_close\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1148400000.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:` \"oi_usd_provenance\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"venue\"`}),_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:` \"ticks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`60`})]}),`\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:` \"ts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1759280400`}),_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:` \"oi_open\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12760.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:` \"oi_high\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12810.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:` \"oi_low\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12600.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:` \"oi_close\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12640.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:` \"oi_usd_close\"`}),_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:` \"oi_usd_provenance\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unavailable\"`}),_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:` \"ticks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`58`})]}),`\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:` \"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_s\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1759363200`})]}),`\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/basis`,children:`Basis`}),` — mark, index and basis OHLC with the same parameters and ranges.`]}),`\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/oi/history: Open-Interest History","sidebarTitle":"GET /oi/history","api":"GET /perps/oi/history","description":"OHLC of Polymarket Perps open interest in contracts, plus the closing USD notional per bucket, at the interval you pick. Scope analytics.read.","href":"/api/perps-data/oi-history"}}},"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/oi/history: Open-Interest History","path":"/perps/oi/history","servers":[{"url":"https://partner-api.bravadotrade.com"}],"method":"get","request":{"security":[],"parameters":{"query":{"instrument":{"schema":[{"type":"string","description":"The instrument, by its venue-native id (for example `6` ) or its canonical symbol (for example `BTC` ). Matches `[A-Za-z0-9._-]{1,32}` .","required":true}]},"interval":{"schema":[{"type":"string","description":"Bucket size: one of `1m` , `5m` , `15m` , `1h` , `4h` , `1d` . The interval sets the maximum window, below."}]},"venue":{"schema":[{"type":"string","description":"One of `polymarket` , `binance` , `bybit` , `hyperliquid` . Omit for the default. Polymarket is the covered venue."}]},"from":{"schema":[{"type":"string","description":"Start of the window. Accepts RFC3339, unix seconds or unix milliseconds."}]},"to":{"schema":[{"type":"string","description":"End of the window. Same formats as `from` . The maximum window depends on `interval` (below); a wider range is refused with `400 range_too_large` ."}]},"limit":{"schema":[{"type":"integer","description":"Rows per page, `1` – `5000` ."}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"instrument":[{"type":"string","description":"The instrument the bars are for."}],"interval":[{"type":"string","description":"The bucket size actually used."}],"data":[{"type":"array","items":[{"type":"object","properties":{"ts":[{"type":"integer","description":"The bar’s boundary timestamp."}],"oi_open":[{"type":"string","description":"Open interest in contracts at the start of the bar."}],"oi_high":[{"type":"string","description":"Highest open interest in the bar."}],"oi_low":[{"type":"string","description":"Lowest open interest in the bar."}],"oi_close":[{"type":"string","description":"Open interest in contracts at the close of the bar."}],"oi_usd_close":[{"type":"object","properties":{},"description":"Closing open interest expressed in USD notional. `null` when the venue published no USD value for the bar — never a fabricated `0` ."}],"oi_usd_provenance":[{"type":"string","description":"Where `oi_usd_close` came from, and why it is `null` when it is."}],"ticks":[{"type":"integer","description":"How many source observations the bar aggregates."}]}}]}],"has_more":[{"type":"boolean","description":"`true` when more rows remain beyond this page."}],"next_from_s":[{"type":"integer","description":"Present when `has_more` is `true` . Unix seconds — pass it back as `from` to read the next page."}]}}],"examples":{"example":{"value":{"instrument":"\u003cstring>","interval":"\u003cstring>","data":[{"ts":123,"oi_open":"\u003cstring>","oi_high":"\u003cstring>","oi_low":"\u003cstring>","oi_close":"\u003cstring>","oi_usd_close":{},"oi_usd_provenance":"\u003cstring>","ticks":123}],"has_more":true,"next_from_s":123}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"bravado","siteName":"Bravado","title":"GET /perps/oi/history: Open-Interest History - Bravado","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T02:22:59.776Z","originalFileLocation":"api/perps-data/oi-history.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=\"OHLC of Polymarket Perps open interest in contracts, plus the closing USD notional per bucket, at the interval you pick. 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/oi/history: Open-Interest History - Bravado\">\u003cmeta data-mint-head property=\"og:description\" content=\"OHLC of Polymarket Perps open interest in contracts, plus the closing USD notional per bucket, at the interval you pick. 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/oi-history\">\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%2Foi%2Fhistory%3A+Open-Interest+History\u0026amp;description=OHLC+of+Polymarket+Perps+open+interest+in+contracts%2C+plus+the+closing+USD+notional+per+bucket%2C+at+the+interval+you+pick.+Scope+analytics.read.\u0026amp;theme=6ef03862924bac3b2ce4fcae\u0026amp;signature=b34c4d97c5ee280c313b3ab455d21e726842f0af3aefd74a41bc15698ac8d6d7\">\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/oi/history: Open-Interest History - Bravado\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"OHLC of Polymarket Perps open interest in contracts, plus the closing USD notional per bucket, at the interval you pick. 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%2Foi%2Fhistory%3A+Open-Interest+History\u0026amp;description=OHLC+of+Polymarket+Perps+open+interest+in+contracts%2C+plus+the+closing+USD+notional+per+bucket%2C+at+the+interval+you+pick.+Scope+analytics.read.\u0026amp;theme=6ef03862924bac3b2ce4fcae\u0026amp;signature=b34c4d97c5ee280c313b3ab455d21e726842f0af3aefd74a41bc15698ac8d6d7\">\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/oi-history\">\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/oi-history.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/oi-history#webpage\",\"url\":\"https://docs.bravadotrade.com/api/perps-data/oi-history\",\"name\":\"GET /perps/oi/history: Open-Interest History\",\"description\":\"OHLC of Polymarket Perps open interest in contracts, plus the closing USD notional per bucket, at the interval you pick. Scope analytics.read.\",\"dateModified\":\"2026-10-29T02:22:59.776Z\",\"isPartOf\":{\"@id\":\"https://docs.bravadotrade.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bravadotrade.com/api/perps-data/oi-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bravadotrade.com/api/perps-data/oi-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Perps data\",\"item\":\"https://docs.bravadotrade.com/products/perps-data\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GET /perps/oi/history: Open-Interest History\",\"item\":\"https://docs.bravadotrade.com/api/perps-data/oi-history\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bravadotrade.com/api/perps-data/oi-history#apireference\",\"headline\":\"GET /perps/oi/history: Open-Interest History\",\"name\":\"GET /perps/oi/history: Open-Interest History\",\"description\":\"OHLC of Polymarket Perps open interest in contracts, plus the closing USD notional per bucket, at the interval you pick. Scope analytics.read.\",\"url\":\"https://docs.bravadotrade.com/api/perps-data/oi-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bravadotrade.com/api/perps-data/oi-history#webpage\"},\"dateModified\":\"2026-10-29T02:22:59.776Z\",\"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","description":"One symbol on the Polymarket perp against Binance, Bybit and Hyperliquid, interval-normalised. A venue with no rows in a complete window is named, never shown a zero rate. Scope analytics.read.","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","description":"OHLC of Polymarket Perps mark, index and basis in basis points per bucket, at the interval you pick. Scope analytics.read.","href":"/api/perps-data/basis"},{"title":"GET /perps/skew: Long/Short Account Skew","sidebarTitle":"GET /skew","api":"GET /perps/skew","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","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/oi/history: Open-Interest 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"]}