Hive Civilization Ops API

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

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

GET /v1/ops/health Get aggregate health for every endpoint group · Ops Health #
Ask an LLM
“What are the p50, p95 and error rates across every endpoint prefix?”
“Which endpoint groups are slow or erroring right now?”
Tell an agent
Show aggregate health for all endpoint prefixes.
List latency percentiles and error rate per route prefix.
GET /v1/ops/revenue Get a revenue snapshot · Ops Revenue #
Ask an LLM
“How much revenue has come in through card payments and the USDC treasury?”
“What's the current on-chain USDC treasury balance?”
Tell an agent
Show the current revenue snapshot.
Report gross card revenue and USDC treasury balance.
GET /v1/ops/calls List the busiest endpoints in the last minute · Ops Calls #
Ask an LLM
“Which endpoints are getting the most calls per minute right now?”
“What are the top 20 routes by request rate?”
Tell an agent
Show the top endpoints by calls per minute.
List per-endpoint call counts for the last 60 seconds.
GET /v1/ops/deploys Show the last deploy for each service · Ops Deploys #
Ask an LLM
“When was each service last deployed and at what commit?”
“Which git SHA is running for each service?”
Tell an agent
Show the latest deploy SHA and time per service.
List recent deploys across services.
GET /v1/ops/traffic Get the public traffic snapshot · Ops Traffic Public #
Ask an LLM
“Is there a public traffic summary I can show on a homepage tile?”
“How busy is the platform right now, publicly?”
Tell an agent
Get the public traffic HUD snapshot.
Show the lean public traffic stats.
GET /v1/ops/full Get the full operator traffic view · Ops Traffic Full #
Ask an LLM
“How do I see the full operator view of every service, repo and perimeter detail?”
“What key do I need for the detailed ops traffic view?”
Tell an agent
Show the full operator view using ops key {key}.
Pull every service and perimeter detail with key {key}.

Documentation

Specifications

Other Resources

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-ops-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.

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

OpenAPI Specification

thehiveryiq-com-ops-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Ops API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: ops
paths:
  /v1/ops/health:
    get:
      tags:
      - ops
      summary: Ops Health
      description: 'Aggregate health of every registered endpoint prefix.

        Uses the OpsMetricsMiddleware ring buffer for p50/p95/error-rate.

        Also introspects app.routes for route_count per prefix.'
      operationId: ops_health_v1_ops_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Ops Health V1 Ops Health Get
  /v1/ops/revenue:
    get:
      tags:
      - ops
      summary: Ops Revenue
      description: 'Revenue snapshot: Square gross + USDC-Base treasury balance.

        Uses Square API if SQUARE_ACCESS_TOKEN is set; otherwise returns cached snapshot.

        Base RPC used for on-chain USDC balance; falls back to cached snapshot on failure.'
      operationId: ops_revenue_v1_ops_revenue_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Ops Revenue V1 Ops Revenue Get
  /v1/ops/calls:
    get:
      tags:
      - ops
      summary: Ops Calls
      description: 'Rolling per-endpoint call counts — top 20 by RPM from in-memory ring buffer

        (last 60 seconds).'
      operationId: ops_calls_v1_ops_calls_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Ops Calls V1 Ops Calls Get
  /v1/ops/deploys:
    get:
      tags:
      - ops
      summary: Ops Deploys
      description: Last deploy SHA + timestamp per service from /tmp/hive_ops/deploys.json.
      operationId: ops_deploys_v1_ops_deploys_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Ops Deploys V1 Ops Deploys Get
  /v1/ops/traffic:
    get:
      tags:
      - ops
      summary: Ops Traffic Public
      description: Public HUD snapshot — lean fields for the homepage tile. Cached 60s.
      operationId: ops_traffic_public_v1_ops_traffic_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Ops Traffic Public V1 Ops Traffic Get
  /v1/ops/full:
    get:
      tags:
      - ops
      summary: Ops Traffic Full
      description: Full operator view — every service, every repo, perimeter detail. Key-gated.
      operationId: ops_traffic_full_v1_ops_full_get
      parameters:
      - name: key
        in: query
        required: true
        schema:
          type: string
          description: ops key
          title: Key
        description: ops key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Ops Traffic Full V1 Ops Full Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    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
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)