# Runitup

> A token launchpad on Robinhood Chain. Tokens launch straight into a real AMM pool with
> permanently locked liquidity, and the creator keeps 75% of every trading fee. A launch can be
> paired against ETH, USDG, or any of 31 tokenized equities — NVDA, TSLA, AAPL and the rest. There
> is a public API, so bots, agents and third-party apps can launch and read tokens without going
> through the website.

Runitup never holds keys. The API builds unsigned transactions; the caller signs and broadcasts
them. There is no endpoint that launches a token on someone's behalf, by design.

## Chains

Every endpoint takes `chain`, as either a slug or a numeric id.

- `robinhood` (4663) — Robinhood Chain mainnet. Pools quoted in ETH, USDG, or one of 31 tokenized
  equities. Uniswap V3, SushiSwap V3 and Uniswap V4.

Omitting `chain` means Robinhood.

Tokenized equities pair on **Uniswap V4 only**, and that is enforced by the contracts rather than
by the interface: the V3 adapters refuse them, so a launch submitted with an equity on a V3 venue
reverts. They are also third-party instruments whose issuer excludes US persons — a restriction
that applies however the token was acquired, and one Runitup cannot enforce.

Read `/api/v1/config` for the live chain list rather than trusting this file. An earlier version of
it named a testnet.

Two chains can hold different tokens at the **same address**, because every chain runs the same
factory deployed from the same wallet. Pass `chain` when looking a token up by address, and read
`chainId` off whatever comes back.

## For agents

- [Agent skill](https://runitup.gg/skills/runitup/SKILL.md): drop-in instructions for Claude
  Code, OpenCode, Hermes, OpenClaw or any agent framework that loads markdown skills
- [API reference](https://runitup.gg/docs/api): the launch flow, read endpoints, error shapes
- [Live config](https://runitup.gg/api/v1/config): every chain's contract addresses, venues,
  quote assets and current launch rules, read from the chain per request

## Docs

- [Start here](https://runitup.gg/docs)
- [Launching a token](https://runitup.gg/docs/launching)
- [Trading](https://runitup.gg/docs/trading)
- [AMM venues](https://runitup.gg/docs/amm-venues): what a venue is and how a pool works
- [Fees](https://runitup.gg/docs/fees-and-tax): the 75/25 split, and when fees arrive
- [Security](https://runitup.gg/docs/security)

## Key endpoints

- `GET /api/v1/config` — every chain's contracts and live launch rules
- `POST /api/v1/launch/prepare` — validated, unsigned launch calldata, on any chain
- `GET /api/tokens` — every live token with price, market cap and volume
- `GET /api/tokens/{address}` — one token, with holders and recent trades
- `GET /api/tokens/{address}/candles?interval=1h` — OHLC price history
- `GET /api/activity` — recent launches and trades
- `GET /api/statistics` — totals for one chain, named in the response
- `GET /api/search/tokens?q=` — search by name, ticker or address
- `GET /api/wallet/{address}/portfolio` — a wallet's holdings, across all chains