Building

API Reference

A public, non-custodial HTTP API. Read on-chain data, check names, get quotes, and build transactions you sign yourself.

Base URL http://5.9.115.219:2442/api/v1 (testnet, chain 46630). No auth; CORS is open. Write endpoints return unsigned transactions — the API never holds a private key.

Note.Amounts in request bodies are human units ("0.5" ETH, "1000000" tokens) unless the field name ends in Wei.

Read

GET/api/v1/tokens

List every launched token (indexed).

bash

curl http://5.9.115.219:2442/api/v1/tokens

GET/api/v1/tokens/:address

One token plus its 10 most recent trades.

GET/api/v1/tokens/:address/candles

OHLC candles built from trades.

Query

interval number Bucket size in seconds. Default 300.

GET/api/v1/names/check

Check name/symbol availability and see the canonical fingerprint.

Query

`name`	`string`	Name to check (optional).
`symbol`	`string`	Symbol to check (optional).

bash

curl "http://5.9.115.219:2442/api/v1/names/check?name=Robinhood"
# { "name": { "canonical": "robinhood", "available": false } }

GET/api/v1/quote

Quote a trade against the live curve.

Query

`side`required	`buy \| sell`	Trade direction.
`token`required	`address`	Token address.
`amount`required	`string`	buy → ETH in; sell → whole tokens in.

Write (non-custodial)

These build a transaction. Sign it with your wallet and send it — or POST the signed raw bytes to /tx/send.

POST/api/v1/tx/create

Build a launch transaction. Pre-checks availability (409 if taken).

Body

`name`required	`string`	Display name.
`symbol`required	`string`	Ticker.
`description`	`string`	Optional description.
`image`	`string`	Logo URL (upload first) or emoji:🚀.
`devBuyEth`	`string`	Optional first buy in the same tx.

bash

curl -X POST http://5.9.115.219:2442/api/v1/tx/create \
  -H 'content-type: application/json' \
  -d '{"name":"Solana","symbol":"SOL","devBuyEth":"0.05"}'

POST/api/v1/tx/buy

Build a buy transaction.

Body

`token`required	`address`	Token to buy.
`ethIn`required	`string`	ETH to spend.
`slippageBps`	`number`	Auto-computes minTokensOut from a live quote (e.g. 300 = 3%).
`minTokensOut`	`string(wei)`	Explicit floor; overrides slippage.
`deadline`	`number`	Unix seconds. Default now + 20m.

POST/api/v1/tx/sell

Build a sell transaction. Requires a prior ERC-20 approval of the launchpad on the token.

Body

`token`required	`address`	Token to sell.
`tokenAmount`required	`string`	Whole tokens to sell.
`slippageBps`	`number`	Auto-computes minEthOut.
`minEthOut`	`string`	Explicit floor (ETH).

POST/api/v1/tx/send

Relay a transaction you already signed locally. Returns the tx hash.

Body

rawTransactionrequired hex 0x-prefixed signed tx.

POST/api/upload

Upload a token logo (multipart field file, ≤ 2 MB). Returns a URL to use as image in /tx/create.

Full example (Python)

python

import requests, os
from web3 import Web3

API = "http://5.9.115.219:2442/api/v1"
w3 = Web3(Web3.HTTPProvider("https://rpc.testnet.chain.robinhood.com"))
acct = w3.eth.account.from_key(os.environ["PK"])

tx = requests.post(f"{API}/tx/buy", json={
    "token": "0x…", "ethIn": "0.1", "slippageBps": 300,
}).json()["tx"]

signed = acct.sign_transaction({
    "to": tx["to"], "data": tx["data"], "value": int(tx["value"]),
    "chainId": tx["chainId"], "gas": 300000,
    "nonce": w3.eth.get_transaction_count(acct.address),
    "maxFeePerGas": w3.eth.gas_price * 2, "maxPriorityFeePerGas": 1,
})
print(w3.eth.send_raw_transaction(signed.raw_transaction).hex())

Errors

Status	Meaning
400	bad or missing parameters
404	token not found
409	name or symbol already taken (an OG exists)
502	upstream RPC error

← Transactions

Errors & limits →