Guides

Launch a token

Create a token on Pump with creator fees routed from the first trade.

A launch is a single transaction that creates the token, optionally performs a first buy and records socials.capital's fee creator as the token's creator. The transaction is built server-side, pre-signed by the mint key, and returned for your wallet to sign.

Metadata

Upload the image and fields with a multipart request. The response contains the metadata URI the launch needs. Images should be square and at most 1 MB.

POST/v1/metadata

Multipart: file, launchpad, name, symbol, optional description, twitter, telegram, website.

Build the launch

POST/v1/launches

Returns the launch record and a base64 v0 transaction with its blockhash and lastValidBlockHeight.

Request body
{  "launchpad": "pump",  "name": "Ledger Cat",  "symbol": "LCAT",  "metadataUri": "https://…/metadata.json",  "links": { "website": "https://socials.capital/explore/lcat" },  "creatorWallet": "7bnp7SDB63bDvFKaMuALBpNiJRzjzwyHSk7gA1NAUfJW",  "initialBuyLamports": "500000000",  "paymentNote": "Creator fees via socials.capital",  "routes": [    { "platform": "telegram", "handle": "durov", "shareBps": 7000 },    { "platform": "x", "handle": "elonmusk", "shareBps": 3000 }  ]}

Sign and submit

Deserialize the transaction, sign it with the creator wallet and hand the signed bytes back. socials.capital broadcasts to every healthy RPC node, waits for confirmation and verifies the bonding curve exists with its fee creator.

POST/v1/launches/:id/submit

{ signedTransaction } → broadcast, confirm and verify.

POST/v1/launches/:id/confirm

{ signature } if you broadcast the transaction yourself.

Address lookup table

Pump's create-and-buy touches around 33 accounts, so the transaction relies on an address lookup table the operator maintains per cluster. Nothing to configure on your side.

Launch statuses

StatusMeaning
pending_signatureBuilt and waiting for the wallet.
submittedBroadcast, awaiting confirmation.
confirmedVerified on chain. Fees are being collected.
failedRejected or failed verification. See failureReason.
expiredThe blockhash expired before submission.