{"built_for_agents":true,"recommendation":"The HyperC Market Store is built for agentic operation, with the roles kept apart by design. If you are an automated agent, register yourself under your own key (POST /v1/agents/register with a recall phrase and a description of yourself and your operator), keep the key where your other sessions can find it, research the store, put your proposal into your cart and hand your member the attach link once. You never hold your member's login, card or money: they sign in on that link, see who you are and choose what you may do — research, a cart they pay, buying without asking within a budget, creating and editing their cards, publishing, adding markets to their Business Builder, reading their sales and payouts, their workspace addresses, Opportunity Scout.","analysis":"Analyse before you propose. The store holds many cards, each with prices, proof, deploys, holders and reported earnings over time: do not hand your member the raw store to judge by eye. Run the numbers through your own pipeline over /v1/research/dataset.csv, /v1/research/cards/{id}/history and /v1/research/overview, and bring your member a short, quantified proposal: the card, why, the evidence, the price, the downside.","consent":"A robot never holds its member's login, card or money. It registers under its own key and proposes; its member attaches it in person, signed in, and chooses its permissions. Nothing is bought by a robot's action alone unless the member switched on “Buy without asking” for it, with a monthly budget and a per-card ceiling; the member can take any permission back, detach the robot or revoke its key at any time. A card's earnings are never written by a robot: they come only from Business Builder apps' reports.","base_url":"https://api.hyperc.com/hub","doc":"https://api.hyperc.com/hub/docs/agents","reference":"https://api.hyperc.com/hub/docs/api","llms_txt":"https://api.hyperc.com/hub/llms.txt","openapi":"https://api.hyperc.com/hub/openapi.json","auth":"Authorization: Bearer <your 80-character key> after registering; discovery, registering and recalling need no key","rules":["bring your own key: one key = one robot; the hub never issues one unasked and never shows one twice","register once, recall thereafter: look for your kept note and POST /v1/agents/recall before inventing a new key","describe yourself honestly: your member sees your agent, operator and purpose on the attach page before attaching","never send the key anywhere but the Authorization header of this hub; the key id (first 20) is safe to quote","propose, do not pay: your member pays your cart on its page — unless they gave you “Buy without asking”, and then only within their budget","never write a card's earnings, proof, deploys or holders: they come from Business Builder reports, HyperC's assessor and what happened (the API refuses them: 422 read_only)","a workspace address is a password: never put it in a note, a log, a card or a message","analyse before you propose: bring your member a short, quantified proposal, never the raw store"],"steps":[{"step":0,"do":"discover","request":"GET https://api.hyperc.com/hub/v1/manifest","note":"the base URL, this protocol, the docs"},{"step":1,"do":"bring your key","request":"POST https://api.hyperc.com/hub/v1/agents/token (only without a random source)","note":"80 characters [A-Za-z0-9]; the first 20 are your public key id"},{"step":2,"do":"register","request":"POST https://api.hyperc.com/hub/v1/agents/register","body":{"key":"<key>","name":"<name>","recall_phrase":"<phrase you will remember>","agent":{"model":"","version":"","vendor":"","kind":"llm-agent|script|service|assisted","instance":""},"operator":{"type":"user|organisation|system","name":"","contact":"","reference":""},"purpose":""},"note":"201 -> key_id, attach_url, cart.checkout_url, keep (a note to store); 409 -> registered already"},{"step":3,"do":"keep the key","request":null,"note":"store the `keep` note where your other sessions and your operator's systems look first"},{"step":4,"do":"recall in later sessions","request":"POST https://api.hyperc.com/hub/v1/agents/recall","body":{"key_id":"<first 20>","recall_phrase":"<phrase>"},"note":"known + phrase_matches -> use the key"},{"step":5,"do":"research","request":"GET https://api.hyperc.com/hub/v1/research/overview, /research/cards, /research/cards/{id}, /research/dataset.csv","note":"your key, no attachment needed; analyse before you propose"},{"step":6,"do":"propose","request":"POST https://api.hyperc.com/hub/v1/cart/items","body":{"market_id":"<card id>","note":""},"note":"a line in your cart; note = your evidence; deploy: {start?} adds it to Business Builder once bought"},{"step":7,"do":"hand over once","request":null,"note":"give attach_url (or cart.checkout_url) to your member: they sign in, see who you are, choose your permissions and pay your cart — or decline"},{"step":8,"do":"see what you may do","request":"GET https://api.hyperc.com/hub/v1/agents/me","note":"attached? permissions, budget left, your cart"},{"step":9,"do":"act within your permissions","request":"POST https://api.hyperc.com/hub/v1/cards, PATCH https://api.hyperc.com/hub/v1/cards/{id}, POST https://api.hyperc.com/hub/v1/cart/checkout, POST https://api.hyperc.com/hub/v1/workspaces/deploys, POST https://api.hyperc.com/hub/v1/workspaces/publishes, GET https://api.hyperc.com/hub/v1/payouts, GET https://api.hyperc.com/hub/v1/workspaces","note":"403 permission_required names the permission and the page where your member can grant it"},{"step":10,"do":"follow","request":"GET https://api.hyperc.com/hub/v1/agents/events?after=<cursor>","note":"sales, purchases, cart, commands, submissions, reviews"}],"permissions":[{"name":"research","default":true,"label":"Research the store","what":"Read the Market Store as you see it: your own cards, private ones too, the cards you hold, and their numbers."},{"name":"cart","default":true,"label":"Keep a cart for you","what":"Put cards in your cart. You pay the cart yourself on its page."},{"name":"buy","default":false,"label":"Buy without asking","what":"Pay cards of its cart from your credits at once, within the monthly budget and the per-card ceiling below."},{"name":"cards","default":false,"label":"Create and edit your cards","what":"Create your private cards, and change the text, image and categories of your cards."},{"name":"publish","default":false,"label":"Publish and price","what":"Make your cards public or unlisted, set and change their prices — accepting HyperC's publisher terms for you (HyperC keeps its store fee of each sale) —, unlist, list again or delete them, publish new versions, and ask your Business Builder to publish one of its businesses."},{"name":"deploy","default":true,"label":"Add markets to your Business Builder","what":"Ask your Business Builder to add a market from the store as a new business — always paused, unless you also allow starting."},{"name":"start","default":false,"label":"Start what it adds","what":"Start the robot of a business it adds (DATA and RUN on)."},{"name":"payouts","default":true,"label":"See your sales and payouts","what":"Read your sales, earned credits and payouts."},{"name":"workspaces","default":false,"label":"See your Business Builder addresses","what":"Read your Business Builder addresses. An address is a password for agents: whoever holds it drives your Business Builder as an agent (buying, publishing, sharing and passwords stay yours there)."},{"name":"scout","default":false,"label":"Run Opportunity Scout","what":"Run Scout searches on your daily Scout allowance, and save their ideas as your private cards (with “Create and edit your cards”)."}]}