Developer API

Read market data and launch coins without asking anybody. There is no API key and nothing to sign up for: reading is open, and anything that moves money is a NEAR transaction signed by your own wallet — stronger proof than any key we could issue.

Non-custodial throughout. We never ask for, accept or store a private key, and no endpoint signs anything on your behalf.

Base URL /api/public/v1Preview

Preview: the HTTP API goes live with the Cerebro backend on NEAR. The contract calls below are the launchpad's interface.

Quickstart

Every endpoint is open behind a per-minute rate limit per IP address. Start from a terminal:

Terminal

# No key, no signup, no plan. Just call it.
curl https://cerebro.fun/api/public/v1/tokens?sort=new

# One coin: its curve, its pair, its price.
curl https://cerebro.fun/api/public/v1/tokens/ncat-1.cerebro.near

Building it yourself

Everything the site does is a call to one contract, launchpad.cerebro.near. You can skip the API entirely and call it from near-cli, near-api-js or any wallet — your own front end, your own bot, your own batch.

Launching. create_token takes the coin's metadata and its quote token, and the NEAR you attach pays the launch fee, the new token's storage and, for a NEAR-paired coin, the first buy. Each coin gets its own account, <symbol>-<n>.cerebro.near, a standard NEP-141 with a fixed supply and no transfer tax.

near-cli

# Launch paired with NEAR, with a 5 NEAR first buy.
# Attach the launch fee (0.1) + storage + the buy; nothing trades before yours.
near call launchpad.cerebro.near create_token '{"name":"Neural Cat","symbol":"NCAT","icon":null,"description":"","socials":{},"quote_token":"wrap.near","min_tokens_out":"0"}' \
  --deposit 5.2 --gas 300000000000000 --accountId you.near

Trading. A coin paired with NEAR is bought by attaching NEAR to buy. A coin paired with any other token is bought by sending that token to the launchpad with ft_transfer_calland a buy message; whatever is not spent — past the graduation cap, say — comes back. A sell is always the coin sent to the launchpad. Register on a token (storage_deposit) before you first hold it.

Sizing. Every pairing opens and graduates at the same dollar value, so the curve's quote side differs per token. Read each one's sizing from GET /api/public/v1/quotes rather than hard-coding it.

near-cli

# Buy a NEAR-paired coin with 1 NEAR (min_tokens_out is your slippage floor).
near call launchpad.cerebro.near buy '{"token_id":"ncat-1.cerebro.near","min_tokens_out":"0"}' \
  --deposit 1 --gas 100000000000000 --accountId you.near

# Buy a USDC-paired coin with 10 USDC: send USDC to the launchpad with a buy message.
near call 17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1 ft_transfer_call '{"receiver_id":"launchpad.cerebro.near","amount":"10000000","msg":"{\"buy\":{\"token_id\":\"gray-3.cerebro.near\",\"min_tokens_out\":\"0\"}}"}' \
  --depositYocto 1 --gas 150000000000000 --accountId you.near

# Sell: send the coin to the launchpad with a sell message.
near call ncat-1.cerebro.near ft_transfer_call '{"receiver_id":"launchpad.cerebro.near","amount":"1000000000000000000000","msg":"{\"sell\":{\"min_quote_out\":\"0\"}}"}' \
  --depositYocto 1 --gas 150000000000000 --accountId you.near

Claiming fees

5% of every curve fee accrues to the coin's creator, in the coin's quote token. Only the creator can claim it.

near-cli

# Pay out what your coin has earned on its curve, in its quote token.
near call launchpad.cerebro.near claim_creator_fees '{"token_id":"ncat-1.cerebro.near"}' \
  --depositYocto 1 --gas 50000000000000 --accountId you.near

Rate limits

Every endpoint is open behind a per-minute limit per IP address. Past it, the API answers 429 with a Retry-After header in seconds. The contract has no limit beyond NEAR's own gas.

Endpoint reference

All under /api/public/v1. Amounts are decimal strings in raw units (NEAR has 24 decimals, a coin 18); USD figures are numbers.

Method	Path	Parameters	Returns
GET	/tokens	sort=marketCap\|new\|volume\|progress, category, q, page, pageSize	The marketplace, a page at a time.
GET	/tokens/{token}	—	One coin: pair, curve, price, market cap, 24h volume and change.
GET	/tokens/{token}/trades	limit	Its trades, newest first.
GET	/tokens/{token}/holders	limit	Its largest holders, with their share and value.
GET	/quotes	—	The quote tokens, and each one's curve sizing.
GET	/flywheel	—	Current rankings and buyback burns.
GET	/revenue	range=24h\|7d\|30d\|all	Volume, revenue, creator fees and buybacks.
GET	/rewards	creator	Creator rewards, site-wide or for one account.

Errors

Every error is JSON with a sentence in it: 400 for a bad parameter, 404 for a coin that does not exist, 429 for the rate limit, and 5xx for our side, which is worth retrying.

Terminal

curl -i https://cerebro.fun/api/public/v1/tokens/nope.near
HTTP/1.1 404 Not Found
content-type: application/json

{ "error": "No coin at nope.near" }