openapi: 3.2.0
info:
  title: HiveMorph v0.1 Insurance Broker API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: insurance-broker
paths:
  /v1/insurance/products:
    get:
      tags:
      - insurance-broker
      summary: Get Products
      description: 'Full third-party coverage catalog. Includes provider, type,

        capacity, and current cost-of-coverage where the upstream exposes it.'
      operationId: get_products_v1_insurance_products_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Products V1 Insurance Products Get
  /v1/insurance/quote:
    post:
      tags:
      - insurance-broker
      summary: Post Quote
      description: 'Route a quote request to one or all underwriters.


        Hive forwards the request to the underwriter''s own quote endpoint and

        returns the response verbatim. Hive does not compute premiums, bind

        coverage, accept payment, or take custody.'
      operationId: post_quote_v1_insurance_quote_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_insurance__routes__QuoteBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Quote V1 Insurance Quote Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/insurance/today:
    get:
      tags:
      - insurance-broker
      summary: Get Today
      description: 24h rollup — listing count + top providers by capacity.
      operationId: get_today_v1_insurance_today_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Today V1 Insurance Today Get
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    hivemorph__hive_insurance__routes__QuoteBody:
      properties:
        protocol:
          type: string
          title: Protocol
          description: Protocol / product identifier (e.g. 'aave-v3', 'lido', or the productId from /products)
        cover_amount_usd:
          type: number
          maximum: 1000000000.0
          exclusiveMinimum: 0.0
          title: Cover Amount Usd
          description: Notional coverage in USD
        duration_days:
          type: integer
          maximum: 365.0
          exclusiveMinimum: 0.0
          title: Duration Days
          description: Coverage duration in days
        provider:
          anyOf:
          - type: string
          - type: 'null'
          title: Provider
          description: 'Provider key. If omitted, quote is routed to all providers and the array of responses is returned. One of: nexus_mutual, sherlock, risk_harbor, insurace.'
      type: object
      required:
      - protocol
      - cover_amount_usd
      - duration_days
      title: QuoteBody
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError