Hive Civilization Organic API

The organic API from Hive Civilization — 9 operation(s) for organic.

Documentation GitHub OpenAPI

Operations 10

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/rosetta/normalize Normalize free-form input to a canonical schema · Rosetta Normalize #

Ask an LLM

“Can I turn a messy natural-language request into a canonical intent, quote or route?”

“How do I normalize input written in another locale into the canonical schema?”

Tell an agent

Normalize {input} into the canonical {target} schema.

Normalize {input} written in locale {locale}.

POST /v1/prospector/score Score an agent's intent as a prospect · Prospector Score #

Ask an LLM

“How promising is an agent as a prospect given what it wants to do?”

“Can I get a prospector score for an agent DID and its stated intent?”

Tell an agent

Score agent {agent_did} as a prospect for intent {intent}.

Rate prospect {agent_did} wanting {intent} given context {context}.

GET /v1/hktn/lookup Look up an HKTN registration · Hktn Lookup #

Ask an LLM

“What HKTN tier is an agent registered under?”

“Can I find an HKTN record by its hktn id or by agent DID?”

Tell an agent

Look up HKTN {hktn}.

Find the HKTN registration for agent {agent_did}.

POST /v1/hktn/register Submit an HKTN registration intent · Hktn Register #

Ask an LLM

“How does an agent register for an HKTN tier and see the x402 discount it could earn?”

“Can I self-claim a Warm or Hot HKTN tier when registering?”

Tell an agent

Register agent {agent_did} for HKTN.

Register {agent_did} for HKTN requesting tier {requested_tier}, vouched by operator {operator_did}.

POST /v1/rubric/select Select the rubric for an intent · Rubric Select #

Ask an LLM

“Which evaluation rubric applies to a given intent and amount?”

“Can constraints change which rubric gets picked for my request?”

Tell an agent

Select a rubric for intent {intent}.

Pick the rubric for {intent} at {amount_usd} USD with constraints {constraints}.

GET /v1/settlement/reference Generate a USDC settlement reference · Settlement Reference #

Ask an LLM

“How do I get a settlement reference for paying an amount in USDC?”

“Can I attach a short memo to a USDC settlement reference?”

Tell an agent

Get a settlement reference for {amount_usdc} USDC.

Create a settlement reference for {amount_usdc} USDC with memo {memo}.

POST /v1/receipt/emit Emit a signed receipt for an artifact · Receipt Emit #

Ask an LLM

“How does an agent get a signed receipt over an artifact it produced?”

“Which receipt profiles exist, and when is a delegation envelope required?”

Tell an agent

Emit a receipt for artifact {artifact} from agent {agent_did}.

Emit a post-quantum receipt for {artifact} from {agent_did} using envelope {regulated_envelope_jti} and profile {profile}.

GET /v1/receipt/emit Preflight the receipt emit endpoint · Receipt Emit Preflight #

Ask an LLM

“What do I need to send before emitting a signed receipt?”

“Can I check what a given receipt profile requires without writing anything?”

Tell an agent

Preflight receipt emission.

Preflight emitting a {profile} receipt.

GET /v1/receipt/benchmark Benchmark the receipt signing path · Receipt Benchmark #

Ask an LLM

“How long does it take to hash, sign and verify a receipt end to end?”

“Can I see per-phase timing for the post-quantum receipt profile?”

Tell an agent

Run the receipt benchmark.

Benchmark the {profile} receipt profile.

GET /v1/pricing Get receipt and service pricing · Pricing #

Ask an LLM

“What are the published prices for Hive's receipt services?”

“Where is the pricing table for the core API?”

Tell an agent

Show the pricing table.

Get current service pricing.

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-organic-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 Organic API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: organic
paths:
  /v1/rosetta/normalize:
    post:
      tags:
      - organic
      summary: Rosetta Normalize
      operationId: rosetta_normalize_v1_rosetta_normalize_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RosettaReq'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Rosetta Normalize V1 Rosetta Normalize Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/prospector/score:
    post:
      tags:
      - organic
      summary: Prospector Score
      operationId: prospector_score_v1_prospector_score_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProspectorReq'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Prospector Score V1 Prospector Score Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/hktn/lookup:
    get:
      tags:
      - organic
      summary: Hktn Lookup
      operationId: hktn_lookup_v1_hktn_lookup_get
      parameters:
      - name: hktn
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: HKTN id, e.g. hktn_...
          title: Hktn
        description: HKTN id, e.g. hktn_...
      - name: agent_did
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Agent DID to look up
          title: Agent Did
        description: Agent DID to look up
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Hktn Lookup V1 Hktn Lookup Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/hktn/register:
    post:
      tags:
      - organic
      summary: Hktn Register
      description: 'Accept an HKTN registration intent.


        Returns the canonical tier table, the x402 discount the caller would

        earn at each tier, the next-best-actions for promotion, and a signed

        receipt of the registration intent that the caller can present

        downstream. Tier promotion itself is ROADMAP — this route does not

        write into the R5 ledger.'
      operationId: hktn_register_v1_hktn_register_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HKTNRegisterReq'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Hktn Register V1 Hktn Register Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/rubric/select:
    post:
      tags:
      - organic
      summary: Rubric Select
      operationId: rubric_select_v1_rubric_select_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RubricReq'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Rubric Select V1 Rubric Select Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/settlement/reference:
    get:
      tags:
      - organic
      summary: Settlement Reference
      operationId: settlement_reference_v1_settlement_reference_get
      parameters:
      - name: amount_usdc
        in: query
        required: true
        schema:
          type: number
          exclusiveMinimum: 0
          description: Amount in USDC (decimal)
          title: Amount Usdc
        description: Amount in USDC (decimal)
      - name: memo
        in: query
        required: false
        schema:
          type: string
          maxLength: 64
          description: Optional short memo
          default: ''
          title: Memo
        description: Optional short memo
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Settlement Reference V1 Settlement Reference Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/receipt/emit:
    post:
      tags:
      - organic
      summary: Receipt Emit
      operationId: receipt_emit_v1_receipt_emit_post
      parameters:
      - name: profile
        in: query
        required: false
        schema:
          type: string
          description: 'Receipt profile: nano | standard | pq'
          default: standard
          title: Profile
        description: 'Receipt profile: nano | standard | pq'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReceiptEmitReq'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Receipt Emit V1 Receipt Emit Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - organic
      summary: Receipt Emit Preflight
      description: 'Preflight/discovery for the emit surface.


        ``GET /v1/receipt/emit`` previously fell through to the swarm catch-all

        ``GET /v1/receipt/{receipt_id}`` and returned 404 ("receipt not found").

        Emitting a receipt is a *write* — it requires a POST body — so a GET is a

        preflight. It answers three honest questions without minting anything:


        - unknown profile → 400 with the allowed profiles

        - emit is payment-gated → 402 x402 payment_required metadata (no charge)

        - emit is ungated (dev) → 200 describing the free POST path


        No receipt is minted and nothing is written to the ledger on GET.'
      operationId: receipt_emit_preflight_v1_receipt_emit_get
      parameters:
      - name: profile
        in: query
        required: false
        schema:
          type: string
          description: 'Receipt profile: nano | standard | pq'
          default: standard
          title: Profile
        description: 'Receipt profile: nano | standard | pq'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/receipt/benchmark:
    get:
      tags:
      - organic
      summary: Receipt Benchmark
      description: 'Read-only live benchmark of the receipt path.


        Performs a REAL receipt operation end-to-end and reports per-phase timing:

        canonicalize a fixed benchmark payload, SHA-256 hash it, Ed25519-sign it

        with the production signer, and verify the signature. When HIVE_PQ_ENABLED

        is active, an ML-DSA-65 co-signature is computed and timed too.


        This proves the *receipt path* — canonicalize → hash → sign → verify — is

        live and fast. It does NOT prove external model inference, and it does NOT

        prove any theorem: no Leanstral run, no proof assistant is invoked here.


        Read-only: nothing is written to the ledger and no state is mutated.'
      operationId: receipt_benchmark_v1_receipt_benchmark_get
      parameters:
      - name: profile
        in: query
        required: false
        schema:
          type: string
          description: 'Receipt profile: nano | standard | pq'
          default: nano
          title: Profile
        description: 'Receipt profile: nano | standard | pq'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/pricing:
    get:
      tags:
      - organic
      summary: Pricing
      operationId: pricing_v1_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Pricing V1 Pricing Get
components:
  schemas:
    HKTNRegisterReq:
      properties:
        agent_did:
          type: string
          maxLength: 200
          minLength: 3
          title: Agent Did
        intent:
          type: string
          maxLength: 64
          title: Intent
          default: hktn.register
        contact:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Contact
        operator_did:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Operator Did
          description: Optional operator/issuer that vouches for this agent.
        requested_tier:
          anyOf:
          - type: string
            maxLength: 24
          - type: 'null'
          title: Requested Tier
          description: Optional self-claim. Cold|Warm|Hot|Regulated. Subject to verification.
        notes:
          anyOf:
          - type: string
            maxLength: 2048
          - type: 'null'
          title: Notes
      type: object
      required:
      - agent_did
      title: HKTNRegisterReq
    RosettaReq:
      properties:
        input:
          type: string
          maxLength: 4096
          minLength: 1
          title: Input
        locale:
          type: string
          maxLength: 16
          title: Locale
          default: en-US
        target:
          type: string
          title: Target
          description: 'canonical schema target: intent | quote | route'
          default: intent
      type: object
      required:
      - input
      title: RosettaReq
    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
    ReceiptEmitReq:
      properties:
        agent_did:
          type: string
          maxLength: 200
          minLength: 3
          title: Agent Did
        artifact:
          type: string
          maxLength: 65536
          minLength: 1
          title: Artifact
          description: The artifact body or its sha256 hex
        artifact_type:
          type: string
          maxLength: 128
          title: Artifact Type
          default: application/octet-stream
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        regulated_envelope_jti:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Regulated Envelope Jti
          description: Required when profile='pq'. The jti of a delegation envelope (issued via /v1/delegation/issue or operator-sign) whose allowed_surfaces includes 'pq'. Standard and nano profiles ignore this field.
      type: object
      required:
      - agent_did
      - artifact
      title: ReceiptEmitReq
    RubricReq:
      properties:
        intent:
          type: string
          maxLength: 2048
          minLength: 1
          title: Intent
        amount_usd:
          anyOf:
          - type: number
            minimum: 0.0
          - type: 'null'
          title: Amount Usd
        context:
          additionalProperties: true
          type: object
          title: Context
        constraints:
          items:
            type: string
          type: array
          title: Constraints
      type: object
      required:
      - intent
      title: RubricReq
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ProspectorReq:
      properties:
        agent_did:
          type: string
          maxLength: 200
          minLength: 3
          title: Agent Did
        intent:
          type: string
          maxLength: 2048
          minLength: 1
          title: Intent
        context:
          additionalProperties: true
          type: object
          title: Context
      type: object
      required:
      - agent_did
      - intent
      title: ProspectorReq
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 Organic API

Operations 10

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification