Developer reference

Agents

No API key, no signup, no launch fee. A launch is one contract call from any wallet with a little ETH for gas. Everything the site shows is also JSON.

Read llms.txt

The interface is optional.The same protocol is yours to build with.

Start with a launch

Launch a token

One call, from your own wallet.

Base

Chain 8453

factory: 0xad60Fe9e5601500449c7d0a87908636a0920307F
locker: 0x93c137BC5b5449D6202D8BdCf1CA398F3E2781c5

Call launch(params) on that chain's factory. The example below launches on Base with an ETH quote.

Launch on BaseShell · cast

cast send 0xad60Fe9e5601500449c7d0a87908636a0920307F \
  "launch((string,string,string,address,uint256,int24,uint24,bytes32,(address,uint16)[]))" \
  "(My Token,MYT,,0x0000000000000000000000000000000000000000,0,184200,10000,0x$(openssl rand -hex 32),[(0xYourWallet,9500)])" \
  --rpc-url https://mainnet.base.org --private-key $PK

Example only. Replace the wallet placeholder and review the parameters before sending a transaction. Never share your private key.

Parameters, without the guesswork

quote: ETH uses address zero. For USDC on Base use 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. For any ERC-20 quote call findSalt(...) first so the token address sorts above the quote.
supply: 0 means the default 1B supply.
startTick: Sets the opening market cap. A multiple of 200; 184200 ≈ 10 ETH FDV for 1B supply.
lpFee: In pips: 10000 = 1% or 30000 = 3%. At most 30000; 0 makes a pool with no trading fee.
recipients: Your 95% of trading fees: at most 6 entries, shares in bps summing to 9500 (not 10000). The factory prepends basepad's 500 bps (5%) itself. Empty means the 95% share is burned.

POST

Add metadata first

Optional

For an image, description or links, send metadata first. The response contains the uri to pass as metadataURI and the predicted token address.

Buy a little right after the launch confirms (a Universal Router swap on the new pool; the site's form suggests about $25). A token with no holder and no price move reads as dead on screeners and sits under quiet launches on the home page until an outside wallet trades it.

Metadata request shapeReference

POST https://basepad.si/api/launch/meta

{chain, launcher, salt, name, symbol, description?, image_url?, website?, x_handle?}

Read the API

JSON endpoints, plus a plain-text agent reference.

Public endpointsNo API key

GET

/api/launch/list

Browse and sort launches

GET

/api/launch/feed

Latest launches + trades

GET

/api/launch/meta/<token>

Image, description and links

GET

/llms.txt

Machine-readable reference

Read endpointsHTTP reference

GET https://basepad.si/api/launch/list?chain=base&sort=live|new|mcap|volume|gainers|holders&window=1h|24h|all&limit=50
GET https://basepad.si/api/launch/feed              # latest launches + trades
GET https://basepad.si/api/launch/meta/<token>      # image / description / links
GET https://basepad.si/llms.txt

Raw token and quote amounts are decimal integer strings. Use quote_decimals for quote amounts, not a blanket 18 decimals. price_quote and fdv_quote are numbers in the token's quote asset; explicit price_usd, fdv_usd and volume_usd fields are USD values and may be null when pricing is unavailable.

Poll modestly and back off on errors. Indexing and server-side caching mean responses are not a guarantee of the latest chain state, even when an HTTP response uses no-store.

Trade & collect

Standard pools. Direct contract calls.

Swap

Speak Uniswap v4

Pools are plain Uniswap v4, with tick spacing 200 and no hook. The quote can be ETH, USDC or a supported issuer-registry stock token (Coinbase tokenized stocks on Base). Get the actual pool key with poolKeyOf(token) on the factory. Swap through the Universal Router with a V4_SWAP command, or any router that speaks v4.

Collect

Pay out accrued fees

Anyone may call collect(tokenId) on that chain's locker to pay out accrued fees: 95% to the recipients (or burned), 5% to basepad. Base locker: 0x93c137BC5b5449D6202D8BdCf1CA398F3E2781c5. Use the matching chain address above.

Tokenized stocks are third-party securities offered under Regulation S, not to US persons. The site recognizes them from issuer registries, not on-chain names.

POST

Sync your transaction

After a transaction you sent, request immediate indexing with this endpoint. Background polling normally runs about every 15s; receipt availability and RPC errors can delay indexing.

Transaction sync endpointHTTP reference

POST https://basepad.si/api/launch/sync?chain=base&tx=0x…