Hive Civilization · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Thehiveryiq Com Tax API

5 actions 5 updates phrasing extends openapi/thehiveryiq-com-tax-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Hive Civilization's API. It is a proposal applied on top of the contract, not a document Hive Civilization publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info
$.paths['/v1/tax/event'].post
$.paths['/v1/tax/bulk'].post
$.paths['/v1/tax/today'].get
$.paths['/v1/tax/health'].get

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Tax API
  version: 1.0.0
extends: openapi/thehiveryiq-com-tax-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/v1/tax/event'].post
  update:
    x-apievangelist-phrasing:
      intent: Classify one transaction for tax
      effect: read
      questions:
      - How would a single on-chain transaction be classified for tax purposes?
      - Which chains can a transaction be tax-classified on?
      - Does the tax classifier give advice or only classify inputs?
      instructions:
      - text: Classify transaction {tx_hash} on {chain} for tax.
        slots:
          tx_hash: requestBody.tx_hash
          chain: requestBody.chain
      - text: Tell me the taxable event type of {tx_hash} on {chain}.
        slots:
          tx_hash: requestBody.tx_hash
          chain: requestBody.chain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/tax/bulk'].post
  update:
    x-apievangelist-phrasing:
      intent: Classify a batch of transactions for tax
      effect: read
      questions:
      - Can I tax-classify many transactions in one call?
      - What is the maximum number of transactions per bulk classification?
      instructions:
      - text: 'Classify these transactions on {chain}: {tx_hashes}.'
        slots:
          chain: requestBody.chain
          tx_hashes: requestBody.tx_hashes
      - text: Bulk-classify up to 50 hashes {tx_hashes} on {chain}.
        slots:
          tx_hashes: requestBody.tx_hashes
          chain: requestBody.chain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/tax/today'].get
  update:
    x-apievangelist-phrasing:
      intent: Count taxable events in the last 24 hours
      effect: read
      questions:
      - How many taxable events were seen in the past day, by type?
      - Which taxable event types are most common today?
      instructions:
      - text: Show today's taxable event counts by type.
      - text: Get the 24-hour tax classification rollup.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/tax/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the tax classifier's health
      effect: read
      questions:
      - Is the tax classification service up?
      - Can I verify the tax classifier is responding?
      instructions:
      - text: Check tax service health.
      - text: Confirm the tax classifier is available.
      method: generated
      generated: '2026-09-26'