Returns a single venue event. The response may include an embedded venueMarkets array. That array is deprecated — fetch the event’s markets from GET /venue-markets?venueEventId=. marketCount and the rolled-up volume cover the event’s whole matched cluster by default. marketCount is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. volume sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send cluster=false to scope both to this venue event alone. The embedded venueMarkets array is always this one event’s markets regardless of cluster.
GET
/
venue-events
/
{id}
Get Venue Event
curl --request GET \ --url https://api.agg.market/venue-events/{id} \ --header 'x-app-id: <api-key>'
Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.
Path Parameters
id
string
required
Query Parameters
cluster
enum<string>
Available options:
true,
false
minVolume
number
Required range: x >= 0
Response
200
id
string
required
Event id. List responses return one row per matched cluster, and for a matched event this id is the cluster anchor — the handle to use for cross-venue lookups. Re-resolve it from discovery rather than storing it as a permanent key: clusters can merge, after which the id remains a valid event but is no longer the cluster head. See the Matched Clusters guide.
externalIdentifier
string
required
title
string
required
image
string | null
required
venue
enum<string>
required
Available options:
kalshi,
polymarket,
limitless,
predict,
pred,
tiprun,
myriad,
hyperliquid,
novig,
prophetx,
betdex,
lighter
categories
object[]
required
Show child attributes
description
string | null
deployerVenue
string | null
volume
number | null
Required range: x >= 0
status
enum<string>
Available options:
open,
closed,
resolved,
unopened,
paused
startDate
string | null
endDate
string | null
creationDate
string | null
gameStartTime
string | null
slug
string | null
subtitle
string | null
venues
enum<string>[]
Venues this row's matched cluster spans — use it for venue badges. On a cluster anchor this is the cluster-wide set; a non-anchor member usually reports the same set, but narrows to its own venue when none of its markets have cross-venue counterparts.
Available options:
kalshi,
polymarket,
limitless,
predict,
pred,
tiprun,
myriad,
hyperliquid,
novig,
prophetx,
betdex,
lighter
marketCount
integer
Number of markets on this event. Use this rather than the length of an embedded venueMarkets array, which is a preview on list responses. On GET /venue-events/:id this counts the whole matched cluster (send cluster=false to scope it to the single venue event); on list responses it counts the row's own event.
Required range: x >= 0
venueCount
integer
Length of venues — the size of the matched cluster.
Required range: x >= 0
groupMarketCount
integer
Required range: x >= 0
groupParentId
string | null
Same-venue companion grouping: the id of this event's group base. NULL means the event IS the base, or is standalone. A venue splits one game into several events (… - More Markets, … : Spread), and same-venue events never share a matched cluster (the sole exception is Hyperliquid HIP-4 deployers, see /recipes/hyperliquid-deployers) — so on a companion, matchedVenueEvents[] lists the other venues' EQUIVALENT companions, not the game's cluster. Use this id (or the shared aggKey) to reach the base. See /recipes/sports-market-detail.
updatedAt
string | null
venueMarkets
object[]
Embedded markets. On list responses this is a preview of up to three markets chosen to represent the event on a card — not the complete set, and not necessarily the largest; use marketCount for totals. On the by-id response it is uncapped. Deprecated on both — fetch markets from GET /venue-markets?venueEventId=.
Show child attributes
arbReturn
number | null
series
object | null
Show child attributes
recurrence
string | null
aggKey
string | null
Deterministic canonical key computed from this venue's own data; null when not canonicalizable. This is a fetch filter, not a cross-venue join key — it is guaranteed identical across venues only for sports head-to-head and crypto up/down markets, and two members of the same matched cluster can carry different keys. Use the event id and matchedVenueMarkets for identity.
structureType
enum<string> | null
Available options:
candidate,
sport,
axis,
dates
sport
string | null
settlementDiff
object | null
Show child attributes
settlementDiffStatus
enum<string>
Available options:
computed,
pending,
not_applicable
matchedVenueEvents
object[]
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Agg.market — Prediction Market Aggregator","description":"White-label prediction market aggregator API: sign users in, quote the best price across venues, execute trades, and track them to a final status. Start with Quickstart: REST.","colors":{"primary":"#ED8200","light":"#FFA366","dark":"#C66F00"},"logo":{"light":"https://mintcdn.com/agg/SLxnoWBYT8Zyhg9W/assets/agg-dark.svg?fit=max\u0026auto=format\u0026n=SLxnoWBYT8Zyhg9W\u0026q=85\u0026s=f1b6e05f3e2529bc2c7698267234f5d1","dark":"https://mintcdn.com/agg/SLxnoWBYT8Zyhg9W/assets/agg-white.svg?fit=max\u0026auto=format\u0026n=SLxnoWBYT8Zyhg9W\u0026q=85\u0026s=4a896195354d17f32101e0ec90fb822c"},"favicon":"https://mintcdn.com/agg/OOif8Fd2iWonTlgU/assets/favicon.svg?fit=max\u0026auto=format\u0026n=OOif8Fd2iWonTlgU\u0026q=85\u0026s=6907ac01c9b9a95394f668f53099f108","background":{"decoration":"grid"},"navbar":{"links":[{"href":"https://storybook.agg.market","label":"Storybook"}],"primary":{"type":"button","label":"Admin Dashboard","href":"https://admin.agg.market"}},"footer":{"socials":{"x":"https://x.com/Snag_Solutions","linkedin":"https://www.linkedin.com/company/snag-solutions"}},"banner":{"content":"AGG is currently in **alpha**. APIs, components, and docs may change.","dismissible":false},"metadata":{"timestamp":false},"markdown":{"instructions":["To integrate AGG, start with Quickstart: REST (https://docs.agg.market/quickstart/rest), then Order lifecycle \u0026 statuses (https://docs.agg.market/concepts/order-lifecycle).","Track every trade until it reaches a terminal status. Before retrying a failed or timed-out call, read Errors, retries \u0026 idempotency (https://docs.agg.market/concepts/errors).","The API reference is generated from https://docs.agg.market/openapi/openapi.json."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"agg","hasAudioNarration":false,"actualSubdomain":"agg","customDomains":["docs.agg.market"],"gitSource":{"type":"github","owner":"snag-solutions","repo":"agg","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aff4f795246eb87f3620b22","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Trading API","count":80},{"language":"default","tag":"Guides","count":73},{"language":"default","tag":"Trading","count":22},{"language":"default","tag":"Server API","count":21},{"language":"default","tag":"Users","count":13},{"language":"default","tag":"Core concepts","count":12},{"language":"default","tag":"Funding","count":12},{"language":"default","tag":"Market data","count":11},{"language":"default","tag":"Markets","count":10},{"language":"default","tag":"Partner Admin","count":10}]},"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":"site-roles","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/markets/get-venue-event","slug":"/api-reference/markets/get-venue-event","pageMetadata":{"title":"Get Venue Event","description":"Returns a single venue event. The response may include an embedded `venueMarkets` array. That array is deprecated — fetch the event's markets from GET /venue-markets?venueEventId=. `marketCount` and the rolled-up `volume` cover the event's whole matched cluster by default. `marketCount` is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. `volume` sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send `cluster=false` to scope both to this venue event alone. The embedded `venueMarkets` array is always this one event's markets regardless of `cluster`.","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-events/{id}","href":"/api-reference/markets/get-venue-event","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns a single venue event. The response may include an embedded \", _jsx(_components.code, {\n children: \"venueMarkets\"\n }), \" array. That array is deprecated — fetch the event’s markets from GET /venue-markets?venueEventId=. \", _jsx(_components.code, {\n children: \"marketCount\"\n }), \" and the rolled-up \", _jsx(_components.code, {\n children: \"volume\"\n }), \" cover the event’s whole matched cluster by default. \", _jsx(_components.code, {\n children: \"marketCount\"\n }), \" is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. \", _jsx(_components.code, {\n children: \"volume\"\n }), \" sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send \", _jsx(_components.code, {\n children: \"cluster=false\"\n }), \" to scope both to this venue event alone. The embedded \", _jsx(_components.code, {\n children: \"venueMarkets\"\n }), \" array is always this one event’s markets regardless of \", _jsx(_components.code, {\n children: \"cluster\"\n }), \".\"]\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`,li:`li`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`integration-guide`,children:`Integration guide`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Before you call:`}),` `,_jsx(_components.a,{href:`/concepts/ids`,children:`Choose the correct event, market, and outcome IDs`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Workflow:`}),` `,_jsx(_components.a,{href:`/recipes/building-market-views`,children:`Build an event and market screen`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Next:`}),` `,_jsx(_components.a,{href:`/concepts/quotes`,children:`Read quote prices, expiry, fees, and warnings`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Venue Event","description":"Returns a single venue event. The response may include an embedded `venueMarkets` array. That array is deprecated — fetch the event's markets from GET /venue-markets?venueEventId=. `marketCount` and the rolled-up `volume` cover the event's whole matched cluster by default. `marketCount` is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. `volume` sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send `cluster=false` to scope both to this venue event alone. The embedded `venueMarkets` array is always this one event's markets regardless of `cluster`.","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-events/{id}","href":"/api-reference/markets/get-venue-event","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Integration guide","slug":"integration-guide","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Returns a single venue event. The response may include an embedded `venueMarkets` array. That array is deprecated — fetch the event's markets from GET /venue-markets?venueEventId=. `marketCount` and the rolled-up `volume` cover the event's whole matched cluster by default. `marketCount` is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. `volume` sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send `cluster=false` to scope both to this venue event alone. The embedded `venueMarkets` array is always this one event's markets regardless of `cluster`.","summary":"Get Venue Event","tags":["Markets"],"parameters":["d35e405f-e0b4-4618-9266-25c0c6067e47","04605126-0f9c-4599-9e5f-bb9b514cc5cb","41f33c9b-a89c-4b12-b089-b156e6d93097"],"operationId":"getVenueEventById","responses":{"200":"79e4c526-8010-4a30-84ed-aa376a2eff49","401":"31807a5b-e28b-43e7-91b0-c38d236dbff9","404":"c4430e6b-f033-4801-8708-9c737a72f7c9"},"security":["c09e7b1a-c2bc-4a51-8b4b-49512c80250c"],"x-mint":{"content":"## Integration guide\n\n- **Before you call:** [Choose the correct event, market, and outcome IDs](/concepts/ids).\n- **Workflow:** [Build an event and market screen](/recipes/building-market-views).\n- **Next:** [Read quote prices, expiry, fees, and warnings](/concepts/quotes)."},"method":"get","type":"path","servers":["3915078d-e73f-42da-9155-945be58f38f6"],"path":"/venue-events/{id}","baseUrlOptions":["https://api.agg.market"],"title":"Get Venue Event","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d35e405f-e0b4-4618-9266-25c0c6067e47":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"04605126-0f9c-4599-9e5f-bb9b514cc5cb":{"name":"cluster","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"41f33c9b-a89c-4b12-b089-b156e6d93097":{"name":"minVolume","in":"query","required":false,"schema":{"minimum":0,"type":"number","isRequired":false,"uniqueKey":"","typeLabel":"number"}}},"responses":{"79e4c526-8010-4a30-84ed-aa376a2eff49":{"description":"200","content":{"application/json":{"schema":{"type":"object","required":["id","externalIdentifier","title","image","venue","categories"],"properties":{"id":{"description":"Event id. List responses return one row per matched cluster, and for a matched event this id is the cluster anchor — the handle to use for cross-venue lookups. Re-resolve it from discovery rather than storing it as a permanent key: clusters can merge, after which the id remains a valid event but is no longer the cluster head. See the Matched Clusters guide.","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"externalIdentifier":{"type":"string","isRequired":true,"uniqueKey":"externalIdentifier","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"image":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"image.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"image.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"image","typeLabel":"string | null"},"venue":{"type":"string","enum":["kalshi","polymarket","limitless","predict","pred","tiprun","myriad","hyperliquid","novig","prophetx","betdex","lighter"],"isRequired":true,"uniqueKey":"venue","typeLabel":"enum\u003cstring>"},"categories":{"type":"array","items":{"type":"object","required":["id","category"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].id","typeLabel":"string"},"category":{"type":"object","required":["id","name","displayName","parentId","eventCount","volume24hr","volume"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.name","typeLabel":"string"},"displayName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.displayName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.displayName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"categories.items.[INDEX].category.displayName","typeLabel":"string | null"},"parentId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.parentId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.parentId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"categories.items.[INDEX].category.parentId","typeLabel":"string | null"},"eventCount":{"type":"number","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.eventCount","typeLabel":"number"},"volume24hr":{"type":"number","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.volume24hr","typeLabel":"number"},"volume":{"type":"number","isRequired":true,"uniqueKey":"categories.items.[INDEX].category.volume","typeLabel":"number"}},"isRequired":true,"uniqueKey":"categories.items.[INDEX].category","typeLabel":"object"}},"uniqueKey":"categories.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"categories","typeLabel":"object[]"},"description":{"oneOf":[{"type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"deployerVenue":{"oneOf":[{"type":"string","uniqueKey":"deployerVenue.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"deployerVenue.oneOf.1","typeLabel":"null"}],"uniqueKey":"deployerVenue","typeLabel":"string | null"},"volume":{"oneOf":[{"minimum":0,"type":"number","uniqueKey":"volume.oneOf.0","typeLabel":"number"},{"minimum":0,"type":"null","uniqueKey":"volume.oneOf.1","typeLabel":"null"}],"uniqueKey":"volume","typeLabel":"number | null"},"status":{"type":"string","enum":["open","closed","resolved","unopened","paused"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"startDate":{"oneOf":[{"type":"string","uniqueKey":"startDate.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"startDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"startDate","typeLabel":"string | null"},"endDate":{"oneOf":[{"type":"string","uniqueKey":"endDate.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"endDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"endDate","typeLabel":"string | null"},"creationDate":{"oneOf":[{"type":"string","uniqueKey":"creationDate.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"creationDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"creationDate","typeLabel":"string | null"},"gameStartTime":{"oneOf":[{"type":"string","uniqueKey":"gameStartTime.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"gameStartTime.oneOf.1","typeLabel":"null"}],"uniqueKey":"gameStartTime","typeLabel":"string | null"},"slug":{"oneOf":[{"type":"string","uniqueKey":"slug.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"slug","typeLabel":"string | null"},"subtitle":{"oneOf":[{"type":"string","uniqueKey":"subtitle.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"subtitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"subtitle","typeLabel":"string | null"},"venues":{"description":"Venues this row's matched cluster spans — use it for venue badges. On a cluster anchor this is the cluster-wide set; a non-anchor member usually reports the same set, but narrows to its own venue when none of its markets have cross-venue counterparts.","type":"array","items":{"type":"string","enum":["kalshi","polymarket","limitless","predict","pred","tiprun","myriad","hyperliquid","novig","prophetx","betdex","lighter"],"uniqueKey":"venues.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"venues","typeLabel":"enum\u003cstring>[]"},"marketCount":{"minimum":0,"description":"Number of markets on this event. Use this rather than the length of an embedded venueMarkets array, which is a preview on list responses. On GET /venue-events/:id this counts the whole matched cluster (send cluster=false to scope it to the single venue event); on list responses it counts the row's own event.","type":"integer","uniqueKey":"marketCount","typeLabel":"integer"},"venueCount":{"minimum":0,"description":"Length of `venues` — the size of the matched cluster.","type":"integer","uniqueKey":"venueCount","typeLabel":"integer"},"groupMarketCount":{"minimum":0,"type":"integer","uniqueKey":"groupMarketCount","typeLabel":"integer"},"groupParentId":{"oneOf":[{"description":"Same-venue companion grouping: the id of this event's group base. NULL means the event IS the base, or is standalone. A venue splits one game into several events (`… - More Markets`, `… : Spread`), and same-venue events never share a matched cluster (the sole exception is Hyperliquid HIP-4 deployers, see /recipes/hyperliquid-deployers) — so on a companion, `matchedVenueEvents[]` lists the other venues' EQUIVALENT companions, not the game's cluster. Use this id (or the shared `aggKey`) to reach the base. See /recipes/sports-market-detail.","type":"string","uniqueKey":"groupParentId.oneOf.0","typeLabel":"string"},{"description":"Same-venue companion grouping: the id of this event's group base. NULL means the event IS the base, or is standalone. A venue splits one game into several events (`… - More Markets`, `… : Spread`), and same-venue events never share a matched cluster (the sole exception is Hyperliquid HIP-4 deployers, see /recipes/hyperliquid-deployers) — so on a companion, `matchedVenueEvents[]` lists the other venues' EQUIVALENT companions, not the game's cluster. Use this id (or the shared `aggKey`) to reach the base. See /recipes/sports-market-detail.","type":"null","uniqueKey":"groupParentId.oneOf.1","typeLabel":"null"}],"uniqueKey":"groupParentId","typeLabel":"string | null"},"updatedAt":{"oneOf":[{"type":"string","uniqueKey":"updatedAt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"updatedAt","typeLabel":"string | null"},"venueMarkets":{"description":"Embedded markets. On list responses this is a preview of up to three markets chosen to represent the event on a card — not the complete set, and not necessarily the largest; use marketCount for totals. On the by-id response it is uncapped. Deprecated on both — fetch markets from GET /venue-markets?venueEventId=.","type":"array","items":{"type":"object","required":["id","venue","externalIdentifier","question","venueMarketOutcomes"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].id","typeLabel":"string"},"venue":{"type":"string","enum":["kalshi","polymarket","limitless","predict","pred","tiprun","myriad","hyperliquid","novig","prophetx","betdex","lighter"],"isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].venue","typeLabel":"enum\u003cstring>"},"externalIdentifier":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].externalIdentifier","typeLabel":"string"},"question":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].question","typeLabel":"string"},"venueMarketOutcomes":{"type":"array","items":{"type":"object","required":["id","venueMarketId","label"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].id","typeLabel":"string"},"venueMarketId":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].venueMarketId","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].label","typeLabel":"string"},"externalIdentifier":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].externalIdentifier.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].externalIdentifier.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].externalIdentifier","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].title","typeLabel":"string | null"},"price":{"minimum":0,"maximum":1,"deprecated":true,"description":"No longer returned. Fetch live prices from GET /midpoints (pass this outcome's parent venueMarketId in `ids` and match on `outcomes[].venueMarketOutcomeId`), or subscribe to the WebSocket midpoint stream.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].price","typeLabel":"number"},"priceChange24h":{"oneOf":[{"description":"Change in this outcome's price over the last 24 hours, in absolute probability points (0.05 = up 5 cents). `null` = unknown, never zero: venues that publish no 24h change are sampled by us, so their markets read `null` for roughly their first 24 hours. Refreshed out of band, so it can lag the live price: a few minutes for active Polymarket markets and on Myriad, about 30 minutes on Kalshi and Hyperliquid, about 15 minutes on sampled venues, and hours for quiet Polymarket markets.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].priceChange24h.oneOf.0","typeLabel":"number"},{"description":"Change in this outcome's price over the last 24 hours, in absolute probability points (0.05 = up 5 cents). `null` = unknown, never zero: venues that publish no 24h change are sampled by us, so their markets read `null` for roughly their first 24 hours. Refreshed out of band, so it can lag the live price: a few minutes for active Polymarket markets and on Myriad, about 30 minutes on Kalshi and Hyperliquid, about 15 minutes on sampled venues, and hours for quiet Polymarket markets.","type":"null","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].priceChange24h.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].priceChange24h","typeLabel":"number | null"},"winner":{"oneOf":[{"type":"boolean","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winner.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winner.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winner","typeLabel":"boolean | null"},"payoutPerShare":{"oneOf":[{"minimum":0,"maximum":1,"description":"Per-share USDC payout of this outcome in [0, 1] once the market settles. Source of truth over `winner` when set: a Polymarket UMA 50/50 stores 0.5 on both sides, a Novig void stores its refund prices (e.g. 0.155 / 0.845). `null` = unknown; clients fall back to `winner ? 1/winnerCount : 0`.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].payoutPerShare.oneOf.0","typeLabel":"number"},{"minimum":0,"maximum":1,"description":"Per-share USDC payout of this outcome in [0, 1] once the market settles. Source of truth over `winner` when set: a Polymarket UMA 50/50 stores 0.5 on both sides, a Novig void stores its refund prices (e.g. 0.155 / 0.845). `null` = unknown; clients fall back to `winner ? 1/winnerCount : 0`.","type":"null","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].payoutPerShare.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].payoutPerShare","typeLabel":"number | null"},"refundAtCost":{"description":"True when the venue voided the market and returns every holder their stake (ProphetX). `winner` is true on every outcome and `payoutPerShare` is null; the per-share refund is the holder's own average entry price. Check this BEFORE `payoutPerShare` / `winner ? 1/winnerCount : 0`.","type":"boolean","uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].refundAtCost","typeLabel":"boolean"},"winnerSource":{"oneOf":[{"description":"Who decided `winner`: `venue` = the venue's own result; `matched` = inferred from matched markets on other venues because this venue named no winner yet (ProphetX). A `matched` winner can still change when the venue settles — e.g. tennis retirements. `null` when `winner` is null or the winner predates this field.","type":"string","enum":["venue","matched"],"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winnerSource.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Who decided `winner`: `venue` = the venue's own result; `matched` = inferred from matched markets on other venues because this venue named no winner yet (ProphetX). A `matched` winner can still change when the venue settles — e.g. tennis retirements. `null` when `winner` is null or the winner predates this field.","type":"null","enum":["venue","matched"],"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winnerSource.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winnerSource","typeLabel":"enum\u003cstring> | null"},"matchedVenueMarketOutcomes":{"type":"array","items":{"type":"object","required":["venueMarketId","venueMarketOutcomeId"],"properties":{"venueMarketId":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].matchedVenueMarketOutcomes.items.[INDEX].venueMarketId","typeLabel":"string"},"venueMarketOutcomeId":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].matchedVenueMarketOutcomes.items.[INDEX].venueMarketOutcomeId","typeLabel":"string"}},"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].matchedVenueMarketOutcomes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].matchedVenueMarketOutcomes","typeLabel":"object[]"}},"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].venueMarketOutcomes","typeLabel":"object[]"},"deployerVenue":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].deployerVenue.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].deployerVenue.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].deployerVenue","typeLabel":"string | null"},"marketId":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].marketId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].marketId.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].marketId","typeLabel":"string | null"},"venueEventId":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].venueEventId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].venueEventId.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].venueEventId","typeLabel":"string | null"},"detailsDeferred":{"type":"boolean","enum":[true],"uniqueKey":"venueMarkets.items.[INDEX].detailsDeferred","typeLabel":"enum\u003cboolean>"},"description":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].description","typeLabel":"string | null"},"rulesPrimary":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].rulesPrimary.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].rulesPrimary.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].rulesPrimary","typeLabel":"string | null"},"rulesSecondary":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].rulesSecondary.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].rulesSecondary.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].rulesSecondary","typeLabel":"string | null"},"conditionId":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].conditionId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].conditionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].conditionId","typeLabel":"string | null"},"volume":{"oneOf":[{"minimum":0,"type":"number","uniqueKey":"venueMarkets.items.[INDEX].volume.oneOf.0","typeLabel":"number"},{"minimum":0,"type":"null","uniqueKey":"venueMarkets.items.[INDEX].volume.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].volume","typeLabel":"number | null"},"volume24hr":{"oneOf":[{"minimum":0,"type":"number","uniqueKey":"venueMarkets.items.[INDEX].volume24hr.oneOf.0","typeLabel":"number"},{"minimum":0,"type":"null","uniqueKey":"venueMarkets.items.[INDEX].volume24hr.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].volume24hr","typeLabel":"number | null"},"image":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].image.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].image","typeLabel":"string | null"},"status":{"type":"string","enum":["open","closed","resolved","unopened","paused"],"uniqueKey":"venueMarkets.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"startDate":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].startDate.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].startDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].startDate","typeLabel":"string | null"},"endDate":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].endDate.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].endDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].endDate","typeLabel":"string | null"},"creationDate":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].creationDate.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].creationDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].creationDate","typeLabel":"string | null"},"createdAt":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].createdAt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].createdAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].createdAt","typeLabel":"string | null"},"resolutionDate":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].resolutionDate.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].resolutionDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].resolutionDate","typeLabel":"string | null"},"negRisk":{"type":"boolean","uniqueKey":"venueMarkets.items.[INDEX].negRisk","typeLabel":"boolean"},"venues":{"type":"array","items":{"type":"string","enum":["kalshi","polymarket","limitless","predict","pred","tiprun","myriad","hyperliquid","novig","prophetx","betdex","lighter"],"uniqueKey":"venueMarkets.items.[INDEX].venues.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"venueMarkets.items.[INDEX].venues","typeLabel":"enum\u003cstring>[]"},"venueCount":{"minimum":0,"type":"integer","uniqueKey":"venueMarkets.items.[INDEX].venueCount","typeLabel":"integer"},"arbReturn":{"oneOf":[{"type":"number","uniqueKey":"venueMarkets.items.[INDEX].arbReturn.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].arbReturn.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].arbReturn","typeLabel":"number | null"},"aggKey":{"oneOf":[{"description":"Deterministic canonical key computed from this venue's own data; null when not canonicalizable. This is a fetch filter, not a cross-venue join key — it is guaranteed identical across venues only for sports head-to-head and crypto up/down markets, and two members of the same matched cluster can carry different keys. Use the event id and matchedVenueMarkets for identity.","type":"string","uniqueKey":"venueMarkets.items.[INDEX].aggKey.oneOf.0","typeLabel":"string"},{"description":"Deterministic canonical key computed from this venue's own data; null when not canonicalizable. This is a fetch filter, not a cross-venue join key — it is guaranteed identical across venues only for sports head-to-head and crypto up/down markets, and two members of the same matched cluster can carry different keys. Use the event id and matchedVenueMarkets for identity.","type":"null","uniqueKey":"venueMarkets.items.[INDEX].aggKey.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].aggKey","typeLabel":"string | null"},"sportsMarketType":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].sportsMarketType.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].sportsMarketType.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].sportsMarketType","typeLabel":"string | null"},"sectionRank":{"oneOf":[{"type":"integer","uniqueKey":"venueMarkets.items.[INDEX].sectionRank.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].sectionRank.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].sectionRank","typeLabel":"integer | null"},"period":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].period.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].period.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].period","typeLabel":"string | null"},"marketCategory":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].marketCategory.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].marketCategory.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].marketCategory","typeLabel":"string | null"},"marketGroup":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].marketGroup.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].marketGroup.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].marketGroup","typeLabel":"string | null"},"marketSubtype":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].marketSubtype.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].marketSubtype.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].marketSubtype","typeLabel":"string | null"},"lineValue":{"oneOf":[{"type":"number","uniqueKey":"venueMarkets.items.[INDEX].lineValue.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].lineValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].lineValue","typeLabel":"number | null"},"minOrderSize":{"oneOf":[{"description":"Per-market minimum order size in shares/contracts. Populated for Polymarket (the market's own floor) and PRED (0.001); null elsewhere. POST /execution/limit-orders validates `sizeRaw` against this value on Polymarket. `null` means AGG ingested no value for this market — NOT that the market has no minimum; other venues enforce their own floors this field does not carry.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].minOrderSize.oneOf.0","typeLabel":"number"},{"description":"Per-market minimum order size in shares/contracts. Populated for Polymarket (the market's own floor) and PRED (0.001); null elsewhere. POST /execution/limit-orders validates `sizeRaw` against this value on Polymarket. `null` means AGG ingested no value for this market — NOT that the market has no minimum; other venues enforce their own floors this field does not carry.","type":"null","uniqueKey":"venueMarkets.items.[INDEX].minOrderSize.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].minOrderSize","typeLabel":"number | null"},"tickSize":{"oneOf":[{"description":"Price increment from the venue's market metadata. A seed value — prefer the runtime-inferred `tick` from GET /orderbooks or GET /orderbook/outcome/:outcomeId when aligning a limit price, since the live grid can be finer than this.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].tickSize.oneOf.0","typeLabel":"number"},{"description":"Price increment from the venue's market metadata. A seed value — prefer the runtime-inferred `tick` from GET /orderbooks or GET /orderbook/outcome/:outcomeId when aligning a limit price, since the live grid can be finer than this.","type":"null","uniqueKey":"venueMarkets.items.[INDEX].tickSize.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].tickSize","typeLabel":"number | null"},"feeRate":{"oneOf":[{"description":"The venue's published taker fee rate for this market. `null` means we do not have it — fall back to your own table; `0` is a real rate meaning the venue charges nothing. For `feeBasis` `fill_in_game_only` it is the rate a fill placed now pays: `0` until the venue reports the event live, the published rate after. Excludes our builder and clearinghouse fees, which appear in the quote's `feeBreakdown`. See /recipes/venue-fees.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].feeRate.oneOf.0","typeLabel":"number"},{"description":"The venue's published taker fee rate for this market. `null` means we do not have it — fall back to your own table; `0` is a real rate meaning the venue charges nothing. For `feeBasis` `fill_in_game_only` it is the rate a fill placed now pays: `0` until the venue reports the event live, the published rate after. Excludes our builder and clearinghouse fees, which appear in the quote's `feeBreakdown`. See /recipes/venue-fees.","type":"null","uniqueKey":"venueMarkets.items.[INDEX].feeRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].feeRate","typeLabel":"number | null"},"feeExponent":{"oneOf":[{"description":"Exponent paired with `feeRate`: `0` = flat fraction of notional, `>= 1` = quadratic family. `null` when `feeBasis` is `winnings`, which has no price curve. See /recipes/venue-fees.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].feeExponent.oneOf.0","typeLabel":"number"},{"description":"Exponent paired with `feeRate`: `0` = flat fraction of notional, `>= 1` = quadratic family. `null` when `feeBasis` is `winnings`, which has no price curve. See /recipes/venue-fees.","type":"null","uniqueKey":"venueMarkets.items.[INDEX].feeExponent.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].feeExponent","typeLabel":"number | null"},"feeBasis":{"oneOf":[{"description":"When the fee is charged: `fill` at execution, `fill_in_game_only` only on fills matched while the event is live, `winnings` at settlement on net profit per market, `exit` only when a position is closed or settles as a winner (opening trades are free). See /recipes/venue-fees.","type":"string","enum":["fill","fill_in_game_only","winnings","exit"],"uniqueKey":"venueMarkets.items.[INDEX].feeBasis.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"When the fee is charged: `fill` at execution, `fill_in_game_only` only on fills matched while the event is live, `winnings` at settlement on net profit per market, `exit` only when a position is closed or settles as a winner (opening trades are free). See /recipes/venue-fees.","type":"null","enum":["fill","fill_in_game_only","winnings","exit"],"uniqueKey":"venueMarkets.items.[INDEX].feeBasis.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].feeBasis","typeLabel":"enum\u003cstring> | null"},"matchedVenueMarkets":{"description":"The same market on other venues, as linked by AGG's matching pipeline. This is the cross-venue linkage — it hangs off each market, not off the event, and is complete regardless of which cluster member you queried.","type":"array","items":{"type":"object","required":["id","venue","externalIdentifier","question"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].id","typeLabel":"string"},"venue":{"type":"string","enum":["kalshi","polymarket","limitless","predict","pred","tiprun","myriad","hyperliquid","novig","prophetx","betdex","lighter"],"isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venue","typeLabel":"enum\u003cstring>"},"externalIdentifier":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].externalIdentifier","typeLabel":"string"},"question":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].question","typeLabel":"string"},"deployerVenue":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].deployerVenue.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].deployerVenue.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].deployerVenue","typeLabel":"string | null"},"detailsDeferred":{"type":"boolean","enum":[true],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].detailsDeferred","typeLabel":"enum\u003cboolean>"},"description":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].description","typeLabel":"string | null"},"rulesPrimary":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].rulesPrimary.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].rulesPrimary.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].rulesPrimary","typeLabel":"string | null"},"rulesSecondary":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].rulesSecondary.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].rulesSecondary.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].rulesSecondary","typeLabel":"string | null"},"volume":{"oneOf":[{"minimum":0,"type":"number","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].volume.oneOf.0","typeLabel":"number"},{"minimum":0,"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].volume.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].volume","typeLabel":"number | null"},"volume24hr":{"oneOf":[{"minimum":0,"type":"number","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].volume24hr.oneOf.0","typeLabel":"number"},{"minimum":0,"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].volume24hr.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].volume24hr","typeLabel":"number | null"},"status":{"type":"string","enum":["open","closed","resolved","unopened","paused"],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"conditionId":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].conditionId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].conditionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].conditionId","typeLabel":"string | null"},"arbReturn":{"oneOf":[{"type":"number","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].arbReturn.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].arbReturn.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].arbReturn","typeLabel":"number | null"},"shortTitle":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].shortTitle.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].shortTitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].shortTitle","typeLabel":"string | null"},"image":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].image.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].image.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].image","typeLabel":"string | null"},"venueEvent":{"oneOf":[{"type":"object","required":["id","externalIdentifier"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.id","typeLabel":"string"},"externalIdentifier":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.externalIdentifier","typeLabel":"string"},"slug":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.slug.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.slug","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.title","typeLabel":"string | null"},"series":{"oneOf":[{"type":"object","required":["id","venue","externalIdentifier"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series.oneOf.0.id","typeLabel":"string"},"venue":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series.oneOf.0.venue","typeLabel":"string"},"externalIdentifier":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series.oneOf.0.externalIdentifier","typeLabel":"string"},"name":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series.oneOf.0.name","typeLabel":"string | null"}},"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series.oneOf.0","typeLabel":"object"},{"type":"null","required":["id","venue","externalIdentifier"],"properties":{"id":{"type":"string"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"venue":{"type":"string"},"externalIdentifier":{"type":"string"}},"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0.series","typeLabel":"object | null"}},"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.0","typeLabel":"object"},{"type":"null","required":["id","externalIdentifier"],"properties":{"id":{"type":"string"},"externalIdentifier":{"type":"string"},"slug":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"series":{"oneOf":[{"type":"object","required":["id","venue","externalIdentifier"],"properties":{"id":{"type":"string"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"venue":{"type":"string"},"externalIdentifier":{"type":"string"}}},{"type":"null","required":["id","venue","externalIdentifier"],"properties":{"id":{"type":"string"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"venue":{"type":"string"},"externalIdentifier":{"type":"string"}}}]}},"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueEvent","typeLabel":"object | null"},"venueMarketOutcomes":{"type":"array","items":{"type":"object","required":["id","venueMarketId","label"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].id","typeLabel":"string"},"venueMarketId":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].venueMarketId","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].label","typeLabel":"string"},"externalIdentifier":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].externalIdentifier.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].externalIdentifier.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].externalIdentifier","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].title","typeLabel":"string | null"},"price":{"deprecated":true,"description":"No longer returned. Fetch live prices from GET /midpoints — sibling outcomes are covered by the `matched[]` entries of the parent market's midpoint item.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].price","typeLabel":"number"},"winner":{"oneOf":[{"type":"boolean","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winner.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winner.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winner","typeLabel":"boolean | null"},"payoutPerShare":{"oneOf":[{"minimum":0,"maximum":1,"description":"Per-share USDC payout of this outcome in [0, 1] once the market settles. Source of truth over `winner` when set: a Polymarket UMA 50/50 stores 0.5 on both sides, a Novig void stores its refund prices (e.g. 0.155 / 0.845). `null` = unknown; clients fall back to `winner ? 1/winnerCount : 0`.","type":"number","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].payoutPerShare.oneOf.0","typeLabel":"number"},{"minimum":0,"maximum":1,"description":"Per-share USDC payout of this outcome in [0, 1] once the market settles. Source of truth over `winner` when set: a Polymarket UMA 50/50 stores 0.5 on both sides, a Novig void stores its refund prices (e.g. 0.155 / 0.845). `null` = unknown; clients fall back to `winner ? 1/winnerCount : 0`.","type":"null","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].payoutPerShare.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].payoutPerShare","typeLabel":"number | null"},"refundAtCost":{"description":"True when the venue voided the market and returns every holder their stake (ProphetX). `winner` is true on every outcome and `payoutPerShare` is null; the per-share refund is the holder's own average entry price. Check this BEFORE `payoutPerShare` / `winner ? 1/winnerCount : 0`.","type":"boolean","uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].refundAtCost","typeLabel":"boolean"},"winnerSource":{"oneOf":[{"description":"Who decided `winner`: `venue` = the venue's own result; `matched` = inferred from matched markets on other venues because this venue named no winner yet (ProphetX). A `matched` winner can still change when the venue settles — e.g. tennis retirements. `null` when `winner` is null or the winner predates this field.","type":"string","enum":["venue","matched"],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winnerSource.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Who decided `winner`: `venue` = the venue's own result; `matched` = inferred from matched markets on other venues because this venue named no winner yet (ProphetX). A `matched` winner can still change when the venue settles — e.g. tennis retirements. `null` when `winner` is null or the winner predates this field.","type":"null","enum":["venue","matched"],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winnerSource.oneOf.1","typeLabel":"null"}],"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX].winnerSource","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX].venueMarketOutcomes","typeLabel":"object[]"}},"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"venueMarkets.items.[INDEX].matchedVenueMarkets","typeLabel":"object[]"}},"uniqueKey":"venueMarkets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"venueMarkets","typeLabel":"object[]"},"arbReturn":{"oneOf":[{"type":"number","uniqueKey":"arbReturn.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"arbReturn.oneOf.1","typeLabel":"null"}],"uniqueKey":"arbReturn","typeLabel":"number | null"},"series":{"oneOf":[{"type":"object","required":["externalIdentifier"],"properties":{"externalIdentifier":{"type":"string","isRequired":true,"uniqueKey":"series.oneOf.0.externalIdentifier","typeLabel":"string"}},"uniqueKey":"series.oneOf.0","typeLabel":"object"},{"type":"null","required":["externalIdentifier"],"properties":{"externalIdentifier":{"type":"string"}},"uniqueKey":"series.oneOf.1","typeLabel":"null"}],"uniqueKey":"series","typeLabel":"object | null"},"recurrence":{"oneOf":[{"type":"string","uniqueKey":"recurrence.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"recurrence.oneOf.1","typeLabel":"null"}],"uniqueKey":"recurrence","typeLabel":"string | null"},"aggKey":{"oneOf":[{"description":"Deterministic canonical key computed from this venue's own data; null when not canonicalizable. This is a fetch filter, not a cross-venue join key — it is guaranteed identical across venues only for sports head-to-head and crypto up/down markets, and two members of the same matched cluster can carry different keys. Use the event id and matchedVenueMarkets for identity.","type":"string","uniqueKey":"aggKey.oneOf.0","typeLabel":"string"},{"description":"Deterministic canonical key computed from this venue's own data; null when not canonicalizable. This is a fetch filter, not a cross-venue join key — it is guaranteed identical across venues only for sports head-to-head and crypto up/down markets, and two members of the same matched cluster can carry different keys. Use the event id and matchedVenueMarkets for identity.","type":"null","uniqueKey":"aggKey.oneOf.1","typeLabel":"null"}],"uniqueKey":"aggKey","typeLabel":"string | null"},"structureType":{"oneOf":[{"type":"string","enum":["candidate","sport","axis","dates"],"uniqueKey":"structureType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["candidate","sport","axis","dates"],"uniqueKey":"structureType.oneOf.1","typeLabel":"null"}],"uniqueKey":"structureType","typeLabel":"enum\u003cstring> | null"},"sport":{"oneOf":[{"type":"string","uniqueKey":"sport.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"sport.oneOf.1","typeLabel":"null"}],"uniqueKey":"sport","typeLabel":"string | null"},"settlementDiff":{"oneOf":[{"type":"object","required":["sharedSummary","differences"],"properties":{"sharedSummary":{"type":"string","isRequired":true,"uniqueKey":"settlementDiff.oneOf.0.sharedSummary","typeLabel":"string"},"differences":{"type":"array","items":{"type":"object","required":["type","title","perVenue"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"settlementDiff.oneOf.0.differences.items.[INDEX].type","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"settlementDiff.oneOf.0.differences.items.[INDEX].title","typeLabel":"string"},"perVenue":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"settlementDiff.oneOf.0.differences.items.[INDEX].perVenue.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"settlementDiff.oneOf.0.differences.items.[INDEX].perVenue","typeLabel":"object"},"summary":{"type":"string","uniqueKey":"settlementDiff.oneOf.0.differences.items.[INDEX].summary","typeLabel":"string"}},"uniqueKey":"settlementDiff.oneOf.0.differences.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"settlementDiff.oneOf.0.differences","typeLabel":"object[]"}},"uniqueKey":"settlementDiff.oneOf.0","typeLabel":"object"},{"type":"null","required":["sharedSummary","differences"],"properties":{"sharedSummary":{"type":"string"},"differences":{"type":"array","items":{"type":"object","required":["type","title","perVenue"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"perVenue":{"type":"object","additionalProperties":{"type":"string"}},"summary":{"type":"string"}}}}},"uniqueKey":"settlementDiff.oneOf.1","typeLabel":"null"}],"uniqueKey":"settlementDiff","typeLabel":"object | null"},"settlementDiffStatus":{"type":"string","enum":["computed","pending","not_applicable"],"uniqueKey":"settlementDiffStatus","typeLabel":"enum\u003cstring>"},"matchedVenueEvents":{"type":"array","items":{"type":"object","required":["id","venue","externalIdentifier","title"],"properties":{"id":{"description":"Sibling event id. Re-resolve from discovery rather than persisting: cluster merges re-point members onto the surviving root, after which this id remains a valid event but is no longer the cluster head.","type":"string","isRequired":true,"uniqueKey":"matchedVenueEvents.items.[INDEX].id","typeLabel":"string"},"venue":{"type":"string","enum":["kalshi","polymarket","limitless","predict","pred","tiprun","myriad","hyperliquid","novig","prophetx","betdex","lighter"],"isRequired":true,"uniqueKey":"matchedVenueEvents.items.[INDEX].venue","typeLabel":"enum\u003cstring>"},"externalIdentifier":{"type":"string","isRequired":true,"uniqueKey":"matchedVenueEvents.items.[INDEX].externalIdentifier","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"matchedVenueEvents.items.[INDEX].title","typeLabel":"string"},"slug":{"oneOf":[{"type":"string","uniqueKey":"matchedVenueEvents.items.[INDEX].slug.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"matchedVenueEvents.items.[INDEX].slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"matchedVenueEvents.items.[INDEX].slug","typeLabel":"string | null"},"status":{"type":"string","enum":["open","closed","resolved","unopened","paused"],"uniqueKey":"matchedVenueEvents.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"series":{"oneOf":[{"type":"object","required":["externalIdentifier"],"properties":{"externalIdentifier":{"type":"string","isRequired":true,"uniqueKey":"matchedVenueEvents.items.[INDEX].series.oneOf.0.externalIdentifier","typeLabel":"string"}},"uniqueKey":"matchedVenueEvents.items.[INDEX].series.oneOf.0","typeLabel":"object"},{"type":"null","required":["externalIdentifier"],"properties":{"externalIdentifier":{"type":"string"}},"uniqueKey":"matchedVenueEvents.items.[INDEX].series.oneOf.1","typeLabel":"null"}],"uniqueKey":"matchedVenueEvents.items.[INDEX].series","typeLabel":"object | null"}},"uniqueKey":"matchedVenueEvents.items.[INDEX]","typeLabel":"object"},"uniqueKey":"matchedVenueEvents","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","externalIdentifier":"\u003cstring>","title":"\u003cstring>","image":"\u003cstring>","venue":"kalshi","categories":[{"id":"\u003cstring>","category":{"id":"\u003cstring>","name":"\u003cstring>","displayName":"\u003cstring>","parentId":"\u003cstring>","eventCount":123,"volume24hr":123,"volume":123}}],"description":"\u003cstring>","deployerVenue":"\u003cstring>","volume":1,"status":"open","startDate":"\u003cstring>","endDate":"\u003cstring>","creationDate":"\u003cstring>","gameStartTime":"\u003cstring>","slug":"\u003cstring>","subtitle":"\u003cstring>","venues":["kalshi"],"marketCount":1,"venueCount":1,"groupMarketCount":1,"groupParentId":"\u003cstring>","updatedAt":"\u003cstring>","venueMarkets":[{"id":"\u003cstring>","venue":"kalshi","externalIdentifier":"\u003cstring>","question":"\u003cstring>","venueMarketOutcomes":[{"id":"\u003cstring>","venueMarketId":"\u003cstring>","label":"\u003cstring>","externalIdentifier":"\u003cstring>","title":"\u003cstring>","price":0.5,"priceChange24h":123,"winner":true,"payoutPerShare":0.5,"refundAtCost":true,"winnerSource":"venue","matchedVenueMarketOutcomes":[{"venueMarketId":"\u003cstring>","venueMarketOutcomeId":"\u003cstring>"}]}],"deployerVenue":"\u003cstring>","marketId":"\u003cstring>","venueEventId":"\u003cstring>","detailsDeferred":true,"description":"\u003cstring>","rulesPrimary":"\u003cstring>","rulesSecondary":"\u003cstring>","conditionId":"\u003cstring>","volume":1,"volume24hr":1,"image":"\u003cstring>","status":"open","startDate":"\u003cstring>","endDate":"\u003cstring>","creationDate":"\u003cstring>","createdAt":"\u003cstring>","resolutionDate":"\u003cstring>","negRisk":true,"venues":["kalshi"],"venueCount":1,"arbReturn":123,"aggKey":"\u003cstring>","sportsMarketType":"\u003cstring>","sectionRank":123,"period":"\u003cstring>","marketCategory":"\u003cstring>","marketGroup":"\u003cstring>","marketSubtype":"\u003cstring>","lineValue":123,"minOrderSize":123,"tickSize":123,"feeRate":123,"feeExponent":123,"feeBasis":"fill","matchedVenueMarkets":[{"id":"\u003cstring>","venue":"kalshi","externalIdentifier":"\u003cstring>","question":"\u003cstring>","deployerVenue":"\u003cstring>","detailsDeferred":true,"description":"\u003cstring>","rulesPrimary":"\u003cstring>","rulesSecondary":"\u003cstring>","volume":1,"volume24hr":1,"status":"open","conditionId":"\u003cstring>","arbReturn":123,"shortTitle":"\u003cstring>","image":"\u003cstring>","venueEvent":{"id":"\u003cstring>","externalIdentifier":"\u003cstring>","slug":"\u003cstring>","title":"\u003cstring>","series":{"id":"\u003cstring>","venue":"\u003cstring>","externalIdentifier":"\u003cstring>","name":"\u003cstring>"}},"venueMarketOutcomes":[{"id":"\u003cstring>","venueMarketId":"\u003cstring>","label":"\u003cstring>","externalIdentifier":"\u003cstring>","title":"\u003cstring>","price":123,"winner":true,"payoutPerShare":0.5,"refundAtCost":true,"winnerSource":"venue"}]}]}],"arbReturn":123,"series":{"externalIdentifier":"\u003cstring>"},"recurrence":"\u003cstring>","aggKey":"\u003cstring>","structureType":"candidate","sport":"\u003cstring>","settlementDiff":{"sharedSummary":"\u003cstring>","differences":[{"type":"\u003cstring>","title":"\u003cstring>","perVenue":{},"summary":"\u003cstring>"}]},"settlementDiffStatus":"computed","matchedVenueEvents":[{"id":"\u003cstring>","venue":"kalshi","externalIdentifier":"\u003cstring>","title":"\u003cstring>","slug":"\u003cstring>","status":"open","series":{"externalIdentifier":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"31807a5b-e28b-43e7-91b0-c38d236dbff9":{"description":"401","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c4430e6b-f033-4801-8708-9c737a72f7c9":{"description":"404","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c09e7b1a-c2bc-4a51-8b4b-49512c80250c":{"appId":{"type":"apiKey","in":"header","name":"x-app-id","description":"Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.","scopes":[],"schemeName":"appId"}}},"servers":{"3915078d-e73f-42da-9155-945be58f38f6":{"url":"https://api.agg.market","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-app-id","description":"Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.","scopes":[],"schemeName":"appId"},"schema":{"title":"x-app-id","type":"string","description":"Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"appId","name":"x-app-id"}],"title":"appId"}]},"originalFileLocation":"openapi/openapi.json"},"subdomain":"agg","siteName":"Agg.market — Prediction Market Aggregator","title":"Get Venue Event - Agg.market — Prediction Market Aggregator","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T18:31:38.437Z","originalFileLocation":"api-reference/markets/get-venue-event.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=\"Returns a single venue event. The response may include an embedded venueMarkets array. That array is deprecated — fetch the event\u0026#x27;s markets from GET /venue-markets?venueEventId=. marketCount and the rolled-up volume cover the event\u0026#x27;s whole matched cluster by default. marketCount is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. volume sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send cluster=false to scope both to this venue event alone. The embedded venueMarkets array is always this one event\u0026#x27;s markets regardless of cluster.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_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/agg/DToJYvh64DP_aQ9r/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agg/DToJYvh64DP_aQ9r/_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/agg/DToJYvh64DP_aQ9r/_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/agg/DToJYvh64DP_aQ9r/_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/agg/DToJYvh64DP_aQ9r/_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/agg/DToJYvh64DP_aQ9r/_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/agg/DToJYvh64DP_aQ9r/_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/agg/DToJYvh64DP_aQ9r/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Venue Event - Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a single venue event. The response may include an embedded venueMarkets array. That array is deprecated — fetch the event\u0026#x27;s markets from GET /venue-markets?venueEventId=. marketCount and the rolled-up volume cover the event\u0026#x27;s whole matched cluster by default. marketCount is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. volume sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send cluster=false to scope both to this venue event alone. The embedded venueMarkets array is always this one event\u0026#x27;s markets regardless of cluster.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agg.market/api-reference/markets/get-venue-event\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://agg.mintlify.site/_mintlify/api/og/v2?division=Markets\u0026amp;title=Get+Venue+Event\u0026amp;description=Returns+a+single+venue+event.+The+response+may+include+an+embedded+%60venueMarkets%60+array.+That+array+is+deprecated+%E2%80%94+fetch+the+event%27s+markets+from+GET+%2Fvenue-ma\u0026amp;theme=e3d91c6fb16e65bc3c49f43b\u0026amp;signature=792487983e77efdffd8671f43b0e3d66c54a79149cd1b5c160782737702e90a1\">\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 Venue Event - Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a single venue event. The response may include an embedded venueMarkets array. That array is deprecated — fetch the event\u0026#x27;s markets from GET /venue-markets?venueEventId=. marketCount and the rolled-up volume cover the event\u0026#x27;s whole matched cluster by default. marketCount is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. volume sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send cluster=false to scope both to this venue event alone. The embedded venueMarkets array is always this one event\u0026#x27;s markets regardless of cluster.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agg.mintlify.site/_mintlify/api/og/v2?division=Markets\u0026amp;title=Get+Venue+Event\u0026amp;description=Returns+a+single+venue+event.+The+response+may+include+an+embedded+%60venueMarkets%60+array.+That+array+is+deprecated+%E2%80%94+fetch+the+event%27s+markets+from+GET+%2Fvenue-ma\u0026amp;theme=e3d91c6fb16e65bc3c49f43b\u0026amp;signature=792487983e77efdffd8671f43b0e3d66c54a79149cd1b5c160782737702e90a1\">\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/agg/DToJYvh64DP_aQ9r/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Agg.market — Prediction Market Aggregator\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ED8200\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agg.market/api-reference/markets/get-venue-event\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/markets/get-venue-event.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agg.market/#organization\",\"name\":\"Agg.market — Prediction Market Aggregator\",\"url\":\"https://docs.agg.market\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/agg/SLxnoWBYT8Zyhg9W/assets/agg-dark.svg?fit=max\u0026auto=format\u0026n=SLxnoWBYT8Zyhg9W\u0026q=85\u0026s=f1b6e05f3e2529bc2c7698267234f5d1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agg.market#website\",\"name\":\"Agg.market — Prediction Market Aggregator\",\"url\":\"https://docs.agg.market\",\"publisher\":{\"@id\":\"https://docs.agg.market/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agg.market/api-reference/markets/get-venue-event#webpage\",\"url\":\"https://docs.agg.market/api-reference/markets/get-venue-event\",\"name\":\"Get Venue Event\",\"description\":\"Returns a single venue event. The response may include an embedded venueMarkets array. That array is deprecated — fetch the event's markets from GET /venue-markets?venueEventId=. marketCount and the rolled-up volume cover the event's whole matched cluster by default. marketCount is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. volume sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send cluster=false to scope both to this venue event alone. The embedded venueMarkets array is always this one event's markets regardless of cluster.\",\"dateModified\":\"2026-11-19T18:31:38.437Z\",\"isPartOf\":{\"@id\":\"https://docs.agg.market#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agg.market/api-reference/markets/get-venue-event#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agg.market/api-reference/markets/get-venue-event#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Markets\",\"item\":\"https://docs.agg.market/api-reference/markets/get-the-first-useful-event-view\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Venue Event\",\"item\":\"https://docs.agg.market/api-reference/markets/get-venue-event\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.agg.market/api-reference/markets/get-venue-event#apireference\",\"headline\":\"Get Venue Event\",\"name\":\"Get Venue Event\",\"description\":\"Returns a single venue event. The response may include an embedded venueMarkets array. That array is deprecated — fetch the event's markets from GET /venue-markets?venueEventId=. marketCount and the rolled-up volume cover the event's whole matched cluster by default. marketCount is the number of rows GET /venue-markets?venueEventId= returns for this event (open markets, matched siblings folded into their anchor), so it can be paged to exactly. volume sums EVERY open and closed market in the cluster including those folded siblings, so it is not a total over those rows. Send cluster=false to scope both to this venue event alone. The embedded venueMarkets array is always this one event's markets regardless of cluster.\",\"url\":\"https://docs.agg.market/api-reference/markets/get-venue-event\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agg.market/api-reference/markets/get-venue-event#webpage\"},\"dateModified\":\"2026-11-19T18:31:38.437Z\",\"publisher\":{\"@id\":\"https://docs.agg.market/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agg.market#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Agg.market — Prediction Market Aggregator\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Agg.market — Prediction Market Aggregator\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/markets/get-venue-event.md","siteName":"Agg.market — Prediction Market Aggregator","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/reference"}]},{"tab":"Trading API","groups":[{"group":"Authentication","pages":[{"title":"Start authentication","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/start","href":"/api-reference/authentication/start-authentication"},{"title":"Verify sign-in","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/verify","href":"/api-reference/authentication/verify-sign-in"},{"title":"Complete redirect sign-in","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/token/exchange","href":"/api-reference/authentication/complete-redirect-sign-in"},{"title":"Refresh access token","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/token/refresh","href":"/api-reference/authentication/refresh-access-token"},{"title":"Sign out","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /auth/sign-out","href":"/api-reference/authentication/sign-out"},{"title":"Fetch Turnstile site key","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /bot-protection/site-key","href":"/api-reference/authentication/fetch-turnstile-site-key"},{"title":"Verify Turnstile token","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /bot-protection/verify","href":"/api-reference/authentication/verify-turnstile-token"}]},{"group":"Markets","pages":[{"title":"Get the first useful event view","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-events/{id}/bootstrap","href":"/api-reference/markets/get-the-first-useful-event-view"},{"title":"Search events or markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /search","href":"/api-reference/markets/search-events-or-markets"},{"title":"List catalog changes","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /catalog/changes","href":"/api-reference/markets/list-catalog-changes"},{"title":"List venue events","description":"Returns paginated venue events with optional filters for venue, status, category, and search. DEPRECATION: the per-item `description` field is deprecated and will be removed from list responses — fetch the full event (including `description`) via GET /venue-events/:id. The embedded `venueMarkets` on each item are a top-N preview only; for the full market list use GET /venue-markets?venueEventId=.","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-events","href":"/api-reference/markets/list-venue-events"},{"title":"Get Venue Event","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-events/{id}","href":"/api-reference/markets/get-venue-event"},{"title":"List venue markets","description":"Use projection=summary to omit description/rules text while preserving market ordering and trading metadata; markets and siblings are marked detailsDeferred=true. Use projection=full for demand-loaded text. Projection is independent of context and defaults to existing response behavior. Returns paginated venue markets with optional filters for venue, status, category, and date range. When `venueEventId` is set, the response covers that event's ENTIRE matched cluster by default — every venue's markets for the same real-world event, with matched siblings folded into their anchor row rather than repeated. Naming any member of a cluster returns the same page, and the ordering does not depend on which member you name. This is the only way to reach markets that exist on a single venue and therefore have no cross-venue counterpart. Send `cluster=false` for the legacy behaviour (that one venue event's own markets), or `venue=` to keep the cluster scope but narrow to one venue.","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-markets","href":"/api-reference/markets/list-venue-markets"},{"title":"Look up venue market outcomes by external identifier","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-market-outcomes","href":"/api-reference/markets/look-up-venue-market-outcomes-by-external-identifier"},{"title":"List categories","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /categories","href":"/api-reference/markets/list-categories"},{"title":"Get the per-app UI config (disabled venues + categories)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /app/config","href":"/api-reference/markets/get-the-per-app-ui-config-disabled-venues-+-categories"},{"title":"List recurring crypto window markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /crypto/recurring-markets","href":"/api-reference/markets/list-recurring-crypto-window-markets"}]},{"group":"Market Data","pages":[{"title":"Get bounded outcome snapshots","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /orderbooks/outcomes","href":"/api-reference/market-data/get-bounded-outcome-snapshots"},{"title":"Get live orderbooks for multiple markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /orderbooks","href":"/api-reference/market-data/get-live-orderbooks-for-multiple-markets"},{"title":"Get live orderbook for a single outcome","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /orderbook/outcome/{outcomeId}","href":"/api-reference/market-data/get-live-orderbook-for-a-single-outcome"},{"title":"Get live midpoints for multiple markets","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /midpoints","href":"/api-reference/market-data/get-live-midpoints-for-multiple-markets"},{"title":"Get versioned chart history references","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /charts/history/manifest","href":"/api-reference/market-data/get-versioned-chart-history-references"},{"title":"Get chart bars","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /charts/bars","href":"/api-reference/market-data/get-chart-bars"},{"title":"Get live crypto reference prices","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /crypto/reference-prices","href":"/api-reference/market-data/get-live-crypto-reference-prices"},{"title":"Get live sports scores","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /sports/live","href":"/api-reference/market-data/get-live-sports-scores"}]},{"group":"Trading","pages":[{"title":"Get a quote (smart route)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /orderbook/{venueMarketOutcomeId}/route","href":"/api-reference/trading/get-a-quote-smart-route"},{"title":"Execute quote","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/fill","href":"/api-reference/trading/execute-quote"},{"title":"Submit signatures for a pending self-custody fill","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/fill/{quoteId}/signatures","href":"/api-reference/trading/submit-signatures-for-a-pending-self-custody-fill"},{"title":"Get execution status","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/status","href":"/api-reference/trading/get-execution-status"},{"title":"Place an order directly","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/orders","href":"/api-reference/trading/place-an-order-directly"},{"title":"Place limit order","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/limit-orders","href":"/api-reference/trading/place-limit-order"},{"title":"Cancel an order","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/orders/cancel","href":"/api-reference/trading/cancel-an-order"},{"title":"Redeem winnings for resolved positions","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/redeem","href":"/api-reference/trading/redeem-winnings-for-resolved-positions"},{"title":"Get the per-venue blocked-country lists (ISO 3166-1 alpha-2)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /app/venue-geo-policy","href":"/api-reference/trading/get-the-per-venue-blocked-country-lists-iso-3166-1-alpha-2"}]},{"group":"Portfolio","pages":[{"title":"Get user orders","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/orders","href":"/api-reference/portfolio/get-user-orders"},{"title":"Get balances","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/balances","href":"/api-reference/portfolio/get-balances"},{"title":"Get user positions","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/positions","href":"/api-reference/portfolio/get-user-positions"},{"title":"Get user activity feed","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/activity","href":"/api-reference/portfolio/get-user-activity-feed"},{"title":"Trader leaderboard","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /leaderboard","href":"/api-reference/portfolio/trader-leaderboard"},{"title":"Trader leaderboard series","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /leaderboard/series","href":"/api-reference/portfolio/trader-leaderboard-series"}]},{"group":"Funding","pages":[{"title":"Get deposit addresses","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/deposit-addresses","href":"/api-reference/funding/get-deposit-addresses"},{"title":"Quote withdrawable amount","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/withdrawable/quote","href":"/api-reference/funding/quote-withdrawable-amount"},{"title":"Preview a withdrawal","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/withdraw/preview","href":"/api-reference/funding/preview-a-withdrawal"},{"title":"Withdraw funds","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/withdraw","href":"/api-reference/funding/withdraw-funds"},{"title":"Get withdrawal status","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/withdrawals/{withdrawalId}","href":"/api-reference/funding/get-withdrawal-status"},{"title":"List managed balance refill policies","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/balance-refill-policies","href":"/api-reference/funding/list-managed-balance-refill-policies"},{"title":"Create a managed balance refill policy","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/balance-refill-policies","href":"/api-reference/funding/create-a-managed-balance-refill-policy"},{"title":"Update or pause a managed balance refill policy","deprecated":null,"version":null,"openapi":"/openapi/openapi.json patch /execution/balance-refill-policies/{policyId}","href":"/api-reference/funding/update-or-pause-a-managed-balance-refill-policy"},{"title":"List recent managed balance refill attempts","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /execution/balance-refill-policies/{policyId}/attempts","href":"/api-reference/funding/list-recent-managed-balance-refill-attempts"},{"title":"Get crypto purchase quotes","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /ramp/quotes","href":"/api-reference/funding/get-crypto-purchase-quotes"},{"title":"Create a ramp widget session for checkout","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /ramp/session","href":"/api-reference/funding/create-a-ramp-widget-session-for-checkout"},{"title":"Submit signatures for a pending self-custody withdrawal","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /execution/withdrawals/{withdrawalId}/signatures","href":"/api-reference/funding/submit-signatures-for-a-pending-self-custody-withdrawal"}]},{"group":"Users","pages":[{"title":"Get current user","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me","href":"/api-reference/users/get-current-user"},{"title":"Update username","deprecated":null,"version":null,"openapi":"/openapi/openapi.json patch /users/me","href":"/api-reference/users/update-username"},{"title":"Link partner external user ID (HMAC-verified)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/external-id","href":"/api-reference/users/link-partner-external-user-id-hmac-verified"},{"title":"Get avatar upload URL","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/avatar","href":"/api-reference/users/get-avatar-upload-url"},{"title":"Disconnect auth provider","deprecated":null,"version":null,"openapi":"/openapi/openapi.json delete /users/me/accounts/{provider}","href":"/api-reference/users/disconnect-auth-provider"},{"title":"Start account linking","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/link-account/start","href":"/api-reference/users/start-account-linking"},{"title":"Confirm account linking","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/link-account/confirm","href":"/api-reference/users/confirm-account-linking"},{"title":"Get shared KYC status","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /kyc/status","href":"/api-reference/users/get-shared-kyc-status"},{"title":"Initiate KYC","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /kyc/{venue}","href":"/api-reference/users/initiate-kyc"},{"title":"Upsert a venue API key","deprecated":null,"version":null,"openapi":"/openapi/openapi.json put /venue-keys","href":"/api-reference/users/upsert-a-venue-api-key"},{"title":"List venue keys","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-keys","href":"/api-reference/users/list-venue-keys"},{"title":"Delete a venue key","deprecated":null,"version":null,"openapi":"/openapi/openapi.json delete /venue-keys/{venue}","href":"/api-reference/users/delete-a-venue-key"},{"title":"Get venue key connection status","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /venue-keys/{venue}/status","href":"/api-reference/users/get-venue-key-connection-status"}]},{"group":"Hosted Venue Accounts","pages":[{"title":"Get hosted venue deposit address","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me/venue-accounts/{venue}/deposit-address","href":"/api-reference/hosted-venue-accounts/get-hosted-venue-deposit-address"},{"title":"Withdraw hosted venue funds","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/venue-accounts/{venue}/withdrawals","href":"/api-reference/hosted-venue-accounts/withdraw-hosted-venue-funds"},{"title":"Get hosted venue withdrawal","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me/venue-accounts/{venue}/withdrawals/{withdrawalId}","href":"/api-reference/hosted-venue-accounts/get-hosted-venue-withdrawal"},{"title":"Get hosted venue account activity","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me/venue-accounts/{venue}/activity","href":"/api-reference/hosted-venue-accounts/get-hosted-venue-account-activity"},{"title":"Get hosted venue account","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /users/me/venue-accounts/{venue}","href":"/api-reference/hosted-venue-accounts/get-hosted-venue-account"},{"title":"Provision hosted venue account","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /users/me/venue-accounts/{venue}","href":"/api-reference/hosted-venue-accounts/provision-hosted-venue-account"}]},{"group":"News","pages":[{"title":"Get news articles for markets with market impact summaries","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /news-feed/market-news","href":"/api-reference/news/get-news-articles-for-markets-with-market-impact-summaries"},{"title":"Article-centric news feed for a category - latest articles with linked markets and live prices","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /news-feed/{category}","href":"/api-reference/news/article-centric-news-feed-for-a-category--latest-articles-with-linked-markets-and-live-prices"},{"title":"Market-centric news feed - markets grouped with their news timeline","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /news-feed/{category}/markets","href":"/api-reference/news/market-centric-news-feed--markets-grouped-with-their-news-timeline"},{"title":"List available news feeds with IDs and item counts","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /news-feed","href":"/api-reference/news/list-available-news-feeds-with-ids-and-item-counts"}]},{"group":"Correlated Markets","pages":[{"title":"Get correlated market signals for a market","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /correlated-markets/{venueMarketId}","href":"/api-reference/correlated-markets/get-correlated-market-signals-for-a-market"},{"title":"Find correlated markets by semantic similarity","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /correlated-markets/query","href":"/api-reference/correlated-markets/find-correlated-markets-by-semantic-similarity"},{"title":"Find events connected via shared market signals","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /correlated-markets/connections/{venueMarketId}","href":"/api-reference/correlated-markets/find-events-connected-via-shared-market-signals"},{"title":"Get ripple effect of a market resolving (by market ID)","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /correlated-markets/cascade/{venueMarketId}","href":"/api-reference/correlated-markets/get-ripple-effect-of-a-market-resolving-by-market-id"},{"title":"Resolve a market by venue ID, slug, or text and return cascade","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /correlated-markets/resolve","href":"/api-reference/correlated-markets/resolve-a-market-by-venue-id-slug-or-text-and-return-cascade"}]}]},{"tab":"Server API","pages":[{"title":"Server API","href":"/api-reference/webhooks/rotate-webhook-signing-secret"}]},{"tab":"WebSocket API","pages":[{"title":"WebSocket API","href":"/api-reference/websockets/orderbook"}]}]},"basePath":"","title":"Get Venue Event - Agg.market — Prediction Market Aggregator","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js"]}