Watchlist users
Updated
What is Watchlist users?
Watchlist users is a market-data metric that BlackForge measures for every listed pair on the major spot exchanges, in real time. 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 every venue
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 n/a. Nothing is invented.
| Venue | Symbol | Watchlist users |
|---|---|---|
| Binance | BTCUSDT | 2,488,385 |
| Bitget | BTCUSDT | 2,488,385 |
| Bybit | BTCUSDT | 2,488,385 |
| Coinbase | BTC-USDT | 2,488,385 |
| Gate | BTC_USDT | 2,488,385 |
| Kraken | BTCUSDT | 2,488,385 |
| Kucoin | BTC-USDT | 2,488,385 |
| Mexc | BTCUSDT | 2,488,385 |
| Okx | BTC-USDT | 2,488,385 |
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 that BlackForge measures for every listed pair on the major spot exchanges, in real time. 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, in real time, 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.