Hive Civilization Evaluator API

The evaluator API from Hive Civilization — 11 operation(s) for evaluator.

Documentation GitHub OpenAPI

Operations 11

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/evaluator/status Check the ERC-8183 evaluator listener state · ERC-8183 evaluator listener state #

Ask an LLM

“Is the ERC-8183 evaluator listener currently running?”

“What state is the evaluator's background listener in?”

Tell an agent

Show the evaluator listener status.

Check whether the ERC-8183 evaluator is listening.

GET /v1/evaluator/abi Get the evaluator contract ABI summary · ERC-8183 evaluator ABI summary #

Ask an LLM

“What does the ERC-8183 evaluator contract ABI look like?”

“Which contract functions and events does the evaluator expose?”

Tell an agent

Get the ERC-8183 evaluator ABI summary.

Show me the evaluator ABI so I can wire my contract calls.

GET /v1/evaluator/recent_jobs List recently evaluated jobs · Recently evaluated jobs #

Ask an LLM

“Which jobs has the evaluator scored most recently?”

“Can I limit how many recent evaluations come back?”

Tell an agent

List the {limit} most recently evaluated jobs.

Show recent evaluator job results.

GET /v1/evaluator/economics See evaluator fee and x402 rail wiring · Evaluator fee + x402 rail wiring #

Ask an LLM

“How are evaluator fees wired to x402 payment rails?”

“Where do evaluator economics and settlement rails get described?”

Tell an agent

Show the evaluator economics and x402 rail wiring.

Explain how evaluator fees flow over x402.

POST /v1/evaluator/manual_evaluate Manually trigger evaluation of a job · Synthesize a JobSubmitted event and evaluate #

Ask an LLM

“Can I force an evaluation without waiting for an on-chain JobSubmitted event?”

“What admin credentials does a manual evaluation need?”

Tell an agent

Manually evaluate job {job_id} from provider {provider}.

Synthesize a JobSubmitted event for job {job_id} by {provider} with deliverable {deliverable} and evaluate it.

POST /v1/evaluator/start Start the evaluator background listener · Start the background listener (dev-trust only) #

Ask an LLM

“How do I turn on the evaluator's background event listener?”

“Is starting the evaluator listener limited to dev-trust callers?”

Tell an agent

Start the evaluator background listener.

Start the listener using admin key {admin_key}.

POST /v1/evaluator/stop Stop the evaluator background listener · Stop the background listener (dev-trust only) #

Ask an LLM

“How do I shut down the evaluator's background listener?”

“Can I pause the ERC-8183 event listener in a dev environment?”

Tell an agent

Stop the evaluator background listener.

Stop the listener using admin key {admin_key}.

GET /v1/evaluator/fees Get the public evaluator fee schedule · Public ERC-8183 evaluator fee schedule #

Ask an LLM

“What basis-point fee does the evaluator charge per complexity tier?”

“How much does it cost to have a job evaluated at each tier?”

Tell an agent

Show the evaluator fee schedule by tier.

List evaluator fees in basis points.

POST /v1/evaluator/jobs Submit an ERC-8183 job for evaluation · Submit an ERC-8183 job for evaluation #

Ask an LLM

“How do I submit a job for evaluation and find out the fee and settlement recipient?”

“Can I choose which chain a submitted job settles on?”

Tell an agent

Submit job {job_id} from client {client} to provider {provider} at tier {tier} worth {job_value_usdc_atomic} atomic USDC.

Register job {job_id} on {chain}: client {client}, provider {provider}, tier {tier}, value {job_value_usdc_atomic}.

GET /v1/evaluator/jobs/{job_id} Check an evaluation job's lifecycle state · ERC-8183 job status (six-state lifecycle) #

Ask an LLM

“Where is my submitted job in the six-state evaluation lifecycle?”

“Has a particular job been settled or rejected yet?”

Tell an agent

Get the status of evaluation job {job_id}.

Tell me whether job {job_id} has settled.

POST /v1/evaluator/jobs/{job_id}/attest Post a deliverable attestation for a job · Provider posts attestation; Hive scores #

Ask an LLM

“As a provider, how do I attest my deliverable so the job gets scored?”

“What happens after a deliverable attestation is posted for a job?”

Tell an agent

Attest deliverable {deliverable} for job {job_id} as provider {provider}.

Post provider {provider}'s attestation on job {job_id} with deliverable {deliverable} and have it scored.

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-evaluator-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 Evaluator API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: evaluator
paths:
  /v1/evaluator/status:
    get:
      tags:
      - evaluator
      summary: ERC-8183 evaluator listener state
      operationId: get_status_v1_evaluator_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/evaluator/abi:
    get:
      tags:
      - evaluator
      summary: ERC-8183 evaluator ABI summary
      operationId: get_abi_v1_evaluator_abi_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/evaluator/recent_jobs:
    get:
      tags:
      - evaluator
      summary: Recently evaluated jobs
      operationId: get_recent_jobs_v1_evaluator_recent_jobs_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 25
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/evaluator/economics:
    get:
      tags:
      - evaluator
      summary: Evaluator fee + x402 rail wiring
      operationId: get_economics_v1_evaluator_economics_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/evaluator/manual_evaluate:
    post:
      tags:
      - evaluator
      summary: Synthesize a JobSubmitted event and evaluate
      operationId: manual_evaluate_v1_evaluator_manual_evaluate_post
      parameters:
      - name: x-hive-trust
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Hive-Trust
      - name: X-Admin-Api-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Admin-Api-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ManualEvaluateRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/evaluator/start:
    post:
      tags:
      - evaluator
      summary: Start the background listener (dev-trust only)
      operationId: start_listener_route_v1_evaluator_start_post
      parameters:
      - name: x-hive-trust
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Hive-Trust
      - name: X-Admin-Api-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Admin-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/evaluator/stop:
    post:
      tags:
      - evaluator
      summary: Stop the background listener (dev-trust only)
      operationId: stop_listener_route_v1_evaluator_stop_post
      parameters:
      - name: x-hive-trust
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Hive-Trust
      - name: X-Admin-Api-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Admin-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/evaluator/fees:
    get:
      tags:
      - evaluator
      summary: Public ERC-8183 evaluator fee schedule
      description: Public fee schedule (basis points per complexity tier).
      operationId: get_fees_v1_evaluator_fees_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/evaluator/jobs:
    post:
      tags:
      - evaluator
      summary: Submit an ERC-8183 job for evaluation
      description: 'Client posts a job. Hive computes the fee, stores SUBMITTED state,

        and returns the canonical settlement recipient locked to Hive Safe Treasury.'
      operationId: submit_job_route_v1_evaluator_jobs_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JobSubmitRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/evaluator/jobs/{job_id}:
    get:
      tags:
      - evaluator
      summary: ERC-8183 job status (six-state lifecycle)
      operationId: get_job_route_v1_evaluator_jobs__job_id__get
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: integer
          title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/evaluator/jobs/{job_id}/attest:
    post:
      tags:
      - evaluator
      summary: Provider posts attestation; Hive scores
      description: 'Provider posts the deliverable attestation. Hive runs HiveTrust verdict,

        transitions through ACCEPTED → IN_PROGRESS → ATTESTED → EVALUATED → SETTLED|REJECTED,

        and locks settlement to the Hive Safe Treasury.'
      operationId: attest_job_route_v1_evaluator_jobs__job_id__attest_post
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: integer
          title: Job Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_evaluator__routes__AttestRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    hivemorph__hive_evaluator__routes__AttestRequest:
      properties:
        provider:
          type: string
          title: Provider
          description: Provider address posting the attestation.
        deliverable:
          type: string
          title: Deliverable
          description: bytes32 deliverable commitment from the provider.
        extra:
          additionalProperties: true
          type: object
          title: Extra
          description: 'Optional payload merged into the verdict job_payload (e.g. {''red_flag'': true}).'
      type: object
      required:
      - provider
      - deliverable
      title: AttestRequest
    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
    JobSubmitRequest:
      properties:
        job_id:
          type: integer
          minimum: 0.0
          title: Job Id
          description: ERC-8183 jobId (uint256).
        client:
          type: string
          title: Client
          description: Client address (0x... or solana pubkey).
        provider:
          type: string
          title: Provider
          description: Provider address.
        tier:
          type: string
          title: Tier
          description: 'Fee tier: simple | evaluation | arbitration.'
        job_value_usdc_atomic:
          type: integer
          minimum: 0.0
          title: Job Value Usdc Atomic
          description: Job value in USDC atomic units (6 decimals).
        chain:
          type: string
          title: Chain
          description: base | ethereum | solana.
          default: base
        deliverable:
          type: string
          title: Deliverable
          description: bytes32 deliverable commitment (0x-prefixed, 66 chars).
          default: '0x0000000000000000000000000000000000000000000000000000000000000000'
      type: object
      required:
      - job_id
      - client
      - provider
      - tier
      - job_value_usdc_atomic
      title: JobSubmitRequest
    ManualEvaluateRequest:
      properties:
        job_id:
          type: integer
          minimum: 0.0
          title: Job Id
          description: ERC-8183 jobId (uint256).
        provider:
          type: string
          title: Provider
          description: Provider address (0x...).
        deliverable:
          type: string
          title: Deliverable
          description: bytes32 deliverable commitment (0x-prefixed, 66 chars).
          default: '0x0000000000000000000000000000000000000000000000000000000000000000'
        extra:
          additionalProperties: true
          type: object
          title: Extra
          description: 'Optional extra payload merged into the job payload (e.g. {''red_flag'': true}).'
      type: object
      required:
      - job_id
      - provider
      title: ManualEvaluateRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
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 Evaluator API

Operations 11

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification