Use this endpoint to pull the L2 events for one or more outcome tokens. Each event is either a book snapshot (full bids and asks) or a price_change delta (a single side, price, and sizeAfter).Provide at least one of marketId, conditionId, or tokenId. The API combines values in the same parameter with OR. It combines different parameters with AND.
Reconstructing a book
To rebuild a token’s book at a target time:
For one tokenId, fetch the latest book at or before the target time with eventType=book, to=<target_time>, order=desc, and limit=1.
Start a new query from that event’s cursor. Set eventType=price_change, keep to=<target_time>, and use order=asc.
Page through the results with the same filters and order, passing each nextCursor into the next request.
Apply BUY deltas to bids and SELL deltas to asks. A sizeAfter value of 0 removes the price level. Any other value replaces its size.
You need a book snapshot to start reconstruction. If none exists at or before the target time, the later price changes are not enough to rebuild the book.Snapshot levels use [price, source order size] decimal-string pairs. The API contract does not guarantee the order of the arrays. Sort bids from highest to lowest and asks from lowest to highest if your application depends on that ordering.
Order Book event timestamps use Unix milliseconds. Numeric block and trade timestamps use seconds. Subtract timestamp from indexedTimestamp to estimate total indexing latency, including WebSocket delivery, queueing, batching, and insertion. Some historical rows do not have a reliable original ingestion timestamp.
Cursors are opaque. Keep the filters and order unchanged while paging through one result set. When reconstructing a book, you can use the snapshot cursor to start the new ascending price_change query described above.
Authorizations
Authorization
string
header
required
Paste your Orbscan API key here. The Bearer prefix is added automatically.
Query Parameters
marketId
string[]
Market IDs to include. You can provide up to 20 as comma-separated values, repeated parameters, or both.
Maximum array length: 20
Example:
["12345"]
conditionId
string[]
Condition IDs to include. You can provide up to 20 as comma-separated values, repeated parameters, or both. Input is case-insensitive.
Outcome token IDs to include. You can provide up to 50 as comma-separated values, repeated parameters, or both.
Maximum array length: 50
Example:
["123456789"]
eventType
enum<string>[]
Event types to include: book, price_change, or both. The endpoint returns both when you omit this parameter.
Maximum array length: 2
Available options:
book,
price_change
from
integer<int64>
Inclusive lower bound on source time, Unix milliseconds.
Example:
1788852000000
to
integer<int64>
Inclusive upper bound on source time, Unix milliseconds. Must be greater than or equal to from.
order
enum<string>
default:asc
Sort by source time. Defaults to asc. Case-insensitive.
Available options:
asc,
desc
limit
integer
default:1000
Page size. Defaults to 1,000. Values outside 1 to 10,000 return 400.
Required range: 1 <= x <= 10000
cursor
string
Opaque cursor from the last item's cursor or the response's nextCursor. Keep the filters and order unchanged while paging one result set. To reconstruct a book, you can use a snapshot cursor to start a new ascending price_change query.
Response
Successful response
message
enum<string>
required
Available options:
OK
Example:
"OK"
status_code
enum<string>
required
Available options:
1
Example:
"1"
data
object
required
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Orbscan","colors":{"primary":"#0F57FF","light":"#5082F7","dark":"#0C46CC"},"logo":{"light":"https://mintcdn.com/orbscandoc/BBYifdsHa5aKucFo/images/logo.svg?fit=max\u0026auto=format\u0026n=BBYifdsHa5aKucFo\u0026q=85\u0026s=da203d1da94aeda6c5c50fccc74db4ae","dark":"https://mintcdn.com/orbscandoc/BBYifdsHa5aKucFo/images/logo-light.svg?fit=max\u0026auto=format\u0026n=BBYifdsHa5aKucFo\u0026q=85\u0026s=cd9f0875a79ab2fed054f8fffa7c6e18","href":"https://orbscan.com"},"favicon":{"light":"https://mintcdn.com/orbscandoc/BBYifdsHa5aKucFo/images/logo-symbol.svg?fit=max\u0026auto=format\u0026n=BBYifdsHa5aKucFo\u0026q=85\u0026s=499bd2f2fec645a71009d545f2eb1098","dark":"https://mintcdn.com/orbscandoc/BBYifdsHa5aKucFo/images/logo-symbol-light.svg?fit=max\u0026auto=format\u0026n=BBYifdsHa5aKucFo\u0026q=85\u0026s=7896b31029ebe658be9d74b8db9bc9b6"},"api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer","name":"your_api_key"}}},"background":{"color":{"dark":"#0A0B10"}},"navbar":{"primary":{"type":"button","label":"Visit Orbscan","href":"https://orbscan.com"}},"footer":{"socials":{"x":"https://x.com/OrbscanHQ"}},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"orbscandoc","hasAudioNarration":false,"actualSubdomain":"orbscandoc","customDomains":["docs.orbscan.com"],"gitSource":{"type":"github","owner":"serliang","repo":"orbscan-doc","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afad141eeeb15b4be8ea719","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"Trader \u0026 transactions","count":10},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"Order Book","count":3}]},"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":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/market/orderbook-events","slug":"/api-reference/market/orderbook-events","pageMetadata":{"title":"Get order book events","sidebarTitle":"Get order book events","description":"Get the L2 snapshots and price changes needed to reconstruct an outcome token's order book over time.","openapi":"openapi.json GET /v1/orderbook/events","href":"/api-reference/market/orderbook-events"},"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: \"Get the L2 snapshots and price changes needed to reconstruct an outcome token’s order book over time.\"\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={code:`code`,li:`li`,ol:`ol`,p:`p`,..._provideComponents(),...props.components},{Heading,Note,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this endpoint to pull the L2 events for one or more outcome tokens. Each event is either a `,_jsx(_components.code,{children:`book`}),` snapshot (full `,_jsx(_components.code,{children:`bids`}),` and `,_jsx(_components.code,{children:`asks`}),`) or a `,_jsx(_components.code,{children:`price_change`}),` delta (a single `,_jsx(_components.code,{children:`side`}),`, `,_jsx(_components.code,{children:`price`}),`, and `,_jsx(_components.code,{children:`sizeAfter`}),`).`]}),`\n`,_jsxs(_components.p,{children:[`Provide at least one of `,_jsx(_components.code,{children:`marketId`}),`, `,_jsx(_components.code,{children:`conditionId`}),`, or `,_jsx(_components.code,{children:`tokenId`}),`. The API combines values in the same parameter with OR. It combines different parameters with AND.`]}),`\n`,_jsx(Heading,{level:`2`,id:`reconstructing-a-book`,children:`Reconstructing a book`}),`\n`,_jsx(_components.p,{children:`To rebuild a token’s book at a target time:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`For one `,_jsx(_components.code,{children:`tokenId`}),`, fetch the latest `,_jsx(_components.code,{children:`book`}),` at or before the target time with `,_jsx(_components.code,{children:`eventType=book`}),`, `,_jsx(_components.code,{children:`to=\u003ctarget_time>`}),`, `,_jsx(_components.code,{children:`order=desc`}),`, and `,_jsx(_components.code,{children:`limit=1`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Start a new query from that event’s `,_jsx(_components.code,{children:`cursor`}),`. Set `,_jsx(_components.code,{children:`eventType=price_change`}),`, keep `,_jsx(_components.code,{children:`to=\u003ctarget_time>`}),`, and use `,_jsx(_components.code,{children:`order=asc`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Page through the results with the same filters and `,_jsx(_components.code,{children:`order`}),`, passing each `,_jsx(_components.code,{children:`nextCursor`}),` into the next request.`]}),`\n`,_jsxs(_components.li,{children:[`Apply `,_jsx(_components.code,{children:`BUY`}),` deltas to bids and `,_jsx(_components.code,{children:`SELL`}),` deltas to asks. A `,_jsx(_components.code,{children:`sizeAfter`}),` value of `,_jsx(_components.code,{children:`0`}),` removes the price level. Any other value replaces its size.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`You need a `,_jsx(_components.code,{children:`book`}),` snapshot to start reconstruction. If none exists at or before the target time, the later price changes are not enough to rebuild the book.`]}),`\n`,_jsxs(_components.p,{children:[`Snapshot levels use `,_jsx(_components.code,{children:`[price, source order size]`}),` decimal-string pairs. The API contract does not guarantee the order of the arrays. Sort bids from highest to lowest and asks from lowest to highest if your application depends on that ordering.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Order Book event timestamps use Unix milliseconds. Numeric block and trade timestamps use seconds. Subtract `,_jsx(_components.code,{children:`timestamp`}),` from `,_jsx(_components.code,{children:`indexedTimestamp`}),` to estimate total indexing latency, including WebSocket delivery, queueing, batching, and insertion. Some historical rows do not have a reliable original ingestion timestamp.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Cursors are opaque. Keep the filters and `,_jsx(_components.code,{children:`order`}),` unchanged while paging through one result set. When reconstructing a book, you can use the snapshot cursor to start the new ascending `,_jsx(_components.code,{children:`price_change`}),` query described above.`]})})]})}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 order book events","sidebarTitle":"Get order book events","description":"Get the L2 snapshots and price changes needed to reconstruct an outcome token's order book over time.","openapi":"openapi.json GET /v1/orderbook/events","href":"/api-reference/market/orderbook-events"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Reconstructing a book","slug":"reconstructing-a-book","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getOrderBookEvents","summary":"Get order book events","description":"Get the L2 snapshots and price changes needed to reconstruct an outcome token's order book over time.","parameters":["c56c30a0-6182-4962-ba4e-bad1ed01ec51","d36ccfbe-493a-43c4-a062-9743bb851a47","566aff52-6aa9-47fd-88fb-03662d775187","c73549a0-18b5-4300-a42c-ca23fbd2107a","5fb92f4a-b756-492b-9c75-b22c40f74076","fcfcbb8c-604e-4177-970d-25eda4d2c372","7b4c8b4c-970c-45df-9aed-cfa0f4f5ecde","f09a1e9b-febc-48fe-961f-9ab574475787","0bf93094-7faf-4a06-8555-e47d45a64124"],"responses":{"200":"7671d0fe-5d79-469b-98c8-316a17cd60b2","400":"f2f1fd42-bdf6-4170-9a57-2fa5738562fc","401":"5158124f-8124-4b37-a4c0-5b326104e442","403":"a78a6bd0-651f-44d8-ba42-dec96265a9ea","429":"7ca1b9d8-f9c6-4111-ae61-08f3eea023fd","500":"e88661b8-7143-4c7b-a414-218e96f9c528"},"method":"get","type":"path","servers":["ba9290b0-59f5-4cf4-abeb-118dacef8ec0"],"security":["71bc4aea-36d2-4bae-96d9-4d310fa960a1"],"path":"/v1/orderbook/events","baseUrlOptions":["https://api.orbscan.com"],"title":"Get order book events","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c56c30a0-6182-4962-ba4e-bad1ed01ec51":{"name":"marketId","in":"query","required":false,"description":"Market IDs to include. You can provide up to 20 as comma-separated values, repeated parameters, or both.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"maxItems":20,"example":["12345"],"isRequired":false,"description":"Market IDs to include. You can provide up to 20 as comma-separated values, repeated parameters, or both.","uniqueKey":"","typeLabel":"string[]"}},"d36ccfbe-493a-43c4-a062-9743bb851a47":{"name":"conditionId","in":"query","required":false,"description":"Condition IDs to include. You can provide up to 20 as comma-separated values, repeated parameters, or both. Input is case-insensitive.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"maxItems":20,"example":["0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"],"isRequired":false,"description":"Condition IDs to include. You can provide up to 20 as comma-separated values, repeated parameters, or both. Input is case-insensitive.","uniqueKey":"","typeLabel":"string[]"}},"566aff52-6aa9-47fd-88fb-03662d775187":{"name":"tokenId","in":"query","required":false,"description":"Outcome token IDs to include. You can provide up to 50 as comma-separated values, repeated parameters, or both.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"maxItems":50,"example":["123456789"],"isRequired":false,"description":"Outcome token IDs to include. You can provide up to 50 as comma-separated values, repeated parameters, or both.","uniqueKey":"","typeLabel":"string[]"}},"c73549a0-18b5-4300-a42c-ca23fbd2107a":{"name":"eventType","in":"query","required":false,"description":"Event types to include: `book`, `price_change`, or both. The endpoint returns both when you omit this parameter.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string","enum":["book","price_change"],"uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"maxItems":2,"isRequired":false,"description":"Event types to include: `book`, `price_change`, or both. The endpoint returns both when you omit this parameter.","uniqueKey":"","typeLabel":"enum\u003cstring>[]"}},"5fb92f4a-b756-492b-9c75-b22c40f74076":{"name":"from","in":"query","required":false,"description":"Inclusive lower bound on source time, Unix milliseconds.","schema":{"type":"integer","format":"int64","example":1788852000000,"isRequired":false,"description":"Inclusive lower bound on source time, Unix milliseconds.","uniqueKey":"","typeLabel":"integer\u003cint64>"}},"fcfcbb8c-604e-4177-970d-25eda4d2c372":{"name":"to","in":"query","required":false,"description":"Inclusive upper bound on source time, Unix milliseconds. Must be greater than or equal to `from`.","schema":{"type":"integer","format":"int64","isRequired":false,"description":"Inclusive upper bound on source time, Unix milliseconds. Must be greater than or equal to `from`.","uniqueKey":"","typeLabel":"integer\u003cint64>"}},"7b4c8b4c-970c-45df-9aed-cfa0f4f5ecde":{"name":"order","in":"query","required":false,"description":"Sort by source time. Defaults to `asc`. Case-insensitive.","schema":{"type":"string","enum":["asc","desc"],"default":"asc","isRequired":false,"description":"Sort by source time. Defaults to `asc`. Case-insensitive.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"f09a1e9b-febc-48fe-961f-9ab574475787":{"name":"limit","in":"query","required":false,"description":"Page size. Defaults to 1,000. Values outside 1 to 10,000 return `400`.","schema":{"type":"integer","default":1000,"minimum":1,"maximum":10000,"isRequired":false,"description":"Page size. Defaults to 1,000. Values outside 1 to 10,000 return `400`.","uniqueKey":"","typeLabel":"integer"}},"0bf93094-7faf-4a06-8555-e47d45a64124":{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from the last item's `cursor` or the response's `nextCursor`. Keep the filters and `order` unchanged while paging one result set. To reconstruct a book, you can use a snapshot cursor to start a new ascending `price_change` query.","schema":{"type":"string","isRequired":false,"description":"Opaque cursor from the last item's `cursor` or the response's `nextCursor`. Keep the filters and `order` unchanged while paging one result set. To reconstruct a book, you can use a snapshot cursor to start a new ascending `price_change` query.","uniqueKey":"","typeLabel":"string"}}},"responses":{"7671d0fe-5d79-469b-98c8-316a17cd60b2":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["message","status_code","data"],"properties":{"message":{"type":"string","enum":["OK"],"example":"OK","isRequired":true,"uniqueKey":"message","typeLabel":"enum\u003cstring>"},"status_code":{"type":"string","enum":["1"],"example":"1","isRequired":true,"uniqueKey":"status_code","typeLabel":"enum\u003cstring>"},"data":{"type":"object","required":["items","nextCursor"],"properties":{"items":{"type":"array","items":{"oneOf":[{"type":"object","title":"Book snapshot","required":["cursor","marketId","conditionId","tokenId","outcome","eventType","timestamp","indexedTimestamp","side","price","sizeAfter","bids","asks","sourceHash"],"properties":{"eventType":{"type":"string","description":"Event type.","enum":["book"],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.eventType","typeLabel":"enum\u003cstring>"},"side":{"type":"null","description":"Source side, normally `BUY` or `SELL`. Set only for `price_change`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.side","typeLabel":"null"},"price":{"type":"null","description":"Price on a 0 to 1 scale. Set only for `price_change`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.price","typeLabel":"null"},"sizeAfter":{"type":"null","description":"Remaining size after the update; `0` removes the level, any other value replaces the level size. Set only for `price_change`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.sizeAfter","typeLabel":"null"},"bids":{"type":"array","items":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"string","uniqueKey":"data.\\items.items.[INDEX].oneOf.0.bids.items.[INDEX].items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.bids.items.[INDEX]","typeLabel":"string[]"},"description":"Bid levels as `[price, source order size]` decimal-string pairs. Array order is not guaranteed. Set only for `book`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.bids","typeLabel":"string[][]"},"asks":{"type":"array","items":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"string","uniqueKey":"data.\\items.items.[INDEX].oneOf.0.asks.items.[INDEX].items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.asks.items.[INDEX]","typeLabel":"string[]"},"description":"Ask levels as `[price, source order size]` decimal-string pairs. Array order is not guaranteed. Set only for `book`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.asks","typeLabel":"string[][]"},"cursor":{"type":"string","description":"Stable opaque boundary for this logical event; pass it back as the `cursor` query parameter.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.cursor","typeLabel":"string"},"marketId":{"type":"string","description":"Gamma market ID.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.marketId","typeLabel":"string"},"conditionId":{"type":"string","description":"Condition ID.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.conditionId","typeLabel":"string"},"tokenId":{"type":"string","description":"Outcome token whose independent book changed.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.tokenId","typeLabel":"string"},"outcome":{"oneOf":[{"type":"string","description":"Outcome label resolved from metadata.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.outcome.oneOf.0","typeLabel":"string"},{"type":"null","description":"Outcome label resolved from metadata.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.outcome.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.outcome","typeLabel":"string | null"},"timestamp":{"type":"integer","format":"int64","description":"Polymarket source time, Unix milliseconds.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.timestamp","typeLabel":"integer\u003cint64>"},"indexedTimestamp":{"type":"integer","format":"int64","description":"Earliest ingestion time for the logical event, in Unix milliseconds. Subtract `timestamp` from this value to estimate total indexing latency.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.indexedTimestamp","typeLabel":"integer\u003cint64>"},"sourceHash":{"oneOf":[{"type":"string","description":"Hash supplied by Polymarket for integrity checks.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.sourceHash.oneOf.0","typeLabel":"string"},{"type":"null","description":"Hash supplied by Polymarket for integrity checks.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.sourceHash.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.0.sourceHash","typeLabel":"string | null"}},"uniqueKey":"data.\\items.items.[INDEX].oneOf.0","typeLabel":"Book snapshot · object"},{"type":"object","title":"Price change","required":["cursor","marketId","conditionId","tokenId","outcome","eventType","timestamp","indexedTimestamp","side","price","sizeAfter","bids","asks","sourceHash"],"properties":{"eventType":{"type":"string","description":"Event type.","enum":["price_change"],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.eventType","typeLabel":"enum\u003cstring>"},"side":{"type":"string","description":"Source side, normally `BUY` or `SELL`. Set only for `price_change`.","enum":["BUY","SELL"],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.side","typeLabel":"enum\u003cstring>"},"price":{"type":"string","description":"Price on a 0 to 1 scale. Set only for `price_change`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.price","typeLabel":"string"},"sizeAfter":{"type":"string","description":"Remaining size after the update; `0` removes the level, any other value replaces the level size. Set only for `price_change`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.sizeAfter","typeLabel":"string"},"bids":{"type":"null","description":"Bid levels as `[price, source order size]` decimal-string pairs. Array order is not guaranteed. Set only for `book`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.bids","typeLabel":"null"},"asks":{"type":"null","description":"Ask levels as `[price, source order size]` decimal-string pairs. Array order is not guaranteed. Set only for `book`.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.asks","typeLabel":"null"},"cursor":{"type":"string","description":"Stable opaque boundary for this logical event; pass it back as the `cursor` query parameter.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.cursor","typeLabel":"string"},"marketId":{"type":"string","description":"Gamma market ID.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.marketId","typeLabel":"string"},"conditionId":{"type":"string","description":"Condition ID.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.conditionId","typeLabel":"string"},"tokenId":{"type":"string","description":"Outcome token whose independent book changed.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.tokenId","typeLabel":"string"},"outcome":{"oneOf":[{"type":"string","description":"Outcome label resolved from metadata.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.outcome.oneOf.0","typeLabel":"string"},{"type":"null","description":"Outcome label resolved from metadata.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.outcome.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.outcome","typeLabel":"string | null"},"timestamp":{"type":"integer","format":"int64","description":"Polymarket source time, Unix milliseconds.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.timestamp","typeLabel":"integer\u003cint64>"},"indexedTimestamp":{"type":"integer","format":"int64","description":"Earliest ingestion time for the logical event, in Unix milliseconds. Subtract `timestamp` from this value to estimate total indexing latency.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.indexedTimestamp","typeLabel":"integer\u003cint64>"},"sourceHash":{"oneOf":[{"type":"string","description":"Hash supplied by Polymarket for integrity checks.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.sourceHash.oneOf.0","typeLabel":"string"},{"type":"null","description":"Hash supplied by Polymarket for integrity checks.","isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.sourceHash.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.\\items.items.[INDEX].oneOf.1.sourceHash","typeLabel":"string | null"}},"uniqueKey":"data.\\items.items.[INDEX].oneOf.1","typeLabel":"Price change · object"}],"uniqueKey":"data.\\items.items.[INDEX]","typeLabel":"Book snapshot · object | Price change · object"},"isRequired":true,"uniqueKey":"data.\\items","typeLabel":"(Book snapshot · object | Price change · object)[]"},"nextCursor":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.nextCursor.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.nextCursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.nextCursor","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"OK","status_code":"1","data":{"items":[{"cursor":"AAABoIUSUAm3qt444MRDsUeszsPPlC2V4ijGB4PrCvlQPcNHl9XYGg","marketId":"573656","conditionId":"0x02deb9538f5c123373adaa4ee6217b01745f1662bc902e46ac92f3fe6f8741e8","tokenId":"93694900555669388759405753550770573998169287228984912881955464376232163096213","outcome":"Yes","eventType":"price_change","timestamp":1788938965001,"indexedTimestamp":1788938967881,"side":"SELL","price":"0.79","sizeAfter":"6","bids":null,"asks":null,"sourceHash":"7bbd3aff3cc9a5b22c69a6a4f3c2ce8c2fb4b6ab"},{"cursor":"AAABoMfIdTSZ95XfHI2JY3xDPBEiM-NgpOm-DblE2HiRi5Ny98xn0g","marketId":"573656","conditionId":"0x02deb9538f5c123373adaa4ee6217b01745f1662bc902e46ac92f3fe6f8741e8","tokenId":"93694900555669388759405753550770573998169287228984912881955464376232163096213","outcome":"Yes","eventType":"book","timestamp":1790058198324,"indexedTimestamp":1790058204527,"side":null,"price":null,"sizeAfter":null,"bids":[["0.48","12500"],["0.47","20000"]],"asks":[["0.49","8000"],["0.5","15000"]],"sourceHash":"db60d216be1f61bfe63c4c9a92a2d42fd30e319c"}],"nextCursor":null}},"examples":{"Example":{"title":"Example","value":{"message":"OK","status_code":"1","data":{"items":[{"cursor":"AAABoIUSUAm3qt444MRDsUeszsPPlC2V4ijGB4PrCvlQPcNHl9XYGg","marketId":"573656","conditionId":"0x02deb9538f5c123373adaa4ee6217b01745f1662bc902e46ac92f3fe6f8741e8","tokenId":"93694900555669388759405753550770573998169287228984912881955464376232163096213","outcome":"Yes","eventType":"price_change","timestamp":1788938965001,"indexedTimestamp":1788938967881,"side":"SELL","price":"0.79","sizeAfter":"6","bids":null,"asks":null,"sourceHash":"7bbd3aff3cc9a5b22c69a6a4f3c2ce8c2fb4b6ab"},{"cursor":"AAABoMfIdTSZ95XfHI2JY3xDPBEiM-NgpOm-DblE2HiRi5Ny98xn0g","marketId":"573656","conditionId":"0x02deb9538f5c123373adaa4ee6217b01745f1662bc902e46ac92f3fe6f8741e8","tokenId":"93694900555669388759405753550770573998169287228984912881955464376232163096213","outcome":"Yes","eventType":"book","timestamp":1790058198324,"indexedTimestamp":1790058204527,"side":null,"price":null,"sizeAfter":null,"bids":[["0.48","12500"],["0.47","20000"]],"asks":[["0.49","8000"],["0.5","15000"]],"sourceHash":"db60d216be1f61bfe63c4c9a92a2d42fd30e319c"}],"nextCursor":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"f2f1fd42-bdf6-4170-9a57-2fa5738562fc":{"description":"A filter, `eventType`, `order`, `limit`, timestamp, or time range is invalid; or no `marketId`, `conditionId`, or `tokenId` was supplied.","content":{"application/json":{"schema":{"type":"object","required":["message","status_code","data"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"string","enum":["0"],"description":"Application-level error status.","isRequired":true,"uniqueKey":"status_code","typeLabel":"enum\u003cstring>"},"data":{"type":"null","isRequired":true,"uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"tokenId, marketId, or conditionId is required","status_code":"0","data":null},"examples":{"Example":{"title":"Example","value":{"message":"tokenId, marketId, or conditionId is required","status_code":"0","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"5158124f-8124-4b37-a4c0-5b326104e442":{"description":"The API key is missing or invalid.","content":{"application/json":{"schema":{"type":"object","required":["message","status_code","data"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"string","enum":["0"],"description":"Application-level error status.","isRequired":true,"uniqueKey":"status_code","typeLabel":"enum\u003cstring>"},"data":{"type":"null","isRequired":true,"uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Missing or invalid API key","status_code":"0","data":null},"examples":{"Example":{"title":"Example","value":{"message":"Missing or invalid API key","status_code":"0","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"a78a6bd0-651f-44d8-ba42-dec96265a9ea":{"description":"The API key is valid but not allowed to use this resource. The response body is not specified.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"7ca1b9d8-f9c6-4111-ae61-08f3eea023fd":{"description":"The rate limit for your credential was exceeded.","content":{"application/json":{"schema":{"type":"object","required":["message","status_code","data"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"string","enum":["0"],"description":"Application-level error status.","isRequired":true,"uniqueKey":"status_code","typeLabel":"enum\u003cstring>"},"data":{"type":"null","isRequired":true,"uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Rate limit exceeded","status_code":"0","data":null},"examples":{"Example":{"title":"Example","value":{"message":"Rate limit exceeded","status_code":"0","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"e88661b8-7143-4c7b-a414-218e96f9c528":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"type":"object","required":["message","status_code","data"],"properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status_code":{"type":"string","enum":["0"],"description":"Application-level error status.","isRequired":true,"uniqueKey":"status_code","typeLabel":"enum\u003cstring>"},"data":{"type":"null","isRequired":true,"uniqueKey":"data","typeLabel":"null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","status_code":"0","data":null}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"71bc4aea-36d2-4bae-96d9-4d310fa960a1":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Paste your Orbscan API key here. The `Bearer` prefix is added automatically.","scopes":[]}}},"servers":{"ba9290b0-59f5-4cf4-abeb-118dacef8ec0":{"url":"https://api.orbscan.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Paste your Orbscan API key here. The `Bearer` prefix is added automatically.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Paste your Orbscan API key here. The `Bearer` prefix is added automatically.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"orbscandoc","siteName":"Orbscan","title":"Get order book events - Orbscan","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-23T06:20:22.187Z","originalFileLocation":"api-reference/market/orderbook-events.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=\"Get the L2 snapshots and price changes needed to reconstruct an outcome token\u0026#x27;s order book over time.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Orbscan\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/orbscandoc/iVCH0VvBHxa-bItV/_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/orbscandoc/iVCH0VvBHxa-bItV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/orbscandoc/iVCH0VvBHxa-bItV/_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/orbscandoc/iVCH0VvBHxa-bItV/_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/orbscandoc/iVCH0VvBHxa-bItV/_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/orbscandoc/iVCH0VvBHxa-bItV/_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/orbscandoc/iVCH0VvBHxa-bItV/_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/orbscandoc/iVCH0VvBHxa-bItV/_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/orbscandoc/iVCH0VvBHxa-bItV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get order book events - Orbscan\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get the L2 snapshots and price changes needed to reconstruct an outcome token\u0026#x27;s order book over time.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Orbscan\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.orbscan.com/api-reference/market/orderbook-events\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://orbscandoc.mintlify.site/_mintlify/api/og/v2?division=Order+Book\u0026amp;title=Get+order+book+events\u0026amp;description=Get+the+L2+snapshots+and+price+changes+needed+to+reconstruct+an+outcome+token%27s+order+book+over+time.\u0026amp;theme=bb31d88852e6bf9c6b69b905\u0026amp;signature=775f0a2bbbf9a38b873189f63de7e8d080de337f17f03020e4526beef5376cef\">\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 order book events - Orbscan\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get the L2 snapshots and price changes needed to reconstruct an outcome token\u0026#x27;s order book over time.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://orbscandoc.mintlify.site/_mintlify/api/og/v2?division=Order+Book\u0026amp;title=Get+order+book+events\u0026amp;description=Get+the+L2+snapshots+and+price+changes+needed+to+reconstruct+an+outcome+token%27s+order+book+over+time.\u0026amp;theme=bb31d88852e6bf9c6b69b905\u0026amp;signature=775f0a2bbbf9a38b873189f63de7e8d080de337f17f03020e4526beef5376cef\">\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/orbscandoc/iVCH0VvBHxa-bItV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Orbscan\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F57FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.orbscan.com/api-reference/market/orderbook-events\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/market/orderbook-events.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.orbscan.com/#organization\",\"name\":\"Orbscan\",\"url\":\"https://docs.orbscan.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/orbscandoc/BBYifdsHa5aKucFo/images/logo.svg?fit=max\u0026auto=format\u0026n=BBYifdsHa5aKucFo\u0026q=85\u0026s=da203d1da94aeda6c5c50fccc74db4ae\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.orbscan.com#website\",\"name\":\"Orbscan\",\"url\":\"https://docs.orbscan.com\",\"publisher\":{\"@id\":\"https://docs.orbscan.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.orbscan.com/api-reference/market/orderbook-events#webpage\",\"url\":\"https://docs.orbscan.com/api-reference/market/orderbook-events\",\"name\":\"Get order book events\",\"description\":\"Get the L2 snapshots and price changes needed to reconstruct an outcome token's order book over time.\",\"dateModified\":\"2026-09-23T06:20:22.187Z\",\"isPartOf\":{\"@id\":\"https://docs.orbscan.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.orbscan.com/api-reference/market/orderbook-events#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.orbscan.com/api-reference/market/orderbook-events#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Order Book\",\"item\":\"https://docs.orbscan.com/api-reference/market/orderbook-markets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get order book events\",\"item\":\"https://docs.orbscan.com/api-reference/market/orderbook-events\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.orbscan.com/api-reference/market/orderbook-events#apireference\",\"headline\":\"Get order book events\",\"name\":\"Get order book events\",\"description\":\"Get the L2 snapshots and price changes needed to reconstruct an outcome token's order book over time.\",\"url\":\"https://docs.orbscan.com/api-reference/market/orderbook-events\",\"mainEntityOfPage\":{\"@id\":\"https://docs.orbscan.com/api-reference/market/orderbook-events#webpage\"},\"dateModified\":\"2026-09-23T06:20:22.187Z\",\"publisher\":{\"@id\":\"https://docs.orbscan.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.orbscan.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Orbscan\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Orbscan\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/market/orderbook-events.md","siteName":"Orbscan","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Get Started","pages":[{"title":"Orbscan Open API overview","sidebarTitle":"Overview","href":""},{"title":"Orbscan API quickstart: First request in 5 minutes","sidebarTitle":"Quickstart","href":"/quickstart"},{"title":"Authentication","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"Orbscan Open API errors","sidebarTitle":"Errors","href":"/api-reference/errors"},{"title":"Orbscan API rate limits","sidebarTitle":"Rate limits","href":"/api-reference/rate-limits"}]},{"group":"Trader \u0026 transactions","pages":[{"title":"Get wallet address","sidebarTitle":"Get wallet address","openapi":"openapi.json GET /v1/trader/wallet-address/{address}","href":"/api-reference/endpoints/get-wallet-address"},{"title":"Get portfolio","sidebarTitle":"Get portfolio","openapi":"openapi.json GET /v1/trader/{address}/portfolio","href":"/api-reference/endpoints/get-portfolio"},{"title":"Get open positions","sidebarTitle":"Get open positions","openapi":"openapi.json GET /v1/trader/{address}/positions/open","href":"/api-reference/endpoints/get-open-positions"},{"title":"Get closed positions","sidebarTitle":"Get closed positions","openapi":"openapi.json GET /v1/trader/{address}/positions/closed","href":"/api-reference/endpoints/get-closed-positions"},{"title":"Get open combo positions","sidebarTitle":"Get open combo positions","openapi":"openapi.json GET /v1/trader/{address}/combo-positions/open","href":"/api-reference/endpoints/get-combo-open-positions"},{"title":"Get closed combo positions","sidebarTitle":"Get closed combo positions","openapi":"openapi.json GET /v1/trader/{address}/combo-positions/closed","href":"/api-reference/endpoints/get-combo-closed-positions"},{"title":"Get trader activity","sidebarTitle":"Get trader activity","openapi":"openapi.json GET /v1/trader/{address}/activity","href":"/api-reference/endpoints/get-trader-activity"},{"title":"Get trader rewards","sidebarTitle":"Get trader rewards","openapi":"openapi.json GET /v1/trader/{address}/rewards","href":"/api-reference/endpoints/get-rewards"},{"title":"Get deposits and withdrawals","sidebarTitle":"Get deposits and withdrawals","openapi":"openapi.json GET /v1/trader/{address}/deposits-withdrawals","href":"/api-reference/endpoints/get-deposits-withdrawals"},{"title":"Get actions by transaction hash","sidebarTitle":"Get actions by hash","openapi":"openapi.json GET /v1/tx/{txHash}","href":"/api-reference/endpoints/get-transaction"}]},{"group":"Order Book","pages":[{"title":"Get order book markets","sidebarTitle":"Get order book markets","description":"List the Polymarket crypto markets and outcome tokens covered by the Order Book API.","openapi":"openapi.json GET /v1/orderbook/markets","href":"/api-reference/market/orderbook-markets"},{"title":"Get order book events","sidebarTitle":"Get order book events","openapi":"openapi.json GET /v1/orderbook/events","href":"/api-reference/market/orderbook-events"},{"title":"Get order book coverage","sidebarTitle":"Get order book coverage","description":"Get the earliest and latest source timestamps stored for order book data.","openapi":"openapi.json GET /v1/orderbook/coverage","href":"/api-reference/market/orderbook-coverage"}]}]}]},"basePath":"","title":"Get order book events - Orbscan","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}