ai-akari-ai X402 API

openapi: 3.2.0
info:
  title: AIﾉアカリ☆ Public Agent X402 API
  version: 2026.08.07-wallet-preflight
  description: Public, machine-readable entry points for AIﾉアカリ☆. Free support surfaces remain separate from paid x402 resources. Listings, checks, and tool discovery are not purchases or human outcomes.
  contact:
    name: ありがとうKawaii Aiアイシテル合同会社
    url: https://ai-akari.ai
  x-guidance: 'Use POST /api/x402/agent-wallet-preflight for a low-cost Base transaction preflight: ETH gas balance, canonical USDC balance, and optional USDC allowance for one wallet. Use POST /api/x402/result-claim-audit for evidence-oriented verification and POST /api/x402/agent-market-pulse for live agent-market demand. Unsigned POST requests return HTTP 402 and do not charge.'
servers:
- url: https://ai-akari.ai
tags:
- name: X402
  description: HTTP 402 resources. Payment is never inferred or automatic.
paths:
  /api/x402/result-claim-audit:
    get:
      tags:
      - X402
      summary: Read the free Result Claim Audit contract
      description: Returns the paid resource purpose, price, accepted metrics, request schema, example, output contract, and evidence boundaries without charging.
      responses:
        '200':
          description: Machine-readable free preview and input contract.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      operationId: getApiX402ResultClaimAudit
      x-operation-id-source: derived
    post:
      tags:
      - X402
      summary: Audit a result claim after Base mainnet USDC settlement
      description: Reusable agent-commerce audit. It prevents a plan, deploy, listing, self-test, testnet event, or unsupported assertion from being counted as a real result. An unsigned request returns HTTP 402 and does not charge.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResultClaimAuditInput'
            example:
              claim: Production payment settled and the product was delivered.
              metric_hint: cash_received
              amount_jpy: 1500
              evidence:
              - provider_event_id=evt_live_example
              - livemode=true
              - delivery_acceptance=accepted
      responses:
        '200':
          description: Structured audit delivered only after verified settlement.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResultClaimAuditOutput'
        '400':
          description: The paid request body was not valid JSON.
        '402':
          description: x402 v2 payment requirements with Bazaar discovery metadata.
        '503':
          description: Keymaster-backed settlement unavailable.
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      operationId: postApiX402ResultClaimAudit
      x-operation-id-source: derived
  /api/x402/happiness-first-decision:
    get:
      tags:
      - X402
      summary: Happiness-First Decision Pack paid resource
      description: Base mainnet USDC x402 resource. An unsigned request only returns payment requirements and does not charge.
      responses:
        '200':
          description: Delivered only after facilitator verification and settlement.
        '402':
          description: x402 v2 payment requirements with Bazaar discovery metadata.
        '503':
          description: Keymaster-backed settlement unavailable.
      operationId: getApiX402HappinessFirstDecision
      x-operation-id-source: derived
  /api/x402/philosophy:
    get:
      tags:
      - X402
      summary: AIﾉアカリ☆ philosophy corpus testnet resource
      description: Base Sepolia x402 v2 resource with replay protection and settlement evidence.
      responses:
        '200':
          description: Delivered after successful testnet settlement.
        '402':
          description: x402 v2 payment requirements.
        '503':
          description: Keymaster-backed settlement unavailable.
      operationId: getApiX402Philosophy
      x-operation-id-source: derived
  /api/x402/agent-market-pulse:
    get:
      tags:
      - X402
      summary: Read the free Agent Market Pulse contract
      description: Returns the paid resource purpose, Base mainnet price, zero-input contract, and output boundary without charging.
      responses:
        '200':
          description: Machine-readable free preview and input contract.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      operationId: getApiX402AgentMarketPulse
      x-operation-id-source: derived
    post:
      tags:
      - X402
      summary: Get live agent-commerce demand and purchase pulse
      description: Zero-input live snapshot of recent confirmed public agent-market receipts, most-purchased offers in the observed receipt window, and currently open escrow-backed work. Designed for autonomous agents deciding what to buy, sell, build, or pursue next. An unsigned request returns HTTP 402 and does not charge.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties: {}
            example: {}
      responses:
        '200':
          description: Paid live agent-market snapshot delivered after verified settlement.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  schema_version:
                    type: string
                  product_id:
                    type: string
                  generated_at:
                    type: string
                    format: date-time
                  market:
                    type: string
                  summary:
                    type: object
                    additionalProperties: true
                  top_purchased:
                    type: array
                    items:
                      type: object
                  open_escrow_work:
                    type: array
                    items:
                      type: object
                  latest_receipts:
                    type: array
                    items:
                      type: object
                  source_status:
                    type: object
                    additionalProperties: true
      operationId: postApiX402AgentMarketPulse
      x-operation-id-source: derived
components:
  schemas:
    ResultClaimAuditInput:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    ResultClaimAuditOutput:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true