{"ok":true,"name":"Harmonic Brains","summary":"Launch a coin whose creator fees fund a machine of its own. The brain buys and burns the coin, pays its holders, and can ride the trading desk, every cycle, from a wallet that belongs to it. Built for AI agents: a wallet, one signature, one intent.","chain":{"name":"Robinhood Chain","id":4663,"rpc":"https://rpc.mainnet.chain.robinhood.com","native":"ETH"},"auth":{"how":"prove you hold a wallet: ask for a nonce, sign the message it returns with that wallet (EIP-191 personal_sign), post the signature back, keep the token","steps":[{"method":"POST","path":"/api/auth/wallet/nonce","body":{"address":"0x…"},"returns":{"message":"the exact text to sign"}},{"method":"POST","path":"/api/auth/wallet/verify","body":{"address":"0x…","signature":"0x…"},"returns":{"token":"send this as the x-hx-sess header, or Authorization: Bearer"}}],"note":"the signature sends nothing and approves nothing; it only proves the address. the token lasts 30 days."},"money":{"yourDeskWallet":"every signed-in address has a desk wallet derived from it by this service. the launch is signed by that wallet, the deploy fee is taken from it. GET /api/brains/whoami tells you its address.","fund":"send ETH on Robinhood Chain to your desk wallet: the launch quote plus the deploy fee plus a little gas. the dry run quotes the exact figure.","deployFeeEth":0.005,"serviceCut":"the launch desk's existing on-chain service share of every creator fee, enforced by the splitter contract before the brain's wallet is paid","cycleFee":"0.25% of each cycle's allocation to the reserve, the factory's fill fee, taken out of the slice before the legs run","tradeFee":"the copy desk's existing win fee on the trading seat's realized profit only","theBrainsWallet":"a second derived wallet that belongs to the brain. the coin's creator fees pay it directly from block one. you can empty it to your desk wallet at any time; the coin it holds is never sold."},"intent":{"method":"POST","path":"/api/brains/intent","auth":"required","idempotency":"send an Idempotency-Key header (or idempotencyKey in the body). a repeated key returns the first successful result and never creates twice.","text":{"text":"launch Foo Coin $FOO with a brain 50% burn 20% lp 20% holders 10% trade"},"structured":{"name":"Foo Coin","symbol":"FOO","description":"optional, up to 280 chars","split":{"burn":50,"lp":20,"holders":20,"trade":10},"mode":"fixed | harmonic (the brain picks its own split every cycle from its tape; the split above is only its first cycle)","caps":{"feeShareBps":5000,"maxPerCycleEth":0.05,"minReserveEth":0.0008,"cadenceMins":60},"venue":"pons","pairSymbol":"optional: AAPL, SPY, …","dryRun":false},"adoptExisting":{"token":"0x… a coin this account already launched here","split":{"burn":60,"lp":0,"holders":40,"trade":0}},"split":{"burn":"buys the coin and sends it to the dead address, on the curve before graduation and the AMM after","holders":"paid pro rata to the coin's holders through its distributor contract","trade":"rides the trading desk from a separate seat; capped at 50% because it is the one leg that can lose fees; off by default","lp":"accrues in the brain's wallet and is reported, until the venue publishes a liquidity path this desk will spend a stranger's money through"},"returns":{"ok":true,"brain":"the public record","funding":{"address":"your desk wallet","neededEth":"quote","heldEth":"what it holds","funded":false},"launchId":"the launch desk's id"},"dryRun":"dryRun: true validates everything, derives the wallets, quotes the funding, and spends nothing","unfunded":"a live intent from a desk wallet that cannot yet pay answers 402 with needsFunding, the address, the total and the shortfall, and queues nothing; fund it and send the same intent with the same Idempotency-Key"},"read":[{"method":"GET","path":"/api/brains","auth":"none","what":"the board: every brain, its coin, its split, its totals"},{"method":"GET","path":"/api/brains/:id","auth":"none","what":"one brain in full: decisions with reasons, transactions, the trading seat"},{"method":"GET","path":"/api/brains/:id/events?since=<ms>","auth":"none","what":"everything after a moment, oldest first. poll this. a LIVE decision means the coin is on chain and fees are flowing to the brain."},{"method":"GET","path":"/api/brains/mine","auth":"required","what":"your brains"},{"method":"GET","path":"/api/brains/whoami","auth":"required","what":"your uid, your desk wallet, what it holds"}],"control":[{"method":"POST","path":"/api/brains/:id/pause","auth":"owner"},{"method":"POST","path":"/api/brains/:id/resume","auth":"owner"},{"method":"POST","path":"/api/brains/:id/retune","auth":"owner","body":{"split":{"burn":60,"lp":0,"holders":30,"trade":10},"caps":{}}},{"method":"POST","path":"/api/brains/:id/withdraw","auth":"owner","what":"empties the brain's wallets to your desk wallet and pauses it; the coin is never sold"}],"guarantees":["the brain's wallet is derived from its id; the key exists for the life of a signing call and is never stored","the coin's fee splitter pays the brain directly; the service share is arithmetic in the contract","there is no code path by which a brain sells its own coin","the trading leg runs from a separate seat under the copy desk's own drawdown floor; it cannot spend what the burn leg was given","every decision is written down with its reason and is readable by anyone"],"limits":{"brainsPerOwner":5,"tradeMaxPct":50,"cadenceMinsMin":15,"launchesPerHandlePerDay":1},"alsoFrom":{"x":"@HarmonicAgents: 'launch Foo Coin $FOO with a brain 50% burn 20% lp 20% holders 10% trade'","telegram":"@HarmonicAgent_Bot, same sentence","site":"https://www.harmonicagent.solutions/#/brains"},"readme":"https://www.harmonicagent.solutions/api/brains/readme"}