Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.
BitMEX’s volume field represents the number of contracts traded, not the volume in the base asset.To obtain the correct volume, users must adjust for contract size using the underlyingToPositionMultiplier from our Reference endpoint.For details on this calculation and how to retrieve the correct values, see our Changelog Update.
The maximum time range (difference between startDate and endDate) is 18 months.
If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours.
Authorizations
x-api-key
string
header
required
Headers
Accept-Encoding
string
default:gzip, deflate, br
required
api-version
string
Path Parameters
instrument
string
default:btc_usd
required
The spot instrument for which data will be retrieved.
Query Parameters
exchange
string
default:gdax
required
The exchange for which data should be retrieved. Only 1 exchange is allowed.
startDate
string<date-time>
default:2024-03-01T00:00:00
[Optional] Payload only includes data after this date (inclusive). [Formats]seconds | milliseconds | iso8601[Examples]1578531600 | 1578531600000 | 2020-09-01T01:00:00
endDate
string<date-time>
default:2024-03-01T01:00:00
[Optional] Payload only includes data before this date (exclusive). [Formats]seconds | milliseconds | iso8601[Examples]1578531600 | 1578531600000 | 2020-09-01T01:00:00
timeFormat
enum<string>
default:hr
[Optional] Time format of the timestamps in the response.
Available options:
milliseconds,
ms*,
iso,
iso8601,
hr,
human_readable
sortDirection
string
[Optional] Specifies the direction in which the data is sorted (by timestamp). [Defaults] asc (ascending order). [Usage Conditions] This parameter can only be used if the startDate and endDate timeframe is within the most recent 24 hours, or if the startDate and endDate parameters are not used at all. [Examples] ascending | descending | asc | desc
Response
200 - application/json
200
status
integer
title
string
description
string
payload
object
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Amberdata Docs","colors":{"primary":"#E17039","light":"#E17039","dark":"#E17039"},"logo":{"light":"https://mintcdn.com/amberdata/WBTlNuO5-2IAq9z3/images/logo/amberdata_logo_color_light.svg?fit=max\u0026auto=format\u0026n=WBTlNuO5-2IAq9z3\u0026q=85\u0026s=2251cc13c2305e431971beef410e262b","dark":"https://mintcdn.com/amberdata/WBTlNuO5-2IAq9z3/images/logo/amberdata_logo_color_light.svg?fit=max\u0026auto=format\u0026n=WBTlNuO5-2IAq9z3\u0026q=85\u0026s=2251cc13c2305e431971beef410e262b"},"favicon":"https://mintcdn.com/amberdata/K1lRsbAeowhJaNOp/favicon.png?fit=max\u0026auto=format\u0026n=K1lRsbAeowhJaNOp\u0026q=85\u0026s=ff9b06df12005ffda6f689ef42365837","appearance":{"default":"light","strict":true},"footer":{"socials":{"x":"https://x.com/Amberdataio","github":"https://github.com/amberdata","linkedin":"https://www.linkedin.com/company/amberdata"}},"errors":{"404":{"redirect":true}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"amberdata","hasAudioNarration":false,"actualSubdomain":"amberdata","customDomains":["docs.amberdata.io"],"gitSource":{"type":"github","owner":"amberdata","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ad672eac8809c060cc474e8","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"HTTP","count":191},{"language":"default","tag":"Data Dictionary","count":122},{"language":"default","tag":"Analytics","count":80},{"language":"default","tag":"Market Data","count":69},{"language":"default","tag":"Derivatives Analytics","count":60},{"language":"default","tag":"Options","count":51},{"language":"default","tag":"Spot \u0026 Derivative Analytics","count":50},{"language":"default","tag":"Blockchain \u0026 DeFi","count":44},{"language":"default","tag":"Market Insights","count":36},{"language":"default","tag":"Volatility","count":34}]},"assistantConfig":{},"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--brand-orange: #f26522;--brand-blue: #7aabdd;--brand-sky: #9dceff;--brand-pale: #d9e4ee;--brand-gray: #8d8d8d;--ink: #0b0f19;--ink-dim: #47506b;--muted: var(--brand-gray);--line: #e7e9ee;--bg: #ffffff;--tile: #ffffff;--tile-hover: #f4f9ff;--alt-surface: var(--brand-pale);--accent-solid: var(--brand-blue);--accent-soft: var(--brand-sky);--accent-grad: linear-gradient(90deg, var(--brand-blue), var(--brand-sky));--accent-ink: #0b0f19;--micro-accent: color-mix(in srgb, var(--brand-orange) 18%, transparent);--micro-line: color-mix(in srgb, var(--brand-orange) 22%, #e7e9ee 78%);--radius: 14px;--maxw: 1120px}html,body{background:var(--bg);color:var(--ink)}*{box-sizing:border-box}.container{max-width:var(--maxw);margin:0 auto;padding:0 24px}hr{border:0;border-top:1px solid var(--line);margin:48px 0}.hero{background:linear-gradient(\n 180deg,\n #fff 0%,\n color-mix(in srgb, var(--brand-pale) 18%, #fff 82%) 100%\n );border-bottom:none!important;background:none!important}.hero-inner{padding:88px 0 64px;text-align:center}.hero-eyebrow{display:inline-block;padding:6px 10px;border:1px solid var(--line);border-radius:999px;font-size:12px;letter-spacing:0.06em;text-transform:uppercase;color:var(--ink-dim);background:#fff;margin-bottom:18px}.hero h1{font-size:clamp(36px, 6vw, 64px);line-height:1.05;letter-spacing:-0.02em;margin:0 0 14px;font-weight:750;background:linear-gradient(\n 90deg,\n rgb(34, 53, 97) 0%,\n /* Dark Amberdata blue */\n color-mix(in srgb, rgb(34, 53, 97) 40%, white 60%) 100%\n /* Lightened blue */\n );-webkit-background-clip:text;-webkit-text-fill-color:transparent;text-decoration:none!important;pointer-events:none!important;cursor:default!important}.hero p{max-width:900px;margin:0 auto 22px;color:var(--ink-dim);font-size:clamp(16px, 1.8vw, 19px);line-height:1.65}.hero-cta{display:inline-flex;gap:12px;flex-wrap:wrap;justify-content:center}.btn{display:inline-flex;align-items:center;gap:10px;padding:12px 18px;border-radius:12px;text-decoration:none;border:1px solid var(--line);color:var(--ink);font-weight:600;transition:transform 0.06s ease,\n border-color 0.2s ease,\n background 0.2s ease,\n box-shadow 0.2s ease}.btn:hover{transform:translateY(-1px);border-color:#d6dae3}.btn-primary{background:#000!important;color:#fff!important;border:none!important;box-shadow:none!important}.btn-primary:hover{background:#111!important}.btn-ghost{background:#fff}.btn-secondary{background:var(--brand-sky);color:#0b0f19;border:1px solid color-mix(in srgb, var(--brand-blue) 35%, #fff 65%)}.btn-secondary:hover{filter:brightness(1.03)}a.btn-primary:hover,a.btn-secondary:hover{box-shadow:0 2px 0 0 var(--micro-line) inset}.features{padding:26px 0 8px}.feature-row{display:grid;gap:16px;grid-template-columns:repeat(1, minmax(0, 1fr))}@media (min-width: 900px){.feature-row{grid-template-columns:repeat(3, minmax(0, 1fr))}}.feature{background:color-mix(in srgb, var(--brand-pale) 55%, #fff 45%);border:1px solid color-mix(in srgb, var(--brand-blue) 30%, #cfe0f2 70%);border-radius:var(--radius);padding:18px;min-height:220px;display:flex;flex-direction:column;justify-content:center;transition:background 0.2s,\n border-color 0.2s,\n transform 0.06s,\n box-shadow 0.2s;text-decoration:none!important;pointer-events:none!important;cursor:default!important}.feature:hover{background:color-mix(in srgb, var(--brand-sky) 20%, #fff 80%);border-color:color-mix(in srgb, var(--brand-sky) 55%, #cfe0f2 45%);transform:translateY(-2px);box-shadow:0 8px 22px rgba(157, 206, 255, 0.18)}.feature h3{margin:0 0 6px;font-size:18px;letter-spacing:-0.01em;font-weight:700}.feature p{margin:0;color:var(--ink-dim)}.section{padding:36px 0 8px}.section h2{font-size:clamp(24px, 3.4vw, 36px);background:var(--accent-grad);-webkit-background-clip:text;-webkit-text-fill-color:transparent;letter-spacing:-0.015em;margin:0 0 8px;font-weight:740}.section p.lead{color:var(--ink-dim);max-width:900px;line-height:1.65}.section--alt{background:linear-gradient(\n 180deg,\n color-mix(in srgb, var(--brand-pale) 35%, #fff 65%),\n #fff\n )}.cards{margin-top:18px;display:grid;gap:16px;grid-template-columns:repeat(1, minmax(0, 1fr))}@media (min-width: 720px){.cards{grid-template-columns:repeat(2, minmax(0, 1fr))}}@media (min-width: 1120px){.cards{grid-template-columns:repeat(4, minmax(0, 1fr))}}.card{background:var(--tile);border:1px solid var(--line);border-radius:var(--radius);padding:18px;transition:background 0.2s,\n border-color 0.2s,\n transform 0.06s,\n box-shadow 0.2s;box-shadow:0 2px 6px rgba(0, 0, 0, 0.04)}.card:hover{background:var(--tile-hover);transform:translateY(-1px);border-color:color-mix(in srgb, var(--brand-sky) 50%, #dfe3ea 50%);box-shadow:0 8px 20px rgba(0, 0, 0, 0.08)}.card h3{margin:0 0 8px;font-size:16px;font-weight:700}.card p{margin:0 10px 10px 0;color:var(--ink-dim)}.card a{color:var(--ink);text-decoration:none;border-bottom:1px solid #dfe3ea}.card a:hover{border-bottom-color:color-mix(in srgb, var(--brand-blue) 45%, #c6ccd8 55%)}.usecases{margin-top:18px;display:grid;gap:16px;grid-template-columns:repeat(1, minmax(0, 1fr))}@media (min-width: 900px){.usecases{grid-template-columns:repeat(3, minmax(0, 1fr))}}.ucard{background:var(--tile);border:1px solid var(--line);border-radius:var(--radius);padding:18px;transition:background 0.2s,\n border-color 0.2s,\n transform 0.06s,\n box-shadow 0.2s;box-shadow:0 2px 6px rgba(0, 0, 0, 0.04)}.ucard:hover{background:var(--tile-hover);transform:translateY(-1px);border-color:color-mix(in srgb, var(--brand-blue) 45%, #cfe0f2 55%);box-shadow:0 8px 20px rgba(0, 0, 0, 0.08)}.ucard h4{margin:0 0 6px;font-weight:700}.ucard p{margin:0 10px 10px 0;color:var(--ink-dim)}.ucard a{color:var(--ink);text-decoration:none;border-bottom:1px solid #dfe3ea}.ucard a:hover{border-bottom-color:color-mix(in srgb, var(--brand-sky) 55%, #c6ccd8 45%)}.cta-band{padding:72px 0;background:linear-gradient(\n 180deg,\n color-mix(in srgb, var(--brand-blue) 15%, var(--brand-pale) 85%),\n var(--brand-pale)\n );text-align:center}.cta-band h2{font-size:clamp(28px, 3.4vw, 40px);margin:0 0 12px;background:var(--accent-grad);-webkit-background-clip:text;-webkit-text-fill-color:transparent}.cta-band p{max-width:800px;margin:0 auto 22px;color:var(--ink-dim);font-size:clamp(16px, 1.8vw, 19px);line-height:1.65}.cta-band .btn-primary{background:var(--accent-grad);box-shadow:0 6px 18px rgba(122, 171, 221, 0.18)}.cta-band .btn-primary:hover{filter:brightness(1.04)}.ready-section{max-width:900px;margin:40px auto;padding:0 20px;text-align:left}.ready-section h2{font-size:clamp(24px, 3.4vw, 36px);color:#000!important;background:none!important;-webkit-background-clip:initial;-webkit-text-fill-color:initial;letter-spacing:-0.015em;font-weight:740;padding-bottom:1rem}.ready-list{display:flex;flex-wrap:wrap;gap:2rem}.ready-item{flex:1 1 30%;display:flex}.tile-link{display:flex;flex:1;text-decoration:none;color:inherit}.tile{display:flex;flex-direction:column;justify-content:space-between;flex:1;padding:1.5rem;background:#fff;border:1px solid #ddd;border-radius:12px;transition:transform 0.2s ease,\n box-shadow 0.2s ease}.tile h3{margin-top:0;font-weight:700;color:#f26522}.tile p{flex-grow:1}.tile-link:hover .tile{transform:translateY(-4px);box-shadow:0 6px 18px rgba(0, 0, 0, 0.1)}.tile-link:hover .cta{text-decoration:underline}@media (max-width: 900px){.ready-item{flex:1 1 100%}}:root{--cf-bg: #0b0b0c;--cf-surface: #101113;--cf-border: #1b1d20;--cf-text: #e7e8ea;--cf-text-dim: #b7bac0;--cf-accent: #7aa2ff;--cf-ring: rgba(122, 162, 255, 0.4)}@media (prefers-color-scheme: light){:root{--cf-bg: #f7f7f8;--cf-surface: #ffffff;--cf-border: #e6e7eb;--cf-text: #0b0b0c;--cf-text-dim: #5b616e;--cf-accent: #3b6cff;--cf-ring: rgba(59, 108, 255, 0.2)}}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 1px, 1px);white-space:nowrap;border:0}.cf{width:100%;max-width:none;margin-left:0;margin-right:0;padding-left:2rem;padding-right:2rem;background-color:#000000;color:#ffffff;padding-top:2.4rem;padding-bottom:2.4rem}.cf-cta{border-bottom:1px solid var(--cf-border)}.cf-cta-inner{max-width:1200px;margin:0 auto;padding:2.5rem 1.25rem;display:grid;grid-template-columns:1fr;gap:1rem;align-items:center}.cf-cta-title{font-size:1.25rem;font-weight:600}.cf-cta-copy{color:var(--cf-text-dim)}.cf-cta-form{display:flex;gap:0.75rem;flex-wrap:wrap}.cf-input{flex:1 1 240px;min-width:220px;background:transparent;color:var(--cf-text);border:1px solid var(--cf-border);border-radius:0.75rem;padding:0.75rem 0.9rem;outline:none}.cf-input:focus{border-color:var(--cf-accent);box-shadow:0 0 0 4px var(--cf-ring)}.cf-button{border:1px solid var(--cf-border);border-radius:0.75rem;padding:0.75rem 1rem;cursor:default;background:var(--cf-accent);color:white;font-weight:600}.cf-button:hover{filter:brightness(1.05)}.cf-main{display:flex;justify-content:space-between;align-items:flex-start;margin-top:3rem;padding:2rem}.cf-brand{margin-left:auto}.cf-social{display:flex;gap:1rem;margin-right:0}.cf-social-link{display:inline-flex;padding:0.5rem;border:1px solid var(--cf-border);border-radius:0.75rem;color:#ffffff;fill:#ffffff;border-color:#ffffff}.cf-social-link:hover{border-color:#dddddd;box-shadow:0 0 0 3px rgba(255, 255, 255, 0.3)}.cf-icon{width:18px;height:18px;fill:currentColor}.cf-links{display:flex;gap:6rem;margin-left:0}.cf-col{display:grid;gap:0.6rem}.cf-col-title{font-size:0.9rem;font-weight:700;color:#ffffff;text-decoration:none!important;pointer-events:none!important;cursor:default!important}.cf-list{font-size:0.7rem;list-style:none;margin:0;padding:0;display:grid;gap:0.4rem}.cf-list a{color:#ffffff;text-decoration:none}.cf-list a:hover{color:#dddddd;text-decoration:underline}.cf-bottom{border-top:1px solid var(--cf-border);display:flex;justify-content:space-between;gap:1rem;padding:1.25rem;max-width:1200px;font-size:small;border-top:none!important}.cf-meta{display:flex;align-items:center;gap:0.5rem;color:var(--cf-text-dim)}.cf-meta-link{color:inherit;text-decoration:none}.cf-meta-link:hover{color:var(--cf-text);text-decoration:underline}.cf-dot{opacity:0.6}.cf-locale{display:flex;align-items:center;gap:0.5rem}.cf-select{background:transparent;color:var(--cf-text);border:1px solid var(--cf-border);border-radius:0.5rem;padding:0.4rem 0.6rem}.cf-select:focus{border-color:var(--cf-accent);box-shadow:0 0 0 3px var(--cf-ring);outline:none}@media (min-width: 800px){.cf-cta-inner{grid-template-columns:1fr auto}.cf-main{grid-template-columns:1.2fr 2fr}}.feature{background:#d9e4ee;border-color:color-mix(in srgb, #d9e4ee 60%, #cfe0f2 40%)}.feature h3{color:rgb(34, 53, 97)}.feature p{color:grey}.feature:hover{background:color-mix(in srgb, #d9e4ee 85%, white 15%);border-color:color-mix(in srgb, #d9e4ee 80%, #cfe0f2 20%);box-shadow:0 8px 22px rgba(217, 228, 238, 0.35)}.usecases{padding-left:20px;padding-right:20px;padding-bottom:20px}@media (min-width: 720px){.usecases{padding-left:40px;padding-right:40px;padding-bottom:40px}}@media (min-width: 1120px){.usecases{padding-left:60px;padding-right:60px;padding-bottom:60px}}.section.container h2{padding-left:20px;padding-right:20px;text-decoration:none!important;pointer-events:none!important;cursor:default!important}@media (min-width: 720px){.section.container h2{padding-left:40px;padding-right:40px}}@media (min-width: 1120px){.section.container h2{padding-left:60px;padding-right:60px}}.cf{background-color:#000000;color:#ffffff;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;text-rendering:optimizeLegibility;font-feature-settings:\"kern\" 1,\n \"liga\" 1,\n \"calt\" 1;display:flex;padding-left:4rem;padding-right:4rem;flex-direction:column;align-items:center;justify-content:center}.cf *{-webkit-tap-highlight-color:transparent}.cf a{color:#ffffff;text-decoration:none}.cf a:hover{text-decoration:underline}.cf-main{display:grid;grid-template-columns:1fr;gap:2rem;margin-top:2rem;padding:2.4rem 0}@media (min-width: 700px){.cf-main{grid-template-columns:1.2fr 2fr;align-items:start}}@media (min-width: 1100px){.cf-main{grid-template-columns:1.2fr 2.2fr}}.cf-links{display:grid;grid-template-columns:repeat(2, minmax(140px, 1fr));gap:1.25rem 2.5rem;margin:0;padding:0}@media (min-width: 900px){.cf-links{grid-template-columns:repeat(4, minmax(140px, 1fr));gap:1.25rem 3.5rem}}.cf-col-title{font-size:1rem;font-weight:700;color:#ffffff}.cf-list{list-style:none;margin:0;padding:0;display:grid;gap:0.45rem;font-size:0.85rem}.cf-brand{display:grid;gap:0.75rem;justify-items:start}.cf-social{display:flex;gap:0.75rem;flex-wrap:wrap}.cf-social-link{display:inline-flex;align-items:center;justify-content:center;width:38px;height:38px;border:1px solid rgba(255, 255, 255, 0.4);border-radius:0.75rem;color:#ffffff;background:transparent;transition:border-color 0.2s ease,\n transform 0.06s ease,\n box-shadow 0.2s ease}.cf-social-link:hover{border-color:#ffffff;transform:translateY(-1px);box-shadow:0 6px 16px rgba(255, 255, 255, 0.12)}.cf-social-link svg,.cf svg{display:block;width:20px;height:20px;fill:currentColor;stroke:currentColor;shape-rendering:geometricPrecision;text-rendering:geometricPrecision;image-rendering:-webkit-optimize-contrast;vector-effect:non-scaling-stroke}.cf-bottom{border-top:1px solid rgba(255, 255, 255, 0.12);display:grid;grid-template-columns:1fr;gap:0.75rem;padding:1.5rem 0 2.4rem;font-size:0.85rem}@media (min-width: 700px){.cf-bottom{grid-template-columns:1fr auto;align-items:center}}.cf-social-and-terms{display:flex;align-items:right}.cf-meta{display:flex;flex-wrap:wrap;gap:0.5rem 0.75rem;color:rgba(255, 255, 255, 0.75);font-size:0.85rem}.cf-locale{display:flex;align-items:center;gap:0.5rem}.cf-select{background:transparent;color:#ffffff;border:1px solid rgba(255, 255, 255, 0.22);border-radius:0.5rem;padding:0.4rem 0.6rem}.cf-select:focus{outline:none;border-color:#ffffff;box-shadow:0 0 0 3px rgba(255, 255, 255, 0.25)}.cf-inner,.cf-cta-inner{max-width:1200px;margin:0 auto;padding-left:1.25rem;padding-right:1.25rem}@media (min-width: 900px){.cf-inner,.cf-cta-inner{padding-left:1.5rem;padding-right:1.5rem}}@media (min-width: 1200px){.cf-inner,.cf-cta-inner{padding-left:2rem;padding-right:2rem}}.cf-button{background:#ffffff;color:#000000;border:none;border-radius:0.75rem;padding:0.75rem 1rem;font-weight:700;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.cf-button:hover{filter:brightness(0.92)}@media (max-width: 700px){.cf-meta{flex-direction:column;align-items:center;gap:0.4rem;text-align:center}}.cf-terms a:hover,.cf-meta a:hover{text-decoration:underline}@media (max-width: 768px){.cf-main{flex-direction:column!important;align-items:center!important;gap:20px!important}}"}],"page":{"pagePath":"http/market/spot-order-book-events","slug":"/http/market/spot-order-book-events","pageMetadata":{"openapi":"get /spot/order-book-events/{instrument}","title":"Events/Updates Historical","description":"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.","href":"/http/market/spot-order-book-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: \"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.\"\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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,Note,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Accordion,{title:`BitMEX Volume Calculation Warning`,id:`bitmex-volume-calculation-warning`,children:_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`BitMEX’s `,_jsx(_components.code,{children:`volume`}),` field represents the `,_jsx(_components.strong,{children:`number of contracts traded`}),`, not the volume in the base asset.`]}),_jsxs(_components.p,{children:[`To obtain the correct volume, users must adjust for `,_jsx(_components.strong,{children:`contract size`}),` using the `,_jsx(_components.code,{children:`underlyingToPositionMultiplier`}),` from our `,_jsx(_components.a,{href:`/http/md/spot-exchanges-reference`,children:`Reference endpoint`}),`.`]}),_jsxs(_components.p,{children:[`For details on this calculation and how to retrieve the correct values, see our `,_jsx(_components.a,{href:`/changelog/bitmex-volume-mapping`,children:`Changelog Update`}),`.`]})]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The maximum time range (difference between `,_jsx(_components.code,{children:`startDate`}),` and `,_jsx(_components.code,{children:`endDate`}),`) is `,_jsx(_components.strong,{children:`18 months`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`If the `,_jsx(_components.code,{children:`startDate`}),` and `,_jsx(_components.code,{children:`endDate`}),` query parameters are not provided, the API will return the data from the previous 24 hours.`]})})]})}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":{"openapi":"get /spot/order-book-events/{instrument}","title":"Events/Updates Historical","description":"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.","href":"/http/market/spot-order-book-events"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Events/Updates Historical","description":"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.","operationId":"spot-order-book-events","parameters":["9912247e-58ba-4567-9a56-6e77cb648b3c","c10e8439-4684-440d-abe1-81f708bddf8b","d0b9943d-845d-4b42-8fad-db0220a85289","d815ebcd-5cb5-4c1a-a2de-2b3e276e6bc5","0596a865-a197-4e02-bc88-d2cc03cdf493","785ac3de-a868-42ef-ba08-0fc52bc1eb38","4d79a801-c672-4107-ae1e-ec9f56d85088","dc9e6657-d443-4409-8e1a-38936117c8ad"],"responses":{"200":"50108709-b52e-47b8-bc4b-2801ea0186ad"},"deprecated":false,"security":["53f4b7f0-08d5-4ede-a21f-dee7d9ec681b"],"method":"get","type":"path","servers":["e589bb95-a89c-4627-9bb2-b698641b4b56"],"path":"/spot/order-book-events/{instrument}","baseUrlOptions":["https://api.amberdata.com/markets"],"title":"Events/Updates Historical","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9912247e-58ba-4567-9a56-6e77cb648b3c":{"name":"instrument","in":"path","description":"The spot instrument for which data will be retrieved.","schema":{"type":"string","default":"btc_usd","isRequired":true,"description":"The spot instrument for which data will be retrieved.","uniqueKey":"","typeLabel":"string"},"required":true},"c10e8439-4684-440d-abe1-81f708bddf8b":{"name":"exchange","in":"query","description":"The exchange for which data should be retrieved. Only **1** exchange is allowed.","required":true,"schema":{"type":"string","default":"gdax","isRequired":true,"description":"The exchange for which data should be retrieved. Only **1** exchange is allowed.","uniqueKey":"","typeLabel":"string"}},"d0b9943d-845d-4b42-8fad-db0220a85289":{"name":"startDate","in":"query","description":"**[Optional]** Payload only includes data after this date (inclusive). **[Formats]** `seconds | milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`","schema":{"type":"string","format":"date-time","default":"2024-03-01T00:00:00","description":"**[Optional]** Payload only includes data after this date (inclusive). **[Formats]** `seconds | milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"d815ebcd-5cb5-4c1a-a2de-2b3e276e6bc5":{"name":"endDate","in":"query","description":"**[Optional]** Payload only includes data before this date (exclusive). **[Formats]** `seconds | milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`","schema":{"type":"string","format":"date-time","default":"2024-03-01T01:00:00","description":"**[Optional]** Payload only includes data before this date (exclusive). **[Formats]** `seconds | milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"0596a865-a197-4e02-bc88-d2cc03cdf493":{"name":"timeFormat","in":"query","description":"**[Optional]** Time format of the timestamps in the response.","schema":{"type":"string","enum":["milliseconds","ms*","iso","iso8601","hr","human_readable"],"default":"hr","description":"**[Optional]** Time format of the timestamps in the response.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"785ac3de-a868-42ef-ba08-0fc52bc1eb38":{"name":"sortDirection","in":"query","description":"**[Optional]** Specifies the direction in which the data is sorted (by timestamp). **[Defaults]** asc (ascending order). **[Usage Conditions]** This parameter can only be used if the `startDate` and `endDate` timeframe is within the most recent 24 hours, or if the `startDate` and `endDate` parameters are not used at all. **[Examples]** ascending | descending | asc | desc","schema":{"type":"string","description":"**[Optional]** Specifies the direction in which the data is sorted (by timestamp). **[Defaults]** asc (ascending order). **[Usage Conditions]** This parameter can only be used if the `startDate` and `endDate` timeframe is within the most recent 24 hours, or if the `startDate` and `endDate` parameters are not used at all. **[Examples]** ascending | descending | asc | desc","uniqueKey":"","typeLabel":"string"}},"4d79a801-c672-4107-ae1e-ec9f56d85088":{"name":"Accept-Encoding","in":"header","required":true,"description":"","schema":{"type":"string","default":"gzip, deflate, br","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"dc9e6657-d443-4409-8e1a-38936117c8ad":{"name":"api-version","in":"header","schema":{"type":"string","uniqueKey":"","typeLabel":"string"}}},"responses":{"50108709-b52e-47b8-bc4b-2801ea0186ad":{"description":"200","content":{"application/json":{"examples":{"Result":{"title":"Result","value":{"status":200,"title":"OK","description":"Successful request","payload":{"metadata":{"requestedStartDate":"2024-03-01 00:00:00 000","returnedStartDate":"2024-03-01 00:00:00 005","returnedEndDate":"2024-03-01 00:00:42 218","next":"https://api.amberdata.com/markets/spot/order-book-events/btc_usd?cursor=N4IgxgrgTgzg9lEAuAdhANugNCGAXAQyjwBEC8BTZARgHYAGATgCYBWa5gFmeeoA4cFFABMylGgxatOfenLk48ASwC2FAGIIV5ZCAAWEbSgBKFAsIIAjdFUWqKASRSUoANwLpkoFATW6AnmawIDgwAI7oAHK%2BVEgggUQhuBHRagAK6NAeAUHo-knCFABmBBh4yHwAbJzyCiDaAB7IlQDMXDK19DjocHAA1pYEYH1pFFBKcMLIaJgAvjhFWjpxAFbwKEkUDWB6BCgA5rEg%2BxZNOEooYJmFAKooMBAADo8IlMIAotu7BxQwyCXoGAUUKEYjRFBwIFgOAiP5IRjyboEfAAcSgcCeXhAF3wUEMQnKcUseDAAH0IDApoIvntDroTgQziAtjtaRQACr2fC%2BR66Zj0LgAWnoLWF1AABHIkFLuOLeHxNjSfpy1NyVI9wZCKNDYcgEXUgWEIEIwEdOLQ%2BMxKsxaC1aPLLYwksi%2BsgANqgR7jU3NDjURgAOk4rBwrjgmT80pwaBUAHkoIVgqgMOhZgBdHCWJRTJButOzWZAA","api-version":"2023-09-30"},"data":[{"instrument":"btc_usd","exchange":"gdax","exchangeTimestamp":"2024-03-01 00:00:00 005","exchangeTimestampNanoseconds":174000,"sequence":"478262695005780","ask":[],"bid":[{"price":61141.86,"volume":0,"numOrders":null}]},{"instrument":"btc_usd","exchange":"gdax","exchangeTimestamp":"2024-03-01 00:00:00 005","exchangeTimestampNanoseconds":174000,"sequence":"478262695005781","ask":[],"bid":[{"price":61099.03,"volume":0,"numOrders":null}]}]}}}},"schema":{"type":"object","properties":{"status":{"type":"integer","uniqueKey":"status","typeLabel":"integer"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"},"payload":{"type":"object","properties":{"metadata":{"type":"object","properties":{"requestedStartDate":{"type":"string","uniqueKey":"payload.metadata.requestedStartDate","typeLabel":"string"},"returnedStartDate":{"type":"string","uniqueKey":"payload.metadata.returnedStartDate","typeLabel":"string"},"returnedEndDate":{"type":"string","uniqueKey":"payload.metadata.returnedEndDate","typeLabel":"string"},"next":{"type":"string","uniqueKey":"payload.metadata.next","typeLabel":"string"},"api-version":{"type":"string","uniqueKey":"payload.metadata.api-version","typeLabel":"string"}},"uniqueKey":"payload.metadata","typeLabel":"object"},"data":{"type":"array","items":{"type":"object","properties":{"instrument":{"type":"string","uniqueKey":"payload.data.items.[INDEX].instrument","typeLabel":"string"},"exchange":{"type":"string","uniqueKey":"payload.data.items.[INDEX].exchange","typeLabel":"string"},"exchangeTimestamp":{"type":"string","uniqueKey":"payload.data.items.[INDEX].exchangeTimestamp","typeLabel":"string"},"exchangeTimestampNanoseconds":{"type":"integer","uniqueKey":"payload.data.items.[INDEX].exchangeTimestampNanoseconds","typeLabel":"integer"},"sequence":{"type":"string","uniqueKey":"payload.data.items.[INDEX].sequence","typeLabel":"string"},"ask":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"payload.data.items.[INDEX].ask.items.[INDEX]","typeLabel":"any"},"uniqueKey":"payload.data.items.[INDEX].ask","typeLabel":"any[]"},"bid":{"type":"array","items":{"type":"object","properties":{"price":{"type":"number","uniqueKey":"payload.data.items.[INDEX].bid.items.[INDEX].price","typeLabel":"number"},"volume":{"type":"integer","uniqueKey":"payload.data.items.[INDEX].bid.items.[INDEX].volume","typeLabel":"integer"},"numOrders":{"type":"string","uniqueKey":"payload.data.items.[INDEX].bid.items.[INDEX].numOrders","typeLabel":"string"}},"uniqueKey":"payload.data.items.[INDEX].bid.items.[INDEX]","typeLabel":"object"},"uniqueKey":"payload.data.items.[INDEX].bid","typeLabel":"object[]"}},"uniqueKey":"payload.data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"payload.data","typeLabel":"object[]"}},"uniqueKey":"payload","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"53f4b7f0-08d5-4ede-a21f-dee7d9ec681b":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]}}},"servers":{"e589bb95-a89c-4627-9bb2-b698641b4b56":{"url":"https://api.amberdata.com/markets"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"http/market/openapi.yaml"},"subdomain":"amberdata","siteName":"Amberdata Docs","title":"Events/Updates Historical - Amberdata Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-28T18:09:27.019Z","originalFileLocation":"http/market/spot-order-book-events.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Amberdata Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/amberdata/4NLEeYr0d04b68eJ/_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/amberdata/4NLEeYr0d04b68eJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/amberdata/4NLEeYr0d04b68eJ/_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/amberdata/4NLEeYr0d04b68eJ/_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/amberdata/4NLEeYr0d04b68eJ/_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/amberdata/4NLEeYr0d04b68eJ/_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/amberdata/4NLEeYr0d04b68eJ/_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/amberdata/4NLEeYr0d04b68eJ/_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/amberdata/4NLEeYr0d04b68eJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Events/Updates Historical - Amberdata Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Amberdata Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.amberdata.io/http/market/spot-order-book-events\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://amberdata.mintlify.site/_mintlify/api/og/v2?division=Order+Books\u0026amp;title=Events%2FUpdates+Historical\u0026amp;description=Provides+historical+updates+to+Spot+market+order+books%2C+capturing+real-time+changes+in+bid+and+ask+levels%2C+volumes%2C+and+order+counts+for+specified+trading+pairs\u0026amp;theme=0253f0d84e960b3d0f9f95a8\u0026amp;signature=bf443fb873dce7d794567c6607b32c5397399db6c9f5d7cf8e4e1a7410902c28\">\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=\"Events/Updates Historical - Amberdata Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://amberdata.mintlify.site/_mintlify/api/og/v2?division=Order+Books\u0026amp;title=Events%2FUpdates+Historical\u0026amp;description=Provides+historical+updates+to+Spot+market+order+books%2C+capturing+real-time+changes+in+bid+and+ask+levels%2C+volumes%2C+and+order+counts+for+specified+trading+pairs\u0026amp;theme=0253f0d84e960b3d0f9f95a8\u0026amp;signature=bf443fb873dce7d794567c6607b32c5397399db6c9f5d7cf8e4e1a7410902c28\">\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/amberdata/4NLEeYr0d04b68eJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Amberdata Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E17039\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.amberdata.io/http/market/spot-order-book-events\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/http/market/spot-order-book-events.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.amberdata.io/#organization\",\"name\":\"Amberdata Docs\",\"url\":\"https://docs.amberdata.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/amberdata/WBTlNuO5-2IAq9z3/images/logo/amberdata_logo_color_light.svg?fit=max\u0026auto=format\u0026n=WBTlNuO5-2IAq9z3\u0026q=85\u0026s=2251cc13c2305e431971beef410e262b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.amberdata.io#website\",\"name\":\"Amberdata Docs\",\"url\":\"https://docs.amberdata.io\",\"publisher\":{\"@id\":\"https://docs.amberdata.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.amberdata.io/http/market/spot-order-book-events#webpage\",\"url\":\"https://docs.amberdata.io/http/market/spot-order-book-events\",\"name\":\"Events/Updates Historical\",\"description\":\"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.\",\"dateModified\":\"2026-01-28T18:09:27.019Z\",\"isPartOf\":{\"@id\":\"https://docs.amberdata.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.amberdata.io/http/market/spot-order-book-events#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.amberdata.io/http/market/spot-order-book-events#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Market Data\",\"item\":\"https://docs.amberdata.io/http/market/spot-exchanges-information\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Spot\",\"item\":\"https://docs.amberdata.io/http/market/spot-exchanges-information\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Order Books\",\"item\":\"https://docs.amberdata.io/http/market/spot-order-book-snapshots-information\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Events/Updates Historical\",\"item\":\"https://docs.amberdata.io/http/market/spot-order-book-events\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.amberdata.io/http/market/spot-order-book-events#apireference\",\"headline\":\"Events/Updates Historical\",\"name\":\"Events/Updates Historical\",\"description\":\"Provides historical updates to Spot market order books, capturing real-time changes in bid and ask levels, volumes, and order counts for specified trading pairs, with precise timestamps for event sequencing and tracking market activity.\",\"url\":\"https://docs.amberdata.io/http/market/spot-order-book-events\",\"mainEntityOfPage\":{\"@id\":\"https://docs.amberdata.io/http/market/spot-order-book-events#webpage\"},\"dateModified\":\"2026-01-28T18:09:27.019Z\",\"publisher\":{\"@id\":\"https://docs.amberdata.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.amberdata.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Amberdata Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Amberdata Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/http/market/spot-order-book-events.md","siteName":"Amberdata Docs","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Data Dictionary","pages":[{"title":"Data Dictionary","href":"/data-dictionary/coverage/exchange-coverage"}]},{"tab":"Intelligence","pages":[{"title":"Intelligence","href":"/intelligence/getting-started/quick-start"}]},{"tab":"HTTP","groups":[{"group":"Getting Started","pages":[{"title":"API Fundamentals","href":"/http/http-api-fundamentals"},{"title":"Pagination and Timeframes","href":"/http/http-pagination-and-timeframes"},{"title":"Query Parameters and Optimization","href":"/http/http-query-parameters-and-optimization"}]},{"group":"Market Data","pages":[{"group":"Spot","pages":[{"group":"Exchanges","pages":[{"openapi":"get /spot/exchanges/information","title":"Instruments","href":"/http/market/spot-exchanges-information"},{"openapi":"get /spot/exchanges/reference","title":"Reference","href":"/http/market/spot-exchanges-reference"}]},{"group":"OHLCV","pages":[{"openapi":"get /spot/ohlcv/information","title":"Information","href":"/http/market/spot-ohlcv-information"},{"openapi":"get /spot/ohlcv/{instrument}","title":"Historical","href":"/http/market/spot-ohlcv"},{"openapi":"get /spot/batch-ohlcv/{exchange}","title":"Batch Historical","href":"/http/market/spot-batch-ohlcv"}]},{"group":"Order Books","pages":[{"openapi":"get /spot/order-book-snapshots/information","title":"Information","href":"/http/market/spot-order-book-snapshots-information"},{"openapi":"get /spot/order-book-snapshots/{instrument}","title":"Snapshots Historical","description":"Delivers historical order book snapshots for specified Spot market trading pairs, including detailed bid and ask levels, volume, and order count per price level, along with timestamps to track market depth over time.","href":"/http/market/spot-order-book-snapshots"},{"openapi":"get /spot/order-book-events/{instrument}","title":"Events/Updates Historical","href":"/http/market/spot-order-book-events"}]},{"group":"Price","hidden":true,"pages":[{"openapi":"get /spot/prices/assets/information/","title":"Assets Information","description":"Retrieves the list of all the available supported assets and time range availability.","href":"/http/price/spot-prices-assets-information"},{"openapi":"get /spot/prices/assets/{asset}/latest/","title":"Assets Latest","description":"Retrieves the latest price for the specified asset - the global price is calculated across all exchanges which supports this asset, including all cross rates pairs.\n\nPrice of an asset is calculated as the VWAP (Volume Weighted Average Price) across all exchanges supporting this asset, with a 1 bar lookback period.","href":"/http/price/spot-prices-assets-latest"},{"openapi":"get /spot/prices/assets/{asset}/historical/","title":"Assets Historical","description":"Retrieves the historical price for the specified asset - the price is calculated across all exchanges which supports this asset, including all cross rates pairs.\n\nPrice of an asset is calculated as the VWAP (Volume Weighted Average Price) across all exchanges supporting this asset, with a 1 bar lookback period.","href":"/http/price/spot-prices-assets-historical"},{"openapi":"get /spot/prices/pairs/information/","title":"Pairs Information","description":"Retrieves the list of all the available supported pairs and time range availability.","href":"/http/price/spot-prices-pairs-information"},{"openapi":"get /spot/prices/pairs/{pair}/latest/","title":"Pairs Latest","description":"Retrieves the latest price for the specified pair - the price is calculated across all exchanges which supports this pair.\n\nPrice of a pair is calculated as the VWAP (Volume Weighted Average Price) across all exchanges supporting this pair, with a 1 bar lookback period.\n\nIf the parameter exchange is specified, the data returned is the price for that pair on that exchange.","href":"/http/price/spot-prices-pairs-latest"},{"openapi":"get /spot/prices/pairs/{pair}/historical/","title":"Pairs Historical","description":"Retrieves the historical price for the specified pair - the price is calculated across all exchanges which supports this pair, including all cross rates pairs.\n\nPrice of a pair is calculated as the VWAP (Volume Weighted Average Price) across all exchanges supporting this pair, with a 1 bar lookback period. If the parameter exchange is specified, the data returned is the VWAP for that pair on that exchange.","href":"/http/price/spot-prices-pairs-historical"}]},{"group":"Tickers","pages":[{"openapi":"get /spot/tickers/information","title":"Information","description":"Provides availability details for Spot market ticker data across supported exchanges, including trading pairs, data coverage start and end times, and exchange-specific information.","href":"/http/market/spot-tickers-information"},{"openapi":"get /spot/tickers/{instrument}","title":"Historical","href":"/http/market/spot-tickers"}]},{"group":"Trades","pages":[{"openapi":"get /spot/trades/information","title":"Information","href":"/http/market/spot-trades-information"},{"openapi":"get /spot/trades/{instrument}","title":"Historical","href":"/http/market/spot-trades"}]},{"group":"Reference Rates","pages":[{"openapi":"get /spot/reference-rates/{assetId}","title":"Hourly \u0026 Daily Reference Rates","href":"/http/market/spot-reference-rates"}]}]},{"group":"Options","pages":[{"group":"Exchanges","pages":[{"openapi":"get /options/exchanges/information","title":"Instruments","href":"/http/market/options-exchanges-information"},{"openapi":"get /options/exchanges/reference","title":"Reference","href":"/http/market/options-exchanges-reference"}]},{"group":"Liquidations","pages":[{"openapi":"get /options/liquidations/information","title":"Information","href":"/http/market/options-liquidations-information"},{"openapi":"get /options/liquidations/{instrument}","title":"Historical","href":"/http/market/options-liquidations"}]},{"group":"OHLCV","pages":[{"openapi":"get /options/ohlcv/information","title":"Information","href":"/http/market/options-ohlcv-information"},{"openapi":"get /options/ohlcv/{instrument}","title":"Historical","href":"/http/market/options-ohlcv"},{"openapi":"get /options/batch-ohlcv/{exchange}","title":"Batch Historical","href":"/http/market/options-batch-ohlcv"}]},{"group":"Open Interest","pages":[{"openapi":"get /options/open-interest/information","title":"Information","href":"/http/market/options-open-interest-information"},{"openapi":"get /options/open-interest/{instrument}","title":"Historical","href":"/http/market/options-open-interest"},{"openapi":"get /options/batch-open-interest/{exchange}","title":"Batch Historical","href":"/http/market/options-batch-open-interest"}]},{"group":"Order Books","pages":[{"openapi":"get /options/order-book-events/information","title":"Events Information","href":"/http/market/options-order-book-events-information"},{"openapi":"get /options/order-book-events/{instrument}","title":"Events Historical","href":"/http/market/options-order-book-events"},{"openapi":"get /options/order-book-snapshots/information","title":"Snapshots Information","href":"/http/market/options-order-book-snapshots-information"},{"openapi":"get /options/order-book-snapshots/{instrument}","title":"Snapshots Historical","href":"/http/market/options-order-book-snapshots"}]},{"group":"Tickers","pages":[{"openapi":"get /options/tickers/information","title":"Information","href":"/http/market/options-tickers-information"},{"openapi":"get /options/tickers/{instrument}","title":"Historical","href":"/http/market/options-tickers"}]},{"group":"Trades","pages":[{"openapi":"get /options/trades/information","title":"Information","href":"/http/market/options-trades-information"},{"openapi":"get /options/trades/{instrument}","title":"Historical","href":"/http/market/options-trades"}]}]},{"group":"Futures","pages":[{"group":"Exchanges","pages":[{"openapi":"get /futures/exchanges/information","title":"Instruments","href":"/http/market/futures-exchanges-information"},{"openapi":"get /futures/exchanges/reference","title":"Reference","href":"/http/market/futures-exchanges-reference"}]},{"group":"Funding Rates","pages":[{"openapi":"get /futures/funding-rates/information","title":"Information","href":"/http/market/futures-funding-rates-information"},{"openapi":"get /futures/funding-rates/{instrument}","title":"Historical","href":"/http/market/futures-funding-rates"},{"openapi":"get /futures/batch-funding-rates/{exchange}","title":"Batch Historical","href":"/http/market/futures-batch-funding-rates"}]},{"group":"Insurance Funds","pages":[{"openapi":"get /futures/insurance-fund/information","title":"Information","href":"/http/market/futures-insurance-fund-information"},{"openapi":"get /futures/insurance-fund/{instrument}","title":"Historical","href":"/http/market/futures-insurance-fund"}]},{"group":"Liquidations","pages":[{"openapi":"get /futures/liquidations/information","title":"Information","href":"/http/market/futures-liquidations-information"},{"openapi":"get /futures/liquidations/{instrument}","title":"Historical","href":"/http/market/futures-liquidations"}]},{"group":"Long/Short Ratio","pages":[{"openapi":"get /futures/long-short-ratio/information","title":"Information","href":"/http/market/futures-long-short-ratio-information"},{"openapi":"get /futures/long-short-ratio/{instrument}","title":"Historical","href":"/http/market/futures-long-short-ratio"}]},{"group":"OHLCV","pages":[{"openapi":"get /futures/ohlcv/information","title":"Information","href":"/http/market/futures-ohlcv-information"},{"openapi":"get /futures/ohlcv/{instrument}","title":"Historical","href":"/http/market/futures-ohlcv"},{"openapi":"get /futures/batch-ohlcv/{exchange}","title":"Batch Historical","href":"/http/market/futures-batch-ohlcv"}]},{"group":"Open Interest","pages":[{"openapi":"get /futures/open-interest/information","title":"Information","href":"/http/market/futures-open-interest-information"},{"openapi":"get /futures/open-interest/{instrument}","title":"Historical","href":"/http/market/futures-open-interest"},{"openapi":"get /futures/batch-open-interest/{exchange}","title":"Batch Historical","href":"/http/market/futures-batch-open-interest"}]},{"group":"Order Books","pages":[{"openapi":"get /futures/order-book-snapshots/information","title":"Information","href":"/http/market/futures-order-book-snapshots-information"},{"openapi":"get /futures/order-book-snapshots/{instrument}","title":"Snapshots Historical","href":"/http/market/futures-order-book-snapshots"},{"openapi":"get /futures/order-book-events/{instrument}","title":"Events/Updates Historical","href":"/http/market/futures-order-book-events"}]},{"group":"Tickers","pages":[{"openapi":"get /futures/tickers/information","title":"Information","href":"/http/market/futures-tickers-information"},{"openapi":"get /futures/tickers/{instrument}","title":"Historical","href":"/http/market/futures-tickers"}]},{"group":"Trades","pages":[{"openapi":"get /futures/trades/information","title":"Information","href":"/http/market/futures-trades-information"},{"openapi":"get /futures/trades/{instrument}","title":"Historical","href":"/http/market/futures-trades"}]}]}]},{"group":"Blockchain \u0026 DeFi","pages":[{"group":"Blockchain","pages":[{"openapi":"get /contracts/{hash}","title":"Contract Details","href":"/http/blockchain/contract-details"},{"group":"Metrics","pages":[{"openapi":"get /metrics/latest","title":"Metrics - By Blockchain","href":"/http/blockchain/metrics--by-blockchain"},{"openapi":"get /blocks/metrics/historical","title":"Blocks Metrics Historical","href":"/http/blockchain/metrics-historical--confirmed-blocks"},{"openapi":"get /transactions/metrics/historical","title":"Transaction Metrics Historical","href":"/http/blockchain/metrics-historical--confirmed-transactions"},{"openapi":"get /tokens/metrics/{symbol}/historical","title":"Token Metrics Historical","href":"/http/blockchain/token-metrics-historical"},{"openapi":"get /tokens/{hash}/supplies/historical","title":"Token Supplies by Address Historical","href":"/http/blockchain/historical--token-supplies-by-address"}]},{"group":"Wallet (Address) Balances","pages":[{"openapi":"get /addresses/{address}/portfolio","title":"Account and Token Balance - Wallet Portfolio","href":"/http/blockchain/wallet-portfolio--balance-\u0026-token-holdings"},{"openapi":"get /addresses/{hash}/balances","title":"Account and Token Balance Latest","href":"/http/blockchain/balance-\u0026-tokens-latest--by-address"},{"openapi":"get /addresses/balances","title":"Account \u0026 Token Balances Latest Batch - Multiple Wallets","href":"/http/blockchain/account-\u0026-token-balances-latest-batch--multiple-wallets"},{"openapi":"get /addresses/{hash}/account-balances/latest","title":"Account Balance Latest","href":"/http/blockchain/balance-latest--by-address"},{"openapi":"get /addresses/{hash}/account-balances/historical","title":"Account Balance Historical","href":"/http/blockchain/balance-historical--by-address"},{"openapi":"get /addresses/{hash}/token-balances/latest","title":"Token Balances Latest","href":"/http/blockchain/token-balances-latest--by-address"},{"openapi":"get /addresses/{hash}/token-balances/historical","title":"Token Balances Historical","href":"/http/blockchain/token-balances-historical--by-address"}]},{"group":"Transactions and Tokens","pages":[{"openapi":"get /addresses/{hash}/transactions","title":"Transactions - By Wallet Address","href":"/http/blockchain/transactions--by-address"},{"openapi":"get /addresses/{hash}/logs","title":"Transaction Logs - By Wallet Address","href":"/http/blockchain/transaction-logs--by-wallet-address"},{"openapi":"get /tokens/{hash}/transfers","title":"Token Transfers - By Token Address","href":"/http/blockchain/token-transfers--by-token-address"},{"openapi":"get /addresses/{hash}/token-transfers","title":"Token Transfers - By Wallet Address","href":"/http/blockchain/token-transfers--by-wallet-address"},{"openapi":"get /tokens/{hash}/holders/latest","title":"Current Holders - By Token Address","href":"/http/blockchain/current-holders--by-token-address"}]}]},{"group":"Stablecoins","pages":[{"openapi":"get /analytics/stablecoins/information","title":"Stablecoins Supported Assets \u0026 Insights","href":"/http/blockchain/stablecoins-information-gold"},{"group":"Transfer Analytics","pages":[{"openapi":"get /analytics/stablecoins/transfers","title":"Stablecoin Transfers - Aggregated Insights","href":"/http/blockchain/stablecoins-transfers-hourly-gold"}]}]},{"group":"Analytics","pages":[{"openapi":"get /analytics/assets/information","title":"On-chain Analytics Supported Assets","href":"/http/blockchain/analytics-assets-information"},{"openapi":"get /analytics/assets/{arcId}/marketcap","title":"Asset Market Cap","href":"/http/blockchain/analytics-asset-marketcap"}]},{"group":"DeFi","pages":[{"openapi":"get /lending/assets/information","title":"Information - Assets in Lending Protocols","href":"/http/defi/lending-assets-information"},{"openapi":"get /dex/exchanges","title":"Information - DEX Protocols","href":"/http/defi-market/dex-exchanges"},{"openapi":"get /dex/pairs","title":"Information - Pairs in DEX Protocols","href":"/http/defi-market/dex-pairs"},{"group":"DEX - Trades","pages":[{"openapi":"get /dex/trades","hidden":true,"title":"DEX Trades Historical","href":"/http/defi/dex-trades-historical"},{"openapi":"get /dex/information","hidden":true,"title":"DEX Protocols Information","href":"/http/defi/dex-information"}]},{"group":"DEX - OHLCV","pages":[{"openapi":"get /dex/ohlcv/information/","title":"Information","href":"/http/defi/dex-ohlcv-information"},{"openapi":"get /ohlcv/{pool}/latest/","title":"Latest","href":"/http/defi-market/dex-ohlcv-latest"},{"openapi":"get /ohlcv/{pool}/historical/","title":"Historical","href":"/http/defi-market/ohlcv-historical"}]},{"group":"DEX - Metrics","pages":[{"openapi":"get /metrics/exchanges/{exchange}/latest","title":"Exchanges Latest","href":"/http/defi-market/exchanges-latest"},{"openapi":"get /metrics/exchanges/{exchange}/historical","title":"Exchanges Historical","href":"/http/defi-market/exchanges-historical"},{"openapi":"get /metrics/exchanges/{exchange}/assets/{asset}/latest","title":"Assets Latest","href":"/http/defi-market/metrics-assets-latest"},{"openapi":"get /metrics/exchanges/{exchange}/assets/{asset}/historical","title":"Assets Historical","href":"/http/defi-market/metrics-assets-historical"},{"openapi":"get /metrics/exchanges/{exchange}/pairs/{pair}/latest","title":"Pairs Latest","href":"/http/defi-market/metrics-exchanges-pairs-latest"},{"openapi":"get /metrics/exchanges/{exchange}/pairs/{pair}/historical","title":"Pairs Historical","href":"/http/defi-market/metrics-exchanges-pairs-historical"}]},{"group":"Lending - Portfolio \u0026 Returns","pages":[{"openapi":"get /lending/{protocolId}/wallets/{address}/portfolio","title":"Track Positions - Lending Wallets","href":"/http/defi/lending-wallets-portfolio"},{"openapi":"get /lending/wallets/{walletAddress}/returns","title":"Profit \u0026 Loss Analytics in DeFi Lending","href":"/http/defi/lending-wallets-returns"}]},{"group":"Lending - Metrics","pages":[{"openapi":"get /lending/{protocolId}/metrics/summary","title":"Lending Protocol Summary Metrics","href":"/http/defi/lending-metrics-summary"},{"openapi":"get /lending/{protocolId}/assets/{assetId}/metrics/summary","title":"Lending Asset Summary Metrics","href":"/http/defi/lending-assets-metrics-summary"}]},{"group":"Lending - All Transactions","pages":[{"openapi":"get /lending/protocols/information","title":"Information - Lending Protocols","href":"/http/defi/lending-protocols-information"},{"openapi":"get /lending/{protocolId}/protocol","title":"Protocol Lens","href":"/http/defi/lending-protocol"},{"openapi":"get /lending/{protocolId}/assets/{asset}","title":"Asset Lens","href":"/http/defi/lending-assets"},{"openapi":"get /lending/{protocolId}/wallets/{walletAddress}","title":"Wallet Lens","href":"/http/defi/lending-wallets"},{"openapi":"get /lending/{protocolId}/governance","title":"Governance Lens","href":"/http/defi/lending-governance"}]},{"group":"Stablecoins","pages":[{"openapi":"get /stablecoins/{assetSymbol}/lending/metrics/summary","title":"Stablecoins in DeFi Lending - Aggregate Insights","href":"/http/defi/stablecoins-lending-metrics-summary"}]}]}]},{"group":"Price","pages":[{"group":"Information","pages":[{"openapi":"get /prices/spot/instruments/information","title":"Pair Information","href":"/http/price/new-instrument-pair-information"},{"openapi":"get /prices/spot/assets/information","title":"Asset Information","href":"/http/price/new-asset-information"}]},{"group":"Prices","pages":[{"openapi":"get /prices/spot/instruments","title":"Pair Price","href":"/http/price/new-instrument-price"},{"openapi":"get /prices/spot/assets","title":"Asset Price","href":"/http/price/new-asset-price"}]}]},{"group":"Analytics","pages":[{"group":"Derivatives Analytics","pages":[{"group":"Information","pages":[{"openapi":"get /analytics/instruments/information","title":"Options Instruments","href":"/http/analytics/derivatives/instruments-information"}]},{"group":"Futures/Perpetuals","pages":[{"openapi":"get /analytics/futures-perpetuals/apr-basis/constant-maturities","title":"Apr-Basis Constant Maturity","href":"/http/analytics/derivatives/apr-basis-constant-maturity"},{"openapi":"get /analytics/futures-perpetuals/apr-basis/constant-days-to-expiration","title":"Apr-Basis Constant Maturity Decorated","href":"/http/analytics/derivatives/apr-basis-constant-maturity-decorated"},{"openapi":"get /analytics/futures-perpetuals/apr-basis/live-term-structures","title":"Apr-Basis Live Term Structure","href":"/http/analytics/derivatives/apr-basis-live-term-structure"},{"openapi":"get /analytics/futures-perpetuals/realized-funding-rates-cumulated","title":"Funding Realized/Accumulated","href":"/http/analytics/derivatives/funding-realized-accumulated"},{"openapi":"get /analytics/futures-perpetuals/funding-rates","title":"Funding Rates","href":"/http/analytics/derivatives/funding-rates"},{"openapi":"get /analytics/futures-perpetuals/liquidations-total","title":"Liquidations Aggregate (Futures and Perpetuals)","href":"/http/analytics/derivatives/liquidations-aggregate-futures-and-perpetuals"},{"openapi":"get /analytics/futures-perpetuals/open-interest-total","title":"Open Interest","href":"/http/analytics/derivatives/open-interest"},{"openapi":"get /analytics/futures-perpetuals/volumes","title":"Volumes","href":"/http/analytics/derivatives/volumes"}]},{"group":"Realized Volatility","pages":[{"openapi":"get /analytics/realized-volatility/cones/information","title":"Pairs Information","href":"/http/analytics/derivatives/realized-volatility-information"},{"openapi":"get /analytics/realized-volatility/correlation-beta","title":"Correlation, Beta and Realized Volatility","href":"/http/analytics/derivatives/correlation-beta-and-realized-volatility"},{"openapi":"get /analytics/realized-volatility/monthly-vs-daily-ratio","title":"Monthly versus Daily Volatility Ratio","href":"/http/analytics/derivatives/monthly-versus-daily-volatility-ratio"},{"openapi":"get /analytics/realized-volatility/seasonality/day-of-week","title":"Seasonality: Volatility Day of Week","href":"/http/analytics/derivatives/seasonality:-volatility-day-of-week"},{"openapi":"get /analytics/realized-volatility/seasonality/month-of-year","title":"Seasonality: Volatility Month of the Year","href":"/http/analytics/derivatives/seasonality:-volatility-month-of-the-year"},{"openapi":"get /analytics/realized-volatility/cones","title":"Volatility Cones","href":"/http/analytics/derivatives/volatility-cones"}]},{"group":"Volatility","pages":[{"openapi":"get /analytics/volatility/level-1-quotes","title":"Level 1 Quotes","href":"/http/analytics/derivatives/level-1-quotes"},{"openapi":"get /analytics/volatility/delta-surfaces/constant","title":"Delta Surfaces Constant","href":"/http/analytics/derivatives/delta-surfaces-constant"},{"openapi":"get /analytics/volatility/delta-surfaces/floating","title":"Delta Surfaces Floating","href":"/http/analytics/derivatives/delta-surfaces-floating"},{"openapi":"get /analytics/volatility/moneyness-surfaces/constant","title":"Moneyness Surfaces Constant","href":"/http/analytics/derivatives/moneyness-surfaces-constant"},{"openapi":"get /analytics/volatility/moneyness-surfaces/floating","title":"Moneyness Surfaces Floating","href":"/http/analytics/derivatives/moneyness-surfaces-floating"},{"openapi":"get /analytics/realized-volatility/implied-vs-realized","title":"Implied (vs) Realized","href":"/http/analytics/derivatives/implied-vs-realized"},{"openapi":"get /analytics/volatility/term-structures/forward-volatility/constant","title":"Term Structures Constant","href":"/http/analytics/derivatives/term-structures-constant"},{"openapi":"get /analytics/volatility/term-structures/forward-volatility/floating","title":"Term Structures Floating","href":"/http/analytics/derivatives/term-structures-floating"},{"openapi":"get /analytics/volatility/term-structures/richness","title":"Term Structures Richness","href":"/http/analytics/derivatives/term-structures-richness"},{"openapi":"get /analytics/volatility/index","title":"Volatility Index","href":"/http/analytics/derivatives/volatility-index"},{"openapi":"get /analytics/volatility/index-decorated","title":"Volatility Index Decorated","href":"/http/analytics/derivatives/volatility-index-decorated"},{"openapi":"get /analytics/volatility/variance-premium","title":"Volatility Index VRP (variance risk premium)","href":"/http/analytics/derivatives/volatility-index-vrp-variance-risk-premium"},{"openapi":"get /analytics/volatility/volatility-of-volatility","title":"Volatility of Volatility (DVol Index)","href":"/http/analytics/derivatives/volatility-of-volatility-dvol-index"},{"openapi":"get /analytics/volatility/metrics","title":"Volatility Metrics (24 hr)","href":"/http/analytics/derivatives/volatility-metrics-24-hr"},{"openapi":"get /analytics/volatility/index-delivery-price","title":"Index Delivery Price","href":"/http/analytics/derivatives/index-delivery-price"}]},{"group":"SVI Calibration","pages":[{"openapi":"get /analytics/volatility/svi-hourly","title":"SVI - Historical","href":"/http/analytics/derivatives/svi-historical"},{"openapi":"get /analytics/volatility/svi-minutely","title":"SVI - Minutely","href":"/http/analytics/derivatives/svi-minutely"},{"openapi":"get /analytics/volatility/altcoin/atm/hourly","title":"Altcoin ATM Hourly","href":"/http/analytics/derivatives/altcoin-atm-hourly"},{"openapi":"get /analytics/volatility/atm/deribit-vs-model-hourly","title":"Deribit vs Model Hourly","href":"/http/analytics/derivatives/deribit-vs-model-hourly"}]},{"group":"Trades / Flow","pages":[{"openapi":"get /analytics/trades-flow/block-volumes","title":"Block Volumes","href":"/http/analytics/derivatives/block-volumes"},{"openapi":"get /analytics/trades-flow/decorated-trades","title":"Decorated Trades","href":"/http/analytics/derivatives/decorated-trades"},{"openapi":"get /analytics/instruments/most-traded","title":"Instruments Most Traded","href":"/http/analytics/derivatives/instruments-most-traded"},{"openapi":"get /analytics/trades-flow/gamma-exposures/normalized-usd","title":"Gamma Normalized in USD","href":"/http/analytics/derivatives/gamma-normalized-in-usd"},{"openapi":"get /analytics/trades-flow/gamma-exposures-snapshots","title":"Gamma Snapshots (GEX)","href":"/http/analytics/derivatives/gamma-snapshots-gex"},{"openapi":"get /analytics/trades-flow/options-yields","title":"Options Yields","href":"/http/analytics/derivatives/options-yields"},{"openapi":"get /analytics/trades-flow/put-call-distribution","title":"Put Call Trades Distribution","href":"/http/analytics/derivatives/put-call-trades-distribution"},{"openapi":"get /analytics/trades-flow/put-call-ratio","title":"Put Call Ratio","href":"/http/analytics/derivatives/put-call-ratio"},{"openapi":"get /analytics/options-scanner/top-trades","title":"Top Trades","href":"/http/analytics/derivatives/top-trades"},{"openapi":"get /analytics/trades-flow/volume-aggregates","title":"Volume Aggregates","href":"/http/analytics/derivatives/volume-aggregates"}]},{"group":"TradFi: ETFs and Crypto related Equities","pages":[{"group":"Information","pages":[{"openapi":"get /analytics/instruments/information/tradfi","title":"Options Instruments","href":"/http/analytics/derivatives/tradfi-options-instruments"}]},{"group":"Realized Volatility","pages":[{"openapi":"get /analytics/realized-volatility/tradfi","title":"Realized Volatility (Close-to-Close)","href":"/http/analytics/derivatives/tradfi-realized-volatility-close-to-close"},{"openapi":"get /analytics/realized-volatility/cones/tradfi","title":"Volatility Cones","href":"/http/analytics/derivatives/tradfi-volatility-cones"}]},{"group":"Volatility","pages":[{"openapi":"get /analytics/volatility/level-1-quotes/tradfi","title":"Level 1 Quotes","href":"/http/analytics/derivatives/tradfi-level-1-quotes"},{"openapi":"get /analytics/volatility/level-1-quotes-instrument/tradfi","title":"Level 1 Quotes Instrument","href":"/http/analytics/derivatives/tradfi-level-1-quotes-instrument"},{"openapi":"get /analytics/volatility/delta-surfaces/constant/tradfi","title":"Delta Surfaces Constant","href":"/http/analytics/derivatives/tradfi-delta-surfaces-constant"},{"openapi":"get /analytics/volatility/delta-surfaces/floating/tradfi","title":"Delta Surface Floating","href":"/http/analytics/derivatives/tradfi-delta-surfaces-floating"},{"openapi":"get /analytics/realized-volatility/implied-vs-realized/tradfi","title":"Implied (vs) Realized","href":"/http/analytics/derivatives/tradfi-implied-vs-realized"},{"openapi":"get /analytics/volatility/term-structures/forward-volatility/constant/tradfi","title":"Term Structures Constant","href":"/http/analytics/derivatives/tradfi-term-structures-constant"},{"openapi":"get /analytics/volatility/term-structures/richness/tradfi","title":"Term Structure Richness","href":"/http/analytics/derivatives/tradfi-term-structures-richness"},{"openapi":"get /analytics/volatility/open-interest/tradfi","title":"Open Interest","href":"/http/analytics/derivatives/tradfi-open-interest"},{"openapi":"get /analytics/volatility/metrics/tradfi","title":"Volatility Metrics (24 hr)","href":"/http/analytics/derivatives/tradfi-volatility-metrics-24-hr"}]},{"group":"Trades/Flow","pages":[{"openapi":"get /analytics/trades-flow/decorated-trades/tradfi","title":"Decorated Trades","href":"/http/analytics/derivatives/tradfi-decorated-trades"},{"openapi":"get /analytics/instruments/most-traded/tradfi","title":"Instruments Most Traded","href":"/http/analytics/derivatives/tradfi-instruments-most-traded"},{"openapi":"get /analytics/trades-flow/options-yields/tradfi","title":"Options Yields","href":"/http/analytics/derivatives/tradfi-options-yields"},{"openapi":"get /analytics/trades-flow/option-volumes/tradfi","title":"Option Volumes","href":"/http/analytics/derivatives/tradfi-option-volumes"}]}]}]},{"group":"Spot \u0026 Futures Liquidity","pages":[{"group":"Information","pages":[{"openapi":"get /depth/information","title":"Information Depth Analytics Pairs and Exchanges","href":"/http/analytics/spot/information-depth-analytics-pairs-and-exchanges"},{"openapi":"get /trade/information/pairs","title":"Information Trade Analytics Pairs","href":"/http/analytics/spot/information-trade-analytics-pairs"},{"openapi":"get /trade/information/exchanges","title":"Information Trade Exchange Support per Pair","href":"/http/analytics/spot/information-trade-exchange-support-per-pair"},{"openapi":"get /analytics/futures-perpetuals/depth/information","title":"Futures Depth Instruments","href":"/http/analytics/derivatives/futures-depth-information"}]},{"group":"Spot - Order Book Depth Analytics","pages":[{"openapi":"get /depth/bid-ask-spread","title":"Bid Ask Spread","href":"/http/analytics/spot/bid-ask-spread"},{"openapi":"get /depth/average-time-series","title":"Average Depth","href":"/http/analytics/spot/average-depth"},{"openapi":"get /depth","title":"Depth","href":"/http/analytics/spot/depth"},{"openapi":"get /depth/dashboard","title":"Depth Dashboard","href":"/http/analytics/spot/depth-dashboard"},{"openapi":"get /depth/lwap","title":"LWAP","href":"/http/analytics/spot/lwap"},{"openapi":"get /depth/pressure","title":"Pressure","href":"/http/analytics/spot/pressure"}]},{"group":"Futures - Order Book Depth Analytics","pages":[{"openapi":"get /analytics/futures-perpetuals/depth/bid-ask-spread","title":"Bid Ask Spread","href":"/http/analytics/derivatives/bid-ask-spread"},{"openapi":"get /analytics/futures-perpetuals/depth","title":"Depth","href":"/http/analytics/derivatives/depth"},{"openapi":"get /analytics/futures-perpetuals/depth/pressure","title":"Pressure","href":"/http/analytics/derivatives/depth-pressure"}]},{"group":"Trade Analytics","pages":[{"openapi":"get /trade/frequency","title":"Trade Frequency","href":"/http/analytics/spot/trade-frequency"},{"openapi":"get /trade/pressure","title":"Trade Pressure","href":"/http/analytics/spot/trade-pressure"},{"openapi":"get /volumes/asset","title":"Asset Volume USD","href":"/http/analytics/spot/volumes-asset"},{"openapi":"get /volumes/exchange","title":"Exchange Volume USD","href":"/http/analytics/spot/volumes-exchange"},{"openapi":"get /trade/vwap","title":"VWAP - TWAP","href":"/http/analytics/spot/vwap-twap"}]}]}]},{"group":"Market Insights","pages":[{"group":"CEX Metrics","hidden":true,"pages":[{"openapi":"get /exchanges/{exchange}/assets/volumes/latest","title":"asset-volume-latest","href":"/http/metrics/asset-volume-latest"},{"openapi":"get /exchanges/{exchange}/assets/volumes/historical","title":"asset-volume-historical","href":"/http/metrics/asset-volume-historical"},{"openapi":"get /exchanges/{exchange}/pairs/volumes/latest","title":"Pair Volume Latest","href":"/http/metrics/pair-volume-latest"},{"openapi":"get /exchanges/{exchange}/pairs/volumes/historical","title":"Pair Volume Historical","href":"/http/metrics/pair-volume-historical"}]},{"group":"Rankings","pages":[]},{"group":"Supply","pages":[]},{"group":"Token Prices","pages":[]},{"group":"Institutional Metrics","pages":[{"openapi":"get /metrics/information","title":"Datasets Information","href":"/http/amberlens/amberlens-information"},{"openapi":"get /metrics/data","title":"Get Dataset","href":"/http/amberlens/amberlens-metrics"}]}]},{"group":"Asset Reference \u0026 Classification","pages":[{"title":"Updates","openapi":"get /updates","href":"/http/arc/updates"},{"openapi":"get /classifications","title":"List Classifications","href":"/http/arc/list-classifications"},{"openapi":"get /exchanges/statistics","title":"Exchange Statistics","href":"/http/arc/exchange-statistics"},{"openapi":"get /search","title":"Search Assets","href":"/http/arc/search-assets"}]},{"group":"API Specs","pages":[{"title":"Downloads","href":"/data-dictionary/api-specs"}]}]},{"tab":"Real-Time","pages":[{"title":"Real-Time","href":"/real-time/websocket-getting-started"}]},{"tab":"CloudSync","pages":[{"title":"CloudSync","href":"/cloudsync/cloudsync-overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/product-updates"}]}]},"basePath":"","title":"Events/Updates Historical - Amberdata Docs","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}