Documentation Index
Fetch the complete documentation index at: https://0x-250ca30e.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Kuroko evaluates every active Polymarket market against four observable signals and produces a single edge score from 0 to 100. The score tells you how interesting a market is to trade right now — not whether you will win. Higher scores indicate conditions where the market is liquid, active, and uncertain enough to offer meaningful entry and exit opportunities.
Score tiers
Scores map to three tiers that appear throughout the Kuroko UI:
| Tier | Score range | What it means |
|---|
| STRONG | ≥ 70 | High-volume, liquid market with meaningful recent movement. Good conditions to consider a position. |
| MODERATE | 40 – 69 | Reasonable activity and liquidity. Worth watching; not yet prime conditions. |
| WEAK | < 40 | Thin volume, low liquidity, or a resolved-looking market. Exercise caution. |
STRONG does not mean “you should buy.” It means the market has the volume, liquidity, and uncertainty profile that makes a position worth evaluating. Kuroko surfaces conditions — you decide whether to trade.
Scoring dimensions
The total score is the sum of four independent dimensions. Each dimension rewards observable market conditions using fixed point bands.
| Dimension | Max points | What it measures |
|---|
| Volume | 30 | Trading activity — more volume means more reliable price discovery |
| Liquidity | 20 | Depth of the order book — more liquidity means cleaner entry and exit |
| Uncertainty | 30 | Distance of current probability from 50% — markets near 50% have the most edge potential |
| 24h movement | 20 | Recent repricing — a moving market may be incorporating new information |
Volume (0 – 30 points)
| Condition | Points |
|---|
| Volume > $1,000,000 | 30 |
| Volume > $500,000 | 20 |
| Volume > $100,000 | 10 |
| Volume ≤ $100,000 | 5 |
Liquidity (0 – 20 points)
| Condition | Points |
|---|
| Liquidity > $100,000 | 20 |
| Liquidity > $50,000 | 12 |
| Liquidity > $10,000 | 6 |
| Liquidity ≤ $10,000 | 0 |
A liquidity score of 0 does not lower your total below zero, but it does mean orders above a few hundred dollars may experience significant slippage. Check the order book before sizing in.
Uncertainty (0 – 30 points)
Kuroko measures how far a market’s current probability sits from 50%. Markets closest to 50% are the most uncertain — and therefore have the most potential for a meaningful edge.
| Distance from 50% | Points |
|---|
| < 10 percentage points | 30 |
| < 20 percentage points | 20 |
| < 30 percentage points | 10 |
| ≥ 30 percentage points | 5 |
24h movement (0 – 20 points)
| Absolute price change in 24h | Points |
|---|
| > 10 percentage points | 20 |
| > 5 percentage points | 12 |
| > 2 percentage points | 6 |
| ≤ 2 percentage points or data unavailable | 0 |
The 24h movement dimension only awards points when real CLOB price history data is available. If Kuroko cannot fetch price history for a token, this dimension contributes 0 points rather than assuming movement.
Reading the score breakdown
Every edge opportunity in Kuroko includes a plain-English score breakdown. It surfaces only the signals that are actually present, joined by · separators.
Example breakdown:
vol $2.3M · near 50% (max uncertainty) · +4.1pp 24h · +7.2pp 7d
| Segment | Dimension | Meaning |
|---|
vol $2.3M | Volume | $2.3M total trading volume |
near 50% (max uncertainty) | Uncertainty | Probability within 10pp of 50% |
+4.1pp 24h | 24h movement | Probability rose 4.1 percentage points in 24h |
+7.2pp 7d | (informational) | 7-day movement, shown when > 3pp |
How the STRONG tier works in practice
The STRONG edge strength label requires all three of the following to be true simultaneously:
- Edge score ≥ 70
- Volume > $500,000
- Absolute 24h probability change > 3 percentage points
This means a high score alone is not enough. The market also needs recent activity and meaningful trading volume behind it.
Sort by edge score descending to find the highest-conviction setups. Then read the scoreBreakdown to understand exactly what drove each score before sizing in.
Philosophy
Kuroko’s edge scores are built entirely on observable, verifiable market data. The engine never claims a side is “underpriced” relative to some theoretical fair value — it has no independent probability estimate to compare against. Every signal here can be cross-checked against the raw Polymarket data.
The goal is to surface conditions, not recommendations.