Watchlist users
Updated
What is Watchlist users?
Watchlist users is a market-data metric BlackForge measures for every listed pair on nine spot exchanges, once per closed five-minute window. How many CoinGecko users hold the coin in a watchlist portfolio. It reports what the order book or trade tape showed, not what price will do next.
The facts
| Unit | count |
|---|---|
| Family | Enrichment |
| Key | watchlistUsers |
| Quote-relative | No |
| Nullable | Yes |
| Plottable | Yes |
| Available from | Max plan |
Live across all nine venues
Watchlist users for BTC-USDT, as measured in the latest closed window on each venue. Observed . A venue with no reading for this window shows an em dash — nothing is invented.
| Venue | Symbol | Watchlist users |
|---|---|---|
| Binance | BTCUSDT | 2,461,914 |
| Bitget | BTCUSDT | 2,461,914 |
| Bybit | BTCUSDT | 2,461,914 |
| Coinbase | BTC-USDT | 2,461,914 |
| Gate | BTC_USDT | 2,461,914 |
| Kraken | BTCUSDT | 2,461,914 |
| Kucoin | BTC-USDT | 2,461,914 |
| Mexc | BTCUSDT | 2,461,914 |
| Okx | BTC-USDT | 2,461,914 |
Query it
Watchlist users is one field on the wide row /v1/latest returns for a pair. Set $BF to the API base and read it at .values.watchlistUsers:
curl -H "x-api-key: $BLACKFORGE_API_KEY" \
"$BF/v1/latest?exchange=binance&symbol=BTCUSDT"
# read the value at: .values.watchlistUsersRelated
Off-book context per coin: market cap, rank, liquidity, attention and developer activity.
← All Enrichment and every other metric · Coverage by venue
What is Watchlist users?
Watchlist users is a market-data metric BlackForge measures for every listed pair on nine spot exchanges, once per closed five-minute window. How many CoinGecko users hold the coin in a watchlist portfolio. It reports what the order book or trade tape showed, not what price will do next.
How is Watchlist users measured?
BlackForge computes Watchlist users from each venue’s own order book and trades for every listed pair, once per closed five-minute window, and records it as count. The value is stored exactly as observed.
Which plan includes Watchlist users?
Watchlist users is available from the Max plan upward, and on pay-per-call over x402. See pricing for the full plan ladder.
Does Watchlist users predict where price will go?
No. Watchlist users is a measurement of what the order book or trade tape showed in the window. It carries no view on future price, and BlackForge scores nothing — every metric is a measurement, not a call.