{ "openapi": "3.1.0", "info": { "title": "Norynta Agent API", "version": "2026-03-17", "description": "Machine-readable contract for bot, agent, and trading-facing endpoints." }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "paths": { "/api/v1/aggregator/markets": { "get": { "operationId": "get_api_v1_aggregator_markets", "summary": "Venue-normalized public market feed for odds comparison, directories, terminals, and routing partners.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "source", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "category", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "q", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "tradableOnly", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AggregatorMarketsResponse" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events": { "get": { "operationId": "get_api_events", "summary": "List events with volume-sorted defaults and cursor pagination.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "slugs", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeEmptyV2", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeStale", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "staleDays", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ] } }, "/api/events/health": { "get": { "operationId": "get_api_events_health", "summary": "Health metrics for bots: volume, open orders, last trade time, tradability, and market quality.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeStale", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "staleDays", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "minVolumeUsd", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "minOpenOrders", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events/snapshots": { "post": { "operationId": "post_api_events_snapshots", "summary": "Bulk snapshots for many events.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "get": { "operationId": "get_api_events_snapshots", "summary": "Bulk snapshots for many events via query params.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "slugs", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "eventPubkeys", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events/bot-snapshot": { "post": { "operationId": "post_api_events_botsnapshot", "summary": "Bulk snapshots with ranking for bots.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/events/top": { "get": { "operationId": "get_api_events_top", "summary": "Ranked top markets for ops dashboards with tradability and market quality signals.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/data/market-intelligence": { "get": { "operationId": "get_api_data_marketintelligence", "summary": "Ranked aggregated market intelligence for partners, quants, and analytics consumers.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "competitive", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "minVolumeUsd", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ] } }, "/api/data/signals": { "get": { "operationId": "get_api_data_signals", "summary": "Premium derived trading signals built from Norynta liquidity, activity, and outcome-conviction analytics.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "minVolumeUsd", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "signalType", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ] } }, "/api/data/market-intelligence/history": { "get": { "operationId": "get_api_data_marketintelligence_history", "summary": "Premium historical time-series for a market outcome.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "slug", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeIndex", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "timeframe", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "metric", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ] } }, "/api/data/trades": { "get": { "operationId": "get_api_data_trades", "summary": "Normalized historical trade export by market or public wallet address.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "user", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "market", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "from", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "to", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "order", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ] } }, "/api/data/positions": { "get": { "operationId": "get_api_data_positions", "summary": "Normalized public wallet position export computed from public trade history.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "user", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "tradeLimit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ] } }, "/api/bot/config": { "get": { "operationId": "get_api_bot_config", "summary": "Recommended bot polling and guardrails.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BotConfigResponse" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/international/access": { "get": { "operationId": "get_api_international_access", "summary": "Return detected country source, read-only availability, real-money access booleans, and English-only language policy.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InternationalAccessResponse" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/sports/catalog": { "get": { "operationId": "get_api_sports_catalog", "summary": "Canonical sports and league catalog with resolution metadata for bots and agents.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/sports/feed": { "get": { "operationId": "get_api_sports_feed", "summary": "Normalized sports status/results with optional odds and line-history points.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "league", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sport", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "days", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeStale", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ] } }, "/api/sports/lines/history": { "get": { "operationId": "get_api_sports_lines_history", "summary": "Line/odds history points for graphing and bot analysis.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "sourceEventId", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "market", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/sports/metrics": { "get": { "operationId": "get_api_sports_metrics", "summary": "Aggregate sports data quality metrics (stale, confidence, review-required, outliers).", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "days", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sport", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "league", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/bot/quant": { "get": { "operationId": "get_api_bot_quant", "summary": "Compact targeted quant metrics for bot-selected markets and outcomes.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "slugs", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "eventPubkeys", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BotQuantResponse" } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ] }, "post": { "operationId": "post_api_bot_quant", "summary": "Compact targeted quant metrics for bot-selected markets and outcomes.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BotQuantResponse" } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/bot/strategies": { "get": { "operationId": "get_api_bot_strategies", "summary": "Strategy presets and ranked recommendations for target events.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "slugs", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "eventPubkeys", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } }, "post": { "operationId": "post_api_bot_strategies", "summary": "Strategy presets and ranked recommendations for target events.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/agent/access": { "get": { "operationId": "get_api_agent_access", "summary": "Authenticate agent API key and return discovery metadata.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentAccessResponse" } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ] } }, "/api/agent/card": { "get": { "operationId": "get_api_agent_card", "summary": "A2A-compatible agent card with capabilities and operation map.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/status": { "get": { "operationId": "get_api_v1_status", "summary": "Versioned API status, auth-split contract, idempotency policy, and contract version metadata.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/openapi.json": { "get": { "operationId": "get_api_v1_openapijson", "summary": "Versioned REST contract wrapper for the generated OpenAPI specification.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/asyncapi.json": { "get": { "operationId": "get_api_v1_asyncapijson", "summary": "Versioned streaming contract wrapper for the AsyncAPI specification.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/agent/access": { "get": { "operationId": "get_api_v1_agent_access", "summary": "Versioned alias for authenticated agent API key discovery metadata.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ] } }, "/api/v1/agent/tools": { "get": { "operationId": "get_api_v1_agent_tools", "summary": "Agent-native tool manifest for market discovery, trade validation, impact estimation, diagnostics, and failed-request remediation.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/sandbox/scenarios": { "get": { "operationId": "get_api_v1_sandbox_scenarios", "summary": "List sandbox certification scenarios, expected outcomes, and required bot behavior.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/sandbox/certification": { "post": { "operationId": "post_api_v1_sandbox_certification", "summary": "Submit sandbox scenario handling results and receive a production-review eligibility artifact. Requires Idempotency-Key.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/v1/streams/manifest": { "get": { "operationId": "get_api_v1_streams_manifest", "summary": "Streaming manifest with channel keys, sequence policy, replay policy, SSE compatibility, and WebSocket topics.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/streams/replay": { "get": { "operationId": "get_api_v1_streams_replay", "summary": "Replay contract for sequenced stream events. Returns snapshot-remediation guidance until persistent stream storage is enabled.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "channel", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "key", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "afterSequence", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/events": { "get": { "operationId": "get_api_v1_events", "summary": "Versioned market event discovery surface.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ] } }, "/api/v1/markets": { "get": { "operationId": "get_api_v1_markets", "summary": "Versioned market discovery surface.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ] } }, "/api/v1/markets/{id}": { "get": { "operationId": "get_api_v1_markets_id", "summary": "Versioned market detail alias by slug or event public key.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/markets/{id}/orderbook": { "get": { "operationId": "get_api_v1_markets_id_orderbook", "summary": "Versioned market orderbook alias.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeIndex", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "depth", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/markets/{id}/trades": { "get": { "operationId": "get_api_v1_markets_id_trades", "summary": "Versioned market trade/activity history alias.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/markets/{id}/history": { "get": { "operationId": "get_api_v1_markets_id_history", "summary": "Versioned market history/candles alias.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/markets/{id}/health": { "get": { "operationId": "get_api_v1_markets_id_health", "summary": "Versioned market health alias.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/orders/prepare": { "post": { "operationId": "post_api_v1_orders_prepare", "summary": "Prepare canonical unsigned Solana Ed25519 order bytes for a caller-controlled wallet. Requires Idempotency-Key and does not execute.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/v1/orders/validate": { "post": { "operationId": "post_api_v1_orders_validate", "summary": "Validate a signed or sandbox trade payload without execution. Requires Idempotency-Key.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/v1/orders/estimate-impact": { "post": { "operationId": "post_api_v1_orders_estimateimpact", "summary": "Estimate trade depth, slippage, and risk-policy fit before execution. Requires Idempotency-Key.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/v1/orders": { "post": { "operationId": "post_api_v1_orders", "summary": "Postponed legacy real-money endpoint. Play mode returns REAL_MONEY_POSTPONED; use /api/v1/paper/orders.", "deprecated": true, "x-norynta-product-mode": "real_money_postponed", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "423": { "description": "Real-money behavior is postponed. Use the virtual-credit play endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "get": { "operationId": "get_api_v1_orders", "summary": "Versioned order listing alias.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } }, "delete": { "operationId": "delete_api_v1_orders", "summary": "Versioned signed multi-order cancel alias. Requires Idempotency-Key.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/v1/orders/batch": { "post": { "operationId": "post_api_v1_orders_batch", "summary": "Postponed legacy real-money endpoint. Play mode returns REAL_MONEY_POSTPONED; use /api/v1/paper/orders.", "deprecated": true, "x-norynta-product-mode": "real_money_postponed", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing, malformed, or invalid agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "Authenticated agent credential lacks endpoint entitlement", "headers": { "WWW-Authenticate": { "description": "Bearer insufficient-scope challenge metadata", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "423": { "description": "Real-money behavior is postponed. Use the virtual-credit play endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/v1/orders/{id}": { "get": { "operationId": "get_api_v1_orders_id", "summary": "Versioned order lookup alias.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } }, "delete": { "operationId": "delete_api_v1_orders_id", "summary": "Versioned signed single-order cancel alias. Requires Idempotency-Key and returns canceled=false when the order is already filled or closed.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/v1/account/balance": { "get": { "operationId": "get_api_v1_account_balance", "summary": "Versioned signed account balance alias.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/account/positions": { "get": { "operationId": "get_api_v1_account_positions", "summary": "Versioned account positions alias.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/account/fills": { "get": { "operationId": "get_api_v1_account_fills", "summary": "Versioned account fills alias.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/account/transactions": { "get": { "operationId": "get_api_v1_account_transactions", "summary": "Versioned account transactions alias.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/account/limits": { "get": { "operationId": "get_api_v1_account_limits", "summary": "Versioned account limits alias.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/developer/request-logs": { "get": { "operationId": "get_api_v1_developer_requestlogs", "summary": "Developer request log contract with redacted secrets, idempotency key hashes, status, latency, and error codes.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/developer/latency": { "get": { "operationId": "get_api_v1_developer_latency", "summary": "Developer latency dashboard contract with request, validation, match-engine, and blockchain timing percentiles.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/developer/endpoint-costs": { "get": { "operationId": "get_api_v1_developer_endpointcosts", "summary": "Developer endpoint cost and quota unit matrix.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/developer/diagnostics": { "get": { "operationId": "get_api_v1_developer_diagnostics", "summary": "Versioned developer-console readiness checks, quota diagnostics, entitlement hints, and webhook availability status.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid authenticated user session", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "sessionCookieAuth": [] } ] } }, "/api/v1/developer/explain-error": { "post": { "operationId": "post_api_v1_developer_explainerror", "summary": "Map request IDs or machine-readable error codes to retryability and remediation guidance.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/developer/diagnostics": { "get": { "operationId": "get_api_developer_diagnostics", "summary": "Authenticated developer-console readiness checks, quota diagnostics, entitlement hints, and webhook availability status.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid authenticated user session", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "sessionCookieAuth": [] } ] } }, "/.well-known/agent.json": { "get": { "operationId": "get_wellknown_agentjson", "summary": "Well-known A2A card endpoint for agent discovery.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/search": { "get": { "operationId": "get_api_search", "summary": "Machine-friendly keyword lookup for events.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "q", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ] } }, "/api/fees/estimate": { "get": { "operationId": "get_api_fees_estimate", "summary": "Estimate taker, maker, protocol, treasury, and effective fee impact for a prospective trade.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "notionalUsd", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "side", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "userTier", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "maker", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/treasury/fee-config": { "get": { "operationId": "get_api_treasury_feeconfig", "summary": "Return the public trading fee configuration and treasury policy metadata.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/rate-limits": { "get": { "operationId": "get_api_ratelimits", "summary": "Return public API rate-limit tiers and discovery metadata.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/markets/policy": { "get": { "operationId": "get_api_markets_policy", "summary": "Return public market-creation policy, prohibited-content rules, and readiness metadata.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/users/{id}/deposit-address": { "get": { "operationId": "get_api_users_id_depositaddress", "summary": "Resolve deterministic user deposit vault address.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/users/{id}/deposits": { "get": { "operationId": "get_api_users_id_deposits", "summary": "List authenticated user's tracked deposits.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/users/{id}/fiat-deposit-intents": { "post": { "operationId": "post_api_users_id_fiatdepositintents", "summary": "Postponed legacy real-money endpoint. Play mode returns REAL_MONEY_POSTPONED; use /api/v1/paper/orders.", "deprecated": true, "x-norynta-product-mode": "real_money_postponed", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "423": { "description": "Real-money behavior is postponed. Use the virtual-credit play endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/users/{id}/fiat-transfers": { "get": { "operationId": "get_api_users_id_fiattransfers", "summary": "List signed provider-backed fiat deposit and withdrawal transfer status without beneficiary tokens or provider metadata.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "direction", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "status", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/users/{id}/withdrawals": { "get": { "operationId": "get_api_users_id_withdrawals", "summary": "List authenticated user's tracked withdrawals.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } }, "post": { "operationId": "post_api_users_id_withdrawals", "summary": "Track an authenticated user withdrawal transaction.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/users/{id}/trades": { "get": { "operationId": "get_api_users_id_trades", "summary": "List authenticated user's trade history.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/users/{id}/positions": { "get": { "operationId": "get_api_users_id_positions", "summary": "List authenticated user's open and resolved positions.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/account/balance": { "get": { "operationId": "get_api_account_balance", "summary": "Read signed account cash balance summary for a public key.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "publicKey", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "nonce", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "domain", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cluster", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "expiresAt", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/account/transactions": { "get": { "operationId": "get_api_account_transactions", "summary": "Read signed account transaction feed for a public key.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "publicKey", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "nonce", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "domain", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "cluster", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "expiresAt", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/users/{id}/fiat-withdrawal-beneficiaries/stripe-connect": { "post": { "operationId": "post_api_users_id_fiatwithdrawalbeneficiaries_stripeconnect", "summary": "Start signed Stripe Connect onboarding for a tokenized US fiat withdrawal beneficiary without accepting raw bank details.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/users/{id}/fiat-withdrawal-requests": { "post": { "operationId": "post_api_users_id_fiatwithdrawalrequests", "summary": "Create a signed US fiat withdrawal request using a provider beneficiary token.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/bridge/supported-assets": { "get": { "operationId": "get_api_bridge_supportedassets", "summary": "List allowed bridge assets and destination routing metadata.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "originChainId", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "destinationChainId", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/bridge/users/{id}/deposit-address": { "get": { "operationId": "get_api_bridge_users_id_depositaddress", "summary": "Get bridge deposit address and quote steps for a user.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "chain", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "asset", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "tokenAddress", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/bridge/users/{id}/withdraw-address": { "get": { "operationId": "get_api_bridge_users_id_withdrawaddress", "summary": "Get bridge withdraw execution address for a user.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "chain", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "asset", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "recipient", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "tokenAddress", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/moonpay/signed-url": { "get": { "operationId": "get_api_moonpay_signedurl", "summary": "Create signed third-party onramp URL.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "walletAddress", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "baseCurrencyCode", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "baseCurrencyAmount", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "externalTransactionId", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/deposit-options": { "get": { "operationId": "get_api_depositoptions", "summary": "List fiat onramp and transfer deposit options for user locale.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events/health-snapshots": { "post": { "operationId": "post_api_events_healthsnapshots", "summary": "Combined health + snapshots for bots.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "healthLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "minVolumeUsd", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "minOpenOrders", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "get": { "operationId": "get_api_events_healthsnapshots", "summary": "Combined health + snapshots for bots (cacheable).", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "slugs", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "eventPubkeys", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "healthLimit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "minVolumeUsd", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "minOpenOrders", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events/{slug}/activity": { "get": { "operationId": "get_api_events_slug_activity", "summary": "Recent trades for an event.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "slug", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events/{slug}/health": { "get": { "operationId": "get_api_events_slug_health", "summary": "Health metrics for a single event, including tradability and market quality.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "slug", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeStale", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "staleDays", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events/{slug}/stream": { "get": { "operationId": "get_api_events_slug_stream", "summary": "SSE stream of trades and optional orderbook top-of-book.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "slug", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "intervalMs", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeOrderbook", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeIndex", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "since", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events/{slug}/snapshot": { "get": { "operationId": "get_api_events_slug_snapshot", "summary": "Unified bot snapshot with health, best bid/ask for outcomes, tradability, and market quality.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "slug", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "lookbackHours", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "includeResolved", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeLimit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/events/{slug}/orderbook/stream": { "get": { "operationId": "get_api_events_slug_orderbook_stream", "summary": "SSE stream with full orderbook snapshots and deltas for one outcome.", "tags": [ "Agent API" ], "parameters": [ { "in": "path", "name": "slug", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeIndex", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "intervalMs", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "snapshotEvery", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/clob/v2/orderbook": { "get": { "operationId": "get_api_clob_v2_orderbook", "summary": "Top-of-book for a specific event outcome.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "eventPubkey", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeIndex", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "depth", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/clob/v2/orders": { "post": { "operationId": "post_api_clob_v2_orders", "summary": "Postponed legacy real-money endpoint. Play mode returns REAL_MONEY_POSTPONED; use /api/v1/paper/orders.", "deprecated": true, "x-norynta-product-mode": "real_money_postponed", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "423": { "description": "Real-money behavior is postponed. Use the virtual-credit play endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "delete_api_clob_v2_orders", "summary": "Cancel one or many signed orders by id.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/orders/batch": { "post": { "operationId": "post_api_clob_v2_orders_batch", "summary": "Postponed legacy real-money endpoint. Play mode returns REAL_MONEY_POSTPONED; use /api/v1/paper/orders.", "deprecated": true, "x-norynta-product-mode": "real_money_postponed", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "423": { "description": "Real-money behavior is postponed. Use the virtual-credit play endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/cancel": { "post": { "operationId": "post_api_clob_v2_cancel", "summary": "Cancel one open signed order remainder. Returns canceled=false when the order is already filled or closed.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/cancel-all": { "post": { "operationId": "post_api_clob_v2_cancelall", "summary": "Set per-user min nonce and cancel older open orders.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "delete_api_clob_v2_cancelall", "summary": "Cancel all currently open signed orders for a user.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/cancel-market-orders": { "delete": { "operationId": "delete_api_clob_v2_cancelmarketorders", "summary": "Cancel open signed orders for a market or market outcome.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/rfq/quote": { "post": { "operationId": "post_api_clob_v2_rfq_quote", "summary": "Postponed legacy real-money endpoint. Play mode returns REAL_MONEY_POSTPONED; use /api/v1/paper/orders.", "deprecated": true, "x-norynta-product-mode": "real_money_postponed", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "423": { "description": "Real-money behavior is postponed. Use the virtual-credit play endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/rfq/accept": { "post": { "operationId": "post_api_clob_v2_rfq_accept", "summary": "Postponed legacy real-money endpoint. Play mode returns REAL_MONEY_POSTPONED; use /api/v1/paper/orders.", "deprecated": true, "x-norynta-product-mode": "real_money_postponed", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "423": { "description": "Real-money behavior is postponed. Use the virtual-credit play endpoint.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/rfq/network": { "get": { "operationId": "get_api_clob_v2_rfq_network", "summary": "Return public RFQ network configuration, routing limits, and maker eligibility hints.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/clob/v2/simulate": { "post": { "operationId": "post_api_clob_v2_simulate", "summary": "Disabled order simulation endpoint. Returns 410 SIMULATION_DISABLED.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/my-orders": { "post": { "operationId": "post_api_clob_v2_myorders", "summary": "List authenticated user's open signed orders.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Malformed or invalid optional agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] }, {} ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/clob/v2/data/orders": { "get": { "operationId": "get_api_clob_v2_data_orders", "summary": "Query order records by id, market, or owner filters.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "id", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "market", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "owner", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "asset_id", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcomeIndex", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "outcome_index", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/clob/v2/order-scoring": { "get": { "operationId": "get_api_clob_v2_orderscoring", "summary": "Get scoring data for one order.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "order_id", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "orderId", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/clob/v2/orders-scoring": { "post": { "operationId": "post_api_clob_v2_ordersscoring", "summary": "Get scoring data for many orders.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/api/admin/ledger/by-source": { "get": { "operationId": "get_api_admin_ledger_bysource", "summary": "Admin ledger drilldown by sourceType/sourceId.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "sourceType", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sourceId", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/admin/ledger/failures": { "get": { "operationId": "get_api_admin_ledger_failures", "summary": "Admin ledger posting failure feed with optional filters.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sourceType", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "sourceId", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "action", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "component", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "unresolved", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/admin/reconciliation/banking": { "get": { "operationId": "get_api_admin_reconciliation_banking", "summary": "Admin banking reconciliation mismatch summary.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "since", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/v1/paper/orders": { "get": { "operationId": "get_api_v1_paper_orders", "summary": "List the authenticated user or agent's virtual positions and Norynta Credits summary. Credits have no cash value.", "tags": [ "Agent API" ], "parameters": [ { "in": "query", "name": "status", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid authenticated user session or agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "sessionCookieAuth": [] }, { "bearerAuth": [] }, { "apiKeyAuth": [] } ] }, "post": { "operationId": "post_api_v1_paper_orders", "summary": "Open or close an idempotent virtual-credit position using observed market data. Never moves wallet funds.", "tags": [ "Agent API" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid authenticated user session or agent credential", "headers": { "WWW-Authenticate": { "description": "Bearer authentication challenge. Prefer Authorization: Bearer ; x-api-key remains supported for backward compatibility.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "default": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "security": [ { "sessionCookieAuth": [] }, { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "opaque-or-jwt", "description": "Preferred agent authentication. Use Authorization: Bearer ." }, "apiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Legacy/backward-compatible agent credential header." }, "sessionCookieAuth": { "type": "apiKey", "in": "cookie", "name": "sb-access-token", "description": "Authenticated app session cookie for private developer-console endpoints." } }, "schemas": { "AggregatorMarketsResponse": { "type": "object", "required": [ "schemaVersion", "venue", "markets", "nextCursor", "meta" ], "properties": { "schemaVersion": { "type": "string" }, "venue": { "type": "object", "required": [ "id", "name", "chain", "collateral", "homepage" ], "properties": { "id": { "type": "string", "const": "norynta" }, "name": { "type": "string" }, "chain": { "type": "string", "const": "solana" }, "collateral": { "type": "string", "const": "USDC" }, "homepage": { "type": "string", "format": "uri" } }, "additionalProperties": false }, "markets": { "type": "array", "items": { "type": "object", "required": [ "venue", "id", "slug", "title", "marketType", "status", "outcomes", "volume", "liquidity", "rules", "matching", "urls", "observedAt" ], "properties": { "venue": { "type": "string", "const": "norynta" }, "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "category": { "type": [ "string", "null" ] }, "marketType": { "type": "string", "enum": [ "binary", "categorical", "scalar_range" ] }, "status": { "type": "string" }, "createdAt": { "type": [ "string", "null" ] }, "closesAt": { "type": [ "string", "null" ] }, "outcomes": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "volume": { "type": "object", "required": [ "reportedUsd", "scope" ], "properties": { "reportedUsd": { "type": "number", "minimum": 0 }, "scope": { "type": "string", "const": "bounded_sample" } }, "additionalProperties": false }, "liquidity": { "type": "object", "additionalProperties": true }, "rules": { "type": "object", "additionalProperties": true }, "matching": { "type": "object", "additionalProperties": true }, "urls": { "type": "object", "additionalProperties": true }, "observedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": true } }, "nextCursor": { "type": [ "string", "null" ] }, "meta": { "type": "object", "additionalProperties": true } }, "additionalProperties": false }, "MarketStructure": { "oneOf": [ { "$ref": "#/components/schemas/BinaryMarketStructure" }, { "$ref": "#/components/schemas/CategoricalMarketStructure" }, { "$ref": "#/components/schemas/ScalarRangeMarketStructure" } ] }, "BinaryMarketStructure": { "type": "object", "required": [ "kind", "categorical" ], "properties": { "kind": { "type": "string", "const": "binary" }, "categorical": { "type": "object", "properties": { "probabilitySumTarget": { "type": "integer", "default": 1000000 } }, "additionalProperties": true } }, "additionalProperties": true }, "CategoricalMarketStructure": { "type": "object", "required": [ "kind", "categorical" ], "properties": { "kind": { "type": "string", "const": "categorical" }, "categorical": { "type": "object", "properties": { "probabilitySumTarget": { "type": "integer", "default": 1000000 } }, "additionalProperties": true } }, "additionalProperties": true }, "ScalarRangeBucket": { "type": "object", "required": [ "index", "min", "max", "minInclusive", "maxInclusive", "label" ], "properties": { "index": { "type": "integer", "minimum": 0 }, "min": { "type": "number" }, "max": { "type": "number" }, "minInclusive": { "type": "boolean" }, "maxInclusive": { "type": "boolean" }, "label": { "type": "string" } }, "additionalProperties": true }, "ScalarRangeMarketStructure": { "type": "object", "required": [ "kind", "scalarRange" ], "properties": { "kind": { "type": "string", "const": "scalar_range" }, "scalarRange": { "type": "object", "required": [ "min", "max", "precision", "payoutStyle", "observationSource", "buckets" ], "properties": { "unit": { "type": [ "string", "null" ] }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "integer", "minimum": 0, "maximum": 8 }, "payoutStyle": { "type": "string", "enum": [ "winner_take_bucket", "linear_interpolation" ] }, "observationSource": { "type": "string" }, "buckets": { "type": "array", "minItems": 2, "maxItems": 64, "items": { "$ref": "#/components/schemas/ScalarRangeBucket" } } }, "additionalProperties": true } }, "additionalProperties": true }, "AgentApiKeyAuth": { "type": "object", "required": [ "enabled", "keyId", "header", "bearerSupported" ], "properties": { "enabled": { "type": "boolean" }, "keyId": { "type": [ "string", "null" ] }, "header": { "type": "string" }, "bearerSupported": { "type": "boolean" }, "preferredAuthorizationScheme": { "type": "string" }, "hashingSupported": { "type": "boolean" }, "hashedKeyCount": { "type": [ "number", "null" ] }, "scopes": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "AgentProfile": { "type": "object", "properties": { "operatorName": { "type": [ "string", "null" ] }, "strategyType": { "type": [ "string", "null" ] }, "riskTier": { "type": [ "string", "null" ] }, "feeTier": { "type": [ "string", "null" ] } }, "additionalProperties": true }, "AgentQuotaProfile": { "type": "object", "properties": { "readsPerMinute": { "type": [ "number", "null" ] }, "writesPerMinute": { "type": [ "number", "null" ] }, "burst": { "type": [ "number", "null" ] }, "windowSeconds": { "type": [ "number", "null" ] } }, "additionalProperties": true }, "AgentPolicy": { "type": "object", "properties": { "scopes": { "type": "array", "items": { "type": "string" } }, "allowedEndpoints": { "type": "array", "items": { "type": "string" } }, "allowedProducts": { "type": "array", "items": { "type": "string" } }, "features": { "type": "array", "items": { "type": "string" } }, "quotaProfile": { "$ref": "#/components/schemas/AgentQuotaProfile" } }, "additionalProperties": true }, "AgentMetadata": { "type": "object", "required": [ "keyId", "customerId", "plan", "rateTier", "delaySeconds", "profile", "policy" ], "properties": { "keyId": { "type": [ "string", "null" ] }, "customerId": { "type": [ "string", "null" ] }, "plan": { "type": [ "string", "null" ] }, "rateTier": { "type": [ "string", "null" ] }, "delaySeconds": { "type": "number" }, "scopes": { "type": "array", "items": { "type": "string" } }, "profile": { "$ref": "#/components/schemas/AgentProfile" }, "policy": { "$ref": "#/components/schemas/AgentPolicy" } }, "additionalProperties": true }, "AgentAccessResponse": { "type": "object", "required": [ "ok", "authenticated", "apiKey" ], "properties": { "ok": { "type": "boolean" }, "authenticated": { "type": "boolean" }, "apiKey": { "$ref": "#/components/schemas/AgentApiKeyAuth" }, "agent": { "oneOf": [ { "$ref": "#/components/schemas/AgentMetadata" }, { "type": "null" } ] }, "sdk": { "type": "object", "additionalProperties": true }, "mcp": { "type": [ "array", "object" ], "items": { "type": "string" }, "additionalProperties": true }, "mcpServers": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "endpoints": { "type": "object", "additionalProperties": true }, "discovery": { "type": "object", "additionalProperties": true }, "protocols": { "type": "object", "additionalProperties": true }, "execution": { "type": "object", "additionalProperties": true }, "payments": { "type": "object", "additionalProperties": true } }, "additionalProperties": true }, "BotConfigAuthApiKey": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "requiredWhenEnabled": { "type": "boolean" }, "header": { "type": "string" }, "bearerSupported": { "type": "boolean" }, "preferredAuthorizationScheme": { "type": "string" }, "hashingSupported": { "type": "boolean" }, "hashedKeyCount": { "type": "number" }, "scopes": { "type": "array", "items": { "type": "string" } }, "profileFields": { "type": "array", "items": { "type": "string" } }, "policyFields": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "BotConfigAgentIdentity": { "type": "object", "properties": { "supported": { "type": "boolean" }, "profile": { "type": "object", "properties": { "fields": { "type": "array", "items": { "type": "string" } }, "knownStrategyTypes": { "type": "array", "items": { "type": "string" } }, "knownRiskTiers": { "type": "array", "items": { "type": "string" } }, "knownFeeTiers": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "policy": { "type": "object", "properties": { "fields": { "type": "array", "items": { "type": "string" } }, "knownScopes": { "type": "array", "items": { "type": "string" } }, "knownFeatures": { "type": "array", "items": { "type": "string" } }, "quotaProfile": { "type": "object", "properties": { "fields": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true } }, "additionalProperties": true } }, "additionalProperties": true }, "BotConfigDocument": { "type": "object", "properties": { "auth": { "type": "object", "properties": { "apiKey": { "$ref": "#/components/schemas/BotConfigAuthApiKey" } }, "additionalProperties": true }, "agentIdentity": { "$ref": "#/components/schemas/BotConfigAgentIdentity" } }, "additionalProperties": true }, "BotConfigResponse": { "type": "object", "required": [ "ok", "config", "signature", "signedAt", "signatureVersion" ], "properties": { "ok": { "type": "boolean" }, "config": { "$ref": "#/components/schemas/BotConfigDocument" }, "signature": { "type": [ "string", "null" ] }, "signedAt": { "type": [ "string", "null" ] }, "signatureVersion": { "type": "string" } }, "additionalProperties": true }, "BotQuantDepthBand": { "type": "object", "required": [ "1_25", "26_50", "51_75", "76_99" ], "properties": { "1_25": { "type": "number" }, "26_50": { "type": "number" }, "51_75": { "type": "number" }, "76_99": { "type": "number" } }, "additionalProperties": false }, "BotQuantOutcomeLiquidity": { "type": "object", "required": [ "depthShares", "bidDepthShares", "askDepthShares", "depthByPriceBand" ], "properties": { "depthShares": { "type": "number" }, "bidDepthShares": { "type": "number" }, "askDepthShares": { "type": "number" }, "depthByPriceBand": { "type": "object", "required": [ "bid", "ask" ], "properties": { "bid": { "$ref": "#/components/schemas/BotQuantDepthBand" }, "ask": { "$ref": "#/components/schemas/BotQuantDepthBand" } }, "additionalProperties": false } }, "additionalProperties": true }, "BotQuantOutcome": { "type": "object", "required": [ "outcomeIndex", "bestBid", "bestAsk", "spreadCents", "midpointCents", "impliedProbability", "marketState", "hasTwoSidedBook", "liquidity" ], "properties": { "outcomeIndex": { "type": "integer", "minimum": 0 }, "range": { "oneOf": [ { "$ref": "#/components/schemas/ScalarRangeBucket" }, { "type": "null" } ] }, "bestBid": { "type": [ "number", "null" ] }, "bestAsk": { "type": [ "number", "null" ] }, "spreadCents": { "type": [ "number", "null" ] }, "midpointCents": { "type": [ "number", "null" ] }, "impliedProbability": { "type": [ "number", "null" ] }, "marketState": { "type": "string", "enum": [ "empty", "one-sided", "normal", "locked", "crossed" ] }, "hasTwoSidedBook": { "type": "boolean" }, "liquidity": { "$ref": "#/components/schemas/BotQuantOutcomeLiquidity" } }, "additionalProperties": true }, "BotQuantMarketMetrics": { "type": "object", "required": [ "outcomeCount", "twoSidedOutcomeCount", "averageSpreadCents", "averageMidpointCents", "totalDepthShares", "staleBookAgeSeconds", "topOfBookHash" ], "properties": { "outcomeCount": { "type": "integer", "minimum": 0 }, "twoSidedOutcomeCount": { "type": "integer", "minimum": 0 }, "averageSpreadCents": { "type": [ "number", "null" ] }, "averageMidpointCents": { "type": [ "number", "null" ] }, "totalDepthShares": { "type": "number" }, "staleBookAgeSeconds": { "type": [ "integer", "null" ], "minimum": 0 }, "topOfBookHash": { "type": "string" } }, "additionalProperties": true }, "BotQuantMarket": { "type": "object", "required": [ "slug", "eventPubkey", "endTimestamp", "resolved", "volumeUsd", "openOrders", "lastTradeAt", "marketQuality", "metrics", "outcomes" ], "properties": { "slug": { "type": "string" }, "eventPubkey": { "type": "string" }, "endTimestamp": { "type": [ "number", "null" ] }, "resolved": { "type": "boolean" }, "volumeUsd": { "type": "number" }, "openOrders": { "type": "integer", "minimum": 0 }, "lastTradeAt": { "type": [ "string", "null" ] }, "marketQuality": { "oneOf": [ { "type": "object", "additionalProperties": true }, { "type": "null" } ] }, "metrics": { "$ref": "#/components/schemas/BotQuantMarketMetrics" }, "outcomes": { "type": "array", "items": { "$ref": "#/components/schemas/BotQuantOutcome" } } }, "additionalProperties": true }, "BotQuantResponse": { "type": "object", "required": [ "ok", "schemaVersion", "generatedAt", "lookbackHours", "hash", "markets" ], "properties": { "ok": { "type": "boolean" }, "schemaVersion": { "type": "string" }, "generatedAt": { "type": "string" }, "lookbackHours": { "type": "integer" }, "hash": { "type": "string" }, "markets": { "type": "array", "items": { "$ref": "#/components/schemas/BotQuantMarket" } } }, "additionalProperties": true }, "ApiError": { "type": "object", "required": [ "ok", "error", "message", "code", "retryable" ], "properties": { "ok": { "type": "boolean", "const": false }, "error": { "type": "string" }, "message": { "type": "string" }, "code": { "type": "string" }, "retryable": { "type": "boolean" }, "hint": { "type": [ "string", "null" ] } }, "additionalProperties": true } } } }