Hive Civilization Tax API

The tax API from Hive Civilization — 4 operation(s) for tax.

Documentation GitHub OpenAPI

Operations 4

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/tax/event Classify one transaction for tax · Post Tax Event #

Ask an LLM

“How would a single on-chain transaction be classified for tax purposes?”

“Which chains can a transaction be tax-classified on?”

Tell an agent

Classify transaction {tx_hash} on {chain} for tax.

Tell me the taxable event type of {tx_hash} on {chain}.

POST /v1/tax/bulk Classify a batch of transactions for tax · Post Tax Bulk #

Ask an LLM

“Can I tax-classify many transactions in one call?”

“What is the maximum number of transactions per bulk classification?”

Tell an agent

Classify these transactions on {chain}: {tx_hashes}.

Bulk-classify up to 50 hashes {tx_hashes} on {chain}.

GET /v1/tax/today Count taxable events in the last 24 hours · Get Tax Today #

Ask an LLM

“How many taxable events were seen in the past day, by type?”

“Which taxable event types are most common today?”

Tell an agent

Show today's taxable event counts by type.

Get the 24-hour tax classification rollup.

GET /v1/tax/health Check the tax classifier's health · Get Tax Health #

Ask an LLM

“Is the tax classification service up?”

“Can I verify the tax classifier is responding?”

Tell an agent

Check tax service health.

Confirm the tax classifier is available.

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-tax-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 Tax API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: Tax
paths:
  /v1/tax/event:
    post:
      tags:
      - Tax
      summary: Post Tax Event
      description: Classify a single transaction. Real on-chain reads. Inputs only — no advice.
      operationId: post_tax_event_v1_tax_event_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaxEventBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Tax Event V1 Tax Event Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/tax/bulk:
    post:
      tags:
      - Tax
      summary: Post Tax Bulk
      description: Classify an array of transactions in a single call (max 50).
      operationId: post_tax_bulk_v1_tax_bulk_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaxBulkBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Tax Bulk V1 Tax Bulk Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/tax/today:
    get:
      tags:
      - Tax
      summary: Get Tax Today
      description: Count of taxable-classified events seen in the last 24h, by event type.
      operationId: get_tax_today_v1_tax_today_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Tax Today V1 Tax Today Get
  /v1/tax/health:
    get:
      tags:
      - Tax
      summary: Get Tax Health
      operationId: get_tax_health_v1_tax_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Tax Health V1 Tax Health Get
components:
  schemas:
    TaxBulkBody:
      properties:
        tx_hashes:
          items:
            type: string
          type: array
          title: Tx Hashes
          description: Array of transaction hashes/signatures
        chain:
          type: string
          title: Chain
          description: base | ethereum | solana
      type: object
      required:
      - tx_hashes
      - chain
      title: TaxBulkBody
    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
    TaxEventBody:
      properties:
        tx_hash:
          type: string
          title: Tx Hash
          description: Transaction hash (EVM) or signature (Solana)
        chain:
          type: string
          title: Chain
          description: base | ethereum | solana
      type: object
      required:
      - tx_hash
      - chain
      title: TaxEventBody
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 Tax API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification