{"openapi": "3.0.3", "info": {"title": "POKT Settlement Agent", "version": "0.1.0", "description": "What a Pocket supplier was actually paid for a bounded block range, per service, with per-event evidence. Public chain data only; no estimates, prices or costs."}, "servers": [{"url": "https://pokt-agent.com"}], "paths": {"/v1/version": {"get": {"summary": "Identity", "responses": {"200": {"description": "service id and version"}}}}, "/v1/health": {"get": {"summary": "Readiness", "responses": {"200": {"description": "{status: ok}"}}}}, "/v1/settlement": {"post": {"summary": "Settlement question", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["operator_address"], "properties": {"question": {"type": "string", "example": "이 구간 얼마 벌었어?"}, "operator_address": {"type": "string", "pattern": "^pokt1[02-9ac-hj-np-z]{38}$"}, "from_height": {"type": "integer"}, "to_height": {"type": "integer"}, "hours": {"type": "integer", "description": "used when no explicit range (default 24, max ~3000 blocks)"}}}}}}, "responses": {"200": {"description": "answer with status, intent, facts, evidence[], answer (lang), answer_ko"}, "400": {"description": "bad request"}, "503": {"description": "chain unavailable"}}}}, "/v1/supplier/{operator}/economics": {"get": {"summary": "One supplier's stake, share of network stake, 24h/7d/30d settlements by service, observed yield (not a forecast)", "parameters": [{"name": "operator", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^pokt1[02-9ac-hj-np-z]{38}$"}}], "responses": {"200": {"description": "pokt-supplier-economics/v1 JSON object"}}}}, "/v1/network/suppliers": {"get": {"summary": "Network-wide supplier stake (total, 7d/30d change, 60d series), settlement volume and observed network-average yield", "responses": {"200": {"description": "pokt-network-economics/v1 JSON object"}}}}, "/v1/supplier/{operator}/ops": {"get": {"summary": "Operator watch: has anything happened that could stop or change income, and what to check first", "parameters": [{"name": "operator", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^pokt1[02-9ac-hj-np-z]{38}$"}}, {"name": "min_fee_upokt", "in": "query", "schema": {"type": "integer", "default": 1000000}, "description": "your gas-balance warning threshold"}, {"name": "hours", "in": "query", "schema": {"type": "integer", "default": 24, "maximum": 720}}], "responses": {"200": {"description": "pokt-operator-watch/v1: facts (head, stake, balance, last settlement, pending claims/proofs), config_changes[] with activation heights, gap_classification, judgments{} booleans, check_first[], not_verified[]"}}}}}}