Hive Civilization Forge API

The forge API from Hive Civilization — 6 operation(s) for forge.

Documentation GitHub OpenAPI

Operations 6

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/forge/agent/qvac_provider/list List the QVAC provider agent's offerings · List Qvac Provider #

Ask an LLM

“What models or capabilities does the QVAC provider agent offer?”

“Can I filter the QVAC provider listing with metadata?”

Tell an agent

List what the QVAC provider agent offers.

List QVAC provider offerings matching metadata {metadata}.

GET /v1/forge/agents List all forge agents · Get Agents #

Ask an LLM

“Which agents are available in the forge?”

“What forge agents can I invoke?”

Tell an agent

List all forge agents.

Show me every agent registered in the forge.

GET /v1/forge/agent/qvac_provider Get the QVAC provider agent's details · Get Qvac Provider #

Ask an LLM

“What is the QVAC provider agent and how is it configured?”

“Where do I see the profile of the QVAC forge agent?”

Tell an agent

Get the QVAC provider agent's profile.

Describe the QVAC forge agent.

POST /v1/forge/agent/qvac_provider/invoke Run inference on the QVAC provider agent · Invoke Qvac Provider #

Ask an LLM

“How do I send a prompt to a QVAC model through the forge?”

“Can I set the USDC price and payout address when invoking the provider?”

Tell an agent

Invoke QVAC model {model} with prompt {prompt}.

Run {prompt} on the QVAC provider for {price_usdc} USDC paid out to {payout_address}.

POST /v1/forge/agent/qvac_provider/invoke/public Pay-per-call QVAC inference via x402 · Invoke Qvac Provider Public #

Ask an LLM

“How do I call the QVAC provider publicly and pay per request with x402?”

“What happens if I call the public forge invoke without an X-Payment header?”

Tell an agent

Invoke the public x402-gated QVAC endpoint with model {model} and prompt {prompt}.

Pay via x402 and run {prompt} on the public QVAC route.

GET /v1/forge/agent/qvac_provider/economics See the QVAC provider agent's economics · Economics Qvac Provider #

Ask an LLM

“How much has the QVAC provider agent earned and what does it cost?”

“Where are the revenue and pricing numbers for the QVAC agent?”

Tell an agent

Show the QVAC provider agent's economics.

Get earnings and pricing for the QVAC forge agent.

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-forge-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 Forge API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: forge
paths:
  /v1/forge/agent/qvac_provider/list:
    post:
      tags:
      - forge
      summary: List Qvac Provider
      operationId: list_qvac_provider_v1_forge_agent_qvac_provider_list_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response List Qvac Provider V1 Forge Agent Qvac Provider List Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/forge/agents:
    get:
      tags:
      - forge
      summary: Get Agents
      operationId: get_agents_v1_forge_agents_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Agents V1 Forge Agents Get
  /v1/forge/agent/qvac_provider:
    get:
      tags:
      - forge
      summary: Get Qvac Provider
      operationId: get_qvac_provider_v1_forge_agent_qvac_provider_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Qvac Provider V1 Forge Agent Qvac Provider Get
  /v1/forge/agent/qvac_provider/invoke:
    post:
      tags:
      - forge
      summary: Invoke Qvac Provider
      operationId: invoke_qvac_provider_v1_forge_agent_qvac_provider_invoke_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvokeBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Invoke Qvac Provider V1 Forge Agent Qvac Provider Invoke Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/forge/agent/qvac_provider/invoke/public:
    post:
      tags:
      - forge
      summary: Invoke Qvac Provider Public
      description: 'Public x402-gated forge invoke.


        Without X-Payment: HTTP 402 + x402 challenge body

        With valid X-Payment: runs three-gate + qvac inference and returns

        the same response shape as the non-/public route

        With invalid X-Payment: HTTP 402 + INVALID_PAYMENT_PROOF'
      operationId: invoke_qvac_provider_public_v1_forge_agent_qvac_provider_invoke_public_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvokeBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/forge/agent/qvac_provider/economics:
    get:
      tags:
      - forge
      summary: Economics Qvac Provider
      operationId: economics_qvac_provider_v1_forge_agent_qvac_provider_economics_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Economics Qvac Provider V1 Forge Agent Qvac Provider Economics Get
components:
  schemas:
    InvokeBody:
      properties:
        model:
          type: string
          title: Model
          default: LLAMA_3_2_1B_INST_Q4_0
        prompt:
          type: string
          maxLength: 4096
          minLength: 1
          title: Prompt
          default: forge invoke ping
        capability:
          type: string
          title: Capability
          default: llm_completion
        settle_currency:
          type: string
          title: Settle Currency
          description: USDT or USDC
          default: USDT
        price_usdc:
          type: number
          minimum: 0.0
          title: Price Usdc
          default: 0.0008
        requester_did:
          type: string
          title: Requester Did
          default: did:hive:forge:caller
        payout_address:
          type: string
          title: Payout Address
          default: '0x15184bf50b3d3f52b60434f8942b7d52f2eb436e'
        provider_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Provider Id
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        force_need:
          type: boolean
          title: Force Need
          description: Test path — assert NEED externally. Without this, NEED is checked from the live qvac leaderboard.
          default: false
      type: object
      title: InvokeBody
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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
    ListBody:
      properties:
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      title: ListBody
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 Forge API

Operations 6

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification