Developer API
Read Keelfun market data over plain HTTP. No key, no signup: every endpoint is public JSON with CORS enabled. Launching and trading happen on-chain, signed by your own wallet.
Quickstart
Base URL https://api.keelfun.app. Responses are JSON. Errors come back as { "error": string } with a 4xx/5xx status. Please cache and poll gently.
# No key, no signup. Just call it.
curl https://api.keelfun.app/tokens?sort=new
# One token, its trades and fee activity
curl https://api.keelfun.app/tokens/0x…/trades
curl https://api.keelfun.app/tokens/0x…/feesEndpoints
GET/stats
Totals: tokens, volume, trades, platform fees, ETH/BTC price and indexer head.
GET/tokens?sort=trending&q=&limit=48&offset=0
Token list. sort: trending, new, top, holders. q searches name, ticker or address. creator filters by wallet.
GET/tokens/{address}
One token: pair, taxes, split, supply, price, FDV, liquidity, volume, holders.
GET/tokens/{address}/trades?limit=50
Latest trades. Amounts in the pair asset (pairAmount) and ETH value (eth).
GET/tokens/{address}/holders
Top 100 holders with share of supply. The v4 pool, dead address and creator are labelled.
GET/tokens/{address}/fees
Fee activity: buy/sell tax per trade, creator claims, holder dividends and buyback burns.
GET/tokens/{address}/candles?res=60
OHLCV candles. res in seconds: 15, 60, 300, 900, 3600, 14400, 86400.
GET/portfolio/{wallet}
Balances, created tokens and claimable fees for a wallet.
GET/revenue
Platform revenue, creator fees, dividends, burns, revenue per pair and daily series.
GET/flywheel
Buyback totals, top tokens by market cap and recent buyback burns.
GET/builders
Registered builders and the volume they routed.
Launching yourself
There is no launch endpoint to trust: call the Factory directly from your wallet. The token address must sort above the pair asset, so mine a salt against the Factory's token init code hash first (the Keelfun launch page does this in the browser). Indexed launches show up in the API within a minute.
import { createWalletClient, custom, parseEther } from "viem";
import { base } from "viem/chains";
const factory = "0xDC802747d6c5271e2fC8a51bc52D279bDb80b463";
// launch(LaunchParams) — see contracts/src/LaunchFactory.sol
await wallet.writeContract({
address: factory, abi: launchFactoryAbi, functionName: "launch", chain: base,
args: [{
name: "My Token", symbol: "MYT", metadataURI: "", supplyTier: 0,
pair: "0x0000000000000000000000000000000000000000", // ETH, or any enabled pair
buyBps: 300, sellBps: 300, creatorBps: 10000, holdersBps: 0, burnBps: 0,
antiSnipe: true, editable: true, recipients: [me], shares: [10000],
salt, devBuy: 0n, minTokensOut: 0n,
}],
value: 0n,
});