# BNKR Screener — Skill Reference

You have access to the BNKR Screener API, a real-time token screener for the BNKR ecosystem on Base chain. It reads from the Css God database and serves aggregated metrics from an in-memory cache.

## Base URL

`https://bnkr.cssgod.io` (production)

## Available Endpoints

### GET /api/stats

Returns ecosystem-level totals. No parameters.

Response fields: `tokenCount`, `activeTokens`, `totalVolume24h` (ETH), `ethUsdPrice` (USD per ETH, polled every 5s), `lastUpdate`

Note: `totalVolume24h` is in ETH. Multiply by `ethUsdPrice` for USD value.

### GET /api/tokens

Returns the screener table — a filtered, sorted list of tokens with per-window metrics.

Query parameters:

- `window` — Time window: `5m`, `1h` (default), `6h`, `24h`
- `sort` — Sort field (default: `totalVolume`). Options: `totalVolume`, `buyVolume`, `sellVolume`, `buyCount`, `sellCount`, `tradeCount`, `buySellRatio`, `priceChangePct`, `lastPrice`, `highPrice`, `lowPrice`, `liquidity`, `marketCap`, `blockNumber`, `latestMinuteKey`, `barCount`

Common sort patterns:
  - **Most active**: `sort=totalVolume&order=desc`
  - **Newest deployments**: `sort=blockNumber&order=desc`
  - **Recent activity**: `sort=latestMinuteKey&order=desc`
  - **Top gainers**: `sort=priceChangePct&order=desc`
  - **Top losers**: `sort=priceChangePct&order=asc`
- `order` — `desc` (default) or `asc`
- `search` — Substring match on token address or initializer
- `minVolume` — Minimum total volume in ETH (default: 0)
- `minTrades` — Minimum trade count (default: 0)

- `limit` — Results per page, max 100 (default: 20)
- `offset` — Pagination offset (default: 0)

Each token in the response contains: `address`, `initializer`, `blockNumber`, `insertedAt`, `barCount`, `latestMinuteKey`, `totalVolume` (ETH), `buyVolume` (ETH), `sellVolume` (ETH), `buyCount`, `sellCount`, `tradeCount`, `buySellRatio`, `firstPrice`, `lastPrice`, `highPrice`, `lowPrice`, `priceChangePct`, `marketCap` (USD), `totalSupply`, `symbol`, `name`, `liquidity` (ETH)

Note: Volume and liquidity are in ETH. `marketCap` is pre-computed in USD (lastPrice * ethUsdPrice * totalSupply). Multiply ETH fields by `ethUsdPrice` from `/api/stats` for USD conversion.

### GET /api/tokens/latest

Returns the newest BNKR tokens ordered by creation block.

Query parameters:

- `limit` — Max results, cap 200 (default: 50)

### GET /api/tokens/:address

Returns a single token's full detail across all windows plus 24h bar history.

Path parameter: `address` — token contract address (case-insensitive)

Response includes all window metrics (`windows.5m`, `windows.1h`, `windows.6h`, `windows.24h`) and a `bars` array of minute-level data points with `minuteKey`, `createdAt`, `price`, `buyVolume`, `sellVolume`, `buyCount`, `sellCount`.