Hive Civilization Billing Meter API

The billing-meter API from Hive Civilization — 6 operation(s) for billing-meter.

Documentation GitHub OpenAPI

Business capability

Usage Metering BC-4250.10

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/billing/meter/health Describe the billing meter and its prices · Meter Health #

Ask an LLM

“What does the usage meter charge, and which chains can I pay on?”

“Where can I see the billing meter schema?”

Tell an agent

Show me the billing meter schema and prices.

List the chains the meter accepts.

POST /v1/billing/activate Activate a metered billing account · Meter Activate #

Ask an LLM

“How do I bind my activation key to a metered account?”

“Can I attach a wallet when activating billing, and is it safe to repeat?”

Tell an agent

Activate metering for key {activation_key_id}.

Activate key {activation_key_id} with wallet {wallet_addr} labeled {label}.

GET /v1/billing/usage/{account_id} Get an account's signed usage snapshot · Meter Usage #

Ask an LLM

“How much has my metered account used so far?”

“Is the usage snapshot signed so I can verify it?”

Tell an agent

Show usage for account {account_id}.

Get the signed usage snapshot for {account_id}.

POST /v1/billing/topup/intent Start a USDC top-up · Meter Topup Intent #

Ask an LLM

“How do I add USDC credit to my metered account?”

“What treasury address and memo do I use to top up?”

Tell an agent

Top up account {account_id} with {amount_cents} cents of USDC on {chain}.

Create a top-up intent for {account_id} on {chain} worth {amount_cents} cents.

GET /v1/billing/topup/{intent_id} Check a top-up's settlement status · Meter Topup Status #

Ask an LLM

“Has my USDC top-up settled yet?”

“Can I track a top-up intent after I send funds?”

Tell an agent

Check top-up {intent_id}.

Tell me whether top-up intent {intent_id} has settled.

GET /v1/billing/whoami Find the account for my activation key · Whoami #

Ask an LLM

“Which billing account does my activation key belong to?”

“Can I resolve my key to an account ID for the billing dashboard?”

Tell an agent

Tell me which billing account I'm using.

Resolve my activation key to its account ID.

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-billing-meter-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 Billing Meter API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: billing-meter
paths:
  /v1/billing/meter/health:
    get:
      tags:
      - billing-meter
      summary: Meter Health
      description: Public — describes the meter schema, prices, and supported chains.
      operationId: meter_health_v1_billing_meter_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Meter Health V1 Billing Meter Health Get
  /v1/billing/activate:
    post:
      tags:
      - billing-meter
      summary: Meter Activate
      description: 'Bind an activation key (and optionally a wallet) to a metered account.

        Idempotent — activating the same key twice returns the same account.'
      operationId: meter_activate_v1_billing_activate_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ActivateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Meter Activate V1 Billing Activate Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/usage/{account_id}:
    get:
      tags:
      - billing-meter
      summary: Meter Usage
      description: Signed usage snapshot for an account. Verify via /v1/receipt/verify.
      operationId: meter_usage_v1_billing_usage__account_id__get
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Meter Usage V1 Billing Usage  Account Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/topup/intent:
    post:
      tags:
      - billing-meter
      summary: Meter Topup Intent
      description: Create a USDC top-up intent. Returns treasury address + amount + memo.
      operationId: meter_topup_intent_v1_billing_topup_intent_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TopupIntentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Meter Topup Intent V1 Billing Topup Intent Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/topup/{intent_id}:
    get:
      tags:
      - billing-meter
      summary: Meter Topup Status
      description: Check settlement status of a topup intent.
      operationId: meter_topup_status_v1_billing_topup__intent_id__get
      parameters:
      - name: intent_id
        in: path
        required: true
        schema:
          type: string
          title: Intent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Meter Topup Status V1 Billing Topup  Intent Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/whoami:
    get:
      tags:
      - billing-meter
      summary: Whoami
      description: Resolve activation key → account_id. Useful for the /billing/ dashboard.
      operationId: whoami_v1_billing_whoami_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Whoami V1 Billing Whoami Get
components:
  schemas:
    TopupIntentRequest:
      properties:
        account_id:
          type: string
          title: Account Id
        chain:
          type: string
          title: Chain
          description: 'One of: base, ethereum'
        amount_cents:
          type: integer
          minimum: 1000.0
          title: Amount Cents
          description: Amount to top up in USD cents. Minimum 1000 ($10.00).
      type: object
      required:
      - account_id
      - chain
      - amount_cents
      title: TopupIntentRequest
    ActivateRequest:
      properties:
        activation_key_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Activation Key Id
          description: Existing X-Hive-Activation-Key value
        wallet_addr:
          anyOf:
          - type: string
          - type: 'null'
          title: Wallet Addr
          description: Optional wallet address to bind (informational)
        label:
          anyOf:
          - type: string
          - type: 'null'
          title: Label
          description: Optional human label — e.g. 'circle-prod'
      type: object
      title: ActivateRequest
    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)

Hive Civilization Billing Meter 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