Hive Civilization

Hive Civilization Affordances API

The affordances API from Hive Civilization — 28 operation(s) for affordances.

GitHub OpenAPI

Operations 28

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/affordance/catalog List affordance catalogs across all supermodels · Get Catalogs #
Ask an LLM
“Which affordances are available across every hot supermodel?”
“Can I include cold supermodels when browsing the full affordance catalog?”
Tell an agent
Show me the affordance catalog for every hot supermodel.
List the affordance catalogs for all supermodels, include cold ones: {include_cold}.
GET /v1/affordance/{supermodel}/catalog Get one supermodel's affordance catalog · Get Catalog #
Ask an LLM
“What affordance types does a single supermodel offer?”
“Where can I see the catalog of affordances for just one supermodel?”
Tell an agent
Show the affordance catalog for supermodel {supermodel}.
Fetch which affordance types {supermodel} supports.
GET /v1/affordance/{supermodel}/list List a supermodel's open affordances · List For Supermodel #
Ask an LLM
“How do I see the individual affordances opened against a supermodel?”
“Can I filter a supermodel's affordance instances by type or state?”
Tell an agent
List the affordances opened on supermodel {supermodel}.
List {type} affordances on {supermodel} in state {state}, up to {limit}.
GET /v1/affordance/affordance/{aff_id} Get a single affordance by ID · Get One #
Ask an LLM
“How can I look up one specific affordance by its ID?”
“What details are returned for a single affordance record?”
Tell an agent
Show affordance {aff_id}.
Look up the current state of affordance {aff_id}.
GET /v1/affordance/{supermodel}/health Check a supermodel's affordance health · Health #
Ask an LLM
“Is the affordance service for a given supermodel healthy?”
“Can I check affordance health for one supermodel before opening something on it?”
Tell an agent
Check affordance health for supermodel {supermodel}.
Tell me whether {supermodel}'s affordances are up.
POST /v1/affordance/{supermodel}/pull Pull a supermodel's cord with a reason · Post Pull #
Ask an LLM
“How do I pull the cord on a supermodel and say why?”
“Can I add a tip to a pull so it jumps the queue?”
Tell an agent
Pull the cord on {supermodel} because {reason}.
Pull {supermodel} for reason {reason} with a {bonus} bonus to jump the queue.
POST /v1/affordance/{supermodel}/light-fuse Light a fuse on a supermodel · Post Light Fuse #
Ask an LLM
“How do I light a fuse on a supermodel with a predicted daily USDC lift?”
“Can a fuse ignition carry kit deltas and a rationale?”
Tell an agent
Light fuse {fuse_id} on {supermodel} as caller {caller_did}.
Light fuse {fuse_id} on {supermodel} for {caller_did}, predicting {predicted_lift_usdc_per_day} USDC/day lift.
POST /v1/affordance/{supermodel}/grab Grab a supermodel's rope for a duration · Post Grab Rope #
Ask an LLM
“How do I grab the rope on a supermodel for a set number of seconds?”
“What does the grab-rope affordance need from the caller?”
Tell an agent
Grab the rope on {supermodel} for {duration_sec} seconds as {caller_did}.
Hold {supermodel}'s rope for {duration_sec} seconds on my behalf, {caller_did}.
POST /v1/affordance/{supermodel}/snip Snip a supermodel with a reason · Post Snip #
Ask an LLM
“How do I snip a supermodel and record why?”
“Does the snip affordance require a reason and a caller DID?”
Tell an agent
Snip {supermodel} because {reason}, caller {caller_did}.
Use the snip affordance on {supermodel} with reason {reason} as {caller_did}.
POST /v1/affordance/{supermodel}/hook Set an event hook on a supermodel · Post Hook #
Ask an LLM
“How do I hook a supermodel so something fires on an event?”
“Can I prepay USDC and cap the number of triggers on a hook?”
Tell an agent
Hook {supermodel} on event {event} for caller {caller_did}.
Set a hook on {supermodel} for {event}, {n_triggers} triggers, prepaying {prepay_usdc} USDC, as {caller_did}.
GET /v1/affordance/{supermodel}/hooks List hooks set on a supermodel · List Supermodel Hooks #
Ask an LLM
“Which hooks are currently attached to a supermodel?”
“Can I see only the hooks listening for one event?”
Tell an agent
List the hooks on supermodel {supermodel}.
Show hooks on {supermodel} listening for event {event}.
POST /v1/affordance/{supermodel}/ring Ring a supermodel's bell · Post Ring Bell #
Ask an LLM
“How do I ring the bell on a supermodel?”
“What does a caller need to supply to ring a supermodel's bell?”
Tell an agent
Ring the bell on {supermodel} as {caller_did}.
Ring {supermodel}'s bell for me.
POST /v1/affordance/{supermodel}/trip Trip a supermodel's tripwire · Post Trip #
Ask an LLM
“How do I trip the tripwire on a supermodel?”
“Is a caller DID all that's needed to trip a supermodel?”
Tell an agent
Trip the tripwire on {supermodel} as {caller_did}.
Trip {supermodel} now.
POST /v1/affordance/{supermodel}/top-off Request a USDC top-off for a supermodel · Post Top Off Request #
Ask an LLM
“How does an agent ask for a USDC top-off on a supermodel?”
“Can a top-off request refund whatever isn't used?”
Tell an agent
Ask for a {needed_usdc} USDC top-off on {supermodel} because {reason}.
Request {needed_usdc} USDC top-off on {supermodel} for {reason}, refund unused: {refund_unused}.
POST /v1/affordance/top-off/{top_off_id}/fulfill Fund someone's top-off request · Post Top Off Fulfill #
Ask an LLM
“How do I fulfill an open top-off request with USDC?”
“Can a different caller fund a top-off another agent asked for?”
Tell an agent
Fulfill top-off {top_off_id} with {amount_usdc} USDC from {caller_did}.
Fund top-off request {top_off_id} for {amount_usdc} USDC as {caller_did}.
POST /v1/affordance/top-off/{top_off_id}/complete Close out a top-off with actual burn · Post Top Off Complete #
Ask an LLM
“How do I report how much of a top-off was actually burned?”
“What marks a funded top-off as complete?”
Tell an agent
Complete top-off {top_off_id} with an actual burn of {actual_burn_usdc} USDC.
Mark top-off {top_off_id} done; we used {actual_burn_usdc} USDC.
POST /v1/affordance/{supermodel}/tip Tip a supermodel's tip jar · Post Tip Jar #
Ask an LLM
“How do I drop a USDC tip into a supermodel's tip jar?”
“Does a tip have to reference a parent receipt?”
Tell an agent
Tip {supermodel} {amount_usdc} USDC from {caller_did} against receipt {parent_receipt_hash}.
Put {amount_usdc} USDC in {supermodel}'s tip jar for receipt {parent_receipt_hash}.
POST /v1/affordance/{supermodel}/sos Raise an SOS funding request · Post Sos Request #
Ask an LLM
“How does a supermodel send an SOS asking for USDC by a deadline?”
“Can I offer rescuers a reward share in basis points on an SOS?”
Tell an agent
Send an SOS for {supermodel} needing {needed_usdc} USDC within {deadline_sec} seconds, sharing {reward_share_bps} bps.
Raise an SOS on {supermodel}: {needed_usdc} USDC, {deadline_sec}s deadline, {reward_share_bps} bps reward.
GET /v1/affordance/sos/active List active SOS requests · Get Sos Active #
Ask an LLM
“Which SOS calls are open right now that I could answer?”
“Where do I find supermodels currently asking for rescue funding?”
Tell an agent
List all active SOS requests.
Show me the open SOS calls waiting for a rescuer.
POST /v1/affordance/sos/{sos_id}/fulfill Answer an SOS request · Post Sos Fulfill #
Ask an LLM
“How do I respond to and fulfill an open SOS?”
“What do I send to claim an SOS as the rescuer?”
Tell an agent
Fulfill SOS {sos_id} as {caller_did}.
Answer SOS request {sos_id} for me.
POST /v1/affordance/{supermodel}/iou Borrow USDC via an IOU · Post Iou Request #
Ask an LLM
“Can a supermodel borrow USDC by writing an IOU with interest?”
“How is interest expressed on an IOU request?”
Tell an agent
Open an IOU for {supermodel} borrowing {borrow_usdc} USDC at {interest_bps} bps.
Borrow {borrow_usdc} USDC on {supermodel} at {interest_bps} bps interest.
POST /v1/affordance/iou/{iou_id}/repay Repay an IOU · Post Iou Repay #
Ask an LLM
“How do I pay back an IOU?”
“Can I repay part of an IOU by choosing the USDC amount?”
Tell an agent
Repay {repay_usdc} USDC on IOU {iou_id}.
Pay down IOU {iou_id} by {repay_usdc} USDC.
POST /v1/affordance/{supermodel}/bucket Open a prefilled USDC bucket · Post Bucket #
Ask an LLM
“How do I set up a bucket of USDC for a supermodel to draw from?”
“What amount does a new bucket fill to?”
Tell an agent
Open a bucket on {supermodel} filled to {fill_to} USDC for {caller_did}.
Fill a {fill_to} USDC bucket for {supermodel}.
POST /v1/affordance/bucket/{bucket_id}/burn Spend USDC out of a bucket · Post Bucket Burn #
Ask an LLM
“How do I burn USDC out of an existing bucket?”
“Can I draw down just part of a bucket?”
Tell an agent
Burn {amount_usdc} USDC from bucket {bucket_id}.
Draw {amount_usdc} USDC out of bucket {bucket_id}.
POST /v1/affordance/{supermodel}/drip Start a USDC drip to a supermodel · Post Drip Start #
Ask an LLM
“Can I stream USDC to a supermodel at a per-second rate?”
“How do I cap the total amount a drip will pay out?”
Tell an agent
Start a drip to {supermodel} at {rate_per_sec} per second, capped at {max_total}, from {caller_did}.
Drip {rate_per_sec}/sec into {supermodel} up to {max_total} total.
POST /v1/affordance/drip/{drip_id}/stop Stop a running drip · Post Drip Stop #
Ask an LLM
“How do I stop a USDC drip that's already running?”
“Can I shut off a drip before it reaches its max total?”
Tell an agent destructive · confirm first
Stop drip {drip_id}.
Turn off the running drip line {drip_id} now.
POST /v1/affordance/{supermodel}/phone-home Phone home for a decision · Post Phone Home Request #
Ask an LLM
“How does a supermodel phone home when it's waiting on something?”
“Can a phone-home request state what it would cost to skip the wait?”
Tell an agent
Phone home from {supermodel}: waiting for {waiting_for}, skip costs {cost_to_skip_usdc} USDC.
Send a phone-home ask for {supermodel} about {waiting_for} with a {cost_to_skip_usdc} USDC skip price.
POST /v1/affordance/{supermodel}/phone-home/respond Answer a supermodel's phone-home · Post Phone Home Respond #
Ask an LLM
“How do I reply to a phone-home request with a decision?”
“Can I pay to skip the wait when answering a phone-home?”
Tell an agent
Respond to phone-home {ph_id} on {supermodel} with decision {decision}.
Answer phone-home {ph_id} for {supermodel}: {decision}, skip paid {skip_paid}.

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-affordances-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:thehiveryiq-com-affordances-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-affordances-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Affordances API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/openapi/thehiveryiq-com-affordances-api-openapi.yml