Pokélator API

Basics • Coins • One coin • Trades, holders, candles • Search • Packs • Arena • Pulls • Stats • Docs

Basics

A free, read only JSON API. No key is needed. Feeds are cached for about 15 seconds. Errors come back as { "error": "..." } with a 4xx or 5xx status. Amounts in lamports are strings (1 SOL = 1,000,000,000 lamports); times are ISO strings.

Base URL: https://pokelator.cards

Coins

GET/api/coins?order={order}&cursor={cursor}&limit={n}

Coins launched on Pokélator, 25 per page by default.

orderVOLUME_30_MIN_DESC (trending, default), NEWEST, MARKET_CAP_DESC, CLOSEST_TO_GRADUATION, PRICE_CHANGE_24_HOUR_DESC, OLDEST
cursorThe nextCursor of the previous page
limit1 to 100
creatorOptional: only the coins this wallet launched
{ "items": [ Coin, ... ], "nextCursor": "..." | null }

One coin

GET/api/coins/{mint}

One coin with its stats, its pack and its safety facts read from the chain. 404 when the coin was not launched on Pokélator.

{
  "mint": "...", "name": "...", "symbol": "...", "imageUrl": "...", "description": "...",
  "createdAt": "...", "graduatedAt": null,
  "pack": { "code": "pokemon_50", "name": "Elite Pokémon Gacha Pack", "short": "Elite", "usd": 50 },
  "stats": { "marketCapUsd": 0, "priceUsd": 0, "priceSol": 0, "volume24HUsd": 0,
             "graduatedPercentage": 0, "holders": 0, ... },
  "safety": { "mintAuthorityRevoked": true, "freezeAuthorityRevoked": true, ... },
  "creator": { "address": "..." }, "pools": []
}

Trades, holders, candles

GET/api/coins/{mint}/trades?cursor={cursor}&limit={n}

The coin's trades, newest first: direction, SOL and token amounts, trader, signature.

GET/api/coins/{mint}/holders

The top 20 holders of the newest snapshot, with the bonding curve, pool and launcher labelled.

GET/api/coins/{mint}/candles?res={seconds}&limit={n}

USD candles, oldest first. res is 60, 300, 900, 3600, 14400 or 86400.

GET/api/search?q={text}

Up to 4 coins matching a name, ticker or contract address.

Packs

GET/api/packs

The eight Collector Crypt Pokémon packs a coin can be paired to, with their live price, odds, card value tiers and stock, and how many coins and pulls each has.

Arena

GET/api/arena/{mint}

The coin's current round (state, start, pack meter, traders), the smoothed mark price, open interest, funding and the leaderboard. Signed in with Phantom, it also carries your own play margin, position and tickets. Margin in the arena is play margin, never money.

Pulls

GET/api/pulls?page={n}&limit={n}

Every pull drawn, newest first: coin, pack, round, winner, status (owed, sent or rolled).

GET/api/pulls/{id}

One pull with its full draw proof: the drand beacon round and randomness, the published ticket commitment, the seed, the winning ticket and every ticket range.

Stats

GET/api/stats

{ "coins", "graduated", "trades", "traders", "volumeUsd" } across every coin launched here.

GET/api/sol-price

{ "usd": 0 }, the SOL price the site uses.