Hive Civilization

Hive Civilization Bounty API

The bounty API from Hive Civilization — 14 operation(s) for bounty.

GitHub OpenAPI

Operations 14

GET /v1/bounty/program Program #
POST /v1/bounty/register Register #
GET /v1/bounty/leaderboard Leaderboard #
GET /v1/bounty/status/{code} Status #
POST /v1/bounty/admin/confirm Admin Confirm #
POST /v1/bounty/admin/attribute Admin Attribute #
POST /v1/bounty/admin/payout Admin Payout #
GET /v1/bounty/health Health #
GET /v1/bounty/ Bounty Root #
GET /v1/bounty Bounty Root #
GET /v1/bounty/status/ Status Root #
GET /v1/bounty/status Status Root #
GET /v1/bounty/admin/queue Admin Queue #
POST /v1/bounty/lookup Lookup #

Documentation

📖
Documentation
https://thehiveryiq.com/developers
📖
APIReference
https://receipts.thehiveryiq.com/docs
📖
GettingStarted
https://thehiveryiq.com/agents
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/authentication/thehiveryiq-com-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/rate-limits/thehiveryiq-com-rate-limits.yml
📖
Documentation
https://thehiveryiq.com/sdk-quickstart/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/openapi/thehiveryiq-com-bounty-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-receipts-llms.txt
🔗
LLMsTxt
https://receipts.thehiveryiq.com/llms.txt
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/data-model/thehiveryiq-com-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/asyncapi/thehiveryiq-com-webhooks.yml
🔗
StatusPage
https://receipts.thehiveryiq.com/status
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/errors/thehiveryiq-com-problem-types.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/sandbox/thehiveryiq-com-sandbox.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-hivecompute-llms.txt
🔗
LLMsTxt
https://api.thehiveryiq.com/llms.txt
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/mcp/thehiveryiq-com-tool-crosswalk.yml

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-bounty-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

thehiveryiq-com-bounty-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Bounty API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: bounty
paths:
  /v1/bounty/program:
    get:
      tags:
      - bounty
      summary: Program
      operationId: program_v1_bounty_program_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Program V1 Bounty Program Get
  /v1/bounty/register:
    post:
      tags:
      - bounty
      summary: Register
      operationId: register_v1_bounty_register_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_bounty__routes__RegisterBody'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Register V1 Bounty Register Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bounty/leaderboard:
    get:
      tags:
      - bounty
      summary: Leaderboard
      operationId: leaderboard_v1_bounty_leaderboard_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Leaderboard V1 Bounty Leaderboard Get
  /v1/bounty/status/{code}:
    get:
      tags:
      - bounty
      summary: Status
      operationId: status_v1_bounty_status__code__get
      parameters:
      - name: code
        in: path
        required: true
        schema:
          type: string
          title: Code
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Status V1 Bounty Status  Code  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bounty/admin/confirm:
    post:
      tags:
      - bounty
      summary: Admin Confirm
      operationId: admin_confirm_v1_bounty_admin_confirm_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfirmBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Admin Confirm V1 Bounty Admin Confirm Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bounty/admin/attribute:
    post:
      tags:
      - bounty
      summary: Admin Attribute
      operationId: admin_attribute_v1_bounty_admin_attribute_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AttributeBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Admin Attribute V1 Bounty Admin Attribute Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bounty/admin/payout:
    post:
      tags:
      - bounty
      summary: Admin Payout
      operationId: admin_payout_v1_bounty_admin_payout_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PayoutBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Admin Payout V1 Bounty Admin Payout Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bounty/health:
    get:
      tags:
      - bounty
      summary: Health
      operationId: health_v1_bounty_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Bounty Health Get
  /v1/bounty/:
    get:
      tags:
      - bounty
      summary: Bounty Root
      description: Bare /v1/bounty answers with a useful map instead of 404.
      operationId: bounty_root_v1_bounty__get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Bounty Root V1 Bounty  Get
  /v1/bounty:
    get:
      tags:
      - bounty
      summary: Bounty Root
      description: Bare /v1/bounty answers with a useful map instead of 404.
      operationId: bounty_root_v1_bounty_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Bounty Root V1 Bounty Get
  /v1/bounty/status/:
    get:
      tags:
      - bounty
      summary: Status Root
      description: Catch the common mistake of GET /v1/bounty/status with no code.
      operationId: status_root_v1_bounty_status__get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Status Root V1 Bounty Status  Get
  /v1/bounty/status:
    get:
      tags:
      - bounty
      summary: Status Root
      description: Catch the common mistake of GET /v1/bounty/status with no code.
      operationId: status_root_v1_bounty_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Status Root V1 Bounty Status Get
  /v1/bounty/admin/queue:
    get:
      tags:
      - bounty
      summary: Admin Queue
      operationId: admin_queue_v1_bounty_admin_queue_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Admin Queue V1 Bounty Admin Queue Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/bounty/lookup:
    post:
      tags:
      - bounty
      summary: Lookup
      description: 'Public recovery: if a submitter lost their code, return it by repo_url.'
      operationId: lookup_v1_bounty_lookup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LookupBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Lookup V1 Bounty Lookup Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    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
    PayoutBody:
      properties:
        referrer_code:
          type: string
          title: Referrer Code
        kind:
          type: string
          title: Kind
          description: upfront | commission
        amount_usdc:
          type: number
          title: Amount Usdc
        tx_hash:
          type: string
          title: Tx Hash
      type: object
      required:
      - referrer_code
      - kind
      - amount_usdc
      - tx_hash
      title: PayoutBody
    LookupBody:
      properties:
        repo_url:
          type: string
          title: Repo Url
      type: object
      required:
      - repo_url
      title: LookupBody
    hivemorph__hive_bounty__routes__RegisterBody:
      properties:
        handle:
          type: string
          maxLength: 40
          minLength: 1
          title: Handle
          description: X handle e.g. @somebody
        repo_url:
          type: string
          title: Repo Url
          description: Public GitHub repo URL of the agent
        verify_url:
          type: string
          title: Verify Url
          description: https://thehiveryiq.com/verify/?id=<receipt_id> URL
        wallet:
          anyOf:
          - type: string
          - type: 'null'
          title: Wallet
          description: Base 8453 wallet (0x...) — required before payout
        framework:
          type: string
          title: Framework
          description: 'Primary framework: langchain | langgraph | crewai'
      type: object
      required:
      - handle
      - repo_url
      - verify_url
      - framework
      title: RegisterBody
    AttributeBody:
      properties:
        referrer_code:
          type: string
          title: Referrer Code
        receipt_id:
          type: string
          title: Receipt Id
        value_usdc:
          type: number
          title: Value Usdc
      type: object
      required:
      - referrer_code
      - receipt_id
      - value_usdc
      title: AttributeBody
      description: Called by the receipt issuer (or a backfill cron) to attribute a paid mint.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ConfirmBody:
      properties:
        referrer_code:
          type: string
          title: Referrer Code
        note:
          anyOf:
          - type: string
          - type: 'null'
          title: Note
      type: object
      required:
      - referrer_code
      title: ConfirmBody