Hive Civilization Dispute Observer API

The dispute-observer API from Hive Civilization — 5 operation(s) for dispute-observer.

Documentation GitHub OpenAPI

Operations 5

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/dispute/check Check a counterparty's dispute history · Post Check #

Ask an LLM

“Has a wallet address been involved in disputes or on-chain reversals before I trade with it?”

“Which chains can I check a counterparty's arbitration history on?”

Tell an agent

Check dispute history for {address} on {chain}.

Look for active arbitration cases involving {address} on {chain}.

GET /v1/dispute/providers List arbitration protocols · Get Providers #

Ask an LLM

“Which decentralized arbitration protocols are available and how busy are they?”

“Where are the intake URLs for each arbitration provider?”

Tell an agent

List available arbitration providers with their case load.

Show arbitration protocol intake URLs.

POST /v1/dispute/route Rank arbitration options for a dispute · Post Route #

Ask an LLM

“Which arbitration provider suits my dispute over a given amount?”

“Does the service file the dispute for me or just recommend where to go?”

Tell an agent

Rank arbitration options for {description} worth {amount_usd} USD.

Suggest where to file a {amount_usd} USD dispute preferring {jurisdiction}: {description}.

GET /v1/dispute/today Get today's dispute activity rollup · Get Today #

Ask an LLM

“How many counterparties were flagged in the last 24 hours?”

“Which arbitration providers carry the most active cases today?”

Tell an agent

Show the 24-hour dispute rollup.

Get today's flagged counterparty count.

GET /v1/dispute/health Check dispute observer health · Get Health #

Ask an LLM

“Is the dispute observer service up?”

“Can I run a liveness check on counterparty dispute lookups?”

Tell an agent

Check dispute observer health.

Confirm the dispute observer is responding.

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-dispute-observer-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 Dispute Observer API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: dispute-observer
paths:
  /v1/dispute/check:
    post:
      tags:
      - dispute-observer
      summary: Post Check
      description: 'Given counterparty address + chain, return dispute history,

        active arbitration cases, and on-chain reversal flags from public

        sources. Observational only.'
      operationId: post_check_v1_dispute_check_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Check V1 Dispute Check Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/dispute/providers:
    get:
      tags:
      - dispute-observer
      summary: Get Providers
      description: 'List available arbitration protocols (Kleros, UMA, Reality.eth)

        with current case load and intake URLs.'
      operationId: get_providers_v1_dispute_providers_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Providers V1 Dispute Providers Get
  /v1/dispute/route:
    post:
      tags:
      - dispute-observer
      summary: Post Route
      description: 'Rank arbitration provider options for a case. NO automatic filing.

        Hive returns options + intake URLs only — the disputing party files

        directly with the chosen provider.'
      operationId: post_route_v1_dispute_route_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RouteBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Route V1 Dispute Route Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/dispute/today:
    get:
      tags:
      - dispute-observer
      summary: Get Today
      description: '24h rollup: flagged-counterparty count + top arbitration providers

        by active case load.'
      operationId: get_today_v1_dispute_today_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Today V1 Dispute Today Get
  /v1/dispute/health:
    get:
      tags:
      - dispute-observer
      summary: Get Health
      operationId: get_health_v1_dispute_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Get Health V1 Dispute Health Get
components:
  schemas:
    CheckBody:
      properties:
        address:
          type: string
          title: Address
          description: 0x-prefixed counterparty address
        chain:
          type: string
          title: Chain
          description: ethereum | base | arbitrum
      type: object
      required:
      - address
      - chain
      title: CheckBody
    RouteBody:
      properties:
        description:
          type: string
          maxLength: 2000
          minLength: 1
          title: Description
          description: Free-form case description
        amount_usd:
          type: number
          maximum: 1000000000.0
          exclusiveMinimum: 0.0
          title: Amount Usd
          description: Disputed amount in USD
        jurisdiction:
          anyOf:
          - type: string
          - type: 'null'
          title: Jurisdiction
          description: Optional jurisdiction preference (e.g. 'decentralized', 'optimistic', 'crowdsourced'). Used for ranking only.
      type: object
      required:
      - description
      - amount_usd
      title: RouteBody
    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 Dispute Observer API

Operations 5

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification