FomoPad

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.

Start with a launch
00

npm packages

Typed SDK and MCP server, ready to drop in.

@fomopad/sdk — typed REST client

InstallShell
npm install @fomopad/sdk

UsageTypeScript
import { 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

Claude Desktop / Cursor / any MCP clientJSON
{
  "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.

01

Launch a token

One call, from your own wallet.

Call launch(params) on the Robinhood Chain factory. The example below uses an ETH quote.

Launch on Robinhood ChainShell · cast
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 $PK

Example 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 call findSalt(...) first so the token address sorts above the quote.
supply
0 means the default 1B supply.
startTick
Sets the opening market cap. A multiple of 200; 184200 ≈ 10 ETH FDV for 1B supply.
lpFee
In pips: 0, 10000 = 1%, or 30000 = 3%.
recipients
Empty means fees are burned. Otherwise, shares are in bps and sum to 10000.
02

Read the API

JSON endpoints, plus a plain-text agent reference.

Public endpointsNo API key
GET
/api/agent/capabilities

Agent discovery, custody boundary and tool list

GET
/openapi.json

OpenAPI 3.1 contract for REST clients

GET
/api/launch/list

Browse and sort launches

?chain=robinhood&sort=live|new|mcap|volume|gainers|holders&window=1h|24h|all&limit=50
GET
/api/launch/feed

Latest launches + trades

GET
/api/launch/candles

Bounded OHLCV for one launched token

GET
/api/launch/holders

Holder distribution and concentration facts

GET
/api/launch/meta/<token>

Image, description and links

GET
/llms.txt

Machine-readable reference

Read endpointsHTTP 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.txt

Read 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.

03

Trade & collect

Standard pools. Direct contract calls.

Swap

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.

Collect

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.