Keelfun

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.

terminal
# 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…/fees

Endpoints

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.

launch.ts
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,
});