Hive Civilization

Hive Civilization Stormlock API

The stormlock API from Hive Civilization — 11 operation(s) for stormlock.

GitHub OpenAPI

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/stormlock/health Check StormLock service health · Health #
Ask an LLM
“Is the StormLock parametric insurance service up?”
“How do I health-check StormLock?”
Tell an agent
Check StormLock health.
Ping the parametric policy receipt service.
GET /v1/stormlock/pricing Get StormLock pricing · Pricing #
Ask an LLM
“How much does each StormLock attestation cost?”
“What are the prices for recording parametric policy events?”
Tell an agent
Show StormLock pricing.
List the price of each parametric attestation type.
POST /v1/stormlock/bind_attest Record a parametric policy bind · Bind Attest #
Ask an LLM
“How do I record that a parametric catastrophe policy has been bound?”
“Can I include the cedent, carrier and reinsurer when attesting a bind?”
Tell an agent
Record the bind of policy {policy_did} for peril {peril_class} with threshold {threshold_spec}.
Attest binding policy {policy_did} ({peril_class}, threshold {threshold_spec}) at {bound_notional_usdc} USDC notional.
POST /v1/stormlock/oracle_subscribe Register an oracle for a policy · Oracle Subscribe #
Ask an LLM
“How do I attach a weather oracle to a parametric policy?”
“Which oracle feeds are registered to a policy?”
Tell an agent
Subscribe oracle {oracle_did} to policy {policy_did}.
Register {oracle_did} as the data oracle for policy {policy_did}.
POST /v1/stormlock/oracle_reading_attest Record an oracle reading for a policy · Oracle Reading Attest #
Ask an LLM
“How do I log a wind speed reading from an oracle against a policy?”
“Can I record raw oracle readings without evaluating the trigger yet?”
Tell an agent
Record oracle {oracle_did} reading {oracle_reading_payload} for policy {policy_did}.
Attest a single reading {oracle_reading_payload} from {oracle_did} on policy {policy_did}.
POST /v1/stormlock/trigger_eval_attest Evaluate a policy trigger against a reading · Trigger Eval Attest #
Ask an LLM
“Did this oracle reading breach the policy's parametric threshold?”
“How do I evaluate and record whether a trigger fired?”
Tell an agent
Evaluate reading {oracle_reading_payload} against threshold {threshold_spec} for policy {policy_did}.
Check whether policy {policy_did} triggered given {oracle_reading_payload} and {threshold_spec}, and record the result.
POST /v1/stormlock/loss_calc_attest Record a loss calculation and payout amount · Loss Calc Attest #
Ask an LLM
“How do I record the calculated payout after a parametric trigger fires?”
“Can a loss calculation be recorded if the trigger result is false?”
Tell an agent
Record a loss calc for policy {policy_did}: trigger {trigger_result}, payout {payout_amount_usdc} USDC, result {loss_calc_result}.
Attest {payout_amount_usdc} USDC calculated loss on {policy_did} with trigger {trigger_result} and calc {loss_calc_result}.
POST /v1/stormlock/payout_auth_attest Record a payout authorization · Payout Auth Attest #
Ask an LLM
“How do I record that a policy payout was authorized from treasury?”
“Can I note which treasury sub-account funds the payout?”
Tell an agent
Authorize a {payout_amount_usdc} USDC payout on policy {policy_did}.
Record payout authorization of {payout_amount_usdc} USDC for {policy_did} to cedent {cedent_did} from sub-account {treasury_sub_account}.
POST /v1/stormlock/reinsurance_settle_attest Record a reinsurance settlement leg · Reinsurance Settle Attest #
Ask an LLM
“How do I log the reinsurer's settlement leg on a parametric policy?”
“Can I record the amount a reinsurer settled with the carrier?”
Tell an agent
Record the reinsurance settlement for policy {policy_did}.
Attest reinsurer {reinsurer_did} settling {settle_amount_usdc} USDC with carrier {carrier_did} on {policy_did}.
POST /v1/stormlock/dispute_attest Record a dispute on a policy · Dispute Attest #
Ask an LLM
“How do I open a dispute on a parametric policy outcome?”
“Can the dispute record include who is disputing and on what grounds?”
Tell an agent
Open a dispute on policy {policy_did}.
Record that {disputing_party_did} disputes policy {policy_did} on grounds: {dispute_grounds}.
GET /v1/stormlock/chain_verify Verify a policy's receipt chain · Chain Verify Endpoint #
Ask an LLM
“Is the full receipt chain for a policy intact and validly signed?”
“How can I audit every event recorded against a policy in order?”
Tell an agent
Verify the receipt chain for policy {policy_did}.
Show the ordered receipts and signature validity for {policy_did}.

Documentation

📖
Documentation
https://thehiveryiq.com/developers
📖
APIReference
https://receipts.thehiveryiq.com/docs
📖
GettingStarted
https://thehiveryiq.com/agents
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/authentication/thehiveryiq-com-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/rate-limits/thehiveryiq-com-rate-limits.yml
📖
Documentation
https://thehiveryiq.com/sdk-quickstart/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/openapi/thehiveryiq-com-stormlock-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-receipts-llms.txt
🔗
LLMsTxt
https://receipts.thehiveryiq.com/llms.txt
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/data-model/thehiveryiq-com-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/asyncapi/thehiveryiq-com-webhooks.yml
🔗
StatusPage
https://receipts.thehiveryiq.com/status
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/errors/thehiveryiq-com-problem-types.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/sandbox/thehiveryiq-com-sandbox.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-hivecompute-llms.txt
🔗
LLMsTxt
https://api.thehiveryiq.com/llms.txt
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/mcp/thehiveryiq-com-tool-crosswalk.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/thehiveryiq-com:thehiveryiq-com-stormlock-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

thehiveryiq-com-stormlock-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Stormlock API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: stormlock
paths:
  /v1/stormlock/health:
    get:
      tags:
      - stormlock
      summary: Health
      operationId: health_v1_stormlock_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Stormlock Health Get
  /v1/stormlock/pricing:
    get:
      tags:
      - stormlock
      summary: Pricing
      operationId: pricing_v1_stormlock_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Pricing V1 Stormlock Pricing Get
  /v1/stormlock/bind_attest:
    post:
      tags:
      - stormlock
      summary: Bind Attest
      description: Record a policy bind event.
      operationId: bind_attest_v1_stormlock_bind_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BindAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Bind Attest V1 Stormlock Bind Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stormlock/oracle_subscribe:
    post:
      tags:
      - stormlock
      summary: Oracle Subscribe
      description: Register an oracle for a policy.
      operationId: oracle_subscribe_v1_stormlock_oracle_subscribe_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OracleSubscribeRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Oracle Subscribe V1 Stormlock Oracle Subscribe Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stormlock/oracle_reading_attest:
    post:
      tags:
      - stormlock
      summary: Oracle Reading Attest
      description: Record a single oracle reading.
      operationId: oracle_reading_attest_v1_stormlock_oracle_reading_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OracleReadingAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Oracle Reading Attest V1 Stormlock Oracle Reading Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stormlock/trigger_eval_attest:
    post:
      tags:
      - stormlock
      summary: Trigger Eval Attest
      description: Evaluate threshold against oracle reading and record result.
      operationId: trigger_eval_attest_v1_stormlock_trigger_eval_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerEvalAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Trigger Eval Attest V1 Stormlock Trigger Eval Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stormlock/loss_calc_attest:
    post:
      tags:
      - stormlock
      summary: Loss Calc Attest
      description: Record loss calculation and payout amount.
      operationId: loss_calc_attest_v1_stormlock_loss_calc_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LossCalcAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Loss Calc Attest V1 Stormlock Loss Calc Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stormlock/payout_auth_attest:
    post:
      tags:
      - stormlock
      summary: Payout Auth Attest
      description: Record payout authorization (treasury sub-account).
      operationId: payout_auth_attest_v1_stormlock_payout_auth_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PayoutAuthAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Payout Auth Attest V1 Stormlock Payout Auth Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stormlock/reinsurance_settle_attest:
    post:
      tags:
      - stormlock
      summary: Reinsurance Settle Attest
      description: Record reinsurance settle leg.
      operationId: reinsurance_settle_attest_v1_stormlock_reinsurance_settle_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReinsuranceSettleAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Reinsurance Settle Attest V1 Stormlock Reinsurance Settle Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stormlock/dispute_attest:
    post:
      tags:
      - stormlock
      summary: Dispute Attest
      description: Record a dispute opened.
      operationId: dispute_attest_v1_stormlock_dispute_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DisputeAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Dispute Attest V1 Stormlock Dispute Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/stormlock/chain_verify:
    get:
      tags:
      - stormlock
      summary: Chain Verify Endpoint
      description: Return ordered receipt chain + chain_valid bool + per-receipt sig validity.
      operationId: chain_verify_endpoint_v1_stormlock_chain_verify_get
      parameters:
      - name: policy_did
        in: query
        required: true
        schema:
          type: string
          description: Policy DID to verify chain for
          title: Policy Did
        description: Policy DID to verify chain for
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Chain Verify Endpoint V1 Stormlock Chain Verify Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    TriggerEvalAttestRequest:
      properties:
        policy_did:
          type: string
          title: Policy Did
          description: DID of the policy
        oracle_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Oracle Did
          description: DID of the oracle
        oracle_reading_payload:
          additionalProperties: true
          type: object
          title: Oracle Reading Payload
          description: Oracle reading payload to evaluate
        threshold_spec:
          additionalProperties: true
          type: object
          title: Threshold Spec
          description: Threshold specification to evaluate against
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: Additional evaluation metadata
      type: object
      required:
      - policy_did
      - oracle_reading_payload
      - threshold_spec
      title: TriggerEvalAttestRequest
      description: Evaluate threshold against oracle reading and record result.
    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
    BindAttestRequest:
      properties:
        policy_did:
          type: string
          title: Policy Did
          description: DID of the parametric policy being bound
        cedent_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Cedent Did
          description: DID of the cedent
        carrier_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Carrier Did
          description: DID of the carrier
        reinsurer_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Reinsurer Did
          description: DID of the reinsurer
        peril_class:
          $ref: '#/components/schemas/PerilClass'
          description: Peril class
        threshold_spec:
          additionalProperties: true
          type: object
          title: Threshold Spec
          description: 'Threshold specification: {metric, operator, value, station_id, duration_min}'
        bound_notional_usdc:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          - type: 'null'
          title: Bound Notional Usdc
          description: Bound notional in USDC
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: Additional bind metadata
      type: object
      required:
      - policy_did
      - peril_class
      - threshold_spec
      title: BindAttestRequest
      description: Record a policy bind event.
    DisputeAttestRequest:
      properties:
        policy_did:
          type: string
          title: Policy Did
          description: DID of the policy under dispute
        disputing_party_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Disputing Party Did
          description: DID of the disputing party
        dispute_grounds:
          anyOf:
          - type: string
          - type: 'null'
          title: Dispute Grounds
          description: Grounds for dispute
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: Dispute metadata
      type: object
      required:
      - policy_did
      title: DisputeAttestRequest
      description: Record a dispute opened.
    OracleSubscribeRequest:
      properties:
        policy_did:
          type: string
          title: Policy Did
          description: DID of the policy
        oracle_did:
          type: string
          title: Oracle Did
          description: DID of the oracle being registered
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: Oracle subscription metadata
      type: object
      required:
      - policy_did
      - oracle_did
      title: OracleSubscribeRequest
      description: Register an oracle for a policy.
    PerilClass:
      type: string
      enum:
      - hurricane
      - earthquake
      - wildfire
      - flood
      - hailstorm
      - tornado
      - extratropical_cyclone
      - drought
      - freeze
      title: PerilClass
    ReinsuranceSettleAttestRequest:
      properties:
        policy_did:
          type: string
          title: Policy Did
          description: DID of the policy
        reinsurer_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Reinsurer Did
          description: DID of the reinsurer
        carrier_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Carrier Did
          description: DID of the carrier
        settle_amount_usdc:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          - type: 'null'
          title: Settle Amount Usdc
          description: Settlement amount in USDC
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: Settlement leg metadata
      type: object
      required:
      - policy_did
      title: ReinsuranceSettleAttestRequest
      description: Record reinsurance settle leg.
    LossCalcAttestRequest:
      properties:
        policy_did:
          type: string
          title: Policy Did
          description: DID of the policy
        oracle_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Oracle Did
          description: DID of the oracle
        trigger_result:
          type: boolean
          title: Trigger Result
          description: Must be True to proceed with loss calc
        payout_amount_usdc:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Payout Amount Usdc
          description: Calculated payout in USDC
        bound_notional_usdc:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          - type: 'null'
          title: Bound Notional Usdc
          description: Bound notional in USDC
        loss_calc_result:
          additionalProperties: true
          type: object
          title: Loss Calc Result
          description: 'Loss calc result: {payout_amount_usdc, calc_method, audit_trail}'
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: Additional loss calc metadata
      type: object
      required:
      - policy_did
      - trigger_result
      - payout_amount_usdc
      - loss_calc_result
      title: LossCalcAttestRequest
      description: Record loss calculation and payout amount.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    OracleReadingAttestRequest:
      properties:
        policy_did:
          type: string
          title: Policy Did
          description: DID of the policy
        oracle_did:
          type: string
          title: Oracle Did
          description: DID of the oracle
        oracle_reading_payload:
          additionalProperties: true
          type: object
          title: Oracle Reading Payload
          description: 'Raw oracle reading payload: {windspeed_kmh:185, ts:''...'', station_id:''WMO_722023''}'
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: Additional reading metadata
      type: object
      required:
      - policy_did
      - oracle_did
      - oracle_reading_payload
      title: OracleReadingAttestRequest
      description: Record a single oracle reading.
    PayoutAuthAttestRequest:
      properties:
        policy_did:
          type: string
          title: Policy Did
          description: DID of the policy
        cedent_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Cedent Did
          description: DID of the cedent receiving payout
        payout_amount_usdc:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Payout Amount Usdc
          description: Authorized payout amount in USDC
        treasury_sub_account:
          anyOf:
          - type: string
          - type: 'null'
          title: Treasury Sub Account
          description: Treasury sub-account address
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: Authorization metadata
      type: object
      required:
      - policy_did
      - payout_amount_usdc
      title: PayoutAuthAttestRequest
      description: Record payout authorization (treasury sub-account).
x-provenance:
  method: harvested
  publisher: Hive Civilization
  source: https://receipts.thehiveryiq.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)