{ "openapi": "3.1.1", "info": { "title": "Seer API", "version": "1.0.0", "description": "Seer API: authenticated discovery, financial research, portfolio analysis and controlled execution. Use the HTTPS service base assigned to your connection. Tool input/output payloads are specified in tool-catalog.json and live discovery." }, "security": [ { "IssuedAccessToken": [] } ], "paths": { "/v1/tools": { "get": { "operationId": "listTools", "summary": "Discover tools", "description": "Required scope: tools:read. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Retrieved or completed result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "tools:read" ] } }, "/v1/tool-invocations": { "post": { "operationId": "invokeTool", "summary": "Invoke a permitted tool", "description": "Required scope: tools:invoke. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Required on creation. Scoped by workspace, client, method and normalized path. Retention follows the connection’s idempotency policy." } ], "responses": { "200": { "description": "Retrieved or completed result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolResult" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "202": { "description": "Accepted asynchronous invocation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptedJob" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "tools:invoke" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolInvocation" } } } } } }, "/v1/jobs/{job_id}": { "get": { "operationId": "getJob", "summary": "Inspect a job", "description": "Required scope: jobs:read. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Retrieved or completed result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "jobs:read" ] } }, "/v1/artifacts/{artifact_id}": { "get": { "operationId": "getArtifact", "summary": "Retrieve a typed computation artifact", "description": "Required scope: artifacts:read. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "artifact_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Retrieved or completed result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Artifact" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "artifacts:read" ] } }, "/v1/forecasts": { "post": { "operationId": "createForecast", "summary": "Request a quantitative forecast", "description": "Required scope: forecasts:create. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Required on creation. Scoped by workspace, client, method and normalized path. Retention follows the connection’s idempotency policy." } ], "responses": { "202": { "description": "Accepted resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptedJob" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "forecasts:create" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForecastRequest" } } } } } }, "/v1/portfolio-proposals": { "post": { "operationId": "createPortfolioProposal", "summary": "Compute a candidate allocation", "description": "Required scope: portfolios:propose. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Required on creation. Scoped by workspace, client, method and normalized path. Retention follows the connection’s idempotency policy." } ], "responses": { "202": { "description": "Accepted resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptedJob" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "portfolios:propose" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PortfolioProposalRequest" } } } } } }, "/v1/actions": { "post": { "operationId": "createAction", "summary": "Admit an already-authorized action", "description": "Required scope: actions:submit. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Required on creation. Scoped by workspace, client, method and normalized path. Retention follows the connection’s idempotency policy." } ], "responses": { "202": { "description": "Accepted resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Action" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "actions:submit" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionRequest" } } } } }, "get": { "operationId": "listActions", "summary": "listActions", "description": "Required scope: actions:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "actions:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "account_id", "in": "query", "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/actions/{action_id}": { "get": { "operationId": "getAction", "summary": "Inspect execution and reconciliation", "description": "Required scope: actions:read. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "action_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Retrieved or completed result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Action" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "actions:read" ] } }, "/v1/settlements/{settlement_id}": { "get": { "operationId": "getSettlement", "summary": "Inspect a financial movement", "description": "Required scope: settlements:read. Ownership, entitlement and operation-specific checks also apply.", "parameters": [ { "name": "settlement_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Retrieved or completed result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Settlement" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "settlements:read" ] } }, "/v1/scc/balance": { "get": { "operationId": "getSccBalance", "summary": "Inspect the caller’s SCC balance", "description": "Required scope: scc:read. Ownership, entitlement and operation-specific checks also apply.", "parameters": [], "responses": { "200": { "description": "Retrieved or completed result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SccBalance" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Rejected or failed request. See code and retry semantics; query existing actions after uncertain submission.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "x-required-scopes": [ "scc:read" ] } }, "/v1/connection": { "get": { "operationId": "getConnection", "summary": "getConnection", "description": "Required scope: connection:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "connection:read" ], "parameters": [], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Connection" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/agent-revisions": { "get": { "operationId": "listAgentRevisions", "summary": "listAgentRevisions", "description": "Required scope: agents:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "agents:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRevisionList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/agent-revisions/{agent_revision_id}": { "get": { "operationId": "getAgentRevision", "summary": "getAgentRevision", "description": "Required scope: agents:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "agents:read" ], "parameters": [ { "name": "agent_revision_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRevision" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/instruments": { "get": { "operationId": "listInstruments", "summary": "listInstruments", "description": "Required scope: instruments:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "instruments:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "query", "in": "query", "schema": { "type": "string" } }, { "name": "venue", "in": "query", "schema": { "type": "string" } }, { "name": "kind", "in": "query", "schema": { "type": "string", "enum": [ "equity", "token", "derivative", "event_outcome" ] } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstrumentList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/accounts": { "get": { "operationId": "listAccounts", "summary": "listAccounts", "description": "Required scope: accounts:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "accounts:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/account-snapshots": { "post": { "operationId": "createAccountSnapshot", "summary": "createAccountSnapshot", "description": "Required scope: accounts:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "accounts:read" ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Stable per logical creation. Retention is exposed by GET /v1/connection and the admission expiry header." } ], "responses": { "201": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountSnapshot" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountSnapshotRequest" } } } } }, "get": { "operationId": "listAccountSnapshots", "summary": "listAccountSnapshots", "description": "Required scope: accounts:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "accounts:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "account_id", "in": "query", "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountSnapshotList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/account-snapshots/{snapshot_id}": { "get": { "operationId": "getAccountSnapshot", "summary": "getAccountSnapshot", "description": "Required scope: accounts:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "accounts:read" ], "parameters": [ { "name": "snapshot_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountSnapshot" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/evidence-snapshots": { "post": { "operationId": "createEvidenceSnapshot", "summary": "createEvidenceSnapshot", "description": "Required scope: evidence:write. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "evidence:write" ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Stable per logical creation. Retention is exposed by GET /v1/connection and the admission expiry header." } ], "responses": { "201": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceSnapshot" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceSnapshotRequest" } } } } } }, "/v1/evidence-snapshots/{snapshot_id}": { "get": { "operationId": "getEvidenceSnapshot", "summary": "getEvidenceSnapshot", "description": "Required scope: evidence:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "evidence:read" ], "parameters": [ { "name": "snapshot_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceSnapshot" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/models": { "get": { "operationId": "listForecastModels", "summary": "listForecastModels", "description": "Required scope: forecasts:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "forecasts:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForecastModelList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/risk-models": { "get": { "operationId": "listRiskModels", "summary": "listRiskModels", "description": "Required scope: risk:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "risk:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RiskModelList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/research-registry": { "get": { "operationId": "listResearchRegistry", "summary": "listResearchRegistry", "description": "Required scope: research:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "research:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "kind", "in": "query", "schema": { "type": "string", "enum": [ "feature", "strategy", "baseline", "execution_model", "split_policy", "cost_model", "scenario_set", "benchmark", "experiment_family" ] } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegistryList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/research-registry/{revision_id}": { "get": { "operationId": "getResearchRevision", "summary": "getResearchRevision", "description": "Required scope: research:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "research:read" ], "parameters": [ { "name": "revision_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegistryEntry" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/execution-proposals": { "post": { "operationId": "createExecutionProposal", "summary": "createExecutionProposal", "description": "Required scope: actions:propose. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "actions:propose" ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Stable per logical creation. Retention is exposed by GET /v1/connection and the admission expiry header." } ], "responses": { "201": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionProposal" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionProposalRequest" } } } } } }, "/v1/execution-proposals/{proposal_id}": { "get": { "operationId": "getExecutionProposal", "summary": "getExecutionProposal", "description": "Required scope: actions:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "actions:read" ], "parameters": [ { "name": "proposal_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionProposal" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/authorizations": { "get": { "operationId": "listAuthorizations", "summary": "listAuthorizations", "description": "Required scope: authorizations:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "authorizations:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "proposal_id", "in": "query", "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthorizationList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/actions/{action_id}/cancellations": { "post": { "operationId": "cancelAction", "summary": "cancelAction", "description": "Required scope: actions:cancel. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "actions:cancel" ], "parameters": [ { "name": "action_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Stable per logical creation. Retention is exposed by GET /v1/connection and the admission expiry header." } ], "responses": { "202": { "description": "Durably accepted; follow the resource state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cancellation" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancellationRequest" } } } } } }, "/v1/actions/{action_id}/settlements": { "get": { "operationId": "listActionSettlements", "summary": "listActionSettlements", "description": "Required scope: settlements:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "settlements:read" ], "parameters": [ { "name": "action_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SettlementList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/jobs": { "get": { "operationId": "listJobs", "summary": "listJobs", "description": "Required scope: jobs:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "jobs:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/jobs/{job_id}/cancellations": { "post": { "operationId": "cancelJob", "summary": "cancelJob", "description": "Required scope: jobs:cancel. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "jobs:cancel" ], "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Stable per logical creation. Retention is exposed by GET /v1/connection and the admission expiry header." } ], "responses": { "202": { "description": "Durably accepted; follow the resource state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cancellation" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancellationRequest" } } } } } }, "/v1/monitors": { "post": { "operationId": "createMonitor", "summary": "createMonitor", "description": "Required scope: monitors:write. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "monitors:write" ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Stable per logical creation. Retention is exposed by GET /v1/connection and the admission expiry header." } ], "responses": { "201": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Monitor" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitorRequest" } } } } }, "get": { "operationId": "listMonitors", "summary": "listMonitors", "description": "Required scope: monitors:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "monitors:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitorList" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/monitors/{monitor_id}": { "get": { "operationId": "getMonitor", "summary": "getMonitor", "description": "Required scope: monitors:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "monitors:read" ], "parameters": [ { "name": "monitor_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Monitor" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/monitors/{monitor_id}/revisions": { "post": { "operationId": "updateMonitor", "summary": "updateMonitor", "description": "Required scope: monitors:write. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "monitors:write" ], "parameters": [ { "name": "monitor_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Stable per logical creation. Retention is exposed by GET /v1/connection and the admission expiry header." } ], "responses": { "201": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Monitor" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." }, "Idempotency-Key-Expires-At": { "schema": { "type": "string", "format": "date-time" }, "description": "UTC expiry of the original admission binding." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitorUpdate" } } } } } }, "/v1/events": { "get": { "operationId": "listEvents", "summary": "listEvents", "description": "Required scope: events:read. Resource ownership, current grants and capability prerequisites also apply. Exactly one of start, after or cursor is required. start=latest establishes a current watermark without replay. Batches bind a high watermark; follow next_cursor until null, then use resume_cursor as after.", "x-required-scopes": [ "events:read" ], "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "start", "in": "query", "schema": { "type": "string", "enum": [ "earliest", "latest" ] } }, { "name": "after", "in": "query", "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventList" } } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/research-records/{record_id}": { "get": { "operationId": "getResearchRecord", "summary": "getResearchRecord", "description": "Required scope: research:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "research:read" ], "parameters": [ { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchRecord" } } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Correlation identifier; never a credential." } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential.", "headers": { "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Capacity or dependency failure; inspect retry class.", "headers": { "Retry-After": { "schema": { "type": "string" }, "description": "Delta-seconds or HTTP date; minimum retry delay." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/monitors/{monitor_id}/runs": { "get": { "operationId": "listMonitorRuns", "summary": "listMonitorRuns", "description": "Required scope: monitors:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "monitors:read" ], "parameters": [ { "name": "monitor_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitorRunList" } } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/v1/monitor-runs/{run_id}": { "get": { "operationId": "getMonitorRun", "summary": "getMonitorRun", "description": "Required scope: monitors:read. Resource ownership, current grants and capability prerequisites also apply.", "x-required-scopes": [ "monitors:read" ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Resource response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MonitorRun" } } } }, "default": { "description": "Problem details. Inspect code and retry before retrying.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } } }, "components": { "securitySchemes": { "IssuedAccessToken": { "type": "http", "scheme": "bearer", "description": "issued Seer access token. Requests also enforce scope, workspace membership and resource-level permissions." } }, "schemas": { "Amount": { "type": "object", "properties": { "asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "scale": { "type": "integer", "minimum": 0, "maximum": 36 } }, "required": [ "asset", "atoms", "scale" ], "additionalProperties": false }, "EvidenceRef": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "source_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "id", "revision", "source_ref" ], "additionalProperties": false }, "ToolManifest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": { "type": "string" }, "inputSchema": { "type": "object", "additionalProperties": true } }, "required": [ "name", "description", "inputSchema" ], "additionalProperties": false, "examples": [ { "name": "seer_market_bars", "description": "Retrieve completed daily listing observations.", "inputSchema": { "$ref": "#/$defs/MarketBarsInput", "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "MarketBarsInput": { "type": "object", "properties": { "instrumentId": { "type": "string", "minLength": 1, "maxLength": 200 }, "start": { "type": "string", "format": "date" }, "end": { "type": "string", "format": "date" }, "interval": { "type": "string", "enum": [ "1d" ] }, "adjustment": { "type": "string", "enum": [ "split_only", "total_return", "none" ] }, "as_of": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "instrumentId" ], "additionalProperties": false, "description": "Defaults: 252 completed sessions ending at the latest eligible session, interval 1d, adjustment split_only, as_of invocation admission time. start/end, when supplied, are both required and are inclusive session dates; input/output coverage records actual bounds. Maximum 1000 sessions per page. Never returns a partial current-session bar.", "dependentRequired": { "start": [ "end" ], "end": [ "start" ] } } } } } ] }, "HttpToolManifest": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": { "type": "string" }, "schema_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "effect": { "type": "string", "enum": [ "read", "compute", "mutation", "financial_action" ] }, "required_scopes": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "inputSchema": { "type": "object", "additionalProperties": true }, "outputSchema": { "type": "object", "additionalProperties": true }, "mcp_name": { "type": "string", "minLength": 1, "maxLength": 200 }, "prerequisites": { "type": "array", "items": { "type": "string" } }, "error_codes": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "required": [ "name", "description", "schema_revision", "effect", "required_scopes", "inputSchema", "outputSchema", "mcp_name", "prerequisites", "error_codes" ], "additionalProperties": false, "description": "inputSchema validates input; outputSchema validates ToolResult.data. Transport adds evidence, coverage, warnings and pagination. MCP outputSchema wraps the full structured result." }, "ToolList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/HttpToolManifest" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "ToolInvocation": { "type": "object", "properties": { "agent_revision_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "tool": { "type": "string", "minLength": 1, "maxLength": 200 }, "input": { "type": "object", "additionalProperties": true } }, "required": [ "agent_revision_id", "tool", "input" ], "additionalProperties": false, "description": "Input is additionally validated against the selected tool manifest at runtime.", "examples": [ { "agent_revision_id": "agr_example_3", "tool": "research.evaluate", "input": { "strategy_revision": "strategy-example-r3", "evidence_snapshot_id": "snap_example_1", "mode": "historical_simulation", "start_at": "2026-01-01T00:00:00Z", "end_at": "2026-10-01T00:00:00Z", "baseline_revision": "baseline-no-change-r1", "execution_model_revision": "execution-example-r2", "split_policy_revision": "walk-forward-example-r1", "initial_cash": { "asset": "USD", "atoms": "1000000", "scale": 2 }, "experiment_family_id": "experiment_example_1" } }, { "agent_revision_id": "agr_example_3", "tool": "risk.stress", "input": { "account_snapshot_id": "acctsnap_example_1", "risk_model_revision": "risk-example-r1", "scenario_set_revision": "scenarios-example-r2", "confidence": 0.975 } }, { "agent_revision_id": "agr_example_3", "tool": "liquidity.quote_curve", "input": { "instrument_id": "equity:listing:apple-common-xnas", "venue": "XNAS", "side": "buy", "quantities": [ { "asset": "equity:listing:apple-common-xnas", "atoms": "10", "scale": 0 }, { "asset": "equity:listing:apple-common-xnas", "atoms": "50", "scale": 0 } ], "max_age_seconds": 5 } } ] }, "ToolResult": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "invocation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "tool": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": [ "complete", "partial" ] }, "data": {}, "evidence": { "type": "array", "items": { "$ref": "#/components/schemas/EvidenceRef" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "next_cursor": { "type": [ "string", "null" ] }, "coverage": { "$ref": "#/components/schemas/Coverage" } }, "required": [ "schema_version", "invocation_id", "tool", "status", "data", "evidence", "warnings", "next_cursor", "coverage" ], "additionalProperties": false, "examples": [ { "schema_version": "1.0", "invocation_id": "inv_example_1", "tool": "market.bars", "status": "complete", "data": { "instrumentId": "equity:listing:apple-common-xnas", "currency": "USD", "interval": "1d", "observations": [ { "session": "2026-10-01", "close": "100.00" }, { "session": "2026-10-02", "close": "102.00" } ], "adjustment": "split_only", "calendar": "XNAS" }, "evidence": [ { "id": "ev_prices_example", "revision": "1", "source_ref": "source_market_example" } ], "warnings": [], "next_cursor": null, "coverage": { "requested_start": "2026-10-01T00:00:00Z", "requested_end": "2026-10-02T23:59:59Z", "as_of": "2026-10-03T00:00:00Z", "source_refs": [ "source_market_example" ], "missing_reasons": [], "revision_history": "complete" } } ] }, "AcceptedJob": { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "accepted" ] }, "status_url": { "type": "string", "format": "uri-reference" } }, "required": [ "job_id", "state", "status_url" ], "additionalProperties": false, "examples": [ { "job_id": "job_example_1", "state": "accepted", "status_url": "/v1/jobs/job_example_1" } ] }, "Job": { "oneOf": [ { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "accepted", "running", "waiting" ] } }, "required": [ "job_id", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "completed" ] }, "result_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "job_id", "state", "result_ref" ], "additionalProperties": false }, { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "failed" ] }, "error_code": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "job_id", "state", "error_code" ], "additionalProperties": false }, { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "cancelled" ] } }, "required": [ "job_id", "state" ], "additionalProperties": false } ], "examples": [ { "job_id": "job_example_1", "state": "completed", "result_ref": "artifact_forecast_example_1" } ] }, "Horizon": { "type": "object", "properties": { "value": { "type": "integer", "minimum": 1 }, "unit": { "type": "string", "enum": [ "trading_sessions" ] } }, "required": [ "value", "unit" ], "additionalProperties": false, "description": "Calendar and endpoint conventions must be resolved by the supported model contract." }, "ForecastRequest": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "origin_at": { "type": "string", "format": "date-time" }, "target": { "type": "string", "enum": [ "simple_price_return" ] }, "horizon": { "$ref": "#/components/schemas/Horizon" }, "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "model_revision": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "instrument_id", "origin_at", "target", "horizon", "evidence_snapshot_id", "model_revision" ], "additionalProperties": false, "examples": [ { "instrument_id": "equity:listing:apple-common-xnas", "origin_at": "2026-10-01T20:05:00Z", "target": "simple_price_return", "horizon": { "value": 5, "unit": "trading_sessions" }, "evidence_snapshot_id": "snap_example_1", "model_revision": "aura-example-r1" } ] }, "Forecast": { "type": "object", "properties": { "forecast_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "origin_at": { "type": "string", "format": "date-time" }, "target": { "type": "string", "enum": [ "simple_price_return" ] }, "horizon": { "$ref": "#/components/schemas/Horizon" }, "unit": { "type": "string", "enum": [ "fraction" ] }, "model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "estimate": { "type": "object", "properties": { "mean": { "type": "number" }, "quantiles": { "type": "object", "properties": { "0.05": { "type": "number" }, "0.50": { "type": "number" }, "0.95": { "type": "number" } }, "required": [ "0.05", "0.50", "0.95" ], "additionalProperties": false } }, "required": [ "mean", "quantiles" ], "additionalProperties": false }, "evaluation_state": { "type": "string", "enum": [ "pending_outcome", "evaluated", "missing_outcome" ] } }, "required": [ "forecast_id", "instrument_id", "origin_at", "target", "horizon", "unit", "model_revision", "evidence_snapshot_id", "estimate", "evaluation_state" ], "additionalProperties": false, "description": "Forecast contract. Quantile monotonicity is a semantic validation beyond this schema.", "examples": [ { "forecast_id": "fc_example_1", "instrument_id": "equity:listing:apple-common-xnas", "origin_at": "2026-10-01T20:05:00Z", "target": "simple_price_return", "horizon": { "value": 5, "unit": "trading_sessions" }, "unit": "fraction", "model_revision": "aura-example-r1", "evidence_snapshot_id": "snap_example_1", "estimate": { "mean": 0.0218, "quantiles": { "0.05": -0.035438, "0.50": 0.015574, "0.95": 0.101898 } }, "evaluation_state": "pending_outcome" } ] }, "PortfolioProposalRequest": { "type": "object", "properties": { "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "forecast_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1, "uniqueItems": true }, "objective": { "type": "string", "enum": [ "mean_variance_with_turnover" ] }, "constraints": { "type": "object", "properties": { "long_only": { "type": "boolean", "const": true }, "max_weight_bps": { "type": "integer", "minimum": 1, "maximum": 10000 }, "min_cash_bps": { "type": "integer", "minimum": 0, "maximum": 10000 }, "max_turnover_bps": { "type": "integer", "minimum": 0, "maximum": 20000 } }, "required": [ "long_only", "max_weight_bps", "min_cash_bps", "max_turnover_bps" ], "additionalProperties": false }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "objective_parameters": { "type": "object", "properties": { "risk_aversion": { "type": "number", "exclusiveMinimum": 0 }, "turnover_penalty": { "type": "number", "minimum": 0 }, "solver_tolerance": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "risk_aversion", "turnover_penalty", "solver_tolerance" ], "additionalProperties": false } }, "required": [ "account_snapshot_id", "forecast_ids", "objective", "constraints", "risk_model_revision", "objective_parameters" ], "additionalProperties": false, "description": "Objective parameters. Solver settings follow the selected objective contract.", "examples": [ { "account_snapshot_id": "acctsnap_example_1", "forecast_ids": [ "fc_example_1" ], "objective": "mean_variance_with_turnover", "constraints": { "long_only": true, "max_weight_bps": 2000, "min_cash_bps": 1000, "max_turnover_bps": 3000 }, "risk_model_revision": "risk-example-r1", "objective_parameters": { "risk_aversion": 4, "turnover_penalty": 0.001, "solver_tolerance": 1e-08 } } ] }, "ActionRequest": { "type": "object", "properties": { "proposal_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_revision": { "type": "integer", "minimum": 1 }, "authorization_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "proposal_id", "proposal_revision", "authorization_ref" ], "additionalProperties": false, "examples": [ { "proposal_id": "proposal_example_1", "proposal_revision": 3, "authorization_ref": "auth_example_1" } ] }, "Fill": { "type": "object", "properties": { "fill_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "venue_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "quantity": { "$ref": "#/components/schemas/Amount" }, "price": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "quote_asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "observed_at": { "type": "string", "format": "date-time" }, "fees": { "type": "array", "items": { "type": "object", "properties": { "amount": { "$ref": "#/components/schemas/Amount" }, "treatment": { "type": "string", "enum": [ "charge", "rebate" ] }, "kind": { "type": "string", "enum": [ "venue", "broker", "network", "other" ] } }, "required": [ "amount", "treatment", "kind" ], "additionalProperties": false } }, "executed_at": { "type": "string", "format": "date-time" } }, "required": [ "fill_id", "venue_ref", "quantity", "price", "quote_asset", "observed_at", "fees", "executed_at" ], "additionalProperties": false }, "Action": { "type": "object", "properties": { "action_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "execution_state": { "type": "string", "enum": [ "accepted", "ready", "rejected", "submitting", "submission_unknown", "open", "partially_filled", "filled", "cancelled", "expired" ] }, "reconciliation_state": { "type": "string", "enum": [ "pending", "matched", "discrepancy" ] }, "venue_order_ref": { "type": [ "string", "null" ] }, "filled_quantity": { "$ref": "#/components/schemas/Amount" }, "fills": { "type": "array", "items": { "$ref": "#/components/schemas/Fill" } }, "next_step": { "type": "string" } }, "required": [ "action_id", "proposal_id", "execution_state", "reconciliation_state", "venue_order_ref", "filled_quantity", "fills", "next_step" ], "additionalProperties": false, "examples": [ { "action_id": "act_example_1", "proposal_id": "proposal_example_1", "execution_state": "submission_unknown", "reconciliation_state": "pending", "venue_order_ref": null, "filled_quantity": { "asset": "instrument_example", "atoms": "0", "scale": 0 }, "fills": [], "next_step": "query_existing_action" } ] }, "Settlement": { "type": "object", "properties": { "settlement_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "action_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "movement_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "amount": { "$ref": "#/components/schemas/Amount" }, "state": { "type": "string", "enum": [ "pending", "confirmed", "failed", "unknown", "reversed" ] }, "confirmation_basis": { "type": "string", "enum": [ "account_statement", "network_finality", "payment_confirmation" ] }, "external_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "observed_at": { "type": "string", "format": "date-time" }, "reconciliation_state": { "type": "string", "enum": [ "pending", "matched", "discrepancy" ] } }, "required": [ "settlement_id", "action_id", "movement_ref", "amount", "state", "confirmation_basis", "external_ref", "observed_at", "reconciliation_state" ], "additionalProperties": false, "examples": [ { "settlement_id": "set_example_1", "action_id": "act_example_1", "movement_ref": "movement_example_1", "amount": { "asset": "USD", "atoms": "12500", "scale": 2 }, "state": "pending", "confirmation_basis": "account_statement", "external_ref": "external_example_1", "observed_at": "2026-10-01T20:06:00Z", "reconciliation_state": "pending" } ] }, "SccBalance": { "type": "object", "properties": { "asset": { "type": "string", "enum": [ "SCC" ] }, "scale": { "type": "integer", "const": 2 }, "available_atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "committed_atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "outstanding_atoms": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "revision": { "type": "integer", "minimum": 1 } }, "required": [ "asset", "scale", "available_atoms", "committed_atoms", "outstanding_atoms", "revision" ], "additionalProperties": false, "description": "scale only; available + committed must equal outstanding.", "examples": [ { "asset": "SCC", "scale": 2, "available_atoms": "13000", "committed_atoms": "2000", "outstanding_atoms": "15000", "revision": 7 } ] }, "Problem": { "type": "object", "properties": { "type": { "type": "string", "format": "uri-reference" }, "title": { "type": "string" }, "status": { "type": "integer", "minimum": 400, "maximum": 599 }, "detail": { "type": "string" }, "instance": { "type": "string", "format": "uri-reference" }, "code": { "type": "string", "minLength": 1, "maxLength": 200 }, "request_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "retry": { "type": "string", "enum": [ "none", "after_delay", "reconcile_first" ] } }, "required": [ "type", "title", "status", "detail", "instance", "code", "request_id", "retry" ], "additionalProperties": false, "examples": [ { "type": "/problems/idempotency-conflict", "title": "Idempotency conflict", "status": 409, "detail": "This key is already bound to a different request.", "instance": "/v1/requests/req_example_1", "code": "IDEMPOTENCY_CONFLICT", "request_id": "req_example_1", "retry": "none" } ] }, "PortfolioProposal": { "oneOf": [ { "type": "object", "properties": { "proposal_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_revision": { "type": "integer", "minimum": 1 }, "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "solver_status": { "type": "string", "enum": [ "optimal" ] }, "weights": { "type": "array", "items": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "weight": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "instrument_id", "weight" ], "additionalProperties": false } }, "cash_weight": { "type": "number", "minimum": 0, "maximum": 1 }, "objective_value": { "type": "number" }, "primal_residual": { "type": "number", "minimum": 0 }, "constraint_diagnostics": { "type": "array", "items": { "$ref": "#/components/schemas/ConstraintDiagnostic" } } }, "required": [ "proposal_id", "proposal_revision", "account_snapshot_id", "risk_model_revision", "solver_status", "weights", "cash_weight", "objective_value", "primal_residual", "constraint_diagnostics" ], "additionalProperties": false }, { "type": "object", "properties": { "proposal_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_revision": { "type": "integer", "minimum": 1 }, "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "solver_status": { "type": "string", "enum": [ "infeasible", "numerical_failure" ] }, "error_code": { "type": "string", "minLength": 1, "maxLength": 200 }, "constraint_diagnostics": { "type": "array", "items": { "$ref": "#/components/schemas/ConstraintDiagnostic" } } }, "required": [ "proposal_id", "proposal_revision", "account_snapshot_id", "risk_model_revision", "solver_status", "error_code", "constraint_diagnostics" ], "additionalProperties": false } ], "description": "A calculation result. Failed solutions have diagnostics without fabricated target weights. Executable proposals have a separate resource.", "examples": [ { "proposal_id": "allocation_example_2", "proposal_revision": 1, "account_snapshot_id": "acctsnap_example_1", "risk_model_revision": "risk-example-r1", "solver_status": "infeasible", "error_code": "CONSTRAINTS_INFEASIBLE", "constraint_diagnostics": [ { "constraint": "minimum_cash", "residual": 0.05, "tolerance": 1e-08, "binding": false } ] } ] }, "Artifact": { "oneOf": [ { "type": "object", "properties": { "artifact_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "forecast" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "data": { "$ref": "#/components/schemas/Forecast" } }, "required": [ "artifact_id", "kind", "schema_revision", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "artifact_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "portfolio_proposal" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "data": { "$ref": "#/components/schemas/PortfolioProposal" } }, "required": [ "artifact_id", "kind", "schema_revision", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "artifact_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "tool_result" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "data": { "$ref": "#/components/schemas/ToolResult" } }, "required": [ "artifact_id", "kind", "schema_revision", "data" ], "additionalProperties": false } ], "discriminator": { "propertyName": "kind" }, "examples": [ { "artifact_id": "artifact_forecast_example_1", "kind": "forecast", "schema_revision": "1.0", "data": { "forecast_id": "fc_example_1", "instrument_id": "equity:listing:apple-common-xnas", "origin_at": "2026-10-01T20:05:00Z", "target": "simple_price_return", "horizon": { "value": 5, "unit": "trading_sessions" }, "unit": "fraction", "model_revision": "aura-example-r1", "evidence_snapshot_id": "snap_example_1", "estimate": { "mean": 0.0218, "quantiles": { "0.05": -0.035438, "0.50": 0.015574, "0.95": 0.101898 } }, "evaluation_state": "pending_outcome" } } ] }, "Coverage": { "type": "object", "properties": { "requested_start": { "type": [ "string", "null" ], "format": "date-time" }, "requested_end": { "type": [ "string", "null" ], "format": "date-time" }, "as_of": { "type": "string", "format": "date-time" }, "source_refs": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "missing_reasons": { "type": "array", "items": { "type": "string" } }, "revision_history": { "type": "string", "enum": [ "complete", "incomplete", "not_applicable" ] } }, "required": [ "requested_start", "requested_end", "as_of", "source_refs", "missing_reasons", "revision_history" ], "additionalProperties": false }, "AgentRevision": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "agent_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "integer", "minimum": 1 }, "model_binding": { "type": "string", "minLength": 1, "maxLength": 200 }, "instructions": { "type": "string" }, "tool_versions": { "type": "object", "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 200 } }, "grant_refs": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "service_budget_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "execution_mandate_ref": { "type": [ "string", "null" ] } }, "required": [ "id", "agent_id", "revision", "model_binding", "instructions", "tool_versions", "grant_refs", "service_budget_ref", "execution_mandate_ref" ], "additionalProperties": false }, "Connection": { "type": "object", "properties": { "connection_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "workspace_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "client_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "audience": { "type": "string", "minLength": 1, "maxLength": 200 }, "expires_at": { "type": "string", "format": "date-time" }, "scopes": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "default_agent_revision_id": { "type": [ "string", "null" ] }, "mcp_endpoint": { "type": "string", "format": "uri" }, "limits": { "type": "object", "properties": { "request_limit_per_minute": { "type": "integer", "minimum": 1 }, "max_concurrent_jobs": { "type": "integer", "minimum": 1 }, "max_request_bytes": { "type": "integer", "minimum": 1 }, "idempotency_retention_seconds": { "type": "integer", "minimum": 1 }, "cursor_ttl_seconds": { "type": "integer", "minimum": 1 }, "event_retention_seconds": { "type": "integer", "minimum": 1 } }, "required": [ "request_limit_per_minute", "max_concurrent_jobs", "max_request_bytes", "idempotency_retention_seconds", "cursor_ttl_seconds", "event_retention_seconds" ], "additionalProperties": false } }, "required": [ "connection_id", "workspace_id", "client_id", "audience", "expires_at", "scopes", "default_agent_revision_id", "mcp_endpoint", "limits" ], "additionalProperties": false }, "InstrumentRecord": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "equity", "token", "derivative", "event_outcome" ] }, "issuer_ref": { "type": [ "string", "null" ] }, "security_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "symbol": { "type": "string" }, "venue": { "type": "string", "minLength": 1, "maxLength": 200 }, "currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "underlying_id": { "type": [ "string", "null" ] }, "contract_spec_ref": { "type": [ "string", "null" ] }, "supported_tools": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "valid_from": { "type": "string", "format": "date-time" }, "valid_until": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "instrument_id", "kind", "issuer_ref", "security_ref", "symbol", "venue", "currency", "underlying_id", "contract_spec_ref", "supported_tools", "valid_from", "valid_until" ], "additionalProperties": false }, "Account": { "type": "object", "properties": { "account_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "venue": { "type": "string", "minLength": 1, "maxLength": 200 }, "base_currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "capabilities": { "type": "array", "items": { "type": "string", "enum": [ "read", "paper", "limit_orders", "cancel" ] } }, "state": { "type": "string", "enum": [ "connected", "restricted", "disconnected" ] } }, "required": [ "account_id", "venue", "base_currency", "capabilities", "state" ], "additionalProperties": false }, "AccountSnapshotRequest": { "type": "object", "properties": { "account_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "account_id" ], "additionalProperties": false }, "Position": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "quantity": { "$ref": "#/components/schemas/Amount" }, "valuation_price": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "valuation_currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "observed_at": { "type": "string", "format": "date-time" }, "side": { "type": "string", "enum": [ "long", "short" ] } }, "required": [ "instrument_id", "quantity", "valuation_price", "valuation_currency", "observed_at", "side" ], "additionalProperties": false }, "AccountSnapshot": { "type": "object", "properties": { "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "account_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "integer", "minimum": 1 }, "as_of": { "type": "string", "format": "date-time" }, "positions": { "type": "array", "items": { "$ref": "#/components/schemas/Position" } }, "available_cash": { "type": "array", "items": { "$ref": "#/components/schemas/Amount" } }, "committed_cash": { "type": "array", "items": { "$ref": "#/components/schemas/Amount" } }, "pending_action_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "unsettled_movement_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "coverage": { "$ref": "#/components/schemas/Coverage" } }, "required": [ "account_snapshot_id", "account_id", "revision", "as_of", "positions", "available_cash", "committed_cash", "pending_action_ids", "unsettled_movement_ids", "coverage" ], "additionalProperties": false }, "EvidenceSnapshotRequest": { "type": "object", "properties": { "cutoff": { "type": "string", "format": "date-time" }, "mode": { "type": "string", "enum": [ "workflow_replay", "publication_reconstruction" ] }, "evidence_refs": { "type": "array", "items": { "$ref": "#/components/schemas/EvidenceRef" }, "minItems": 1 } }, "required": [ "cutoff", "mode", "evidence_refs" ], "additionalProperties": false, "examples": [ { "cutoff": "2026-10-01T20:05:00Z", "mode": "workflow_replay", "evidence_refs": [ { "id": "ev_release_example", "revision": "1", "source_ref": "source:release:example" } ] } ] }, "EvidenceSnapshot": { "type": "object", "properties": { "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "cutoff": { "type": "string", "format": "date-time" }, "mode": { "type": "string", "enum": [ "workflow_replay", "publication_reconstruction" ] }, "evidence_refs": { "type": "array", "items": { "$ref": "#/components/schemas/EvidenceRef" } }, "coverage": { "$ref": "#/components/schemas/Coverage" }, "digest": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "evidence_snapshot_id", "cutoff", "mode", "evidence_refs", "coverage", "digest" ], "additionalProperties": false }, "ForecastModel": { "type": "object", "properties": { "model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "targets": { "type": "array", "items": { "type": "string", "enum": [ "simple_price_return" ] } }, "horizons": { "type": "array", "items": { "$ref": "#/components/schemas/Horizon" } }, "instrument_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "calendar": { "type": "string", "minLength": 1, "maxLength": 200 }, "endpoint_price": { "type": "string", "enum": [ "close", "midpoint" ] }, "adjustment": { "type": "string", "enum": [ "split_only", "total_return" ] }, "required_feature_revisions": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "required": [ "model_revision", "targets", "horizons", "instrument_ids", "calendar", "endpoint_price", "adjustment", "required_feature_revisions" ], "additionalProperties": false }, "RiskModel": { "type": "object", "properties": { "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "instrument_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "horizon": { "$ref": "#/components/schemas/Horizon" }, "covariance_method": { "type": "string", "minLength": 1, "maxLength": 200 }, "factor_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "parameters": { "type": "object", "additionalProperties": true }, "fit_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "risk_model_revision", "instrument_ids", "horizon", "covariance_method", "factor_revision", "parameters", "fit_snapshot_id" ], "additionalProperties": false }, "RegistryEntry": { "type": "object", "properties": { "revision_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "feature", "strategy", "baseline", "execution_model", "split_policy", "cost_model", "scenario_set", "benchmark", "experiment_family" ] }, "name": { "type": "string" }, "description": { "type": "string" }, "input_schema": { "type": "object" }, "parameters": { "type": "object", "additionalProperties": true }, "input_revision_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "created_at": { "type": "string", "format": "date-time" }, "digest": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "revision_id", "kind", "name", "description", "input_schema", "parameters", "input_revision_ids", "created_at", "digest" ], "additionalProperties": false, "description": "Immutable configured research object. Created/versioned in the workspace Research registry, then selected by API. Parameters and all nested revisions are frozen; the entry declares the exact method settings." }, "AgentRevisionList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/AgentRevision" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "InstrumentList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/InstrumentRecord" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "AccountList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/Account" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "AccountSnapshotList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/AccountSnapshot" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "ForecastModelList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/ForecastModel" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "RiskModelList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/RiskModel" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "RegistryList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/RegistryEntry" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "ConstraintDiagnostic": { "type": "object", "properties": { "constraint": { "type": "string", "minLength": 1, "maxLength": 200 }, "residual": { "type": "number" }, "tolerance": { "type": "number", "minimum": 0 }, "binding": { "type": "boolean" } }, "required": [ "constraint", "residual", "tolerance", "binding" ], "additionalProperties": false }, "ExecutionProposalRequest": { "type": "object", "properties": { "account_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "side": { "type": "string", "enum": [ "buy", "sell" ] }, "quantity": { "$ref": "#/components/schemas/Amount" }, "order_type": { "type": "string", "enum": [ "limit" ] }, "limit_price": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "quote_asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "time_in_force": { "type": "string", "enum": [ "day", "ioc", "gtt" ] }, "expires_at": { "type": "string", "format": "date-time" }, "quote_ref": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "account_id", "account_snapshot_id", "instrument_id", "side", "quantity", "order_type", "limit_price", "quote_asset", "time_in_force", "expires_at", "quote_ref" ], "additionalProperties": false, "examples": [ { "account_id": "account_example_1", "account_snapshot_id": "acctsnap_example_1", "instrument_id": "equity:listing:apple-common-xnas", "side": "buy", "quantity": { "asset": "equity:listing:apple-common-xnas", "atoms": "10", "scale": 0 }, "order_type": "limit", "limit_price": "100.25", "quote_asset": "USD", "time_in_force": "day", "expires_at": "2026-10-01T20:06:00Z", "quote_ref": "quote_example_1" } ] }, "ExecutionProposal": { "type": "object", "properties": { "proposal_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_revision": { "type": "integer", "minimum": 1 }, "order": { "$ref": "#/components/schemas/ExecutionProposalRequest" }, "digest": { "type": "string", "minLength": 1, "maxLength": 200 }, "quote_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "cost_estimate_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "expires_at": { "type": "string", "format": "date-time" }, "state": { "type": "string", "enum": [ "awaiting_authorization", "authorized", "expired", "rejected" ] } }, "required": [ "proposal_id", "proposal_revision", "order", "digest", "quote_ref", "cost_estimate_ref", "expires_at", "state" ], "additionalProperties": false }, "Authorization": { "type": "object", "properties": { "authorization_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "proposal_revision": { "type": "integer", "minimum": 1 }, "proposal_digest": { "type": "string", "minLength": 1, "maxLength": 200 }, "mode": { "type": "string", "enum": [ "single_use", "delegated" ] }, "expires_at": { "type": "string", "format": "date-time" }, "state": { "type": "string", "enum": [ "active", "consumed", "revoked", "expired" ] } }, "required": [ "authorization_ref", "proposal_id", "proposal_revision", "proposal_digest", "mode", "expires_at", "state" ], "additionalProperties": false }, "AuthorizationList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/Authorization" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "ActionList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/Action" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "SettlementList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/Settlement" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "JobList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/Job" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "CancellationRequest": { "type": "object", "properties": { "reason": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "reason" ], "additionalProperties": false }, "Cancellation": { "type": "object", "properties": { "cancellation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "resource_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "state": { "type": "string", "enum": [ "requested", "completed", "rejected" ] }, "reason": { "type": "string" } }, "required": [ "cancellation_id", "resource_id", "state", "reason" ], "additionalProperties": false }, "MonitorCondition": { "type": "object", "properties": { "field": { "type": "string", "enum": [ "source_age_seconds", "coverage_fraction", "consecutive_failures", "baseline_loss_delta" ] }, "operator": { "type": "string", "enum": [ "gt", "lt" ] }, "threshold": { "type": "number" }, "action": { "type": "string", "enum": [ "alert", "pause" ] } }, "required": [ "field", "operator", "threshold", "action" ], "additionalProperties": false }, "MonitorRequest": { "type": "object", "properties": { "agent_revision_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "tool": { "type": "string", "minLength": 1, "maxLength": 200 }, "input": { "type": "object", "additionalProperties": true }, "cadence_seconds": { "type": "integer", "minimum": 60 }, "overlap_policy": { "type": "string", "enum": [ "skip", "coalesce", "enqueue" ] }, "max_service_spend": { "$ref": "#/components/schemas/Amount" }, "conditions": { "type": "array", "items": { "$ref": "#/components/schemas/MonitorCondition" } } }, "required": [ "agent_revision_id", "tool", "input", "cadence_seconds", "overlap_policy", "max_service_spend", "conditions" ], "additionalProperties": false, "examples": [ { "agent_revision_id": "agr_example_3", "tool": "social.search", "input": { "query": "$AAPL lang:en -filter:retweets", "type": "Latest", "count": 20 }, "cadence_seconds": 3600, "overlap_policy": "skip", "max_service_spend": { "asset": "SCC", "atoms": "100", "scale": 2 }, "conditions": [ { "field": "source_age_seconds", "operator": "gt", "threshold": 7200, "action": "alert" } ] } ] }, "Monitor": { "type": "object", "properties": { "monitor_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string", "enum": [ "enabled", "paused" ] }, "configuration": { "$ref": "#/components/schemas/MonitorRequest" }, "last_job_id": { "type": [ "string", "null" ] }, "next_run_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "monitor_id", "revision", "status", "configuration", "last_job_id", "next_run_at" ], "additionalProperties": false }, "MonitorUpdate": { "type": "object", "properties": { "expected_revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string", "enum": [ "enabled", "paused" ] }, "configuration": { "$ref": "#/components/schemas/MonitorRequest" } }, "required": [ "expected_revision", "status", "configuration" ], "additionalProperties": false }, "MonitorList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/Monitor" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false }, "DomainEvent": { "type": "object", "properties": { "event_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "schema_version": { "type": "string", "enum": [ "1.0" ] }, "aggregate_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "aggregate_revision": { "type": "integer", "minimum": 1 }, "occurred_at": { "type": "string", "format": "date-time" }, "type": { "type": "string", "minLength": 1, "maxLength": 200 }, "data_ref": { "type": "string", "pattern": "^/v1/(jobs|actions|settlements|monitor-runs)/[^/?#]+$", "description": "Authenticated relative path to the current authoritative resource. Event identity/revision describes the recorded transition; the fetched projection can already be newer." } }, "required": [ "event_id", "schema_version", "aggregate_id", "aggregate_revision", "occurred_at", "type", "data_ref" ], "additionalProperties": false }, "EventList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/DomainEvent" } }, "next_cursor": { "type": [ "string", "null" ] }, "resume_cursor": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "schema_version", "items", "next_cursor", "resume_cursor" ], "additionalProperties": false, "description": "Drain next_cursor within the batch. When next_cursor is null, checkpoint resume_cursor and poll after it. Empty tail polls still return resume_cursor. start, after and cursor are mutually exclusive." }, "MarketBarsInput": { "type": "object", "properties": { "instrumentId": { "type": "string", "minLength": 1, "maxLength": 200 }, "start": { "type": "string", "format": "date" }, "end": { "type": "string", "format": "date" }, "interval": { "type": "string", "enum": [ "1d" ] }, "adjustment": { "type": "string", "enum": [ "split_only", "total_return", "none" ] }, "as_of": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "instrumentId" ], "additionalProperties": false, "description": "Defaults: 252 completed sessions ending at the latest eligible session, interval 1d, adjustment split_only, as_of invocation admission time. start/end, when supplied, are both required and are inclusive session dates; input/output coverage records actual bounds. Maximum 1000 sessions per page. Never returns a partial current-session bar.", "dependentRequired": { "start": [ "end" ], "end": [ "start" ] } }, "MarketBarsData": { "type": "object", "properties": { "instrumentId": { "type": "string", "minLength": 1, "maxLength": 200 }, "currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "interval": { "type": "string", "enum": [ "1d" ] }, "adjustment": { "type": "string", "enum": [ "split_only", "total_return", "none" ] }, "calendar": { "type": "string", "minLength": 1, "maxLength": 200 }, "observations": { "type": "array", "items": { "type": "object", "properties": { "session": { "type": "string", "format": "date" }, "close": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" } }, "required": [ "session", "close" ], "additionalProperties": false } } }, "required": [ "instrumentId", "currency", "interval", "adjustment", "calendar", "observations" ], "additionalProperties": false }, "TechnicalInput": { "type": "object", "properties": { "instrumentId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "instrumentId" ], "additionalProperties": false, "description": "Fixed daily technical.v1: SMA20/50, Wilder RSI14, return20, volatility20 and drawdown20. Uses split-adjusted completed bars at admission cutoff; insufficient history produces 422, not a zero value." }, "MetricValue": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "name", "value", "unit", "missing_reason" ], "additionalProperties": false }, "TechnicalData": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "method_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "input_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/MetricValue" } } }, "required": [ "instrument_id", "method_revision", "input_snapshot_id", "metrics" ], "additionalProperties": false }, "SocialInput": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 1000 }, "type": { "type": "string", "enum": [ "Latest", "Top" ] }, "count": { "type": "integer", "minimum": 1, "maximum": 100 }, "since": { "type": "string", "format": "date-time" }, "until": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "query", "type", "count" ], "additionalProperties": false }, "SocialData": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "source_item_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "author_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "published_at": { "type": "string", "format": "date-time" }, "available_at": { "type": "string", "format": "date-time" }, "url": { "type": "string", "format": "uri" }, "text": { "type": "string" }, "duplicate_of": { "type": [ "string", "null" ] }, "evidence_ref": { "$ref": "#/components/schemas/EvidenceRef" } }, "required": [ "source_item_id", "author_id", "published_at", "available_at", "url", "text", "duplicate_of", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false }, "SearchInput": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1 }, "start_at": { "type": "string", "format": "date-time" }, "end_at": { "type": "string", "format": "date-time" }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string" } }, "required": [ "query", "start_at", "end_at" ], "additionalProperties": false }, "NewsData": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "document_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "title": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "coverage": { "type": "string", "enum": [ "metadata_only", "excerpt", "full_text" ] }, "text": { "type": "string" }, "entity_refs": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "evidence_ref": { "$ref": "#/components/schemas/EvidenceRef" } }, "required": [ "document_id", "title", "url", "published_at", "coverage", "text", "entity_refs", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false }, "FilingsInput": { "type": "object", "properties": { "issuer_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "forms": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "as_of": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "issuer_ref", "as_of" ], "additionalProperties": false }, "FilingsData": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "filing_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "issuer_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "form": { "type": "string", "minLength": 1, "maxLength": 200 }, "accepted_at": { "type": "string", "format": "date-time" }, "period_end": { "type": "string", "format": "date" }, "amends": { "type": [ "string", "null" ] }, "evidence_ref": { "$ref": "#/components/schemas/EvidenceRef" } }, "required": [ "filing_id", "issuer_ref", "form", "accepted_at", "period_end", "amends", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false }, "FilingReadInput": { "type": "object", "properties": { "filing_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "filing_id" ], "additionalProperties": false }, "FilingReadData": { "type": "object", "properties": { "filing_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "text": { "type": "string" }, "truncated": { "type": "boolean" }, "evidence_ref": { "$ref": "#/components/schemas/EvidenceRef" } }, "required": [ "filing_id", "text", "truncated", "evidence_ref" ], "additionalProperties": false }, "FactsInput": { "type": "object", "properties": { "issuer_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "concepts": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1 }, "as_of": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "issuer_ref", "concepts", "as_of" ], "additionalProperties": false }, "FactsData": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "filing_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "concept": { "type": "string", "minLength": 1, "maxLength": 200 }, "value": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "period_start": { "type": [ "string", "null" ], "format": "date" }, "period_end": { "type": "string", "format": "date" }, "accepted_at": { "type": "string", "format": "date-time" }, "evidence_ref": { "$ref": "#/components/schemas/EvidenceRef" } }, "required": [ "filing_id", "concept", "value", "unit", "period_start", "period_end", "accepted_at", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false }, "MacroInput": { "type": "object", "properties": { "series_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "start": { "type": "string", "format": "date" }, "end": { "type": "string", "format": "date" }, "vintage_at": { "type": "string", "format": "date-time" }, "cursor": { "type": "string" } }, "required": [ "series_id", "start", "end", "vintage_at" ], "additionalProperties": false }, "MacroData": { "type": "object", "properties": { "series_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "frequency": { "type": "string", "minLength": 1, "maxLength": 200 }, "seasonal_adjustment": { "type": "string", "minLength": 1, "maxLength": 200 }, "observations": { "type": "array", "items": { "type": "object", "properties": { "period": { "type": "string" }, "value": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "available_at": { "type": "string", "format": "date-time" }, "evidence_ref": { "$ref": "#/components/schemas/EvidenceRef" } }, "required": [ "period", "value", "published_at", "available_at", "evidence_ref" ], "additionalProperties": false } } }, "required": [ "series_id", "unit", "frequency", "seasonal_adjustment", "observations" ], "additionalProperties": false }, "FeatureInput": { "type": "object", "properties": { "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "feature_revisions": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "minItems": 1 }, "fit_snapshot_id": { "type": [ "string", "null" ] } }, "required": [ "evidence_snapshot_id", "feature_revisions", "fit_snapshot_id" ], "additionalProperties": false }, "FeatureData": { "type": "object", "properties": { "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "feature_revisions": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "fit_snapshot_id": { "type": [ "string", "null" ] }, "rows": { "type": "array", "items": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "decision_at": { "type": "string", "format": "date-time" }, "values": { "type": "array", "items": { "$ref": "#/components/schemas/MetricValue" } } }, "required": [ "instrument_id", "decision_at", "values" ], "additionalProperties": false } } }, "required": [ "evidence_snapshot_id", "feature_revisions", "fit_snapshot_id", "rows" ], "additionalProperties": false }, "ResearchInput": { "type": "object", "properties": { "strategy_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "evidence_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "mode": { "type": "string", "enum": [ "historical_simulation", "prospective_shadow", "paper" ] }, "start_at": { "type": "string", "format": "date-time" }, "end_at": { "type": "string", "format": "date-time" }, "baseline_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "execution_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "split_policy_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "initial_cash": { "$ref": "#/components/schemas/Amount" }, "experiment_family_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "strategy_revision", "evidence_snapshot_id", "mode", "start_at", "end_at", "baseline_revision", "execution_model_revision", "split_policy_revision", "initial_cash", "experiment_family_id" ], "additionalProperties": false }, "ResearchData": { "type": "object", "properties": { "evaluation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "manifest": { "$ref": "#/components/schemas/ResearchInput" }, "status": { "type": "string", "enum": [ "complete", "incomplete" ] }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/MetricValue" } }, "record_refs": { "type": "object", "properties": { "predictions": { "type": "string", "minLength": 1, "maxLength": 200 }, "orders": { "type": "string", "minLength": 1, "maxLength": 200 }, "fills": { "type": "string", "minLength": 1, "maxLength": 200 }, "nav": { "type": "string", "minLength": 1, "maxLength": 200 }, "trials": { "type": "string", "minLength": 1, "maxLength": 200 }, "exclusions": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "predictions", "orders", "fills", "nav", "trials", "exclusions" ], "additionalProperties": false }, "limitations": { "type": "array", "items": { "type": "string" } } }, "required": [ "evaluation_id", "manifest", "status", "metrics", "record_refs", "limitations" ], "additionalProperties": false }, "StressInput": { "type": "object", "properties": { "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "scenario_set_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "confidence": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 } }, "required": [ "account_snapshot_id", "risk_model_revision", "scenario_set_revision", "confidence" ], "additionalProperties": false }, "StressData": { "type": "object", "properties": { "account_snapshot_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "risk_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "scenario_set_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "reporting_currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "confidence": { "type": "number", "exclusiveMinimum": 0, "exclusiveMaximum": 1 }, "expected_shortfall": { "type": [ "string", "null" ] }, "missing_reason": { "type": [ "string", "null" ] }, "scenario_losses": { "type": "array", "items": { "type": "object", "properties": { "scenario_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "loss": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "probability": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "scenario_id", "loss", "probability" ], "additionalProperties": false } }, "factor_exposures": { "type": "array", "items": { "$ref": "#/components/schemas/MetricValue" } }, "limitations": { "type": "array", "items": { "type": "string" } }, "volatility_contributions": { "type": "array", "items": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "contribution": { "type": [ "number", "null" ] }, "unit": { "type": "string", "enum": [ "fraction_per_horizon" ] }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "instrument_id", "contribution", "unit", "missing_reason" ], "additionalProperties": false } } }, "required": [ "account_snapshot_id", "risk_model_revision", "scenario_set_revision", "reporting_currency", "confidence", "expected_shortfall", "missing_reason", "scenario_losses", "factor_exposures", "limitations", "volatility_contributions" ], "additionalProperties": false }, "QuoteCurveInput": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "venue": { "type": "string", "minLength": 1, "maxLength": 200 }, "side": { "type": "string", "enum": [ "buy", "sell" ] }, "quantities": { "type": "array", "items": { "$ref": "#/components/schemas/Amount" }, "minItems": 1, "maxItems": 20 }, "max_age_seconds": { "type": "integer", "minimum": 1 } }, "required": [ "instrument_id", "venue", "side", "quantities", "max_age_seconds" ], "additionalProperties": false }, "QuotePoint": { "type": "object", "properties": { "quote_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "requested_quantity": { "$ref": "#/components/schemas/Amount" }, "fillable_quantity": { "$ref": "#/components/schemas/Amount" }, "average_price": { "type": [ "string", "null" ] }, "quote_asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": [ "executable", "indicative", "unavailable" ] }, "fees_included": { "type": "array", "items": { "type": "string" } }, "expires_at": { "type": [ "string", "null" ], "format": "date-time" }, "missing_reason": { "type": [ "string", "null" ] } }, "required": [ "quote_ref", "requested_quantity", "fillable_quantity", "average_price", "quote_asset", "status", "fees_included", "expires_at", "missing_reason" ], "additionalProperties": false }, "QuoteCurveData": { "type": "object", "properties": { "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "venue": { "type": "string", "minLength": 1, "maxLength": 200 }, "side": { "type": "string", "enum": [ "buy", "sell" ] }, "observed_at": { "type": "string", "format": "date-time" }, "sequence_ref": { "type": [ "string", "null" ] }, "points": { "type": "array", "items": { "$ref": "#/components/schemas/QuotePoint" } } }, "required": [ "instrument_id", "venue", "side", "observed_at", "sequence_ref", "points" ], "additionalProperties": false }, "CostInput": { "type": "object", "properties": { "quote_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "cost_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "urgency_seconds": { "type": "integer", "minimum": 1 } }, "required": [ "quote_ref", "cost_model_revision", "urgency_seconds" ], "additionalProperties": false }, "CostData": { "type": "object", "properties": { "quote_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "cost_model_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "components": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "fee", "spread", "impact", "delay", "financing", "network" ] }, "estimate": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "included_in_quote": { "type": "boolean" } }, "required": [ "kind", "estimate", "included_in_quote" ], "additionalProperties": false } }, "total_incremental_cost": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "uncertainty_note": { "type": "string" } }, "required": [ "quote_ref", "cost_model_revision", "currency", "components", "total_incremental_cost", "uncertainty_note" ], "additionalProperties": false }, "ExecutionQualityInput": { "type": "object", "properties": { "action_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "benchmark_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "window_end": { "type": "string", "format": "date-time" } }, "required": [ "action_id", "benchmark_revision", "window_end" ], "additionalProperties": false }, "ExecutionQualityData": { "type": "object", "properties": { "action_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "benchmark_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "mode": { "type": "string", "enum": [ "paper", "live" ] }, "currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "filled_cost": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "unfilled_opportunity_cost": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "explicit_fees": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "total_shortfall": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "intended_quantity": { "$ref": "#/components/schemas/Amount" }, "filled_quantity": { "$ref": "#/components/schemas/Amount" }, "coverage": { "$ref": "#/components/schemas/Coverage" } }, "required": [ "action_id", "benchmark_revision", "mode", "currency", "filled_cost", "unfilled_opportunity_cost", "explicit_fees", "total_shortfall", "intended_quantity", "filled_quantity", "coverage" ], "additionalProperties": false }, "ChainInput": { "type": "object", "properties": { "chain_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "contract": { "type": "string", "minLength": 1, "maxLength": 200 }, "block_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "cursor": { "type": "string" } }, "required": [ "chain_id", "contract", "block_ref" ], "additionalProperties": false }, "ChainData": { "type": "object", "properties": { "chain_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "contract": { "type": "string", "minLength": 1, "maxLength": 200 }, "block_hash": { "type": "string", "minLength": 1, "maxLength": 200 }, "block_number": { "type": "string", "pattern": "^[0-9]+$" }, "decimals": { "type": "integer", "minimum": 0, "maximum": 36 }, "canonicality": { "type": "string", "enum": [ "included", "finalized", "orphaned" ] }, "observed_at": { "type": "string", "format": "date-time" }, "total_supply_atoms": { "type": "string", "pattern": "^[0-9]+$" } }, "required": [ "chain_id", "contract", "block_hash", "block_number", "decimals", "canonicality", "observed_at", "total_supply_atoms" ], "additionalProperties": false }, "PredictionInput": { "type": "object", "properties": { "market_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "market_id" ], "additionalProperties": false }, "PredictionData": { "type": "object", "properties": { "market_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "resolution_rules_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "resolution_state": { "type": "string", "enum": [ "unresolved", "disputed", "finalized", "void" ] }, "closes_at": { "type": "string", "format": "date-time" }, "outcomes": { "type": "array", "items": { "type": "object", "properties": { "outcome_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "label": { "type": "string" } }, "required": [ "outcome_id", "instrument_id", "label" ], "additionalProperties": false } }, "evidence_refs": { "type": "array", "items": { "$ref": "#/components/schemas/EvidenceRef" } } }, "required": [ "market_id", "resolution_rules_ref", "resolution_state", "closes_at", "outcomes", "evidence_refs" ], "additionalProperties": false }, "ResearchRecord": { "oneOf": [ { "type": "object", "properties": { "record_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "evaluation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "predictions" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchRow_predictions" } }, "row_schema": { "type": "object" }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "record_id", "evaluation_id", "kind", "schema_revision", "rows", "row_schema", "next_cursor" ], "additionalProperties": false }, { "type": "object", "properties": { "record_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "evaluation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "orders" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchRow_orders" } }, "row_schema": { "type": "object" }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "record_id", "evaluation_id", "kind", "schema_revision", "rows", "row_schema", "next_cursor" ], "additionalProperties": false }, { "type": "object", "properties": { "record_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "evaluation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "fills" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchRow_fills" } }, "row_schema": { "type": "object" }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "record_id", "evaluation_id", "kind", "schema_revision", "rows", "row_schema", "next_cursor" ], "additionalProperties": false }, { "type": "object", "properties": { "record_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "evaluation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "nav" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchRow_nav" } }, "row_schema": { "type": "object" }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "record_id", "evaluation_id", "kind", "schema_revision", "rows", "row_schema", "next_cursor" ], "additionalProperties": false }, { "type": "object", "properties": { "record_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "evaluation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "trials" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchRow_trials" } }, "row_schema": { "type": "object" }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "record_id", "evaluation_id", "kind", "schema_revision", "rows", "row_schema", "next_cursor" ], "additionalProperties": false }, { "type": "object", "properties": { "record_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "evaluation_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "kind": { "type": "string", "enum": [ "exclusions" ] }, "schema_revision": { "type": "string", "enum": [ "1.0" ] }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchRow_exclusions" } }, "row_schema": { "type": "object" }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "record_id", "evaluation_id", "kind", "schema_revision", "rows", "row_schema", "next_cursor" ], "additionalProperties": false } ], "description": "Immutable, paginated evaluation records. row_schema is the corresponding self-contained JSON Schema supplied alongside these typed rows." }, "ResearchRow_predictions": { "type": "object", "properties": { "decision_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "origin_at": { "type": "string", "format": "date-time" }, "target": { "type": "string", "minLength": 1, "maxLength": 200 }, "horizon": { "$ref": "#/components/schemas/Horizon" }, "prediction_ref": { "type": "string", "minLength": 1, "maxLength": 200 }, "outcome_ref": { "type": [ "string", "null" ] } }, "required": [ "decision_id", "instrument_id", "origin_at", "target", "horizon", "prediction_ref", "outcome_ref" ], "additionalProperties": false }, "ResearchRow_orders": { "type": "object", "properties": { "order_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "decision_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "instrument_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "side": { "type": "string", "enum": [ "buy", "sell" ] }, "quantity": { "$ref": "#/components/schemas/Amount" }, "eligible_at": { "type": "string", "format": "date-time" }, "status": { "type": "string", "enum": [ "open", "partially_filled", "filled", "cancelled", "expired", "rejected" ] } }, "required": [ "order_id", "decision_id", "instrument_id", "side", "quantity", "eligible_at", "status" ], "additionalProperties": false }, "ResearchRow_fills": { "type": "object", "properties": { "fill_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "order_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "quantity": { "$ref": "#/components/schemas/Amount" }, "price": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "quote_asset": { "type": "string", "minLength": 1, "maxLength": 200 }, "fees": { "type": "array", "items": { "$ref": "#/components/schemas/Amount" } }, "executed_at": { "type": "string", "format": "date-time" } }, "required": [ "fill_id", "order_id", "quantity", "price", "quote_asset", "fees", "executed_at" ], "additionalProperties": false }, "ResearchRow_nav": { "type": "object", "properties": { "at": { "type": "string", "format": "date-time" }, "value": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "currency": { "type": "string", "minLength": 1, "maxLength": 200 }, "external_flow": { "type": "string", "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "costs_included": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "required": [ "at", "value", "currency", "external_flow", "costs_included" ], "additionalProperties": false }, "ResearchRow_trials": { "type": "object", "properties": { "trial_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "strategy_revision": { "type": "string", "minLength": 1, "maxLength": 200 }, "started_at": { "type": "string", "format": "date-time" }, "state": { "type": "string", "enum": [ "completed", "failed", "cancelled" ] }, "selection_metric": { "type": "string", "minLength": 1, "maxLength": 200 }, "metric_value": { "type": [ "number", "null" ] }, "selected": { "type": "boolean" } }, "required": [ "trial_id", "strategy_revision", "started_at", "state", "selection_metric", "metric_value", "selected" ], "additionalProperties": false }, "ResearchRow_exclusions": { "type": "object", "properties": { "decision_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "at": { "type": "string", "format": "date-time" }, "reason_code": { "type": "string", "minLength": 1, "maxLength": 200 }, "stage": { "type": "string", "enum": [ "data", "calculation", "policy", "execution" ] }, "evidence_refs": { "type": "array", "items": { "$ref": "#/components/schemas/EvidenceRef" } } }, "required": [ "decision_id", "at", "reason_code", "stage", "evidence_refs" ], "additionalProperties": false }, "MonitorSummary": { "type": "object", "properties": { "observed_at": { "type": "string", "format": "date-time" }, "source_age_seconds": { "type": [ "number", "null" ], "minimum": 0 }, "missing_required_sources": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "coverage_fraction": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "consecutive_failures": { "type": "integer", "minimum": 0 }, "baseline_loss_delta": { "type": [ "number", "null" ] } }, "required": [ "observed_at", "source_age_seconds", "missing_required_sources", "coverage_fraction", "consecutive_failures", "baseline_loss_delta" ], "additionalProperties": false }, "MonitorMatch": { "type": "object", "properties": { "condition": { "$ref": "#/components/schemas/MonitorCondition" }, "measured_value": { "type": "number" }, "response": { "type": "string", "enum": [ "alert", "pause" ] } }, "required": [ "condition", "measured_value", "response" ], "additionalProperties": false }, "MonitorRun": { "type": "object", "properties": { "run_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "monitor_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "monitor_revision": { "type": "integer", "minimum": 1 }, "job_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "summary": { "$ref": "#/components/schemas/MonitorSummary" }, "matched_conditions": { "type": "array", "items": { "$ref": "#/components/schemas/MonitorMatch" } } }, "required": [ "run_id", "monitor_id", "monitor_revision", "job_id", "summary", "matched_conditions" ], "additionalProperties": false }, "MonitorRunList": { "type": "object", "properties": { "schema_version": { "type": "string", "enum": [ "1.0" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/MonitorRun" } }, "next_cursor": { "type": [ "string", "null" ] } }, "required": [ "schema_version", "items", "next_cursor" ], "additionalProperties": false } } } }