Docs

pill.fm is a launchpad. You create a token in one transaction, it goes straight to a live market, and anyone can buy it immediately. There is no presale, no allocation round, and no team wallet — the whole supply goes into the market at launch.

Every token starts on equal footing and climbs toward graduation as people buy it.

1. 1

   Connect a wallet

   Pick the chain you want to launch on from the header, then connect. You can browse the create page without connecting.

2. 2

   Name it and add an image

   Name, ticker, and a logo are required. A description and links (site, X, Telegram) are optional but make the token page look real — add them.

3. 3

   Optionally buy in at launch

   You can include a first buy in the same transaction. It goes through the market like any other buy and counts toward graduation.

4. 4

   Confirm

   The create page shows the exact total — launch cost plus your first buy, if any — before you sign. Some chains charge a small launch fee; on others it is free.

Supply is fixed at 1 billion tokens and cannot be increased later.

A token is tradable the moment it launches. Buying and selling happens on the token page, and the chart and holder list update live.

For the first couple of blocks after launch there are limits on how much a single wallet can buy. This exists only to stop bots from taking the whole supply in the first second, and it lifts on its own within seconds.

Graduation is the milestone a token reaches once enough has been bought into its market. The progress bar on every token page shows how close it is — each chain has its own target, denominated in that chain's quote currency:

• EthereumETH curve
• StableUSDT0 curve
• Robinhood ChainETH curve
• ArcUSDC curve

Progress can go down as well as up — it tracks what is currently in the market, so selling pulls it back.

Every trade pays a 1% fee. That fee does not disappear — it collects against the token, and the creator can claim it.

Rewards build up as people trade. Open your profile page, find the token you created, and hit Claim fees — the 80% share is sent straight to your wallet. You can claim as often as you like; there is no deadline and nothing expires.

Launching itself is free on some chains and costs a small fee on others. The create page always shows the exact amount before you sign.

Everything the site shows is served from a public, read-only API at https://api.pill.fm. No key required.

• GET /api/v1/chains

  Supported chains and their graduation targets.

• GET /api/v1/tokens?chain_id=988

  Token list. Supports sort, search, limit (max 100) and offset.

• GET /api/v1/tokens/:address?chain_id=988

  One token, with price, holders and graduation progress.

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

  Price history. Takes timeframe (1m…1d) and currency (usd or native).

• GET /api/v1/stats

  Protocol totals per chain.

• WS wss://api.pill.fm/ws

  Live updates. Send {"type":"subscribe","channel":"swap:new"} to stream trades as they happen.

One factory per chain deploys and lists every token. The vault holds each launch's liquidity permanently and pays out creator fees — it has no withdraw function, so listed liquidity can't be pulled.

Open any address above to inspect it on the chain's explorer.

To launch without the UI, call createPill on the factory. It deploys the token, opens its market and locks the liquidity in one transaction.

function createPill(
  PillParams params,      // name, symbol, logo, description, socials, feeWallet
  uint256 launchConfigId, // 0
  uint256 dexId,          // 0
  bytes32 salt,           // any 32 bytes
  uint256 quoteBuyAmount  // your first buy, in quote units (0 = none)
) payable returns (address token)

• params.feeWalletWhere this token's creator fees are paid. Use your own address.
• launchConfigId / dexIdBoth 0 today — the default preset for each chain.
• quoteBuyAmountAn optional buy included in the same transaction. Counts toward graduation like any trade.
• value (msg.value)Covers the launch fee (if the chain has one) plus your buy when the chain's quote asset is the native coin. When the quote is an ERC-20, approve the factory for quoteBuyAmount first instead.

Supply is fixed at 1 billion and minted in full at launch. The token address is returned and also emitted in PillLaunched.

Don't want to trust our API? Read the chain directly. The factory emits PillLaunched on every launch, and each pool emits standard swap events you can index for trades and price.

Creators collect their fees by calling claimRewards(token) on the vault — the same call the profile page's Claim fees button makes.

There is no token affiliated with pill.fm. Anything presented as an official pill.fm token is a scam, no matter who posts it.

Anyone can launch a token with any name or logo, including copies of well-known projects. A token appearing here is not an endorsement — check the contract address before you buy, and treat every launch as high risk.

See the Terms of Use for the full terms.