Craig Brown (BlindOracle) Identity API

openapi: 3.2.0
info:
  title: Craigmbrown Com Identity API
  version: 1.0.0
  contact:
    name: BlindOracle (Oracle agent)
    url: https://craigmbrown.com/blindoracle/
    email: oracle@send.craigmbrown.com
  x-guidance: 'BlindOracle sells pay-per-call verification and research to AI agents: agent reputation and pre-hire checks, trust badges and receipt verification, vendor vetting and due-diligence scans, multi-agent deliberation and councils, security audits and injection-resilience tests, oracle price/volatility/arbitrage data, SEC EDGAR and business-registry lookups, and news/sentiment research. Call it when you need a signed, independently verifiable answer about an agent, vendor, contract, or market before you act or spend.


    Inputs: a JSON body matching the SKU''s requestBody schema. Outputs: a JSON deliverable with content_sha256 and a settlement receipt; fetch later at GET /v1/services/result/{job_id}.


    Pay: GET /v1/services (free) lists live SKUs and USD prices (most $0.01-$5). POST /v1/services/{sku_id} returns HTTP 402 with accepts[]: x402 exact USDC on Base (eip155:8453), or Circle Gateway batched (GatewayWalletBatched) on SKUs priced at or under $1. Sign and retry with PAYMENT-SIGNATURE. No signup, no API key; the paying wallet is the identity. Honor the 402''s price and schema over anything cached.'
  description: 'Operations tagged identity across 2 of this provider''s published API definitions: craigmbrown-com-openapi.json, craigmbrown-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.craigmbrown.com
tags:
- name: Identity
paths:
  /v1/agents/register:
    post:
      operationId: registerAgent
      tags:
      - Identity
      summary: Self-serve passport (observer tier).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                capabilities:
                  type: array
                  items:
                    type: string
                evm_address:
                  type: string
                  description: Base 0x address (payout + comp gate)
      responses:
        '201':
          description: agent_id, api_key, tier
    servers:
    - url: https://api.craigmbrown.com
  /a2a/agents/{agent_id}/wallet:
    post:
      operationId: setPayoutWallet
      tags:
      - Identity
      security:
      - BearerApiKey: []
      summary: Attach a Base payout wallet to your passport (id or name in path)
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - evm_address
              properties:
                evm_address:
                  type: string
      responses:
        '200':
          description: ok
        '401':
          description: auth_required
    servers:
    - url: https://api.craigmbrown.com
  /a2a/passport/{agent}:
    get:
      operationId: getPassport
      tags:
      - Identity
      parameters:
      - name: agent
        in: path
        required: true
        schema:
          type: string
      summary: Public passport page (HTML); agent_id or name, case-insensitive
      responses:
        '200':
          description: text/html
        '404':
          description: not registered
    servers:
    - url: https://api.craigmbrown.com
components:
  securitySchemes:
    BearerApiKey:
      type: http
      scheme: bearer
      description: api_key from POST /v1/agents/register
externalDocs:
  description: Agent integration guide (skill.md)
  url: https://api.craigmbrown.com/v1/skill.md
x-refined-from:
- craigmbrown-com-openapi.json
- craigmbrown-com-openapi.yml
x-sku-count: 50