{
 "openapi": "3.0.3",
 "info": {
  "title": "BotCheck",
  "version": "1.0.0",
  "description": "Per-request AI-traffic integrity attestation for adtech. Deterministic human|agent|bot|unknown classification + Ed25519-signed batch certificates. x402 v1, USDC Solana.",
  "contact": {
   "email": "michael.poncana@gmail.com"
  },
  "x-payment-info": {
   "scheme": "exact",
   "network": "solana",
   "asset": "USDC",
   "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
  }
 },
 "servers": [
  {
   "url": "https://botcheck.themonexus.com"
  }
 ],
 "paths": {
  "/api/v1/botcheck/classify": {
   "post": {
    "summary": "Classify request as human/agent/bot",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.002",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "verdict": "bot",
          "confidence": 0.9,
          "signature": "ed25519..."
         }
        },
        "example": {
         "verdict": "bot",
         "confidence": 0.9,
         "signature": "ed25519..."
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/botcheck/attest/batch": {
   "post": {
    "summary": "Batch classify + signed cert",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.01",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "certificate": "ed25519_signed_batch",
          "count": 1,
          "bots": 1
         }
        },
        "example": {
         "certificate": "ed25519_signed_batch",
         "count": 1,
         "bots": 1
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/botcheck/reputation": {
   "get": {
    "summary": "IP/UA reputation lookup",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.001",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "ip": "196.25.1.1",
          "label": "suspected_bot",
          "source": "seed",
          "as_of": "2026-08-07"
         }
        },
        "example": {
         "ip": "196.25.1.1",
         "label": "suspected_bot",
         "source": "seed",
         "as_of": "2026-08-07"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/botcheck/key": {
   "get": {
    "summary": "Ed25519 public key",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.00",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "key": "bc_live_...",
          "expires": "2026-09-07",
          "tier": "wire"
         }
        },
        "example": {
         "key": "bc_live_...",
         "expires": "2026-09-07",
         "tier": "wire"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "securitySchemes": {
   "x402": {
    "type": "apiKey",
    "in": "header",
    "name": "X-PAYMENT"
   }
  }
 }
}