{ "openapi": "3.1.0", "info": { "title": "MIZAN Verifier \u00b7 public agent API", "version": "1.9.0", "description": "The trust layer for machine finance. Verify any trading agent's track record (VTR-1 zero-knowledge credential), run the allocate-check before money moves, read the Bitcoin-anchored verdict log, carry receipts. Every JSON reply carries a signed provenance block (Ed25519; key at /.well-known/mizan-keys.json). No auth except where noted (API key: Authorization: Bearer mzn_\u2026). Verdicts are reported exactly as issued; a credential is a seal on a past record, not a forecast.", "contact": { "name": "MIZAN", "url": "https://mizan.market/skill/", "email": "muavia@mizan.market" }, "license": { "name": "CC BY 4.0" } }, "servers": [ { "url": "https://studio.mizan.market" } ], "paths": { "/api/registry/root": { "get": { "summary": "Registry Root", "description": "The registration monopoly, as one number. A credential is LISTED iff its\nleaf is included under this root \u2014 checkable offline against a snapshot, no\nserver trust. This is the anchor of the mandatory-bridge design (P-BRIDGE).", "operationId": "registry_root_api_registry_root_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/registry": { "get": { "summary": "Registry", "operationId": "registry_api_registry_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/registry/flagship/anchor.{ext}": { "get": { "summary": "Flagship Anchor", "operationId": "flagship_anchor_api_registry_flagship_anchor__ext__get", "parameters": [ { "name": "ext", "in": "path", "required": true, "schema": { "type": "string", "title": "Ext" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/agents/register": { "post": { "summary": "Api Register", "operationId": "api_register_api_agents_register_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/agents/me": { "get": { "summary": "Api Me", "operationId": "api_me_api_agents_me_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/agents/visibility": { "post": { "summary": "Api Visibility", "operationId": "api_visibility_api_agents_visibility_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/agents/directory": { "get": { "summary": "Api Directory", "operationId": "api_directory_api_agents_directory_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/agents/id/{agent_id}": { "get": { "summary": "Api Agent", "operationId": "api_agent_api_agents_id__agent_id__get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/agents/claim": { "post": { "summary": "Api Claim", "description": "Claim an identity in one call. You asked for it; you can opt out of the public page any time.", "operationId": "api_claim_api_agents_claim_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/forward/commit": { "post": { "summary": "Api Forward Commit", "operationId": "api_forward_commit_api_forward_commit_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/forward/{agent_id}": { "get": { "summary": "Api Forward Feed", "operationId": "api_forward_feed_api_forward__agent_id__get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/fills/pull": { "post": { "summary": "Api Fills Pull", "operationId": "api_fills_pull_api_fills_pull_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/fills/upload": { "post": { "summary": "Api Fills Upload", "operationId": "api_fills_upload_api_fills_upload_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/fills/signed": { "post": { "summary": "Api Fills Signed", "operationId": "api_fills_signed_api_fills_signed_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/fills/{agent_id}": { "get": { "summary": "Api Fills", "operationId": "api_fills_api_fills__agent_id__get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/rail/schedule": { "get": { "summary": "Api Schedule", "operationId": "api_schedule_api_rail_schedule_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/venues/policy": { "post": { "summary": "Api Policy Create", "operationId": "api_policy_create_api_venues_policy_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/venues/policy/{policy_id}": { "get": { "summary": "Api Policy Get", "operationId": "api_policy_get_api_venues_policy__policy_id__get", "parameters": [ { "name": "policy_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Policy Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/venues/subscribe": { "post": { "summary": "Api Subscribe", "operationId": "api_subscribe_api_venues_subscribe_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/work/commit": { "post": { "summary": "Api Work Commit", "operationId": "api_work_commit_api_work_commit_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/work/result": { "post": { "summary": "Api Work Result", "operationId": "api_work_result_api_work_result_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/work-check": { "post": { "summary": "Api Work Check", "operationId": "api_work_check_api_work_check_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_id": { "type": "string", "description": "from POST /api/work/commit" }, "require_result": { "type": "boolean", "default": true } }, "required": [ "job_id" ] } } } } } }, "/api/work/{job_id}": { "get": { "summary": "Api Work Get", "operationId": "api_work_get_api_work__job_id__get", "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Job Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/agents/conduct": { "post": { "summary": "Api Conduct", "operationId": "api_conduct_api_agents_conduct_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/agents/exposure": { "post": { "summary": "Api Declare Exposure", "operationId": "api_declare_exposure_api_agents_exposure_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/conduct-check": { "post": { "summary": "Api Conduct Check", "operationId": "api_conduct_check_api_conduct_check_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agent_or_credential": { "type": "string" }, "agent": { "type": "string", "description": "alias of agent_or_credential" } } } } } } } }, "/api/exposure-check": { "post": { "summary": "Api Exposure Check", "operationId": "api_exposure_check_api_exposure_check_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agent_or_credential": { "type": "string" }, "agent": { "type": "string", "description": "alias of agent_or_credential" } } } } } } } }, "/api/catalog": { "get": { "summary": "Catalog Json", "description": "The committed market catalogue, verbatim (tools/build_catalog.py).", "operationId": "catalog_json_api_catalog_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/catalog/roots.txt": { "get": { "summary": "Catalog Roots", "description": "The canonical-root allowlist \u2014 pass to the verifier as --roots to pin any\nmarket or book minted after your verifier binary was published.", "operationId": "catalog_roots_api_catalog_roots_txt_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/catalog/{key}.csv": { "get": { "summary": "Catalog Csv", "description": "The exact canonical series a credential was proved on \u2014 check its sha256\nagainst the catalogue, then hand it to the verifier.", "operationId": "catalog_csv_api_catalog__key__csv_get", "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/agents/check": { "get": { "summary": "Api Check", "operationId": "api_check_api_agents_check_get", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Q" } }, { "name": "action", "in": "query", "required": false, "schema": { "type": "string", "default": "trusting you", "title": "Action" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "description": "Is this agent proven? q = name, wallet, ERC-8004 id, agent-card URL, credential id or sha256 \u2192 PROVEN / PASSED_BACKTEST / REFUSED / NOT_SIGNIFICANT / UNVERIFIED." } }, "/api/agents/proven": { "get": { "summary": "Api Proven", "operationId": "api_proven_api_agents_proven_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 25, "title": "Limit" } }, { "name": "real_only", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Real Only" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/attempts/head": { "get": { "summary": "Api Head", "operationId": "api_head_api_attempts_head_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/attempts/identity/{ihash}": { "get": { "summary": "Api Identity", "operationId": "api_identity_api_attempts_identity__ihash__get", "parameters": [ { "name": "ihash", "in": "path", "required": true, "schema": { "type": "string", "title": "Ihash" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/public/registry": { "get": { "summary": "Public Registry", "operationId": "public_registry_api_public_registry_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/agents/start": { "get": { "summary": "Agents Start", "operationId": "agents_start_api_agents_start_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/public/check": { "get": { "summary": "Check Batch", "description": "Batch status for embed.js: up to 100 ids / aliases / wallets, one call, CORS.", "operationId": "check_batch_api_public_check_get", "parameters": [ { "name": "ids", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Ids" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/mission": { "get": { "summary": "Endgame", "description": "The endgame and the seven-rung ladder, with live status per rung.", "operationId": "endgame_api_mission_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/endgame": { "get": { "summary": "Endgame", "description": "The endgame and the seven-rung ladder, with live status per rung.", "operationId": "endgame_api_endgame_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/standard/gates": { "get": { "summary": "Standard Gates", "operationId": "standard_gates_api_standard_gates_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/standard/clauses": { "get": { "summary": "Standard Clauses", "operationId": "standard_clauses_api_standard_clauses_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/verifier/{os_name}": { "get": { "summary": "Verifier Download", "operationId": "verifier_download_api_verifier__os_name__get", "parameters": [ { "name": "os_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Os Name" } }, { "name": "era", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Era" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/explain-refusal": { "post": { "summary": "Explain Refusal", "description": "Free forensic case for your own positions: every gate with threshold vs value and what would pass. Nothing charged, nothing kept.", "operationId": "explain_refusal_api_explain_refusal_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/log/head": { "get": { "summary": "Api Head", "operationId": "api_head_api_log_head_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "description": "Signed head of the verdict transparency log (size, Merkle root, latest Bitcoin anchor)." } }, "/api/log/entries": { "get": { "summary": "Api Entries", "operationId": "api_entries_api_log_entries_get", "parameters": [ { "name": "start", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Start" } }, { "name": "end", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "End" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 200, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/log/latest": { "get": { "summary": "Api Latest", "operationId": "api_latest_api_log_latest_get", "parameters": [ { "name": "n", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "N" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/log/proof/{index}": { "get": { "summary": "Api Proof", "operationId": "api_proof_api_log_proof__index__get", "parameters": [ { "name": "index", "in": "path", "required": true, "schema": { "type": "integer", "title": "Index" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/log/proof-for/{subject}": { "get": { "summary": "Api Proof For", "operationId": "api_proof_for_api_log_proof_for__subject__get", "parameters": [ { "name": "subject", "in": "path", "required": true, "schema": { "type": "string", "title": "Subject" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/log/consistency": { "get": { "summary": "Api Consistency", "operationId": "api_consistency_api_log_consistency_get", "parameters": [ { "name": "old", "in": "query", "required": true, "schema": { "type": "integer", "title": "Old" } }, { "name": "new", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "New" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/log/audit": { "get": { "summary": "Api Audit", "operationId": "api_audit_api_log_audit_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/log/anchor/{size}.{ext}": { "get": { "summary": "Api Anchor", "operationId": "api_anchor_api_log_anchor__size___ext__get", "parameters": [ { "name": "size", "in": "path", "required": true, "schema": { "type": "integer", "title": "Size" } }, { "name": "ext", "in": "path", "required": true, "schema": { "type": "string", "title": "Ext" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/log/anchors": { "get": { "summary": "Api Anchors", "operationId": "api_anchors_api_log_anchors_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/receipt/{cid}": { "get": { "summary": "Api Receipt", "operationId": "api_receipt_api_receipt__cid__get", "parameters": [ { "name": "cid", "in": "path", "required": true, "schema": { "type": "string", "title": "Cid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/receipt/verify": { "post": { "summary": "Api Receipt Verify", "operationId": "api_receipt_verify_api_receipt_verify_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/status/{cid}": { "get": { "summary": "Api Status", "operationId": "api_status_api_status__cid__get", "parameters": [ { "name": "cid", "in": "path", "required": true, "schema": { "type": "string", "title": "Cid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/crl": { "get": { "summary": "Api Crl", "operationId": "api_crl_api_crl_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/receipt/attest": { "post": { "summary": "Api Attest", "operationId": "api_attest_api_receipt_attest_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "apiKey": [] } ] } }, "/api/graph": { "get": { "summary": "Api Graph", "operationId": "api_graph_api_graph_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 500, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/reliance/{cid}": { "get": { "summary": "Api Reliance", "operationId": "api_reliance_api_reliance__cid__get", "parameters": [ { "name": "cid", "in": "path", "required": true, "schema": { "type": "string", "title": "Cid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/standing": { "get": { "summary": "Api Standing", "operationId": "api_standing_api_standing_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "description": "Who you are talking to: what MIZAN is, problems closed, receipts, lineage, papers, live counts, the seven-rung ladder." } }, "/api/everything": { "get": { "summary": "Api Everything", "operationId": "api_everything_api_everything_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/conformance": { "get": { "summary": "Api Conformance", "operationId": "api_conformance_api_conformance_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/why-not-gips": { "get": { "summary": "Api Gips", "operationId": "api_gips_api_why_not_gips_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/bounty": { "get": { "summary": "Api Bounty", "operationId": "api_bounty_api_bounty_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/bounty/submit": { "post": { "summary": "Api Bounty Submit", "operationId": "api_bounty_submit_api_bounty_submit_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "apiKey": [] } ] } }, "/api/allocate-check/verify": { "post": { "summary": "Api Verify", "operationId": "api_verify_api_allocate_check_verify_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/allocate-check": { "post": { "summary": "Api Allocate Check", "operationId": "api_allocate_check_api_allocate_check_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agent": { "type": "string", "description": "credential id, alias, wallet, ERC-8004 id, agent-card URL or registry id (ag_\u2026)" }, "credential": { "type": "string" }, "receipt": { "type": "string", "description": "signed receipt JWS; subject taken from it" }, "amount": { "type": "number" }, "currency": { "type": "string", "default": "USD" }, "purpose": { "type": "string" }, "allow_not_significant": { "type": "boolean", "default": false }, "require_forward": { "type": "boolean", "default": false }, "policy": { "type": "object", "description": "inline venue policy: min_record_days, min_trades, require_forward, min_provenance_grade, min_forward_commitments, allow_not_significant" }, "policy_id": { "type": "string", "description": "a policy registered via POST /api/venues/policy; unknown id \u2192 REFUSE" }, "record": { "type": "boolean", "default": false, "description": "with an API key: log the check as a public leaf" } } } } } }, "description": "The one call before money moves (VTR-1 Agent Profile \u00a706). Body: {agent|credential|receipt, amount?, currency?, purpose?, require_forward?, allow_not_significant?, record?}. Returns decision ALLOW/REFUSE, reasons[], checks[] (clause A-26..A-31), verdict_object, token (EdDSA 24 h), check_id. Fail closed." } }, "/api/allocate-check/program": { "get": { "summary": "Api Program", "operationId": "api_program_api_allocate_check_program_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/allocate-check/{subject}": { "get": { "summary": "Api Allocate Check Get", "operationId": "api_allocate_check_get_api_allocate_check__subject__get", "parameters": [ { "name": "subject", "in": "path", "required": true, "schema": { "type": "string", "title": "Subject" } }, { "name": "allow_not_significant", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Allow Not Significant" } }, { "name": "require_forward", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Require Forward" } }, { "name": "policy_id", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Policy Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/rewards/program": { "get": { "summary": "Api Program", "operationId": "api_program_api_rewards_program_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/public/stats": { "get": { "summary": "Public Stats", "operationId": "public_stats_api_public_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } } }, "components": { "securitySchemes": { "apiKey": { "type": "http", "scheme": "bearer", "description": "mzn_\u2026 API key (POST /product/keys). Needed only for attest, bounty submit, logged allocate-checks." } } }, "x-mizan": { "mcp": "https://studio.mizan.market/mcp", "a2a": "https://studio.mizan.market/a2a", "skill": "https://mizan.market/skill/SKILL.md", "llms": "https://mizan.market/llms.txt", "allocate_check_first": "Before money moves to any agent: POST /api/allocate-check {agent, amount, currency} \u2192 ALLOW/REFUSE + signed token." } }