overlay: 1.0.0
info:
  title: API Evangelist enhancements for HiveBank — Treasury Attestation & Settlement API
  version: '2026-09-19'
  x-generated: '2026-09-19'
  x-method: generated
  x-source: openapi/hiveagentiq-com-hivebank-openapi.json
  x-note: Adds operationIds (the provider declares none), a tag per service, per-operation USDC prices decoded from
    x-mpp-charge, the observed 401 envelope, an auth note and, for HiveBank/HiveLaw, the first-party host as an
    additional server. Never mutates the original file.
extends: https://hivebank.hiveagentiq.com/openapi.json
x-extends-local: openapi/hiveagentiq-com-hivebank-openapi.json
actions:
- target: $.tags
  update:
  - name: Treasury
    description: HiveBank — Treasury Attestation & Settlement API operations (tag added by API Evangelist; the provider
      declares none).
- target: $.info
  update:
    x-apievangelist-provider: Hive Agent IQ (hiveagentiq.com); sibling brand Hive Civilization (thehiveryiq.com)
      is the spec contact
    x-apievangelist-auth-note: No securitySchemes are declared. Writes require a Hive DID from POST https://hivegate.hiveagentiq.com/v1/gate/onboard;
      metered operations answer 402 and settle via x402 (X-Payment, USDC on Base) or MPP. See authentication/hiveagentiq-com-authentication.yml.
    x-apievangelist-rate-limit: X-RateLimit-Limit 100 per hour with X-RateLimit-Remaining / X-RateLimit-Reset (epoch
      ms) on hivetrust and hivelaw; none observed on hivegate and hivebank.
- target: $.servers
  update:
  - url: https://hivebank.hiveagentiq.com
    description: First-party host on the company domain (CNAME to the hivebank.onrender.com Render origin the provider
      declares); both serve identical bytes.
- target: $.paths['/v1/bank/custody/attest'].post
  update:
    operationId: attestCustody
    tags:
    - Treasury
    x-apievangelist-price-usdc: 0.25
- target: $.paths['/v1/bank/custody/attest'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/bank/custody/policy'].post
  update:
    operationId: attestTreasuryPolicy
    tags:
    - Treasury
    x-apievangelist-price-usdc: 0.25
- target: $.paths['/v1/bank/custody/policy'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/bank/draw/instant'].post
  update:
    operationId: drawInstant
    tags:
    - Treasury
    x-apievangelist-price-usdc: 1.0
- target: $.paths['/v1/bank/draw/instant'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/bank/draw/schedule'].post
  update:
    operationId: drawScheduled
    tags:
    - Treasury
    x-apievangelist-price-usdc: 1.0
- target: $.paths['/v1/bank/draw/schedule'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/bank/draw/credit'].post
  update:
    operationId: drawCreditLine
    tags:
    - Treasury
    x-apievangelist-price-usdc: 1.0
- target: $.paths['/v1/bank/draw/credit'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'