Trader quality: grade and score
On every trader and leaderboard entry:grade: a letter fromStoF. The headline quality signal. See Grades.score: the numeric composite (0-100) behind the grade.streak_tier: recent form, separate from the all-time grade. One ofhot,rising,neutral,cooling,cold.rank: position on the leaderboard.
streak_tier is the trailing-form overlay: an A-grade trader can be cooling, and a B-grade trader can be hot.
Per-trade strength: signal_score
Each whale trade carries asignal_score: how strong that single fill is as a signal. Use it to rank a feed of trades, not to judge a trader overall.
Market direction: smart money
Market intel and smart-money flows return asmart_money object. This is the canonical view of where graded money is flowing on a market:
| Field | Meaning |
|---|---|
net_flow_usd | Buy volume minus sell volume from graded traders, in USD. The headline number. |
direction | YES or NO: the side net flow is leaning toward. |
buy_volume_usd | Graded buy volume in the timeframe. |
sell_volume_usd | Graded sell volume in the timeframe. |
whale_trade_count | Number of qualifying whale trades. |
top_positions | The largest graded positions on the market, with trader and side. |
net_flow_usd is the field to read for “which way is smart money leaning, and how hard.” A large positive net_flow_usd with direction: YES means graded traders are buying YES.
Market discovery: smart_score
The explore feed ranks markets with a separate set of discovery aggregates:smart_score: a per-market smart-money intensity used for ranking.smart_count: how many graded traders are active on the market.smart_label: a short human-readable tag.discover_score: the backend-owned score behind the default hot sort.
smart_money flow object above. When you want a number to act on for a specific market, use smart_money.net_flow_usd. When you want to rank a list of markets to surface, use the explore sort parameter, which is driven by these scores.
Picking the right field
| Question | Field |
|---|---|
| Is this trader worth following? | grade (and score) |
| Is this trader hot right now? | streak_tier |
| Is this single trade a strong signal? | signal_score |
| Which way is smart money leaning on this market? | smart_money.net_flow_usd and direction |
| Which markets should I surface? | explore sort (driven by discover_score) |