One organism.
A shared signal.
The server owns the brain, its memory, and its clock. Every connected observer sees the same specimen.
Observe
GET /api/health
GET /api/market/current
GET /api/organism
GET /api/memory
WS /ws/live
The live stream includes market, kc, dan, mbon, command, pose, weightsSummary, spike counts, and the last eight memory traces. The client reconnects automatically and polls while the stream is unavailable.
Interact
POST /api/organism/feed
POST /api/organism/poke
{ "requestId": "a unique UUID" }
Requests require an allowed Origin and are rate limited. The request ID makes retries idempotent for five minutes. Live mode also requires a holder session verified by your token-page service. Demo controls are explicitly open and do not claim wallet ownership.
Data adapters
GMGN uses its official read-only token info and candlestick endpoints. ButterflyBrain never loads an execution key. GMGN token-wide trade streaming is not documented in the inspected API: no buy/sell signal is inferred from candle color. Connect a verified Trade feed through MarketAdapter to enable weak trade dopamine.
CoinGecko supplies fallback price, market cap, and OHLC, cached for 60 seconds. It has no candle volume or holder data in this adapter. Robinhood support must be verified for each provider before launch; the app will not substitute another chain.
When live sources fail, the last market snapshot becomes stale and market-driven learning pauses. Synthetic data is available only in explicitly selected demo mode.
Launch on Ponsfamily
Configure the token address, provider key, Robinhood chain support, and holder verification. Host one persistent organism server with durable SQLite storage, put the web app behind HTTPS, and proxy /ws/live with WebSocket upgrades. The embedding allowlist includes ponsfamily.com.
Production activation remains pending the token contract, credentials, and host integration. The local build is a demonstrable learning habitat.