RUNUP for Devs and Agents For Developers and Agents
Read coins, prepare launches, trade and redeem from code.Your wallet keeps control of every action.
Read coins, launch, trade and redeem with codeNon-custodial, your wallet is in control.
RUNUP API
Read token data, prepare launches, get trade quotes and prepare asset redemptions through our open JSON API. We are non-custodial: we never ask for, accept or store private keys. You sign every transaction locally.
- Base path
/api/public/v1- Authentication
- No API key required
- Transactions
- Prepared unsigned
/tokensDiscover coins by mode or pair asset and sort by market cap or bonding progress.
/tokens/{mint}Read live price, market cap, the pair asset, a Rewards coin's fee option and launch block, and launch status.
/tokens/{mint}/tradesRecent trades in the pair asset, newest first.
/tokens/{mint}/candlesPrice candles in USD with volume.
/tokens/{mint}/holdersTop holders, with pool and keeper accounts labeled.
/tokens/{mint}/feesWhat a Basket coin's fees bought for its basket and paid its creator.
/presetsLaunch rules, the Rewards fee options and the defaults.
/stocksAssets a Basket coin could hold, with 30-day and 1-year returns.
/launches/prepareBuild an unsigned Rewards coin launch.
/launches/submitSend the signed launch.
/launches/{launchId}Check whether a launch is live.
/quoteQuote a buy or sell before asking a wallet to sign.
/trades/prepareBuild an unsigned buy or sell transaction.
/redeems/prepareRedeem a Basket coin for its assets; a wound-down basket answers redeem_closed.
/claims/{mint}The unclaimed earnings of a Classic coin's creator.
/claims/{mint}/prepareBuild the creator's unsigned claim (Classic coins).
/transactions/submitSend a signed trade, redeem or claim.
/statsPlatform totals: coins, assets in vaults, fees, $RUNUP burned.
/supply/circulating$RUNUP circulating supply.
/supply/total$RUNUP total supply after burns.
Quickstart
No API key requiredcurl 'https://runup.trade/api/public/v1/tokens?sort=marketCap'TypeScript client
Start with the SDK
npm install @runup.trade/client @solana/web3.jsimport { createRunupClient } from '@runup.trade/client'
const runup = createRunupClient()
const coins = await runup.tokens({ sort: 'marketCap' })
const presets = await runup.presets()A trade, a launch or a claim paid in USDC in the app has its network fee and rent paid by RUNUP's fee account and charged back in the same transaction with the memo "RUNUP network fee": 97igQUQCBHCHWRJyUcbLWFrevXds49tv942psyaDev5s
RUNUP MCP
Connect RUNUP to Claude, Cursor, ChatGPT or another MCP client. Node.js 20 or newer is required.
- 1
Add the server
Paste this into your MCP client configuration.
{ "mcpServers": {
"runup": {
"command": "npx",
"args": ["-y", "@runup.trade/mcp"]
}
} }- 2
Restart your MCP client
The client starts RUNUP through
npxand exposes eleven tools. - 3
Ask it to explore
Try “Show me the top RUNUP coins” or “Draft a Rewards coin called Moon Cat.”
list_coinsget_coinlist_presetsget_quoterecent_tradeslaunch_coinlaunch_statustrade_coinredeem_coinclaim_statusclaim_earnings