Hive Civilization Hive Prior API

The hive-prior API from Hive Civilization — 6 operation(s) for hive-prior.

Documentation GitHub OpenAPI

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

POST /v1/prior/issue Stamp a patent priority record for an invention · Issue Prior #

Ask an LLM

“How do I timestamp an invention disclosure so I can prove I had it first?”

“What does a USPTO-tier priority stamp require beyond the content hash?”

Tell an agent

Stamp priority for content hash {content_hash} by inventor {inventor_did}.

Issue a {classification} priority record titled {title} for hash {content_hash} and inventor {inventor_did}.

GET /v1/prior/verify/{prior_id} Verify a patent priority record · Verify Prior #

Ask an LLM

“Is a given priority record genuine and are both signatures valid?”

“Can I look up a priority stamp by its id and re-check it?”

Tell an agent

Verify priority record {prior_id}.

Re-check the dual signature on prior {prior_id}.

GET /v1/prior/by-hash/{content_hash} Find who stamped a content hash first · By Hash #

Ask an LLM

“Who stamped a particular invention hash first?”

“Can more than one inventor stamp the same content hash?”

Tell an agent

List priority records for content hash {content_hash} in chronological order.

Show who first stamped {content_hash}.

GET /v1/prior/by-inventor/{inventor_did} List an inventor's priority records · By Inventor #

Ask an LLM

“Which disclosures has an inventor DID stamped, newest first?”

“Can I page through one inventor's priority records?”

Tell an agent

List priority records for inventor {inventor_did}.

Show {limit} records for {inventor_did} from offset {offset}.

GET /v1/prior/health Check the priority stamping service health · Health #

Ask an LLM

“Is the patent priority service healthy and able to write records?”

“How many priority records are stored right now?”

Tell an agent

Check the priority service health and record count.

Run the priority service write probe.

GET /v1/prior/leaderboard Rank inventors by priority stamps issued · Leaderboard #

Ask an LLM

“Which inventors have stamped the most disclosures in the last month?”

“Can I change the time window of the inventor leaderboard?”

Tell an agent

Show the top inventors by priority receipts.

Rank inventors over the last {days} days.

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-hive-prior-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 Hive Prior API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: hive-prior
paths:
  /v1/prior/issue:
    post:
      tags:
      - hive-prior
      summary: Issue Prior
      description: 'Stamp a new Patent Priority record.


        Issues a dual-signed ML-DSA-65 + Ed25519 CBOR envelope that binds

        content_hash + inventor_did + timestamp. Persists to prior_records.jsonl.'
      operationId: issue_prior_v1_prior_issue_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PriorIssueRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PriorIssueResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/prior/verify/{prior_id}:
    get:
      tags:
      - hive-prior
      summary: Verify Prior
      description: 'Return the stored Prior record and a freshly-computed dual-signature verification.

        Returns 404 if the prior_id is unknown.'
      operationId: verify_prior_v1_prior_verify__prior_id__get
      parameters:
      - name: prior_id
        in: path
        required: true
        schema:
          type: string
          title: Prior Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/prior/by-hash/{content_hash}:
    get:
      tags:
      - hive-prior
      summary: By Hash
      description: 'Return all Prior records for a content hash.


        Multiple inventors can stamp the same content hash. This endpoint proves

        who stamped first by returning records in chronological order.'
      operationId: by_hash_v1_prior_by_hash__content_hash__get
      parameters:
      - name: content_hash
        in: path
        required: true
        schema:
          type: string
          title: Content Hash
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/prior/by-inventor/{inventor_did}:
    get:
      tags:
      - hive-prior
      summary: By Inventor
      description: 'Return paginated list of Prior records for an inventor DID.

        Results are sorted newest-first.'
      operationId: by_inventor_v1_prior_by_inventor__inventor_did__get
      parameters:
      - name: inventor_did
        in: path
        required: true
        schema:
          type: string
          title: Inventor Did
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/prior/health:
    get:
      tags:
      - hive-prior
      summary: Health
      description: Endpoint health check + record count + write probe.
      operationId: health_v1_prior_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/prior/leaderboard:
    get:
      tags:
      - hive-prior
      summary: Leaderboard
      description: Top inventor DIDs by Prior receipts issued (default last 30 days).
      operationId: leaderboard_v1_prior_leaderboard_get
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    PriorIssueRequest:
      properties:
        content_hash:
          type: string
          maxLength: 64
          minLength: 64
          pattern: ^[0-9a-fA-F]{64}$
          title: Content Hash
          description: SHA-256 hex digest of the disclosed invention content.
        inventor_did:
          type: string
          minLength: 10
          title: Inventor Did
          description: Inventor DID in did:hive format.
        title:
          anyOf:
          - type: string
            maxLength: 256
          - type: 'null'
          title: Title
          description: Optional human title for this disclosure.
        classification:
          type: string
          enum:
          - disclosure
          - singularity
          - uspto
          title: Classification
          description: 'Prior tier: disclosure | singularity | uspto.'
          default: disclosure
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Metadata
          description: Free-form metadata dict.
        uspto_application_serial:
          anyOf:
          - type: string
            maxLength: 32
          - type: 'null'
          title: Uspto Application Serial
          description: USPTO application serial number. Required for uspto tier to unlock USPTO filing integration.
      type: object
      required:
      - content_hash
      - inventor_did
      title: PriorIssueRequest
    PriorIssueResponse:
      properties:
        prior_id:
          type: string
          title: Prior Id
        receipt_envelope:
          additionalProperties: true
          type: object
          title: Receipt Envelope
        content_hash:
          type: string
          title: Content Hash
        inventor_did:
          type: string
          title: Inventor Did
        timestamp_iso:
          type: string
          title: Timestamp Iso
        entropy_axes:
          type: integer
          title: Entropy Axes
        tier:
          type: string
          title: Tier
        price_usd_cents:
          type: integer
          title: Price Usd Cents
      type: object
      required:
      - prior_id
      - receipt_envelope
      - content_hash
      - inventor_did
      - timestamp_iso
      - entropy_axes
      - tier
      - price_usd_cents
      title: PriorIssueResponse
    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 Hive Prior 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