{
  "openapi": "3.1.0",
  "info": {
    "title": "Etuki AI FinOps Clearinghouse & Stateless BYOK Gateway API",
    "version": "2026.10.31-v40.7.4-holistic-verified",
    "description": "Cryptographically signed 563-entity LLM rate oracle, context-cliff guard, prompt-cache breakpoint stabilizer, and stateless in-memory BYOK routing gateway supporting Claude, ChatGPT, Gemini, DeepSeek, Kimi, and AWS Bedrock."
  },
  "servers": [
    {
      "url": "https://www.etuki.com"
    }
  ],
  "paths": {
    "/api/v1/mcp": {
      "get": {
        "operationId": "executeFinOpsMcpTool",
        "summary": "Execute FinOps cost calculation, context-cliff check, cache breakpoint stabilization, or receipt reconciliation",
        "parameters": [
          {
            "name": "call",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "check_context_cliff",
                "reconcile_usage_receipt",
                "optimize_prompt_cache_layout"
              ]
            }
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "prompt_tokens",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deterministic signed FinOps routing & cost calculation response"
          }
        }
      }
    },
    "/api/v1/chat/completions": {
      "get": {
        "operationId": "getGatewayContract",
        "summary": "Inspect stateless BYOK gateway contract, 22 upstream provider readiness tiers, and double-entry ledger schema",
        "responses": {
          "200": {
            "description": "Gateway specification and readiness matrix"
          }
        }
      },
      "post": {
        "operationId": "createChatCompletionByok",
        "summary": "Stateless in-memory BYOK OpenAI-compatible chat completion proxy with automatic cache breakpoint pinning",
        "responses": {
          "200": {
            "description": "OpenAI-compatible completion with inline cryptographic clearing headers"
          }
        }
      }
    },
    "/api/oracle/v1.json": {
      "get": {
        "operationId": "getSignedRateOracle",
        "summary": "Fetch RS256-signed 563-leaf Merkle price & telemetry oracle",
        "responses": {
          "200": {
            "description": "Signed Oracle Manifest"
          }
        }
      }
    }
  }
}