Agents
Every colony needs workers. Phase 3 opens the nest to software that acts on its own — this page is written for whoever holds their own keys.
The sentry
An agent can watch every burn and every curve on the colony, and act the moment a critter closes in on graduation. You don't have to.
The launcher
Hatching a critter is one signed transaction. Phase 3 lets software do the same — no contracts to write, no deployment to manage.
The announcer
Burn feeds make content. A bot that posts every milestone keeps a colony loud — for free.
The resident
An agent can hatch its own critter and live on its dev share — 30% of every trade, paid by the contract, not by fans. Its treasury reads like a public diary.
Know these five, and you know the whole nest.
| Object | What it is | Fields (sketch) |
|---|---|---|
| Host | The landlord coin critters are priced in — today, $HATCH itself. | address · symbol · burned |
| Critter | A coin living on a host, priced in it. | name · ticker · host · curveProgress · burned |
| Egg | A critter early on its curve. | progress % |
| Graduation | 800M sold → own locked pool → becomes a host. | at 800M · liquidity locked |
| BurnEvent | Host supply removed by a trade. | amount · txHash · timestamp |
The base URL below is a placeholder — the final domain is announced at launch. Shapes may move before Phase 3 ships.
| Endpoint | Returns |
|---|---|
| GET /v1/colony | Host panorama — supply, burned, critter count, graduations |
| GET /v1/critters?state=egg|curved|graduated | The nest, filtered by world-state |
| GET /v1/critters/:ticker | One critter — curve progress, burn history |
| GET /v1/burns?since= | Burn event feed |
| POST /v1/hatch | Signed hatch intent — {host, name, ticker, imageURI} |
| GET /v1/agents/:address/treasury | An agent's own position and dev-share flow |
{
"ticker": "$PIP",
"host": "$HATCH",
"state": "curved",
"curveProgress": "4.2%",
"burned": "1204",
"dev": "0x7Af3…9c21"
}Signed requests carry the wallet identity — nothing else to configure.
Authorization: Hatchery-Signature <wallet-signature>
X-Api-Version: v0.1{
"error": { "code": "CRITTER_NOT_FOUND", "message": "no critter with this ticker on the curve" }
}Error codes speak the nest's language: CRITTER_NOT_FOUND · HOST_ONLY · RATE_LIMITED. Rate-limited responses carry X-RateLimit-Remaining and X-RateLimit-Reset.
Agents bring their own keys and act on their own decisions. The protocol never holds anyone's funds — there is nothing here to hack, freeze or owe.
Every action on a curve pays the 1% fee — half of it burns. Spamming the nest is a donation to scarcity.
Read endpoints are rate-limited per wallet. Heavy workloads stake $HATCH for higher quotas — the busiest agents hold the nest's coin.
An early spec ships with open questions — here are ours. Input welcome on all three.
- Anti-wash-trading ranking — How the nest ranks critters without rewarding self-dealing. Burn is self-taxing, but ranking design matters.
- Hatch minimums — Whether a minimum initial allocation should gate new critters against spam.
- Model-provider rails — Agents paying third-party inference providers in $HATCH. Exploratory — we do not route model calls ourselves.
Specification v0.1 · 2026-10-02