$hooks is live0x07bc..7777Buy Chart

Docs · API

The pickhooks API

Everything the site knows, as JSON. Built for trading terminals, indexers and bots. No key, GET only, any origin may read it (CORS on every answer, preflights included). Every answer is cached for a few seconds, and each address has a limit per minute; a few calls per second is plenty.

Base URL: https://pickhooks.com

On chain

Nothing here needs the API. Every launch is an event on the factory, every coin names its metadata, and the liquidity sits in one locker. The API only saves you the indexing.

Locker (holds every coin's liquidity)
0x3613842C0e5ca05E90a4e417364044114A55D0BF
Modes factory for flap coins (BELL, SEAT, PERSUADE, RANSOM, WAR)
0x5572875849d2e79B8F6287e8E31Fe5576771cc9A
Vault factory v1 for flap coins (burn, bell, milestone)
0xe2D22Ee45255A93E81228887d015aC11905C57c6
Launch event on the factory
Launched(address indexed token, address indexed creator, address pool, address pair, uint256 tokenId, uint64 mask)
Metadata of a coin
metadata() on the token returns the JSON URL (name, symbol, description, image)
Chain
BNB Chain, chainId 56

GET/api/launches

Every coin, newest first: token, factory, launch block and transaction, both PancakeSwap pools, name, image, socials and the rules. Coins launched on flap with a pickhooks vault are in it too, marked launchedOn flap, with their vault and tax. A coin with its rules in the pool has rulesIn pool, dex pancakeswap-infinity, its hook, no pair, and the PancakeSwap Infinity pool id (bytes32) as pool. mode names the launch mode (rules, pools, calls, lever, flap), launcher the contract the launch transaction went to (the factory, or the hide box of a find the dev coin), and factories in the header lists every one of them with start block and event.

since
unix seconds, inclusive: the coins launched from that time on. Poll with the newest createdAt you have. Milliseconds are accepted too.
before
unix seconds, exclusive: page back with the oldest createdAt you have.
limit
1 to 200, default 100.

cache 15 slimit 240 per minute per address

Example

https://pickhooks.com/api/launches?limit=1
{
  "launchpad": "pickhooks",
  "chain": "bsc",
  "chainId": 56,
  "factories": [{ "address": "0xecED45Ae3e85D947038009710594a50d422A54D8", "kind": "pickhooks", "startBlock": 125513151, "event": "Launched(...)" }, ...],
  "lastBlock": 125642664,
  "count": 1,
  "launches": [{
    "token": "0x2678...150F",
    "launchedOn": "pickhooks",
    "name": "接龙", "symbol": "JIELONG", "decimals": 18, "totalSupply": "1000000000",
    "description": "...", "image": "https://pickhooks.com/meta/d35f...659d.png",
    "metadataUrl": "https://pickhooks.com/api/launches/0x2678...150F",
    "website": null, "twitter": null, "telegram": null,
    "creator": "0x9d06...16a1", "factory": "0xecED45Ae3e85D947038009710594a50d422A54D8", "launcher": "0xecED45Ae3e85D947038009710594a50d422A54D8", "mode": "rules",
    "pool": "0xaeFB...Cf0b", "pair": "0xAea0...ac1F", "dex": "pancakeswap", "feeTier": 10000,
    "rules": ["Raise", "Buys unlock sells", "Tick tock"],
    "vault": null, "hide": null, "tax": null,
    "createdAt": 1791085974, "blockNumber": 125607595, "txHash": "0x8303...8a4c",
    "url": "https://pickhooks.com/t/0x2678...150F"
  }]
}

GET/api/launches/<address>

One coin, the same shape as a row of the feed. Terminals often know the pool before the token, so every address of a coin works.

address
the coin's token, its V3 pool, its V2 pair or its vault. 400 on a bad address, 404 when it is not one of ours.

cache 15 slimit 240 per minute per address

Example

https://pickhooks.com/api/launches/0x26782D0ad011A3999de66f585005bCAf3D5D150F
{ "token": "0x2678...150F", "launchedOn": "pickhooks", "name": "接龙", ... }

GET/api/coins

The board as the site shows it: price in BNB, market cap in BNB and USD, holders, share of the curve sold and every rule with its sentence. Probe coins are left out.

board
1 adds the coins of the other launch modes (lever, calls, sticky, the flap coins with a pickhooks vault) and marks find the dev and CZ mode coins: each such coin carries kind (lever, calls, hide, cz, sticky or flap) and href, the page it opens (a flap coin's flap page); a flap coin also carries pot, its vault pot in BNB, and its mode as its one rule. Without it, the rules coins only.

cache 8 slimit 120 per minute per address

Example

https://pickhooks.com/api/coins
{
  "coins": [{
    "token": "0x3aAF...88dF", "pool": "0x...", "creator": "0x...",
    "name": "HookCat", "symbol": "HOOKCAT", "description": "...", "image": "https://pickhooks.com/meta/a0f3...349c.jpg",
    "rules": [{ "kind": 1, "name": "Max wallet", "text": "No wallet holds more than 2% of the supply." }],
    "scanner": "yellow",
    "createdAt": 1791060000000,
    "priceBnb": 0.0000000061, "mcapBnb": 6.1, "mcapUsd": 6120, "soldPct": 3.2, "holders": 48
  }]
}

GET/api/activity

What happens on the pad, newest first: launches, fee collects on the locker, $hooks buybacks and burns, jackpots won, buyer rewards, pot top ups, and sell windows or market hours that opened. Every row carries an English sentence in text.

kind
comma list of launch, collect, buyback, jackpot, reward, pot, window, hours, burn, buyout, lifted, released, duel, defend, shift. Empty means all.
limit
1 to 200, default 100.

cache 10 slimit 120 per minute per address

Example

https://pickhooks.com/api/activity?kind=buyback,jackpot&limit=2
{
  "count": 2,
  "lastBlock": 125642660,
  "events": [{
    "id": "buyback:0x415f...9218", "kind": "buyback", "at": 1791101727,
    "token": "0x07bc...7777", "name": "pickhooks", "symbol": "hooks", "image": "",
    "url": "https://dexscreener.com/bsc/0x07bc...7777",
    "tx": "0x415f...9218", "block": null,
    "bnb": 0.475, "tokens": 952733, "who": null, "via": "pancakeswap v2",
    "launchedOn": null, "rules": [], "pot": null,
    "text": "952.7K $hooks bought for 0.475 BNB and burned"
  }, {
    "id": "0x9c1e...41a0:17", "kind": "jackpot", "at": 1791098800,
    "token": "0xE343...c479", "name": "1% can change your life", "symbol": "1",
    "tx": "0x9c1e...41a0", "block": 125630011,
    "bnb": 0.21, "tokens": null, "who": "0x5a1c...9f02", ...
    "text": "0x5a1c..9f02 won the 1% can change your life jackpot: 0.21 BNB"
  }]
}

GET/api/burners

Which coins paid for the most $hooks burns, from the locker's Collected events: fees collected per coin, the part that went into buybacks, and each coin's share of all burns.

cache 30 slimit 60 per minute per address

Example

https://pickhooks.com/api/burners
{
  "burners": [{
    "token": "0x3aAF...88dF", "name": "HookCat", "symbol": "HOOKCAT", "image": "https://pickhooks.com/meta/a0f3...349c.jpg",
    "feesBnb": 0.3653, "burnBnb": 0.2333, "sharePct": 56.46, "collects": 46, "lastAt": 1791096485000
  }],
  "totalBurnBnb": 0.4131, "totalFeesBnb": 0.6471, "lastBlock": 125642660
}

GET/api/official

The pickhooks token: address, phase (flap curve or PancakeSwap), price and market cap, how much the pad has burned, BNB spent, number of buybacks and when the last one was, plus the liquidity its tax has locked into the PancakeSwap pool (lpBnb, lpTokens, lpAdds, lastLp).

cache 15 slimit 120 per minute per address

Example

https://pickhooks.com/api/official
{
  "official": {
    "token": "0x07bcB8E8226f671300e135b4A61Dc157359b7777", "name": "pickhooks", "symbol": "hooks",
    "phase": "dex", "progressPct": null,
    "priceUsd": 0.0005478, "mcapUsd": 494246,
    "burned": 102002381.29, "spentBnb": 49.03, "buybacks": 147, "lastBuyback": 1791101727406,
    "lpBnb": 0.0286, "lpTokens": 47910.33, "lpAdds": 1, "lastLp": 1791130731776,
    "flapUrl": "https://flap.sh/bnb/0x07bc...7777", "chartUrl": "https://dexscreener.com/bsc/0x07bc...7777"
  }
}

Need another shape?

A token list, an RSS feed, webhooks on launch: tell us on X and we build it the same day. The feed above is what we send to Axiom, GMGN and DEXTools to get pickhooks listed as a launchpad.

Back to the docs