Hive Civilization Compute Grid API

The compute-grid API from Hive Civilization — 11 operation(s) for compute-grid.

Documentation 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

POST /v1/compute-grid/verify Verify a zk-proof and get a signed receipt · Verify #

Ask an LLM

“Can I verify a Groth16 zk-proof and receive a signed receipt?”

“What does verifying a proof cost per proof?”

Tell an agent

Verify proof {proof} with public inputs {public_inputs}.

Check {proof_system} proof {proof} against inputs {public_inputs} and sign a receipt.

GET /v1/compute-grid/capacity Check available compute grid capacity · Capacity #

Ask an LLM

“How much GPU and CPU capacity is currently available on the compute grid?”

“Can I force a fresh capacity reading instead of a cached one?”

Tell an agent

Show current compute grid capacity.

Refresh capacity with {refresh} and return the top {n} entries.

GET /v1/compute-grid/agents List compute grid agent types · Agents #

Ask an LLM

“What operational agent types run the compute grid and how many instances exist?”

“Where is the Compute Grid agent registry?”

Tell an agent

List the compute grid agent registry.

Show the operational agent types and their instances.

GET /v1/compute-grid/providers List compute providers and their health · Providers #

Ask an LLM

“Which compute provider adapters are enabled and are their upstreams healthy?”

“Are the provider health checks real probes or mocked?”

Tell an agent

List enabled compute providers with upstream health.

Check which compute adapters are currently healthy.

POST /v1/compute-grid/quote Get compute price quotes without an auction · Quote #

Ask an LLM

“What would an H100 cost across providers for a few hours without committing?”

“Can I compare compute quotes without writing anything to the ledger?”

Tell an agent

Quote {gpu_type} for {duration_hours} hours across providers.

Price-check {cpu_cores} cores and {ram_gb} GB RAM within {budget_usd} USD.

POST /v1/compute-grid/solve Run a cross-provider compute auction · Solve Endpoint #

Ask an LLM

“How do I run the auction that picks a winning compute provider with a selection proof?”

“Can I run the auction in probe mode without persisting to the ledger?”

Tell an agent

Run the compute auction for {gpu_type} for {duration_hours} hours under {budget_usd} USD.

Solve job {job_id} with persist set to {persist}.

POST /v1/compute-grid/book Reserve compute with the auction winner · Book #

Ask an LLM

“Once an auction picks a provider, how do I actually reserve the compute?”

“What happens if the provider's reservation key is not configured?”

Tell an agent

Book auction {auction_id} with provider {provider} using quote {quote} before {deadline_unix}.

Reserve the winning quote {quote} from {provider} for auction {auction_id} by {deadline_unix}.

GET /v1/compute-grid/status Check a compute booking's status · Status Endpoint #

Ask an LLM

“What is the current state of my compute booking?”

“Can I poll a reservation by its booking id?”

Tell an agent

Check the status of booking {booking_id}.

Poll compute booking {booking_id}.

POST /v1/compute-grid/release Release a compute booking · Release Endpoint #

Ask an LLM

“How do I give back compute I reserved when I'm done?”

“Can I release a booking held with a specific provider?”

Tell an agent destructive · confirm first

Release booking {booking_id} with provider {provider}.

Free up the compute held under {booking_id} at {provider}.

GET /v1/compute-grid/audit Read compute auction history · Audit #

Ask an LLM

“Which compute auctions ran recently and what did they cost in USDC?”

“Where can I review the auction ledger entries?”

Tell an agent

Show the last {limit} compute auctions.

Read the compute auction audit log.

POST /v1/compute-grid/verify-selection Independently verify an auction selection proof · Verify Selection #

Ask an LLM

“Can I independently check the selection proof returned by an auction?”

“Is there a way to verify a solve result without building a claim myself?”

Tell an agent

Verify the selection proof {proof} with inputs {public_inputs} from my auction.

Check the auction winner proof {proof} against {public_inputs}.

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-compute-grid-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

openapi: 3.2.0
info:
  title: HiveMorph v0.1 Compute Grid API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: compute-grid
paths:
  /v1/compute-grid/verify:
    post:
      tags:
      - compute-grid
      summary: Verify
      description: 'Verify a zk-proof and return a signed receipt. Spec §3.1 Agent #3.


        Pricing: $0.001/proof recorded inside the receipt body.

        Signing: Evaluator wallet (real EIP-191 sign via eth_account).'
      operationId: verify_v1_compute_grid_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_compute_grid__routes__VerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Verify V1 Compute Grid Verify Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/compute-grid/capacity:
    get:
      tags:
      - compute-grid
      summary: Capacity
      operationId: capacity_v1_compute_grid_capacity_get
      parameters:
      - name: n
        in: query
        required: false
        schema:
          type: integer
          default: 32
          title: N
      - name: refresh
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Refresh
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Capacity V1 Compute Grid Capacity Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/compute-grid/agents:
    get:
      tags:
      - compute-grid
      summary: Agents
      description: Compute Grid agent registry — 6 operational types, 15 instances.
      operationId: agents_v1_compute_grid_agents_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Agents V1 Compute Grid Agents Get
  /v1/compute-grid/providers:
    get:
      tags:
      - compute-grid
      summary: Providers
      description: List enabled adapters and their upstream health. Real probes — no mocks.
      operationId: providers_v1_compute_grid_providers_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Providers V1 Compute Grid Providers Get
  /v1/compute-grid/quote:
    post:
      tags:
      - compute-grid
      summary: Quote
      description: 'Gather quotes across enabled providers WITHOUT running the auction

        (no proof, no ledger write). Useful for price discovery.'
      operationId: quote_v1_compute_grid_quote_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkloadRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Quote V1 Compute Grid Quote Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/compute-grid/solve:
    post:
      tags:
      - compute-grid
      summary: Solve Endpoint
      description: 'Run the cross-pool auction and return the chosen provider, Groth16-shaped

        selection proof, signed receipt, and settlement path.


        Set persist=false to skip ledger write (probe mode).'
      operationId: solve_endpoint_v1_compute_grid_solve_post
      parameters:
      - name: persist
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Persist
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkloadRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Solve Endpoint V1 Compute Grid Solve Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/compute-grid/book:
    post:
      tags:
      - compute-grid
      summary: Book
      description: 'Reserve compute with the chosen provider. Real adapters; reservation paths

        are gated behind provider keys. If the upstream key is not configured we

        return 503 with the missing-key error rather than faking a booking.'
      operationId: book_v1_compute_grid_book_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_compute_grid__routes__BookRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Book V1 Compute Grid Book Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/compute-grid/status:
    get:
      tags:
      - compute-grid
      summary: Status Endpoint
      description: Poll a booking by id. Returns 503 until book() is fully wired.
      operationId: status_endpoint_v1_compute_grid_status_get
      parameters:
      - name: booking_id
        in: query
        required: true
        schema:
          type: string
          title: Booking Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Status Endpoint V1 Compute Grid Status Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/compute-grid/release:
    post:
      tags:
      - compute-grid
      summary: Release Endpoint
      operationId: release_endpoint_v1_compute_grid_release_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReleaseRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Release Endpoint V1 Compute Grid Release Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/compute-grid/audit:
    get:
      tags:
      - compute-grid
      summary: Audit
      description: 'Read auction history from the canonical receipt ledger.


        Returns the most recent compute_grid_auction entries with their cost_usdc

        telemetry. No proof envelopes (those live in the auction-result body and

        are returned by /solve).'
      operationId: audit_v1_compute_grid_audit_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Audit V1 Compute Grid Audit Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/compute-grid/verify-selection:
    post:
      tags:
      - compute-grid
      summary: Verify Selection
      description: 'Independent verifier of a selection proof. Validates envelope structure

        + signs a verification receipt. Reuses /verify under the hood — distinct

        endpoint so callers don''t need to construct a claim manually.'
      operationId: verify_selection_v1_compute_grid_verify_selection_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifySelectionRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Verify Selection V1 Compute Grid Verify Selection Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ReleaseRequest:
      properties:
        provider:
          type: string
          title: Provider
        booking_id:
          type: string
          title: Booking Id
      type: object
      required:
      - provider
      - booking_id
      title: ReleaseRequest
    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
    WorkloadRequest:
      properties:
        gpu_type:
          type: string
          title: Gpu Type
          description: cpu | rtx_4090 | h100 | a100 | l40s | rtx_3090 | rtx_a6000
          default: cpu
        cpu_cores:
          type: integer
          minimum: 1.0
          title: Cpu Cores
          default: 1
        ram_gb:
          type: integer
          minimum: 1.0
          title: Ram Gb
          default: 4
        duration_hours:
          type: number
          exclusiveMinimum: 0.0
          title: Duration Hours
          default: 1.0
        budget_usd:
          anyOf:
          - type: number
            exclusiveMinimum: 0.0
          - type: 'null'
          title: Budget Usd
        deadline_unix:
          anyOf:
          - type: integer
            minimum: 0.0
          - type: 'null'
          title: Deadline Unix
        job_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Job Id
        submitter_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Submitter Did
      type: object
      title: WorkloadRequest
    hivemorph__hive_compute_grid__routes__VerifyRequest:
      properties:
        proof:
          title: Proof
          description: Groth16 proof envelope (dict or 8-elem list)
        public_inputs:
          items: {}
          type: array
          title: Public Inputs
          description: Public inputs (BN254 field elements)
        claim:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Claim
          description: Optional claim metadata
        proof_system:
          type: string
          title: Proof System
          description: Proof system identifier
          default: groth16
      type: object
      required:
      - proof
      - public_inputs
      title: VerifyRequest
    VerifySelectionRequest:
      properties:
        proof:
          title: Proof
          description: Groth16 envelope from /solve.proof_envelope
        public_inputs:
          items: {}
          type: array
          title: Public Inputs
          description: From /solve.proof_public_inputs
      type: object
      required:
      - proof
      - public_inputs
      title: VerifySelectionRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    hivemorph__hive_compute_grid__routes__BookRequest:
      properties:
        auction_id:
          type: string
          title: Auction Id
          description: Auction id from /solve response
        provider:
          type: string
          title: Provider
          description: Chosen provider id (must match auction winner)
        quote:
          additionalProperties: true
          type: object
          title: Quote
          description: The chosen Quote dict from /solve
        deadline_unix:
          type: integer
          exclusiveMinimum: 0.0
          title: Deadline Unix
      type: object
      required:
      - auction_id
      - provider
      - quote
      - deadline_unix
      title: BookRequest
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)

Hive Civilization Compute Grid API

Operations 11

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification