Hive Civilization Qvac API

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

Documentation GitHub OpenAPI

Business capability

Artificial Intelligence Management BC-610.60

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/qvac/provider/register Register a QVAC inference provider · Register Provider #

Ask an LLM

“How do I register my agent as a QVAC inference provider?”

“Can I set a payout address when registering as a QVAC provider?”

Tell an agent

Register {agent_name} as a QVAC provider serving models {models} with capabilities {capabilities}.

Register QVAC provider {agent_name} with models {models}, capabilities {capabilities}, paying out to {payout_address}.

GET /v1/qvac/provider/list List QVAC inference providers · List Providers #

Ask an LLM

“Which QVAC inference providers are registered?”

“Can I see only the providers that cleared the three-gate check?”

Tell an agent

List the QVAC providers.

List QVAC providers with listed_only set to {listed_only}.

GET /v1/qvac/provider/{provider_id} Get a QVAC provider · Get Provider #

Ask an LLM

“What models and capabilities does a specific QVAC provider offer?”

“How do I look up one QVAC provider by id?”

Tell an agent

Get QVAC provider {provider_id}.

Show the details of QVAC provider {provider_id}.

POST /v1/qvac/provider/{provider_id}/unregister Unregister a QVAC provider · Unregister Provider #

Ask an LLM

“How do I take my agent out of the QVAC provider pool?”

“Can I unregister a QVAC provider I no longer run?”

Tell an agent destructive · confirm first

Unregister QVAC provider {provider_id}.

Remove provider {provider_id} from QVAC.

POST /v1/qvac/inference/request Request a QVAC inference · Inference Request #

Ask an LLM

“How do I run a prompt against a QVAC model?”

“Can I pick which provider serves my QVAC inference or let it auto-pick?”

Tell an agent

Run {prompt} on QVAC model {model}.

Send {prompt} to model {model} on provider {provider_id}, settling in {asset}.

POST /v1/qvac/inference/request/public Request a QVAC inference paid by x402 · Inference Request Public #

Ask an LLM

“Can I pay for a QVAC inference with an x402 payment instead of an account?”

“What happens if I call the public QVAC inference endpoint without an X-Payment header?”

Tell an agent

Run {prompt} on QVAC model {model} through the public x402-paid endpoint.

Pay per call with x402 and run {prompt} on {model}, settling in {asset}.

GET /v1/qvac/leaderboard View the QVAC provider leaderboard · Leaderboard #

Ask an LLM

“Which QVAC inference providers rank highest?”

“Can I limit the QVAC provider leaderboard to the top few?”

Tell an agent

Show the QVAC provider leaderboard.

Show the top {top_n} QVAC inference providers.

GET /v1/qvac/agent_c/spread Get Agent C's QVAC spread quote · Agent C Spread #

Ask an LLM

“What spread would Agent C capture on a QVAC inference at a given notional?”

“Can I compute the Agent C spread using only listed providers?”

Tell an agent

Show Agent C's spread on {notional_usd} USD notional.

Get the Agent C spread for {notional_usd} USD with listed_only {listed_only}.

GET /v1/qvac/models List QVAC models · Models Catalog #

Ask an LLM

“Which QVAC model IDs can I request inference from?”

“What models are in the QVAC catalog?”

Tell an agent

List the QVAC model catalog.

Show me every QVAC model ID available.

GET /v1/qvac/stats Get QVAC marketplace stats · Stats #

Ask an LLM

“How many providers and inferences does the QVAC marketplace have?”

“What are the current QVAC usage statistics?”

Tell an agent

Show QVAC marketplace stats.

Report QVAC inference volume statistics.

GET /v1/qvac/economics View QVAC spread economics and projections · Economics #

Ask an LLM

“How much has the 3% HiveCompute spread earned on QVAC inference?”

“What would QVAC revenue look like at higher inference volumes?”

Tell an agent

Show QVAC economics.

Project QVAC spread revenue across inference volumes.

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-qvac-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 Qvac API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: qvac
paths:
  /v1/qvac/provider/register:
    post:
      tags:
      - qvac
      summary: Register Provider
      operationId: register_provider_v1_qvac_provider_register_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterProviderBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Register Provider V1 Qvac Provider Register Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/qvac/provider/list:
    get:
      tags:
      - qvac
      summary: List Providers
      operationId: list_providers_v1_qvac_provider_list_get
      parameters:
      - name: listed_only
        in: query
        required: false
        schema:
          type: boolean
          description: If true, only return providers cleared by 3-gate.
          default: false
          title: Listed Only
        description: If true, only return providers cleared by 3-gate.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Providers V1 Qvac Provider List Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/qvac/provider/{provider_id}:
    get:
      tags:
      - qvac
      summary: Get Provider
      operationId: get_provider_v1_qvac_provider__provider_id__get
      parameters:
      - name: provider_id
        in: path
        required: true
        schema:
          type: string
          title: Provider Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Provider V1 Qvac Provider  Provider Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/qvac/provider/{provider_id}/unregister:
    post:
      tags:
      - qvac
      summary: Unregister Provider
      operationId: unregister_provider_v1_qvac_provider__provider_id__unregister_post
      parameters:
      - name: provider_id
        in: path
        required: true
        schema:
          type: string
          title: Provider Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Unregister Provider V1 Qvac Provider  Provider Id  Unregister Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/qvac/inference/request:
    post:
      tags:
      - qvac
      summary: Inference Request
      operationId: inference_request_v1_qvac_inference_request_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InferenceRequestBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Inference Request V1 Qvac Inference Request Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/qvac/inference/request/public:
    post:
      tags:
      - qvac
      summary: Inference Request Public
      description: 'Public x402-gated variant of /v1/qvac/inference/request.


        Without X-Payment: returns HTTP 402 + x402 challenge body

        With valid X-Payment: returns the inference receipt

        With invalid X-Payment: returns HTTP 402 + INVALID_PAYMENT_PROOF'
      operationId: inference_request_public_v1_qvac_inference_request_public_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InferenceRequestBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/qvac/leaderboard:
    get:
      tags:
      - qvac
      summary: Leaderboard
      operationId: leaderboard_v1_qvac_leaderboard_get
      parameters:
      - name: top_n
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 50
          title: Top N
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Leaderboard V1 Qvac Leaderboard Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/qvac/agent_c/spread:
    get:
      tags:
      - qvac
      summary: Agent C Spread
      operationId: agent_c_spread_v1_qvac_agent_c_spread_get
      parameters:
      - name: notional_usd
        in: query
        required: false
        schema:
          type: number
          minimum: 0
          default: 0.001
          title: Notional Usd
      - name: listed_only
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Listed Only
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Agent C Spread V1 Qvac Agent C Spread Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/qvac/models:
    get:
      tags:
      - qvac
      summary: Models Catalog
      operationId: models_catalog_v1_qvac_models_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Models Catalog V1 Qvac Models Get
  /v1/qvac/stats:
    get:
      tags:
      - qvac
      summary: Stats
      operationId: stats_v1_qvac_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Stats V1 Qvac Stats Get
  /v1/qvac/economics:
    get:
      tags:
      - qvac
      summary: Economics
      description: 'Cumulative HiveCompute 3% spread take + forward projection at varying

        inference volumes. Mock pricing: avg $0.0008 per inference (geometric mean

        across LLM, embedding, TTS at typical token counts).'
      operationId: economics_v1_qvac_economics_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Economics V1 Qvac Economics Get
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    RegisterProviderBody:
      properties:
        agent_name:
          type: string
          maxLength: 80
          minLength: 2
          title: Agent Name
        capabilities:
          items:
            type: string
          type: array
          minItems: 1
          title: Capabilities
        models:
          items:
            type: string
          type: array
          minItems: 1
          title: Models
        operator_did:
          type: string
          title: Operator Did
          default: did:hive:qvac:operator
        payout_address:
          type: string
          title: Payout Address
          default: '0x15184bf50b3d3f52b60434f8942b7d52f2eb436e'
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        force_need:
          type: boolean
          title: Force Need
          description: Test/admin path — assert NEED externally (RFP from /v1/bus). Without this, NEED is enforced from live bus offers.
          default: false
      type: object
      required:
      - agent_name
      - capabilities
      - models
      title: RegisterProviderBody
    InferenceRequestBody:
      properties:
        model:
          type: string
          title: Model
          description: QVAC model ID, e.g. LLAMA_3_2_1B_INST_Q4_0
        prompt:
          type: string
          maxLength: 4096
          minLength: 1
          title: Prompt
        capability:
          type: string
          title: Capability
          default: llm_completion
        asset:
          type: string
          title: Asset
          description: 'Settlement asset: USDT, USDPT, USDC'
          default: USDT
        price_usdc:
          type: number
          minimum: 0.0
          title: Price Usdc
          default: 0.001
        requester_did:
          type: string
          title: Requester Did
          default: did:hive:caller
        provider_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Provider Id
          description: Specific provider; otherwise auto-pick.
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - model
      - prompt
      title: InferenceRequestBody
    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
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 Qvac 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