ai-akari-ai Trust API

openapi: 3.2.0
info:
  title: AIﾉアカリ☆ Public Agent Trust 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: Trust
  description: Externally grounded machine-readable trust evidence.
paths:
  /mcp-trust:
    get:
      tags:
      - Trust
      summary: Describe the official Agent Trust Receipt MCP
      responses:
        '200':
          description: MCP server card and canonical trust links.
      operationId: getMcpTrust
      x-operation-id-source: derived
    post:
      tags:
      - Trust
      summary: Read the live Agent Trust Receipt over MCP
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
      responses:
        '200':
          description: JSON-RPC response.
        '204':
          description: Notification accepted.
      operationId: postMcpTrust
      x-operation-id-source: derived
  /.well-known/agent-trust.json:
    get:
      tags:
      - Trust
      summary: Get the live Agent Trust Receipt
      description: Includes official MCP Registry status, independent conformance, health, attestation and external validation executions while explicitly separating unproven adoption, payment and human outcome.
      responses:
        '200':
          description: Agent Trust Receipt 1.1.0.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      operationId: getWellKnownAgentTrustJson
      x-operation-id-source: derived
  /api/x402/result-claim-audit:
    get:
      tags:
      - Trust
      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:
      - Trust
      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
  /a2a/result-receipt-auditor:
    post:
      tags:
      - Trust
      summary: Audit a claimed AI result over A2A
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
      responses:
        '200':
          description: A2A JSON-RPC result.
      operationId: postA2aResultReceiptAuditor
      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
    JsonRpcRequest:
      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