# Runitup

> A token launchpad on Robinhood Chain. Tokens launch straight into a real AMM pool with
> permanently locked liquidity. A plain launch charges a 1% pool fee and the creator keeps 75% of
> it. A launch can be
> paired against ETH, USDG, or any of 31 tokenized equities — NVDA, TSLA, AAPL and the rest. An
> Advanced launch (Uniswap V4, on the chains where it is switched on) is a taxed token: its pool
> charges no fee of its own; its hook charges a 1% standard fee, half creator and half platform, plus
> a creator-set buy and sell tax of up to 9%, split between the creator, locked liquidity, stakers and
> burn as the creator chose. A launch can also open with a sniper window: for at most 300 seconds its
> hook charges up to 80% of each trade, falling to the normal rate, so read the current rate on chain
> before buying a token that is minutes old. 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.
- `base` (8453) — Base mainnet. Pools quoted in ETH or USDC. Uniswap V4 only.

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.family/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.family/docs/api): the launch flow, read endpoints, error shapes
- [Live config](https://runitup.family/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.family/docs)
- [Launching a token](https://runitup.family/docs/launching)
- [Trading](https://runitup.family/docs/trading)
- [AMM venues](https://runitup.family/docs/amm-venues): what a venue is and how a pool works
- [Fees and tax](https://runitup.family/docs/fees-and-tax): the pool-fee split (75/25; a taxed token's hook charges a 1% standard fee, half creator, half platform), when fees
  arrive, and how an Advanced launch's buy and sell tax works
- [Security](https://runitup.family/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 (tokens in a stealth window only with the wallet's own pass)

## Blog

- /blog — guides and announcements; RSS at /feed.xml; JSON at /api/blog/posts
- /docs/blog-api — how to write and publish posts through the CMS API (needs a key)