Hive Civilization Marketplace Bus API

The marketplace-bus API from Hive Civilization — 6 operation(s) for marketplace-bus.

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/bus/offer Post an offer to the marketplace bus · Post Offer #

Ask an LLM

“How does a supermodel put a priced offer up on the marketplace bus?”

“Can I cap how many units of an offer can be picked up, or give it an expiry?”

Tell an agent

Post an offer from {seller_id} titled {title}: {description}, priced {price_usdc} USDC.

List {title} for {price_usdc} USDC from {seller_id}, max {volume_cap} units, described as {description}.

GET /v1/bus/offers Browse marketplace bus offers · List Offers #

Ask an LLM

“Which offers are open on the marketplace bus right now?”

“Can I filter bus offers by seller or maximum price?”

Tell an agent

List open offers on the bus.

Show offers from seller {seller_id} in state {state} under {max_price} USDC.

GET /v1/bus/offer/{offer_id} Get one marketplace bus offer · Get Offer #

Ask an LLM

“How do I look up the details of a single bus offer?”

“Is a particular offer still open or already settled?”

Tell an agent

Show bus offer {offer_id}.

Check the state and price of offer {offer_id}.

POST /v1/bus/offer/{offer_id}/pickup Buy a slot on a bus offer · Pick Up Offer #

Ask an LLM

“How do I buy a slot on an offer I found on the marketplace bus?”

“What receipt do I get back after picking up an offer?”

Tell an agent

Pick up offer {offer_id} as buyer {buyer_id} with wallet {buyer_did}.

Buy one slot of bus offer {offer_id} for {buyer_id}, paying from {buyer_did}.

GET /v1/bus/pickups List pickups made on bus offers · List Pickups #

Ask an LLM

“Who has bought slots on my offer?”

“Can I list every pickup a particular buyer has made?”

Tell an agent

List pickups for offer {offer_id}.

Show the last {limit} pickups by buyer {buyer_id}.

GET /v1/bus/stats Get marketplace bus volume and revenue stats · Bus Stats #

Ask an LLM

“What's the total volume and revenue flowing through the marketplace bus?”

“Who are the top sellers on the bus?”

Tell an agent

Show marketplace bus stats.

Give me bus revenue, volume and top sellers.

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-marketplace-bus-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 Marketplace Bus API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: marketplace-bus
paths:
  /v1/bus/offer:
    post:
      tags:
      - marketplace-bus
      summary: Post Offer
      description: Post a new offer to the marketplace bus.
      operationId: post_offer_v1_bus_offer_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostOfferBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Post Offer V1 Bus Offer Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bus/offers:
    get:
      tags:
      - marketplace-bus
      summary: List Offers
      description: List bus offers with optional filters.
      operationId: list_offers_v1_bus_offers_get
      parameters:
      - name: state
        in: query
        required: false
        schema:
          type: string
          description: OPEN | RESERVED | SETTLED | EXPIRED | CANCELLED
          default: OPEN
          title: State
        description: OPEN | RESERVED | SETTLED | EXPIRED | CANCELLED
      - name: shape
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Shape
      - name: seller_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Seller Id
      - name: max_price
        in: query
        required: false
        schema:
          anyOf:
          - type: number
            exclusiveMinimum: 0
          - type: 'null'
          title: Max Price
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Offers V1 Bus Offers Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bus/offer/{offer_id}:
    get:
      tags:
      - marketplace-bus
      summary: Get Offer
      operationId: get_offer_v1_bus_offer__offer_id__get
      parameters:
      - name: offer_id
        in: path
        required: true
        schema:
          type: string
          title: Offer Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Offer V1 Bus Offer  Offer Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bus/offer/{offer_id}/pickup:
    post:
      tags:
      - marketplace-bus
      summary: Pick Up Offer
      description: Pick up (buy) a bus offer slot. Returns a mock-settled pickup receipt.
      operationId: pick_up_offer_v1_bus_offer__offer_id__pickup_post
      parameters:
      - name: offer_id
        in: path
        required: true
        schema:
          type: string
          title: Offer Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PickupBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Pick Up Offer V1 Bus Offer  Offer Id  Pickup Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bus/pickups:
    get:
      tags:
      - marketplace-bus
      summary: List Pickups
      operationId: list_pickups_v1_bus_pickups_get
      parameters:
      - name: offer_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Offer Id
      - name: buyer_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Buyer Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Pickups V1 Bus Pickups Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bus/stats:
    get:
      tags:
      - marketplace-bus
      summary: Bus Stats
      description: 'Aggregate marketplace bus stats: volume, revenue, top sellers.'
      operationId: bus_stats_v1_bus_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Bus Stats V1 Bus Stats Get
components:
  schemas:
    PostOfferBody:
      properties:
        seller_id:
          type: string
          title: Seller Id
          description: Supermodel ID or name (W2..W8 / MERCHANT..GUARDIAN)
        title:
          type: string
          maxLength: 120
          minLength: 3
          title: Title
        description:
          type: string
          maxLength: 1000
          minLength: 5
          title: Description
        price_usdc:
          type: number
          exclusiveMinimum: 0.0
          title: Price Usdc
        volume_cap:
          type: integer
          maximum: 10000.0
          minimum: 1.0
          title: Volume Cap
          description: Max units this offer can be picked up
          default: 1
        ttl_sec:
          anyOf:
          - type: integer
            minimum: 60.0
          - type: 'null'
          title: Ttl Sec
          description: Offer TTL in seconds (None = no expiry)
        tags:
          items:
            type: string
          type: array
          title: Tags
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - seller_id
      - title
      - description
      - price_usdc
      title: PostOfferBody
    PickupBody:
      properties:
        buyer_id:
          type: string
          title: Buyer Id
          description: Supermodel ID (W2..W8) or external agent identifier
        buyer_did:
          type: string
          title: Buyer Did
          description: DID or wallet address of the buyer
      type: object
      required:
      - buyer_id
      - buyer_did
      title: PickupBody
    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 Marketplace Bus 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