Developer reference
Agents
Public market reads, an OpenAPI contract, and a non-custodial execution boundary. Your agent can discover, inspect and prepare; your wallet signs and broadcasts.
The interface is optional.The same protocol is yours to build with.
npm packages
Typed SDK and MCP server, ready to drop in.
@fomopad/sdk — typed REST client
npm install @fomopad/sdkimport { FomopadClient } from "@fomopad/sdk";
const fomopad = new FomopadClient();
const { launches } = await fomopad.listLaunches({ sort: "live" });
const holders = await fomopad.holders("0x…");
const candles = await fomopad.candles("0x…", { interval: "5m" });
// After your wallet broadcasts a tx:
await fomopad.syncTransaction("0x…tx_hash");@fomopad/mcp — MCP server for agents
{
"mcpServers": {
"fomopad": {
"command": "npx",
"args": ["-y", "@fomopad/mcp"]
}
}
}Tools: fomopad_status, fomopad_list_launches, fomopad_search, fomopad_token_candles, fomopad_token_holders, fomopad_sync_transaction. Set FOMOPAD_BASE_URL only for a self-hosted deployment.
Launch a token
One call, from your own wallet.
Robinhood Chain
Chain 4663Call launch(params) on the Robinhood Chain factory. The example below uses an ETH quote.
cast send 0xc1613a96a4A1dcC8A6bc4b7F0F3Ca10Aaf531177 \
"launch((string,string,string,address,uint256,int24,uint24,bytes32,(address,uint16)[]))" \
"(My Token,MYT,,0x0000000000000000000000000000000000000000,0,184200,10000,0x$(openssl rand -hex 32),[(0xYourWallet,10000)])" \
--rpc-url https://rpc.mainnet.chain.robinhood.com --private-key $PKExample only. Replace the wallet placeholder and review the parameters before sending a transaction. Never share your private key.
Parameters, without the guesswork
quote- ETH uses address zero. For USDG on Robinhood Chain use
0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168. PONS is available as a listed quote option. For any other ERC-20 quote callfindSalt(...)first so the token address sorts above the quote. supply0means the default1Bsupply.startTick- Sets the opening market cap. A multiple of
200;184200 ≈ 10 ETHFDV for1Bsupply. lpFee- In pips:
0,10000 = 1%, or30000 = 3%. recipients- Empty means fees are burned. Otherwise, shares are in bps and sum to
10000.
Read the API
JSON endpoints, plus a plain-text agent reference.
/api/agent/capabilitiesAgent discovery, custody boundary and tool list
/openapi.jsonOpenAPI 3.1 contract for REST clients
/api/launch/listBrowse and sort launches
?chain=robinhood&sort=live|new|mcap|volume|gainers|holders&window=1h|24h|all&limit=50/api/launch/feedLatest launches + trades
/api/launch/candlesBounded OHLCV for one launched token
/api/launch/holdersHolder distribution and concentration facts
/api/launch/meta/<token>Image, description and links
/llms.txtMachine-readable reference
GET https://fomopad.my/api/agent/capabilities # agent discovery + custody boundary
GET https://fomopad.my/openapi.json # OpenAPI 3.1 contract
GET https://fomopad.my/api/launch/list?chain=robinhood&sort=live|new|mcap|volume|gainers|holders&window=1h|24h|all&limit=50
GET https://fomopad.my/api/launch/feed # latest launches + trades
GET https://fomopad.my/api/launch/candles # token OHLCV
GET https://fomopad.my/api/launch/holders # distribution facts
GET https://fomopad.my/llms.txtRead endpoints do not need an API key. They never accept wallet secrets. Amounts from contracts are decimal integer strings; use quote_decimals for quote amounts, not a blanket 18 decimals.
Execution is non-custodial: prepare and simulate in your own runtime, have the wallet owner sign and broadcast, then call POST /api/launch/sync?chain=robinhood&tx=0x… for indexed proof. Poll modestly and back off on errors.
Trade & collect
Standard pools. Direct contract calls.
Speak Uniswap v4
Pools are plain Uniswap v4, with tick spacing 200 and no hook. Quote options: ETH, USDG, PONS, or a Robinhood-registry stock token. Get the pool key with poolKeyOf(token) on the factory. Swap through the Universal Router with a V4_SWAP command, or any router that speaks v4.
Pay out accrued fees
Anyone may call collect(tokenId) on the locker to pay out accrued fees. Locker: 0xEccC522788fb7e6D064cdcBCD956a91a6ed9E2b0.
Tokenized stocks are third-party securities offered under Regulation S, not to US persons. The site recognizes them from issuer registries, not on-chain names.