{
  "openapi": "3.1.0",
  "info": {
    "title": "ORBITKIN public read API",
    "version": "1.2.0",
    "description": "Public facts and native-BNB Mint preview for ORBITKIN on BNB Smart Chain 56. GET only. No authentication, private key, signature, broadcast or payment endpoint. A quote is not transaction authorization."
  },
  "servers": [
    {
      "url": "https://www.orbitkin.online",
      "description": "Public read mirror"
    },
    {
      "url": "https://orbitkin.online",
      "description": "Canonical website"
    }
  ],
  "externalDocs": {
    "url": "https://orbitkin.online/for-ai"
  },
  "paths": {
    "/api/project-facts": {
      "get": {
        "operationId": "readProjectFacts",
        "summary": "Read chain identity, contracts, controls and current observed state",
        "responses": {
          "200": {
            "description": "Publisher data with live source blocks and explicit evidence scope",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Invalid public query parameters"
          },
          "429": {
            "description": "Read rate limit reached; retry later"
          },
          "503": {
            "description": "Verified chain data unavailable; do not infer a value"
          }
        }
      }
    },
    "/api/ai-mint": {
      "get": {
        "operationId": "readMintManifest",
        "summary": "Read current Mint status and exact payable interface",
        "responses": {
          "200": {
            "description": "Read onchain.mintOpen and uniformPaidMint; null means unknown",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Invalid public query parameters"
          },
          "429": {
            "description": "Read rate limit reached; retry later"
          },
          "503": {
            "description": "Verified chain data unavailable; do not infer a value"
          }
        }
      }
    },
    "/api/ai-mint/quote": {
      "get": {
        "operationId": "previewPaidMint",
        "summary": "Preview exact native-BNB Mint; all wallets pay the current quote",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "description": "Actual signing wallet address",
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          },
          {
            "name": "quantity",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10
            }
          },
          {
            "name": "referrer",
            "in": "query",
            "required": false,
            "description": "Optional qualified prior minter; must pass contract simulation",
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Requires canMint=true, fresh source block and user authorization before any external wallet transaction",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Invalid public query parameters"
          },
          "429": {
            "description": "Read rate limit reached; retry later"
          },
          "503": {
            "description": "Verified chain data unavailable; do not infer a value"
          }
        }
      }
    },
    "/api/agent-id": {
      "get": {
        "operationId": "readOfficialAgentId",
        "summary": "Read official SPACE ID Agent ID, informational only",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "verified, not_registered or unavailable; identity does not change Mint price or access",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Invalid public query parameters"
          },
          "429": {
            "description": "Read rate limit reached; retry later"
          },
          "503": {
            "description": "Verified chain data unavailable; do not infer a value"
          }
        }
      }
    }
  },
  "x-wallet-boundary": {
    "chainId": 56,
    "unitPriceBNB": "0.002",
    "walletLifetimeCap": 10,
    "perTransactionCap": 10,
    "officialAgentIdRequired": false,
    "signingOrBroadcastSupported": false
  }
}