Returns the public market snapshot and only the represented principal’s
accepted bid receipts, current offer states, lottery entry history and
commitments. Private offer terms are omitted. Use a commitment ID here
to confirm an allocation when participant confirmation is required.
Lottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily
a final loss while promotion remains possible. Requires current claim,
bid, offer-submission or lottery-entry authority for the market’s mechanism.
Own entries including withdrawal/re-entry history. Active is not an award; consult commitments. Empty commitments are not final loss while promotion remains possible.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ambient","description":"Build and participate in deterministic markets through HTTP and MCP.","colors":{"primary":"#004D3E","light":"#004D3E","dark":"#7DE0B0"},"favicon":"https://mintcdn.com/ambient-e0cf5f67/7hOa2BO-ut1FqK_l/favicon.svg?fit=max\u0026auto=format\u0026n=7hOa2BO-ut1FqK_l\u0026q=85\u0026s=0969d2e14144ed21f2fe134ae3db7f2d","seo":{"metatags":{"canonical":"https://docs.ambient.market"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ambient-e0cf5f67","hasAudioNarration":false,"actualSubdomain":"ambient-e0cf5f67","customDomains":["docs.ambient.market"],"gitSource":{"type":"github","owner":"ambient-market","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6abeb498cdea67f4a8a3dbea","collectionId":"1610192d-19f3-477b-a364-b2240fdb727b","liveDeploymentHistoryId":"6abeb498cdea67f4a8a3dbea","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6abeb498cdea67f4a8a3dbea","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Reference","count":45},{"language":"default","tag":"HTTP endpoints","count":43},{"language":"default","tag":"Integrate","count":12},{"language":"default","tag":"Participation","count":9},{"language":"default","tag":"Markets","count":7},{"language":"default","tag":"Signup","count":6},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Market mechanisms","count":5},{"language":"default","tag":"Administration","count":5},{"language":"default","tag":"System","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"preview.css","content":"#navbar .nav-logo:not(img){display:inline-flex;align-items:center;gap:12px}#navbar .nav-logo:not(img)::after{content:\"Developer preview\";display:inline-block;padding:5px 9px;border-radius:2px;background:#7de0b0;color:#071d17;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px;font-weight:600;line-height:1.4;letter-spacing:normal;white-space:nowrap}@media (max-width:1023px){#navbar .nav-logo:not(img){gap:8px;font-size:20px;line-height:1.2}#navbar .nav-logo:not(img)::after{padding:3px 7px;background:0 0;border:1px solid #a8c8bc;color:#004d3e;font-family:-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;font-weight:500}.dark #navbar .nav-logo:not(img)::after{border-color:#365d4e;color:#7de0b0}}"}],"page":{"pagePath":"api-reference/markets/get-your-outcome-in-a-market","slug":"/api-reference/markets/get-your-outcome-in-a-market","pageMetadata":{"title":"Get your outcome in a market","description":"Returns the public market snapshot and only the represented principal's\naccepted bid receipts, current offer states, lottery entry history and\ncommitments. Private offer terms are omitted. Use a commitment ID here\nto confirm an allocation when participant confirmation is required.\nLottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily\na final loss while promotion remains possible. Requires current claim,\nbid, offer-submission or lottery-entry authority for the market's mechanism.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/my-outcome","href":"/api-reference/markets/get-your-outcome-in-a-market","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns the public market snapshot and only the represented principal’s\\naccepted bid receipts, current offer states, lottery entry history and\\ncommitments. Private offer terms are omitted. Use a commitment ID here\\nto confirm an allocation when participant confirmation is required.\\nLottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily\\na final loss while promotion remains possible. Requires current claim,\\nbid, offer-submission or lottery-entry authority for the market’s mechanism.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get your outcome in a market","description":"Returns the public market snapshot and only the represented principal's\naccepted bid receipts, current offer states, lottery entry history and\ncommitments. Private offer terms are omitted. Use a commitment ID here\nto confirm an allocation when participant confirmation is required.\nLottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily\na final loss while promotion remains possible. Requires current claim,\nbid, offer-submission or lottery-entry authority for the market's mechanism.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/my-outcome","href":"/api-reference/markets/get-your-outcome-in-a-market","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Markets"],"operationId":"getMyMarketOutcome","summary":"Get your outcome in a market","description":"Returns the public market snapshot and only the represented principal's\naccepted bid receipts, current offer states, lottery entry history and\ncommitments. Private offer terms are omitted. Use a commitment ID here\nto confirm an allocation when participant confirmation is required.\nLottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily\na final loss while promotion remains possible. Requires current claim,\nbid, offer-submission or lottery-entry authority for the market's mechanism.\n","parameters":["82693ba1-60a4-4ade-9d4c-c1be7cf51920","f442562d-eb8f-4bcf-83d8-4a860362d737","99a88ecd-0b27-4a7c-979c-3cf781c930e6"],"responses":{"200":"846159a2-9e2c-4b90-a62f-1b16aa595754","401":"ebe7b91e-a8e9-460a-9120-f13a5bb0fbf9","403":"97144d09-e132-40b1-b2af-8ddd72478863","404":"0edda8cd-b200-416f-a6aa-c67fc2992eb6","500":"f12afa13-93af-48fb-b692-5836c63f2620"},"method":"get","type":"path","servers":["ccaf9552-2a2e-4df0-9e42-c55c270d5a04"],"security":["35dd24b1-7284-4733-9611-2e5506975052","cf6e24dd-c984-41ea-b27c-43d03503dec6"],"path":"/v1/markets/{marketId}/my-outcome","baseUrlOptions":["https://{host}"],"title":"Get your outcome in a market","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"82693ba1-60a4-4ade-9d4c-c1be7cf51920":{"name":"marketId","in":"path","required":true,"description":"Client-selected market identifier.","schema":{"type":"string","minLength":1,"isRequired":true,"description":"Client-selected market identifier.","uniqueKey":"","typeLabel":"string"},"example":"table-2026-09-19-1900"},"f442562d-eb8f-4bcf-83d8-4a860362d737":{"name":"principalId","in":"query","required":false,"description":"Principal represented for a private read; omit for self-representation.","schema":{"type":"string","minLength":1,"isRequired":false,"description":"Principal represented for a private read; omit for self-representation.","uniqueKey":"","typeLabel":"string"}},"99a88ecd-0b27-4a7c-979c-3cf781c930e6":{"name":"authorityRef","in":"query","required":false,"description":"Current delegation reference when reading for another principal.","schema":{"type":"string","minLength":1,"isRequired":false,"description":"Current delegation reference when reading for another principal.","uniqueKey":"","typeLabel":"string"}}},"responses":{"846159a2-9e2c-4b90-a62f-1b16aa595754":{"description":"Principal-scoped participation and commitments.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["market","bidReceipts","offers","commitments"],"properties":{"market":{"type":"object","additionalProperties":false,"required":["id","version","state","discoverability","creatorPrincipalId","subject","mechanism","mechanismState","funding","publicationVerified","createdAt","updatedAt"],"properties":{"id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"market.id","typeLabel":"string"},"version":{"type":"integer","format":"uint64","minimum":1,"isRequired":true,"uniqueKey":"market.version","typeLabel":"integer\u003cuint64>"},"state":{"type":"string","enum":["open","closed","canceled"],"isRequired":true,"uniqueKey":"market.state","typeLabel":"enum\u003cstring>"},"discoverability":{"type":"string","enum":["listed","unlisted"],"default":"listed","description":"Listed markets appear in public discovery. Unlisted markets remain readable by exact market ID and are not private.","isRequired":true,"uniqueKey":"market.discoverability","typeLabel":"enum\u003cstring>"},"creatorPrincipalId":{"type":"string","minLength":1,"description":"Principal responsible for the published market. Creating actor and authority details are omitted.","isRequired":true,"uniqueKey":"market.creatorPrincipalId","typeLabel":"string"},"subject":{"type":"object","additionalProperties":false,"required":["schema","data"],"properties":{"schema":{"type":"string","minLength":1,"description":"Versioned identifier chosen by the client for the subject data shape.","example":"restaurant-table.v1","isRequired":true,"uniqueKey":"market.subject.schema","typeLabel":"string"},"data":{"type":"object","description":"Client-defined JSON object describing the item, service, capacity, or right being allocated.","additionalProperties":true,"example":{"partySize":2,"startsAt":"2026-09-19T19:00:00Z"},"isRequired":true,"uniqueKey":"market.subject.data","typeLabel":"object"}},"isRequired":true,"uniqueKey":"market.subject","typeLabel":"object"},"mechanism":{"oneOf":[{"type":"object","description":"Supported versioned allocation mechanism and its immutable configuration.","required":["presetId","config"],"properties":{"presetId":{"type":"string","const":"direct-claim.v1","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.presetId","typeLabel":"string"},"config":{"oneOf":[{"type":"object","description":"Capacity, pricing, and confirmation rules for a direct-claim market.","required":["capacity","pricing","confirmation"],"properties":{"capacity":{"type":"integer","format":"uint32","minimum":1,"description":"Number of successful commitments the market can allocate.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.capacity","typeLabel":"integer\u003cuint32>"},"pricing":{"oneOf":[{"type":"object","description":"Free or posted terms recorded in the resulting commitment.","required":["mode"],"properties":{"mode":{"type":"string","const":"free","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.pricing.oneOf.0.mode","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.pricing.oneOf.0","typeLabel":"object"},{"type":"object","description":"Free or posted terms recorded in the resulting commitment.","required":["mode","amountMinor","currency"],"properties":{"mode":{"type":"string","const":"posted","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.pricing.oneOf.1.mode","typeLabel":"string"},"amountMinor":{"type":"integer","format":"int64","minimum":1,"description":"Positive posted amount in minor currency units.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.pricing.oneOf.1.amountMinor","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.pricing.oneOf.1.currency","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.pricing.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.pricing","typeLabel":"object"},"confirmation":{"type":"string","const":"none","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.confirmation","typeLabel":"string"},"holdDurationSeconds":{"type":"integer","format":"uint32","maximum":0,"description":"May be omitted. An explicit value must be 0 and is removed during normalization.","uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.holdDurationSeconds","typeLabel":"integer\u003cuint32>"},"maxPerPrincipal":{"type":"integer","format":"uint32","minimum":1,"description":"Optional cap on the live commitments one participant principal may hold. Declined, expired, and failed commitments release the allowance. Omit for no limit.","uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.maxPerPrincipal","typeLabel":"integer\u003cuint32>"},"claimsCloseAt":{"type":"string","format":"date-time","description":"Optional RFC 3339 cutoff for accepting claims, which must be after publication. Claims at or after it are rejected and the market closes automatically.","uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0.claimsCloseAt","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.0","typeLabel":"object"},{"type":"object","description":"Capacity, pricing, and confirmation rules for a direct-claim market.","required":["capacity","pricing","confirmation","holdDurationSeconds"],"properties":{"capacity":{"type":"integer","format":"uint32","minimum":1,"description":"Number of successful commitments the market can allocate.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.capacity","typeLabel":"integer\u003cuint32>"},"pricing":{"oneOf":[{"type":"object","description":"Free or posted terms recorded in the resulting commitment.","required":["mode"],"properties":{"mode":{"type":"string","const":"free","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.pricing.oneOf.0.mode","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.pricing.oneOf.0","typeLabel":"object"},{"type":"object","description":"Free or posted terms recorded in the resulting commitment.","required":["mode","amountMinor","currency"],"properties":{"mode":{"type":"string","const":"posted","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.pricing.oneOf.1.mode","typeLabel":"string"},"amountMinor":{"type":"integer","format":"int64","minimum":1,"description":"Positive posted amount in minor currency units.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.pricing.oneOf.1.amountMinor","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.pricing.oneOf.1.currency","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.pricing.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.pricing","typeLabel":"object"},"confirmation":{"type":"string","enum":["creator","participant","both"],"description":"Principals that must confirm before the commitment is final.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.confirmation","typeLabel":"enum\u003cstring>"},"holdDurationSeconds":{"type":"integer","format":"uint32","minimum":1,"description":"Confirmation period before the commitment expires.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.holdDurationSeconds","typeLabel":"integer\u003cuint32>"},"maxPerPrincipal":{"type":"integer","format":"uint32","minimum":1,"description":"Optional cap on the live commitments one participant principal may hold. Declined, expired, and failed commitments release the allowance. Omit for no limit.","uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.maxPerPrincipal","typeLabel":"integer\u003cuint32>"},"claimsCloseAt":{"type":"string","format":"date-time","description":"Optional RFC 3339 cutoff for accepting claims, which must be after publication. Claims at or after it are rejected and the market closes automatically.","uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1.claimsCloseAt","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0.config","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.0","typeLabel":"object"},{"type":"object","description":"Supported versioned allocation mechanism and its immutable configuration.","required":["presetId","config"],"properties":{"presetId":{"type":"string","const":"sealed-forward-auction.v1","isRequired":true,"uniqueKey":"market.mechanism.oneOf.1.presetId","typeLabel":"string"},"config":{"type":"object","additionalProperties":false,"required":["currency","closesAt","holdDurationSeconds"],"properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","isRequired":true,"uniqueKey":"market.mechanism.oneOf.1.config.currency","typeLabel":"string"},"closesAt":{"type":"string","format":"date-time","description":"Fixed auction close. It must still be in the future when the draft is published.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.1.config.closesAt","typeLabel":"string\u003cdate-time>"},"holdDurationSeconds":{"type":"integer","format":"uint32","minimum":1,"description":"Winner confirmation period after resolution.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.1.config.holdDurationSeconds","typeLabel":"integer\u003cuint32>"},"reserveAmountMinor":{"type":"integer","format":"int64","minimum":1,"description":"Optional positive reserve in minor currency units.","uniqueKey":"market.mechanism.oneOf.1.config.reserveAmountMinor","typeLabel":"integer\u003cint64>"},"resolutionDeadline":{"type":"string","format":"date-time","description":"Final promotion and resolution horizon, which must be after closesAt. Optional for unfunded auctions and required for funded ones, where funding must stay valid through it plus settlement grace.","uniqueKey":"market.mechanism.oneOf.1.config.resolutionDeadline","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"market.mechanism.oneOf.1.config","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.1","typeLabel":"object"},{"type":"object","description":"Supported versioned allocation mechanism and its immutable configuration.","required":["presetId","config"],"properties":{"presetId":{"type":"string","const":"request-for-offers.v1","isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.presetId","typeLabel":"string"},"config":{"type":"object","additionalProperties":false,"required":["capacity","offerSchema","offersCloseAt","selectionClosesAt","selectionTiming","pricing"],"properties":{"capacity":{"type":"integer","format":"uint32","minimum":1,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.config.capacity","typeLabel":"integer\u003cuint32>"},"offerSchema":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.config.offerSchema","typeLabel":"string"},"offersCloseAt":{"type":"string","format":"date-time","description":"Must be after publication.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.config.offersCloseAt","typeLabel":"string\u003cdate-time>"},"selectionClosesAt":{"type":"string","format":"date-time","description":"Must be after offersCloseAt.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.config.selectionClosesAt","typeLabel":"string\u003cdate-time>"},"selectionTiming":{"type":"string","const":"after_deadline","isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.config.selectionTiming","typeLabel":"string"},"pricing":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["none","optional","required"],"isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.config.pricing.mode","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","uniqueKey":"market.mechanism.oneOf.2.config.pricing.currency","typeLabel":"string"},"maximumAmountMinor":{"type":"integer","format":"int64","minimum":1,"uniqueKey":"market.mechanism.oneOf.2.config.pricing.maximumAmountMinor","typeLabel":"integer\u003cint64>"}},"description":"None forbids currency and maximum; optional or required need one currency.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.config.pricing","typeLabel":"object"}},"isRequired":true,"uniqueKey":"market.mechanism.oneOf.2.config","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.2","typeLabel":"object"},{"type":"object","description":"Supported versioned allocation mechanism and its immutable configuration.","required":["presetId","config"],"properties":{"presetId":{"type":"string","const":"lottery.v1","isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.presetId","typeLabel":"string"},"config":{"oneOf":[{"type":"object","required":["capacity","entryClosesAt","confirmation"],"properties":{"capacity":{"type":"integer","format":"uint32","minimum":1,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.0.capacity","typeLabel":"integer\u003cuint32>"},"entryClosesAt":{"type":"string","format":"date-time","description":"Must follow publication; entries and withdrawals at or after it are rejected.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.0.entryClosesAt","typeLabel":"string\u003cdate-time>"},"confirmation":{"type":"string","const":"none","isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.0.confirmation","typeLabel":"string"},"confirmationWindowSeconds":{"oneOf":[{}],"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.0.confirmationWindowSeconds","typeLabel":"any"},"resolutionDeadline":{"oneOf":[{}],"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.0.resolutionDeadline","typeLabel":"any"},"eligibilityTerms":{"type":"string","maxLength":8192,"description":"At most 8192 UTF-8 bytes; described qualifications are not automatically verified. Funding must be none.","uniqueKey":"market.mechanism.oneOf.3.config.oneOf.0.eligibilityTerms","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.0","typeLabel":"object"},{"type":"object","required":["capacity","entryClosesAt","confirmation","confirmationWindowSeconds","resolutionDeadline"],"properties":{"capacity":{"type":"integer","format":"uint32","minimum":1,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.1.capacity","typeLabel":"integer\u003cuint32>"},"entryClosesAt":{"type":"string","format":"date-time","description":"Must follow publication.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.1.entryClosesAt","typeLabel":"string\u003cdate-time>"},"confirmation":{"type":"string","const":"creator","isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.1.confirmation","typeLabel":"string"},"confirmationWindowSeconds":{"type":"integer","format":"uint32","minimum":1,"description":"Per-candidate review window from actual selection, capped at resolutionDeadline. Late selection or promotion can yield a shorter window, even nearly zero.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.1.confirmationWindowSeconds","typeLabel":"integer\u003cuint32>"},"resolutionDeadline":{"type":"string","format":"date-time","description":"Must follow entryClosesAt; no awards or promotions after this deadline.","isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.1.resolutionDeadline","typeLabel":"string\u003cdate-time>"},"eligibilityTerms":{"type":"string","maxLength":8192,"description":"At most 8192 UTF-8 bytes; creator evaluates evidence for provisional winners. Funding must be none.","uniqueKey":"market.mechanism.oneOf.3.config.oneOf.1.eligibilityTerms","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"market.mechanism.oneOf.3.config","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"market.mechanism.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"market.mechanism","typeLabel":"object"},"mechanismState":{"type":"object","description":"Preset-owned public state with private participation identifiers removed. Lottery exposes phase and activeEntryCount only, not digests or alternate positions.","isRequired":true,"uniqueKey":"market.mechanismState","typeLabel":"object"},"funding":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["none","reserve_on_submission"],"isRequired":true,"uniqueKey":"market.funding.mode","typeLabel":"enum\u003cstring>"},"acceptedRailIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"market.funding.acceptedRailIds.items.[INDEX]","typeLabel":"string"},"description":"Rails accepted for funded participation.","uniqueKey":"market.funding.acceptedRailIds","typeLabel":"string[]"},"settlementGraceSeconds":{"type":"integer","format":"uint32","minimum":0,"description":"Additional authorization lifetime required beyond the mechanism horizon.","uniqueKey":"market.funding.settlementGraceSeconds","typeLabel":"integer\u003cuint32>"}},"isRequired":true,"uniqueKey":"market.funding","typeLabel":"object"},"publicationVerified":{"type":"boolean","description":"Whether configured publication admission verified a credential without disclosing its identifier.","isRequired":true,"uniqueKey":"market.publicationVerified","typeLabel":"boolean"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"market.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"market.updatedAt","typeLabel":"string\u003cdate-time>"},"fulfillment":{"type":"object","additionalProperties":false,"required":["requestSchema","acceptedDeliveryTransports","outputMediaTypes"],"properties":{"requestSchema":{"type":"string","minLength":1,"description":"Versioned schema required for participant requests.","isRequired":true,"uniqueKey":"market.fulfillment.requestSchema","typeLabel":"string"},"acceptedDeliveryTransports":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":1,"uniqueKey":"market.fulfillment.acceptedDeliveryTransports.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"market.fulfillment.acceptedDeliveryTransports","typeLabel":"string[]"},"outputMediaTypes":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":3,"uniqueKey":"market.fulfillment.outputMediaTypes.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"market.fulfillment.outputMediaTypes","typeLabel":"string[]"},"providerEndpoint":{"type":"object","additionalProperties":false,"required":["transport","uri"],"properties":{"transport":{"type":"string","minLength":1,"description":"Lowercase transport identifier such as email, https, or a2a.","isRequired":true,"uniqueKey":"market.fulfillment.providerEndpoint.transport","typeLabel":"string"},"uri":{"type":"string","format":"uri","description":"Absolute contact or delivery URI. It must not contain credentials, secrets, or a fragment.","isRequired":true,"uniqueKey":"market.fulfillment.providerEndpoint.uri","typeLabel":"string\u003curi>"}},"uniqueKey":"market.fulfillment.providerEndpoint","typeLabel":"object"},"slaSeconds":{"type":"integer","format":"uint32","minimum":1,"description":"Optional fulfillment target measured from commitment creation.","uniqueKey":"market.fulfillment.slaSeconds","typeLabel":"integer\u003cuint32>"}},"uniqueKey":"market.fulfillment","typeLabel":"object"},"paymentCredentialInstructions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["railId","credentialType","credentialTarget"],"properties":{"railId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"market.paymentCredentialInstructions.items.[INDEX].railId","typeLabel":"string"},"credentialType":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"market.paymentCredentialInstructions.items.[INDEX].credentialType","typeLabel":"string"},"credentialTarget":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"market.paymentCredentialInstructions.items.[INDEX].credentialTarget","typeLabel":"string"}},"uniqueKey":"market.paymentCredentialInstructions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"market.paymentCredentialInstructions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"market","typeLabel":"object"},"bidReceipts":{"type":"array","description":"Accepted sealed-bid receipts belonging to the represented principal.","items":{"type":"object","additionalProperties":false,"required":["bidId","marketId","marketVersion","state","submittedAt"],"properties":{"bidId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"bidReceipts.items.[INDEX].bidId","typeLabel":"string"},"marketId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"bidReceipts.items.[INDEX].marketId","typeLabel":"string"},"marketVersion":{"type":"integer","format":"uint64","minimum":1,"isRequired":true,"uniqueKey":"bidReceipts.items.[INDEX].marketVersion","typeLabel":"integer\u003cuint64>"},"state":{"type":"string","const":"active","isRequired":true,"uniqueKey":"bidReceipts.items.[INDEX].state","typeLabel":"string"},"submittedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"bidReceipts.items.[INDEX].submittedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"bidReceipts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"bidReceipts","typeLabel":"object[]"},"offers":{"type":"array","description":"Own offers with current state; private terms are omitted.","items":{"type":"object","additionalProperties":false,"required":["id","state","submittedAt","updatedAt"],"properties":{"id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"offers.items.[INDEX].id","typeLabel":"string"},"state":{"type":"string","enum":["active","withdrawn","selected","not_selected","expired"],"isRequired":true,"uniqueKey":"offers.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"submittedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"offers.items.[INDEX].submittedAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"offers.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"offers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"offers","typeLabel":"object[]"},"commitments":{"type":"array","description":"Current commitments allocated to the represented principal.","items":{"type":"object","additionalProperties":false,"required":["id","version","marketId","marketVersion","creatorPrincipalId","participantPrincipalId","state","terms","createdAt","updatedAt"],"properties":{"id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].id","typeLabel":"string"},"version":{"type":"integer","format":"uint64","minimum":1,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].version","typeLabel":"integer\u003cuint64>"},"marketId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].marketId","typeLabel":"string"},"marketVersion":{"type":"integer","format":"uint64","minimum":1,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].marketVersion","typeLabel":"integer\u003cuint64>"},"creatorPrincipalId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].creatorPrincipalId","typeLabel":"string"},"participantPrincipalId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].participantPrincipalId","typeLabel":"string"},"state":{"type":"string","enum":["provisional","awaiting_confirmations","committed","declined","expired","failed"],"isRequired":true,"uniqueKey":"commitments.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"terms":{"oneOf":[{"type":"object","description":"Immutable terms generated by the market mechanism.","required":["subject","pricing"],"properties":{"subject":{"type":"object","additionalProperties":false,"required":["schema","data"],"properties":{"schema":{"type":"string","minLength":1,"description":"Versioned identifier chosen by the client for the subject data shape.","example":"restaurant-table.v1","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.subject.schema","typeLabel":"string"},"data":{"type":"object","description":"Client-defined JSON object describing the item, service, capacity, or right being allocated.","additionalProperties":true,"example":{"partySize":2,"startsAt":"2026-09-19T19:00:00Z"},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.subject.data","typeLabel":"object"}},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.subject","typeLabel":"object"},"pricing":{"oneOf":[{"type":"object","description":"Free or posted terms recorded in the resulting commitment.","required":["mode"],"properties":{"mode":{"type":"string","const":"free","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.pricing.oneOf.0.mode","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.pricing.oneOf.0","typeLabel":"object"},{"type":"object","description":"Free or posted terms recorded in the resulting commitment.","required":["mode","amountMinor","currency"],"properties":{"mode":{"type":"string","const":"posted","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.pricing.oneOf.1.mode","typeLabel":"string"},"amountMinor":{"type":"integer","format":"int64","minimum":1,"description":"Positive posted amount in minor currency units.","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.pricing.oneOf.1.amountMinor","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.pricing.oneOf.1.currency","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.pricing.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.pricing","typeLabel":"object"},"fulfillment":{"type":"object","additionalProperties":false,"required":["spec","handoff"],"properties":{"spec":{"type":"object","additionalProperties":false,"required":["requestSchema","acceptedDeliveryTransports","outputMediaTypes"],"properties":{"requestSchema":{"type":"string","minLength":1,"description":"Versioned schema required for participant requests.","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.requestSchema","typeLabel":"string"},"acceptedDeliveryTransports":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":1,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.acceptedDeliveryTransports.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.acceptedDeliveryTransports","typeLabel":"string[]"},"outputMediaTypes":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":3,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.outputMediaTypes.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.outputMediaTypes","typeLabel":"string[]"},"providerEndpoint":{"type":"object","additionalProperties":false,"required":["transport","uri"],"properties":{"transport":{"type":"string","minLength":1,"description":"Lowercase transport identifier such as email, https, or a2a.","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.providerEndpoint.transport","typeLabel":"string"},"uri":{"type":"string","format":"uri","description":"Absolute contact or delivery URI. It must not contain credentials, secrets, or a fragment.","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.providerEndpoint.uri","typeLabel":"string\u003curi>"}},"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.providerEndpoint","typeLabel":"object"},"slaSeconds":{"type":"integer","format":"uint32","minimum":1,"description":"Optional fulfillment target measured from commitment creation.","uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec.slaSeconds","typeLabel":"integer\u003cuint32>"}},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.spec","typeLabel":"object"},"handoff":{"type":"object","additionalProperties":false,"required":["request","deliveryEndpoint"],"properties":{"request":{"type":"object","additionalProperties":false,"required":["schema","data"],"properties":{"schema":{"type":"string","minLength":1,"description":"Versioned identifier chosen by the client for the subject data shape.","example":"restaurant-table.v1","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.handoff.request.schema","typeLabel":"string"},"data":{"type":"object","description":"Client-defined JSON object describing the item, service, capacity, or right being allocated.","additionalProperties":true,"example":{"partySize":2,"startsAt":"2026-09-19T19:00:00Z"},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.handoff.request.data","typeLabel":"object"}},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.handoff.request","typeLabel":"object"},"deliveryEndpoint":{"type":"object","additionalProperties":false,"required":["transport","uri"],"properties":{"transport":{"type":"string","minLength":1,"description":"Lowercase transport identifier such as email, https, or a2a.","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.handoff.deliveryEndpoint.transport","typeLabel":"string"},"uri":{"type":"string","format":"uri","description":"Absolute contact or delivery URI. It must not contain credentials, secrets, or a fragment.","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.handoff.deliveryEndpoint.uri","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.handoff.deliveryEndpoint","typeLabel":"object"}},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment.handoff","typeLabel":"object"}},"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0.fulfillment","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.0","typeLabel":"object"},{"type":"object","description":"Immutable terms generated by the market mechanism.","required":["subject","winningBidId","pricing"],"properties":{"subject":{"type":"object","additionalProperties":false,"required":["schema","data"],"properties":{"schema":{"type":"string","minLength":1,"description":"Versioned identifier chosen by the client for the subject data shape.","example":"restaurant-table.v1","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1.subject.schema","typeLabel":"string"},"data":{"type":"object","description":"Client-defined JSON object describing the item, service, capacity, or right being allocated.","additionalProperties":true,"example":{"partySize":2,"startsAt":"2026-09-19T19:00:00Z"},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1.subject.data","typeLabel":"object"}},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1.subject","typeLabel":"object"},"winningBidId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1.winningBidId","typeLabel":"string"},"pricing":{"type":"object","additionalProperties":false,"required":["rule","amountMinor","currency"],"properties":{"rule":{"type":"string","const":"second_price","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1.pricing.rule","typeLabel":"string"},"amountMinor":{"type":"integer","format":"int64","minimum":0,"description":"Second-highest eligible bid or the reserve when higher. Zero is possible without a reserve and one bidder.","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1.pricing.amountMinor","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Three-letter uppercase currency code.","example":"USD","isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1.pricing.currency","typeLabel":"string"}},"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1.pricing","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"commitments.items.[INDEX].terms","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"commitments.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"commitments.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"paymentAuthorizationId":{"type":"string","minLength":1,"uniqueKey":"commitments.items.[INDEX].paymentAuthorizationId","typeLabel":"string"},"settlementState":{"type":"string","enum":["pending","settled","failed"],"uniqueKey":"commitments.items.[INDEX].settlementState","typeLabel":"enum\u003cstring>"},"settlementOperationId":{"type":"string","minLength":1,"uniqueKey":"commitments.items.[INDEX].settlementOperationId","typeLabel":"string"},"settlementFailureCode":{"type":"string","minLength":1,"uniqueKey":"commitments.items.[INDEX].settlementFailureCode","typeLabel":"string"},"refundState":{"type":"string","enum":["pending","refunded","failed"],"uniqueKey":"commitments.items.[INDEX].refundState","typeLabel":"enum\u003cstring>"},"refundOperationId":{"type":"string","minLength":1,"uniqueKey":"commitments.items.[INDEX].refundOperationId","typeLabel":"string"},"refundFailureCode":{"type":"string","minLength":1,"uniqueKey":"commitments.items.[INDEX].refundFailureCode","typeLabel":"string"},"requiredConfirmationPrincipalIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"commitments.items.[INDEX].requiredConfirmationPrincipalIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"commitments.items.[INDEX].requiredConfirmationPrincipalIds","typeLabel":"string[]"},"confirmedPrincipalIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"commitments.items.[INDEX].confirmedPrincipalIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"commitments.items.[INDEX].confirmedPrincipalIds","typeLabel":"string[]"},"expiresAt":{"type":"string","format":"date-time","description":"Confirmation deadline when the commitment is awaiting confirmation.","uniqueKey":"commitments.items.[INDEX].expiresAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"commitments.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"commitments","typeLabel":"object[]"},"lotteryEntries":{"type":"array","description":"Own entries including withdrawal/re-entry history. Active is not an award; consult commitments. Empty commitments are not final loss while promotion remains possible.","items":{"type":"object","additionalProperties":false,"required":["id","state","submittedAt","updatedAt"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"lotteryEntries.items.[INDEX].id","typeLabel":"string"},"state":{"type":"string","enum":["active","withdrawn"],"isRequired":true,"uniqueKey":"lotteryEntries.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"submittedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"lotteryEntries.items.[INDEX].submittedAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"lotteryEntries.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"evidenceUrl":{"type":"string","uniqueKey":"lotteryEntries.items.[INDEX].evidenceUrl","typeLabel":"string"}},"uniqueKey":"lotteryEntries.items.[INDEX]","typeLabel":"object"},"uniqueKey":"lotteryEntries","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"market":{"id":"\u003cstring>","version":2,"state":"open","discoverability":"listed","creatorPrincipalId":"\u003cstring>","subject":{"schema":"restaurant-table.v1","data":{"partySize":2,"startsAt":"2026-09-19T19:00:00Z"}},"mechanism":{"presetId":"direct-claim.v1","config":{"capacity":2,"pricing":{"mode":"free"},"confirmation":"none","holdDurationSeconds":-1,"maxPerPrincipal":2,"claimsCloseAt":"2023-11-07T05:31:56Z"}},"mechanismState":{},"funding":{"mode":"none","acceptedRailIds":["\u003cstring>"],"settlementGraceSeconds":1},"publicationVerified":true,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","fulfillment":{"requestSchema":"\u003cstring>","acceptedDeliveryTransports":["\u003cstring>"],"outputMediaTypes":["\u003cstring>"],"providerEndpoint":{"transport":"\u003cstring>","uri":"\u003cstring>"},"slaSeconds":2},"paymentCredentialInstructions":[{"railId":"\u003cstring>","credentialType":"\u003cstring>","credentialTarget":"\u003cstring>"}]},"bidReceipts":[{"bidId":"\u003cstring>","marketId":"\u003cstring>","marketVersion":2,"state":"active","submittedAt":"2023-11-07T05:31:56Z"}],"offers":[{"id":"\u003cstring>","state":"active","submittedAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}],"commitments":[{"id":"\u003cstring>","version":2,"marketId":"\u003cstring>","marketVersion":2,"creatorPrincipalId":"\u003cstring>","participantPrincipalId":"\u003cstring>","state":"provisional","terms":{"subject":{"schema":"restaurant-table.v1","data":{"partySize":2,"startsAt":"2026-09-19T19:00:00Z"}},"pricing":{"mode":"free"},"fulfillment":{"spec":{"requestSchema":"\u003cstring>","acceptedDeliveryTransports":["\u003cstring>"],"outputMediaTypes":["\u003cstring>"],"providerEndpoint":{"transport":"\u003cstring>","uri":"\u003cstring>"},"slaSeconds":2},"handoff":{"request":{"schema":"restaurant-table.v1","data":{"partySize":2,"startsAt":"2026-09-19T19:00:00Z"}},"deliveryEndpoint":{"transport":"\u003cstring>","uri":"\u003cstring>"}}}},"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","paymentAuthorizationId":"\u003cstring>","settlementState":"pending","settlementOperationId":"\u003cstring>","settlementFailureCode":"\u003cstring>","refundState":"pending","refundOperationId":"\u003cstring>","refundFailureCode":"\u003cstring>","requiredConfirmationPrincipalIds":["\u003cstring>"],"confirmedPrincipalIds":["\u003cstring>"],"expiresAt":"2023-11-07T05:31:56Z"}],"lotteryEntries":[{"id":"\u003cstring>","state":"active","submittedAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","evidenceUrl":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"ebe7b91e-a8e9-460a-9120-f13a5bb0fbf9":{"description":"Request authentication failed.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","forbidden","identity_conflict","identity_not_found","invalid_credential","credential_conflict","signing_key_mismatch","delegation_not_found","delegation_conflict","delegation_inactive","not_found","method_not_allowed","idempotency_conflict","concurrent_update","internal_error","invalid_command","authority_reference_required","unknown_mechanism","invalid_mechanism_config","market_not_found","commitment_not_found","principal_not_authorized","version_conflict","invalid_market_transition","invalid_commitment_transition","actor_not_authorized","capacity_exhausted","invalid_payment_authorization","payment_authority_required","payment_mandate_exceeded","payment_rail_unavailable","payment_rail_unsupported"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable detail. Clients should branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthenticated","message":"request authentication failed"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthenticated","message":"request authentication failed"}}}},"exampleType":"examples"}},"exampleType":"examples"},"97144d09-e132-40b1-b2af-8ddd72478863":{"description":"The actor or principal is not authorized for this action.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","forbidden","identity_conflict","identity_not_found","invalid_credential","credential_conflict","signing_key_mismatch","delegation_not_found","delegation_conflict","delegation_inactive","not_found","method_not_allowed","idempotency_conflict","concurrent_update","internal_error","invalid_command","authority_reference_required","unknown_mechanism","invalid_mechanism_config","market_not_found","commitment_not_found","principal_not_authorized","version_conflict","invalid_market_transition","invalid_commitment_transition","actor_not_authorized","capacity_exhausted","invalid_payment_authorization","payment_authority_required","payment_mandate_exceeded","payment_rail_unavailable","payment_rail_unsupported"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable detail. Clients should branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0edda8cd-b200-416f-a6aa-c67fc2992eb6":{"description":"The requested market, commitment, or route was not found.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","forbidden","identity_conflict","identity_not_found","invalid_credential","credential_conflict","signing_key_mismatch","delegation_not_found","delegation_conflict","delegation_inactive","not_found","method_not_allowed","idempotency_conflict","concurrent_update","internal_error","invalid_command","authority_reference_required","unknown_mechanism","invalid_mechanism_config","market_not_found","commitment_not_found","principal_not_authorized","version_conflict","invalid_market_transition","invalid_commitment_transition","actor_not_authorized","capacity_exhausted","invalid_payment_authorization","payment_authority_required","payment_mandate_exceeded","payment_rail_unavailable","payment_rail_unsupported"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable detail. Clients should branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f12afa13-93af-48fb-b692-5836c63f2620":{"description":"The command could not be completed because of an internal failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","forbidden","identity_conflict","identity_not_found","invalid_credential","credential_conflict","signing_key_mismatch","delegation_not_found","delegation_conflict","delegation_inactive","not_found","method_not_allowed","idempotency_conflict","concurrent_update","internal_error","invalid_command","authority_reference_required","unknown_mechanism","invalid_mechanism_config","market_not_found","commitment_not_found","principal_not_authorized","version_conflict","invalid_market_transition","invalid_commitment_transition","actor_not_authorized","capacity_exhausted","invalid_payment_authorization","payment_authority_required","payment_mandate_exceeded","payment_rail_unavailable","payment_rail_unsupported"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable detail. Clients should branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"35dd24b1-7284-4733-9611-2e5506975052":{"AmbientActor":{"type":"apiKey","in":"header","name":"X-Ambient-Actor","description":"Provisioned actor identifier.","scopes":[]},"AmbientTimestamp":{"type":"apiKey","in":"header","name":"X-Ambient-Timestamp","description":"Current Unix timestamp in seconds, within the configured clock-skew window.","scopes":[]},"AmbientSignature":{"type":"apiKey","in":"header","name":"Authorization","description":"Ambient-HMAC followed by a space and the unpadded base64url HMAC-SHA256\nsignature. See Authentication and authority for the canonical input.\n","scopes":[]}},"cf6e24dd-c984-41ea-b27c-43d03503dec6":{"AmbientBearer":{"type":"http","scheme":"bearer","description":"Short-lived opaque token issued after Ed25519 actor-key proof.","scopes":[]}}},"servers":{"ccaf9552-2a2e-4df0-9e42-c55c270d5a04":{"url":"https://{host}","description":"Hosted Ambient environment","variables":{"host":{"default":"api.ambient.market","description":"Canonical Ambient production API host."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Ambient-Actor","description":"Provisioned actor identifier.","scopes":[]},"schema":{"title":"X-Ambient-Actor","type":"string","description":"Provisioned actor identifier.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AmbientActor","name":"X-Ambient-Actor"},{"scheme":{"type":"apiKey","in":"header","name":"X-Ambient-Timestamp","description":"Current Unix timestamp in seconds, within the configured clock-skew window.","scopes":[]},"schema":{"title":"X-Ambient-Timestamp","type":"string","description":"Current Unix timestamp in seconds, within the configured clock-skew window.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AmbientTimestamp","name":"X-Ambient-Timestamp"},{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Ambient-HMAC followed by a space and the unpadded base64url HMAC-SHA256\nsignature. See Authentication and authority for the canonical input.\n","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Ambient-HMAC followed by a space and the unpadded base64url HMAC-SHA256\nsignature. See Authentication and authority for the canonical input.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AmbientSignature","name":"Authorization"}],"title":"AmbientActor \u0026 AmbientTimestamp \u0026 AmbientSignature"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Short-lived opaque token issued after Ed25519 actor-key proof.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Short-lived opaque token issued after Ed25519 actor-key proof.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"AmbientBearer","name":"Authorization"}],"title":"AmbientBearer"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"ambient-e0cf5f67","siteName":"Ambient","title":"Get your outcome in a market - Ambient","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T17:43:18.137Z","originalFileLocation":"api-reference/markets/get-your-outcome-in-a-market.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 the public market snapshot and only the represented principal\u0026#x27;s accepted bid receipts, current offer states, lottery entry history and commitments. Private offer terms are omitted. Use a commitment ID here to confirm an allocation when participant confirmation is required. Lottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily a final loss while promotion remains possible. Requires current claim, bid, offer-submission or lottery-entry authority for the market\u0026#x27;s mechanism.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ambient\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get your outcome in a market - Ambient\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the public market snapshot and only the represented principal\u0026#x27;s accepted bid receipts, current offer states, lottery entry history and commitments. Private offer terms are omitted. Use a commitment ID here to confirm an allocation when participant confirmation is required. Lottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily a final loss while promotion remains possible. Requires current claim, bid, offer-submission or lottery-entry authority for the market\u0026#x27;s mechanism.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ambient\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ambient-e0cf5f67.mintlify.app/_mintlify/api/og/v2?division=Markets\u0026amp;title=Get+your+outcome+in+a+market\u0026amp;description=Returns+the+public+market+snapshot+and+only+the+represented+principal%27s%0Aaccepted+bid+receipts%2C+current+offer+states%2C+lottery+entry+history+and%0Acommitments.+Priv\u0026amp;theme=4d6b66c614545d11af667318\u0026amp;signature=d52e6b0b0f0df174994773d03362d96b57ea0924be70c655439a97c443615977\">\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 your outcome in a market - Ambient\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the public market snapshot and only the represented principal\u0026#x27;s accepted bid receipts, current offer states, lottery entry history and commitments. Private offer terms are omitted. Use a commitment ID here to confirm an allocation when participant confirmation is required. Lottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily a final loss while promotion remains possible. Requires current claim, bid, offer-submission or lottery-entry authority for the market\u0026#x27;s mechanism.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ambient-e0cf5f67.mintlify.app/_mintlify/api/og/v2?division=Markets\u0026amp;title=Get+your+outcome+in+a+market\u0026amp;description=Returns+the+public+market+snapshot+and+only+the+represented+principal%27s%0Aaccepted+bid+receipts%2C+current+offer+states%2C+lottery+entry+history+and%0Acommitments.+Priv\u0026amp;theme=4d6b66c614545d11af667318\u0026amp;signature=d52e6b0b0f0df174994773d03362d96b57ea0924be70c655439a97c443615977\">\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/ambient-e0cf5f67/OfNg4a1LzHWBkcFW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ambient\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#004D3E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market\">\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-your-outcome-in-a-market.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ambient.market/#organization\",\"name\":\"Ambient\",\"url\":\"https://docs.ambient.market\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ambient.market#website\",\"name\":\"Ambient\",\"url\":\"https://docs.ambient.market\",\"publisher\":{\"@id\":\"https://docs.ambient.market/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market#webpage\",\"url\":\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market\",\"name\":\"Get your outcome in a market\",\"description\":\"Returns the public market snapshot and only the represented principal's accepted bid receipts, current offer states, lottery entry history and commitments. Private offer terms are omitted. Use a commitment ID here to confirm an allocation when participant confirmation is required. Lottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily a final loss while promotion remains possible. Requires current claim, bid, offer-submission or lottery-entry authority for the market's mechanism.\",\"dateModified\":\"2026-09-30T17:43:18.137Z\",\"isPartOf\":{\"@id\":\"https://docs.ambient.market#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.ambient.market/http-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"HTTP endpoints\",\"item\":\"https://docs.ambient.market/api-reference/system/check-process-liveness\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Markets\",\"item\":\"https://docs.ambient.market/api-reference/markets/discover-published-markets\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Get your outcome in a market\",\"item\":\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market#apireference\",\"headline\":\"Get your outcome in a market\",\"name\":\"Get your outcome in a market\",\"description\":\"Returns the public market snapshot and only the represented principal's accepted bid receipts, current offer states, lottery entry history and commitments. Private offer terms are omitted. Use a commitment ID here to confirm an allocation when participant confirmation is required. Lottery creator review requires the creator to confirm the award. An empty commitment list is not necessarily a final loss while promotion remains possible. Requires current claim, bid, offer-submission or lottery-entry authority for the market's mechanism.\",\"url\":\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ambient.market/api-reference/markets/get-your-outcome-in-a-market#webpage\"},\"dateModified\":\"2026-09-30T17:43:18.137Z\",\"publisher\":{\"@id\":\"https://docs.ambient.market/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ambient.market#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ambient\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ambient","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Ambient platform","href":"/overview"},{"title":"Run your first market","href":"/quickstart"},{"title":"Resources for agents","href":"/agent-resources"},{"title":"Connect over MCP","href":"/integrate/mcp"},{"title":"Environments and testing","href":"/integrate/environments"}]},{"group":"Integrate","pages":[{"title":"Choose an onboarding path","href":"/integrate/onboarding"},{"title":"OAuth connections","href":"/oauth-connections"},{"title":"Market recipes","href":"/recipes"},{"title":"Errors and retries","href":"/errors-and-retries"},{"title":"Creator onboarding","href":"/seller-onboarding"},{"title":"Participant onboarding","href":"/buyer-onboarding"},{"group":"Market mechanisms","pages":[{"title":"Market mechanisms","href":"/mechanisms"},{"title":"Direct claim","href":"/direct-claim"},{"title":"Sealed auction","href":"/sealed-auction"},{"title":"Request for offers","href":"/request-for-offers"},{"title":"Lottery","href":"/lottery"}]},{"title":"Records and history","href":"/records"}]},{"group":"Core concepts","pages":[{"title":"Core concepts","href":"/concepts"},{"title":"Authentication and authority","href":"/authentication"}]},{"group":"Reference","pages":[{"title":"HTTP API overview","href":"/http-api"},{"group":"HTTP endpoints","pages":[{"group":"System","pages":[{"title":"Check process liveness","deprecated":null,"version":null,"openapi":"/openapi.yaml get /livez","href":"/api-reference/system/check-process-liveness"},{"title":"Check service readiness","deprecated":null,"version":null,"openapi":"/openapi.yaml get /readyz","href":"/api-reference/system/check-service-readiness"},{"title":"Check service readiness (compatibility alias)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /healthz","href":"/api-reference/system/check-service-readiness-compatibility-alias"},{"title":"Check worker and durable-queue health","deprecated":null,"version":null,"openapi":"/openapi.yaml get /ops/healthz","href":"/api-reference/system/check-worker-and-durable-queue-health"},{"title":"Scrape bounded application metrics","deprecated":null,"version":null,"openapi":"/openapi.yaml get /ops/metrics","href":"/api-reference/system/scrape-bounded-application-metrics"}]},{"group":"Authentication","pages":[{"title":"Request an actor-key challenge","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/auth/challenges","href":"/api-reference/authentication/request-an-actor-key-challenge"},{"title":"Exchange an Ed25519 proof for a bearer token","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/auth/tokens","href":"/api-reference/authentication/exchange-an-ed25519-proof-for-a-bearer-token"}]},{"group":"Signup","pages":[{"title":"Start agent self-registration with a new Ed25519 key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/agent-challenges","href":"/api-reference/signup/start-agent-self-registration-with-a-new-ed25519-key"},{"title":"Prove key possession and create a self-representing identity","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/agents","href":"/api-reference/signup/prove-key-possession-and-create-a-self-representing-identity"},{"title":"Send a human-only signup or login code","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/email-challenges","href":"/api-reference/signup/send-a-human-only-signup-or-login-code"},{"title":"Exchange a login-purpose code for a human bearer token","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/email-tokens","href":"/api-reference/signup/exchange-a-login-purpose-code-for-a-human-bearer-token"},{"title":"Ask a person to approve this agent's bounded authority","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/delegation-requests","href":"/api-reference/signup/ask-a-person-to-approve-this-agents-bounded-authority"},{"title":"Exchange the person's delegation code for the requested grant","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/signup/delegation-approvals","href":"/api-reference/signup/exchange-the-persons-delegation-code-for-the-requested-grant"}]},{"group":"Administration","pages":[{"title":"Provision a principal, actor, and first public key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/admin/identities","href":"/api-reference/administration/provision-a-principal-actor-and-first-public-key"},{"title":"Issue an Ed25519-signed Ambient credential","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/admin/credentials","href":"/api-reference/administration/issue-an-ed25519-signed-ambient-credential"},{"title":"Read authoritative credential status","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/admin/credentials/{credentialId}","href":"/api-reference/administration/read-authoritative-credential-status"},{"title":"Revoke an Ambient credential","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/admin/credentials/{credentialId}/revoke","href":"/api-reference/administration/revoke-an-ambient-credential"},{"title":"Register a payee rail through the bootstrap operator","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/admin/payee-rails","href":"/api-reference/administration/register-a-payee-rail-through-the-bootstrap-operator"}]},{"group":"Delegations","pages":[{"title":"Grant bounded authority to an actor","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/delegations","href":"/api-reference/delegations/grant-bounded-authority-to-an-actor"},{"title":"Revoke a delegation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/delegations/{delegationId}/revoke","href":"/api-reference/delegations/revoke-a-delegation"}]},{"group":"Payments","pages":[{"title":"Self-service payee registration (new bindings temporarily blocked)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/payee-rails","href":"/api-reference/payments/self-service-payee-registration-new-bindings-temporarily-blocked"},{"title":"Queue a payment authorization","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/payment-authorizations","href":"/api-reference/payments/queue-a-payment-authorization"},{"title":"Read an actor-scoped payment operation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/payment-operations/{commandId}","href":"/api-reference/payments/read-an-actor-scoped-payment-operation"}]},{"group":"Markets","pages":[{"title":"Discover published markets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets","href":"/api-reference/markets/discover-published-markets"},{"title":"Create a market draft","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets","href":"/api-reference/markets/create-a-market-draft"},{"title":"Publish a market draft","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/publish","href":"/api-reference/markets/publish-a-market-draft"},{"title":"Cancel a market before participation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/cancel","href":"/api-reference/markets/cancel-a-market-before-participation"},{"title":"Get a published market","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}","href":"/api-reference/markets/get-a-published-market"},{"title":"Get public market activity","description":"Returns a safe event projection for a published market. It includes\nlifecycle types, times, public counts, states, outcomes, and clearing\nprices where applicable. It omits identities, command bodies, bid and\noffer identifiers, commitments, and payment references.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/activity","href":"/api-reference/markets/get-public-market-activity"},{"title":"Get your outcome in a market","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/my-outcome","href":"/api-reference/markets/get-your-outcome-in-a-market"}]},{"group":"Participation","pages":[{"title":"Submit a direct claim","description":"Claims capacity in an open direct-claim.v1 market. Omit expectedVersion to\nlet Ambient order competing claims by authoritative server arrival.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/direct-claims","href":"/api-reference/participation/submit-a-direct-claim"},{"title":"Submit a sealed bid","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/sealed-bids","href":"/api-reference/participation/submit-a-sealed-bid"},{"title":"Enter an unfunded lottery before its cutoff","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/lottery-entries","href":"/api-reference/participation/enter-an-unfunded-lottery-before-its-cutoff"},{"title":"Withdraw an owned active entry before entries close","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/lottery-withdrawals","href":"/api-reference/participation/withdraw-an-owned-active-entry-before-entries-close"},{"title":"Read selected candidate evidence and review history","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/lottery-review","href":"/api-reference/participation/read-selected-candidate-evidence-and-review-history"},{"title":"Read offers visible to the currently authorized principal","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/offers","href":"/api-reference/participation/read-offers-visible-to-the-currently-authorized-principal"},{"title":"Submit a private offer","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/offers","href":"/api-reference/participation/submit-a-private-offer"},{"title":"Withdraw your own active offer before close","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/offer-withdrawals","href":"/api-reference/participation/withdraw-your-own-active-offer-before-close"},{"title":"Select offers as the requester after close","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/markets/{marketId}/offer-selections","href":"/api-reference/participation/select-offers-as-the-requester-after-close"}]},{"group":"Commitments","pages":[{"title":"Confirm a commitment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/commitments/{commitmentId}/confirm","href":"/api-reference/commitments/confirm-a-commitment"},{"title":"Decline a commitment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/commitments/{commitmentId}/decline","href":"/api-reference/commitments/decline-a-commitment"},{"title":"Refund a settled commitment","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/commitments/{commitmentId}/refund","href":"/api-reference/commitments/refund-a-settled-commitment"}]},{"group":"Records","pages":[{"title":"Get a market record","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/markets/{marketId}/record","href":"/api-reference/records/get-a-market-record"}]}]},{"title":"MCP tools","href":"/mcp-tools"}]},{"group":"Experimental","pages":[{"title":"Payments","href":"/payments"}]}]},"basePath":"","title":"Get your outcome in a market - Ambient","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}