Skip to main content

PONS Lightning Create API: One-Call Token Launch on Robinhood Chain

The custodial twin of PONS Create Token: PumpDev holds a wallet for your API key, builds the launch, signs it and sends it to the sequencer, and you get the transaction hash back. No RPC, no signing, no nonce bookkeeping โ€” one JSON POST launches a token with its dev buy.

API Endpoint: POST https://rhc.pumpdev.io/api/create-lightning?api-key=YOUR_KEY

Get a key on the setup page โ€” the same key trades on trade-lightning. It may also be sent as an X-Api-Key header.

Commission is 1% of the dev buy, taken inside the launch transaction. A launch without a dev buy costs nothing beyond PONS's own launch fee (0.0005 ETH at the time of writing, read live).


Prerequisitesโ€‹

You need a PONS Lightning wallet with an API key. Create or import one on the setup page โ€” one call or one click. Fund it with ETH on Robinhood Chain (chain id 4663) before launching: the launch fee, the dev buy and gas for ~4M units must all be covered, or the request answers 402 before anything is sent.


How It Worksโ€‹

  1. You send the token details (name, symbol, image URL, optional dev buy and team list) in a single POST
  2. The server encodes the launch, prices the dev buy from the fresh curve, estimates gas and predicts the token address
  3. The server checks the wallet's balance, takes the next nonce, signs the transaction and sends it to the sequencer
  4. You get back the transaction hash, the token and curve addresses, the fee and the quote โ€” before the block lands

This is the fastest way to launch on PONS: no RPC, no signing, no nonce bookkeeping. Compare with client-side creation if you need full control over signing.


Request Parametersโ€‹

The body is the create-local body without publicKey, gasLimit and nonce โ€” the wallet comes from the key and the server manages its nonce.

ParameterTypeRequiredDescription
namestringYes64 bytes or less
symbolstringYes16 bytes or less
imagestringYesImage URL (https://โ€ฆ or ipfs://โ€ฆ), 512 bytes or less
descriptionstringNoUp to 2048 bytes. Default: Launched on pumpdev.io โ€” the fastest PONS API
twitter, telegram, websitestringNoSocial links, 256 bytes each
buyAmountnumberNoDev buy in ETH, default 0. buyAmountSol / buyAmountQuote are aliases
creatorTaxBpsnumberNoYour tax on every buy of the curve, 0โ€“1000 bps (default 0)
slippagenumberNoOn the dev buy, default 90
snipeTaxExemptstring[]NoUp to 30 wallets that buy the first seconds tax-free โ€” the bundle team. The Lightning wallet is always exempt
priorityFeenumberNoGwei per gas, default 0.05

Responseโ€‹

{
"hash": "0xโ€ฆ",
"token": "0xNewToken",
"curve": "0xItsBondingCurve",
"salt": "0xโ€ฆ",
"publicKey": "0xLightningWallet",
"launchFee": "500000000000000",
"fee": { "bps": 100, "amount": "100000000000000", "asset": "ETH" },
"quote": {
"amountIn": "9900000000000000",
"expectedOut": "โ€ฆ",
"amountOutMin": "โ€ฆ",
"quoteAsset": { "symbol": "ETH", "decimals": 18 }
}
}

hash is returned before the transaction is on the network, as on every Lightning endpoint. token and curve are predicted from the launch itself (deterministic from salt, name, symbol and wallet) so you can subscribe to the token on the PONS WebSocket before the block lands; confirm with eth_getTransactionReceipt.


Exampleโ€‹

curl -X POST 'https://rhc.pumpdev.io/api/create-lightning?api-key=YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "My Token",
"symbol": "MINE",
"image": "https://example.com/logo.png",
"twitter": "https://x.com/mytoken",
"buyAmount": 0.01,
"creatorTaxBps": 100,
"snipeTaxExempt": ["0xTeamWallet1", "0xTeamWallet2"]
}'
const res = await fetch('https://rhc.pumpdev.io/api/create-lightning?api-key=YOUR_KEY', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: 'My Token', symbol: 'MINE', image: 'https://example.com/logo.png', buyAmount: 0.01 }),
});
const { hash, token } = await res.json();
console.log('Launch sent:', hash, 'token:', token);

Launch, then let the team buyโ€‹

The snipeTaxExempt wallets pay 0% while everyone else pays 99% โ†’ 6.18% โ†’ 0.19% over the first three seconds. A bundle is therefore two steps: launch with the team listed, then have each team wallet buy through trade-lightning with maxSnipeTaxBps: 0 โ€” their quotes read 0 bps from the launch block, so nothing is refused.


Error Responsesโ€‹

All errors return JSON with an error field:

{ "error": "Description of what went wrong" }
HTTP StatusCause
400Missing required fields (name, symbol, image) or a value out of range โ€” see create-local for the full list โ€” or Gas estimation failed: โ€ฆ
401Invalid, missing or deactivated API key
402Insufficient ETH: the response carries need and balance in wei. Nothing was signed or sent
500Transaction build failed (RPC unavailable)
503Token creation is not configured on this server

Not supported yetโ€‹

ERC-20 pairs (USDG, tokenized equities) and vanity addresses โ€” see create-local.


Next Stepsโ€‹