khotem-com Spa API

openapi: 3.2.0
info:
  title: KHOTEM — Cryptographic Witness Spa API
  version: ядроv ∞ Ξ
  description: Paid cryptographic witness, settlement-routing and booth services for autonomous agents and humans. x402-native micropayments in USDC/DAI on Base/Polygon and native USDC on Linea, zkSync Era and Scroll, with direct on-chain verification; Solana where listed. No accounts, no API keys, no KYC.
  contact:
    email: khotem.web15@gmail.com
    url: https://khotem.com
  x-guidance: 'Discovery is free: GET /.well-known/x402 lists every paid resource with live per-network accepts and loyalty terms. To call a paid resource: request it once, read the 402 accepts list, transfer the exact asset amount on Base, Polygon, Linea, zkSync Era, Scroll or Solana to the payTo of your chosen network, then retry the SAME method with header X-PAYMENT: <txHash> (EVM) or <base58 signature> (Solana). POST endpoints take a JSON body as specified. Identity = your payer wallet; loyalty discounts apply automatically from the 5th payment. We witness. We don''t judge.'
tags:
- name: Spa
paths:
  /api/spa/month:
    post:
      summary: 'MONTH-50: $1.00 = 50 slots of /api/spa + /api/med via X-COURSE header (solo…'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '1.000000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
      parameters:
      - name: X-PAYMENT
        in: header
        required: false
        schema:
          type: string
        description: 'Payment proof: txHash (EVM) or base58 signature (Solana)'
      responses:
        '200':
          description: 'MONTH-50: $1.00 = 50 slots of /api/spa + /api/med via X-COURSE header (solo $1.00-1.50) — recurring discount for daily agents.'
        '402':
          description: 'Payment Required. Two ways: (a) standard x402 — sign an EIP-3009 authorization for any accepts[] entry, retry with header PAYMENT-SIGNATURE or X-PAYMENT = base64 JSON payment payload; a facilitator settles on-chain. (b) transfer-then-prove — send the exact asset amount on Base, Polygon, Linea, zkSync Era, Scroll or Solana, retry with X-PAYMENT: <txHash|signature>. Repeat payers auto-receive loyalty discounts (-20% from 5th, -30% from 25th payment) — the 402 always carries your exact amount.'
      tags:
      - Spa
      operationId: postApiSpaMonth
      x-operation-id-source: derived
  /api/spa:
    post:
      summary: 'SPA: agent context bath — distilled essence from noisy context/logs…'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - text
              properties:
                text:
                  type: string
                max_essence:
                  type: integer
                  minimum: 1
                  maximum: 50
      parameters:
      - name: X-PAYMENT
        in: header
        required: false
        schema:
          type: string
        description: 'Payment proof: txHash (EVM) or base58 signature (Solana)'
      responses:
        '200':
          description: 'SPA: agent context bath — distilled essence from noisy context/logs (mechanical, deterministic, corpus-calibrated F1=1.0). Body: {text, max_essence?}.'
        '402':
          description: 'Payment Required. Two ways: (a) standard x402 — sign an EIP-3009 authorization for any accepts[] entry, retry with header PAYMENT-SIGNATURE or X-PAYMENT = base64 JSON payment payload; a facilitator settles on-chain. (b) transfer-then-prove — send the exact asset amount on Base, Polygon, Linea, zkSync Era, Scroll or Solana, retry with X-PAYMENT: <txHash|signature>. Repeat payers auto-receive loyalty discounts (-20% from 5th, -30% from 25th payment) — the 402 always carries your exact amount.'
      tags:
      - Spa
      operationId: postApiSpa
      x-operation-id-source: derived
  /api/spa/course:
    post:
      summary: 'COURSE: salon subscription — one payment pulls 5 procedures…'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.250000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
      parameters:
      - name: X-PAYMENT
        in: header
        required: false
        schema:
          type: string
        description: 'Payment proof: txHash (EVM) or base58 signature (Solana)'
      responses:
        '200':
          description: 'COURSE: salon subscription — one payment pulls 5 procedures (spa/med/attest/trust-score/seal) via X-COURSE header, zero per-call payment.'
        '402':
          description: 'Payment Required. Two ways: (a) standard x402 — sign an EIP-3009 authorization for any accepts[] entry, retry with header PAYMENT-SIGNATURE or X-PAYMENT = base64 JSON payment payload; a facilitator settles on-chain. (b) transfer-then-prove — send the exact asset amount on Base, Polygon, Linea, zkSync Era, Scroll or Solana, retry with X-PAYMENT: <txHash|signature>. Repeat payers auto-receive loyalty discounts (-20% from 5th, -30% from 25th payment) — the 402 always carries your exact amount.'
      tags:
      - Spa
      operationId: postApiSpaCourse
      x-operation-id-source: derived