Resolution Tracker
Markets you hold, sorted by how soon they resolve
The Resolution Tracker answers one question that quietly sinks more prediction-market accounts than bad picks ever do: **when does each of my open positions actually resolve, and which ones do I need to deal with right now?** It lives at `/dashboard/resolutions` and gives you a single, time-ordered view of every market where you hold a position β sorted by how soon it settles, with the most urgent at the top.
This matters because prediction markets are not like stocks. A market does not just keep trading forever. It has an end date, after which the outcome is locked and liquidity vanishes. If you are sitting on a YES position you wanted to exit, "I'll get to it later" can mean the order book is gone by the time you look. The Resolution Tracker exists so "later" never becomes "too late."
## What It Does
The tracker scans all of your **open** positions across every source Predite knows about and merges them into one list:
- **Paper trades** β positions opened in [Paper Trading](/docs/paper-trading)
- β’**Bot trades** β positions opened by your automated bots (Bot plan)
- β’**Copy trades** β positions auto-replicated from wallets you follow via [Copy Trading](/docs/copy-trading)
For each open position it looks up the market's end date directly from the Polymarket Gamma API, calculates the time remaining, and assigns the market to a proximity bucket. Positions in the **same market from different sources are grouped together** β if your bot and a copy-trade both hold the same outcome, you see one market card with both legs and a combined exposure number, not two scattered rows.
Closed and settled positions never appear here. The tracker is strictly a forward-looking view of capital that is still at risk.
### The four stat cards
At the top of the page you get an instant read on your resolution exposure:
1. **Total Active** β how many distinct markets you currently have a live position in. 2. **Imminent (<24h)** β the count of markets resolving within 24 hours. This number turns **red** the moment it is above zero. It is the single most important thing on the page. 3. **Soon (<7d)** β markets resolving inside a week. Turns amber when populated. 4. **Total Exposure** β the summed USD size of every open position across all markets and all sources. This is your aggregate at-risk capital, rendered compactly (e.g. `$12.4k`).
### Proximity buckets
Every market card is color-coded by how close it is to settling:
- **IMMINENT** (red, π¨) β under 24 hours, **or already past its end date** but still marked open in your records. These need a decision today.
- β’**SOON** (amber, β°) β under 7 days.
- β’**MEDIUM** (teal, π ) β under 30 days.
- β’**DISTANT** (gray, π) β more than 30 days out.
- β’**UNKNOWN** (gray, β) β Predite could not retrieve an end date for this market. More on this below.
Markets are sorted strictly by proximity, soonest first, with UNKNOWN pushed to the bottom so it never buries something urgent.
## How to Use It, Step by Step
1. **Open `/dashboard/resolutions`** from the sidebar (under Portfolio & Analytics) or jump straight to it from search. 2. **Read the Imminent card first.** If it is red, you have markets resolving within 24 hours. Everything else can wait thirty seconds; this cannot. 3. **Work top-down.** The list is already ordered by urgency. Start at the first card and move down only as far as the time horizon you care about today. 4. **Open each urgent card's market.** Click the market title to jump to its [Market Detail](/docs/reading-signals) page. There you see the current order book, latest price, AI probability, and recent news β everything you need to decide hold-to-resolution vs. exit-now. 5. **Check the per-position breakdown.** Each card lists every leg: the source (π Paper, π€ Bot, π― Copy), the direction (YES/NO), the size in USD, and your entry price in cents. This tells you exactly what you are holding and at what cost basis before you act. 6. **Decide: hold or exit.** If you are confident in the outcome and the position is deep in the money, holding to resolution avoids exit slippage entirely β the market pays out at $1.00 or $0.00. If you are unsure, or you want to lock partial profit, exit while there is still a book to trade against. 7. **Execute the exit** from the market page (or via [TWAP Orders](/docs/twap-orders) if the size is large enough to move the price). Live exits require the **Bot plan**; paper positions can be closed any time from Paper Trading. 8. **Re-check daily.** Treat this page like a morning inbox. A 30-second scan each day is the entire workflow.
## Planning Exits Before Liquidity Dries Up
This is the core discipline the tracker is built to enforce. Order-book depth on most prediction markets **thins out hard in the final hours** before resolution. Two things happen at once:
- Market makers pull quotes as outcome uncertainty collapses, so the spread widens.
- β’Anyone who wanted out has mostly already left, so there is little volume on the other side.
The practical consequence: a position you could have exited at 88Β’ with negligible slippage on Tuesday might only fill at 81Β’ on Friday afternoon β not because the probability changed, but because there is no one left to sell to. You pay a liquidity tax for waiting.
The Resolution Tracker surfaces this window **before** it closes. Use the SOON bucket (under 7 days) as your planning queue, not your panic queue. A good cadence:
- **7 days out:** decide your intent for each position. Hold to resolution, or plan an exit?
- β’**2-3 days out:** for anything you intend to exit, start working the order. If it is sizeable, lay it out over time rather than dumping it into a thinning book β see TWAP Orders.
- β’**Under 24 hours (IMMINENT):** this should mostly contain positions you have already decided to **hold** to resolution. If something you wanted to exit is sitting in red, you left it too late β exit immediately at whatever the book offers, and treat it as a lesson for next time.
If you are holding to resolution deliberately, imminent is fine β you want the full payout. The danger is only the position you meant to trade out of and forgot.
## Markets With Unknown End Dates
A market lands in the **UNKNOWN** bucket when Predite cannot pull an end date for it from the Polymarket Gamma API. There are a few common causes:
- The market was **delisted or deleted** on Polymarket after you opened the position.
- β’The Gamma API is **temporarily unavailable** when the page loads (transient β refresh in a minute and it usually resolves).
- β’The position's stored `market_id` does not map cleanly to a current Gamma record (rare, typically older bot or copy trades).
UNKNOWN does **not** mean the position is worthless β it means the tracker cannot tell you *when* it resolves, so it cannot rank it. Treat these as items to investigate manually:
1. Open the market page to confirm it still exists and check its status directly. 2. If the market genuinely no longer exists, the position may already have settled; reconcile it in [Portfolio](/docs/portfolio) and your [Trade Journal](/docs/trade-journal). 3. If it is just a transient API blip, the date will reappear on the next refresh and the card will re-sort into its real bucket.
Do not ignore UNKNOWN cards indefinitely. A position with no readable end date is exactly the kind of thing that quietly resolves against you while you are not watching.
## Tips
- **Make it a daily ritual.** The tracker rewards consistency, not deep study. Thirty seconds every morning beats a frantic review once a week.
- β’**Watch the Total Exposure number over time.** A steadily climbing figure with no exits means capital is piling up in open risk β a sign you are entering faster than you are resolving.
- β’**Pair it with stop-loss discipline.** The tracker tells you *when* a market resolves; it does not move prices for you. For positions going the wrong way well before resolution, your stop-loss rules still apply.
- β’**Use the entry price for fast P&L math.** Each leg shows your entry in cents. Compared against the current price on the market page, you can eyeball whether an early exit locks a gain or a loss in seconds.
- β’**Group exposure tells you concentration.** If one market card shows a large combined size across paper, bot, and copy legs, you are more concentrated in that single outcome than any one source suggests on its own.
## Gotchas
- **Data is near-real-time, not tick-by-tick.** End dates are cached briefly to avoid hammering the Polymarket API, and the page refreshes roughly every minute. For a position resolving in the next few minutes, confirm the exact countdown on the market page before acting.
- β’**"Resolution overdue" / "Resolvingβ¦" means the clock has passed.** If a card shows the end date as already elapsed but the position is still listed, the market is settling and your records have not yet caught up. Reconcile it shortly after.
- β’**Only open positions count.** If something you expected to see is missing, it was likely already closed or settled β check Portfolio.
- β’**Entry price reads 0 when unknown.** Some legs (particularly older copy trades) may not carry a stored entry price; the cents figure is simply hidden in that case.
- β’**This is a tracking tool, not an execution tool.** You cannot close a position from this page. It points you to the market; you act there.
## Plan Requirements
The Resolution Tracker is available on the **Pro ($59/mo)** and **Bot ($99/mo)** plans. It is **not** included in Starter ($29/mo) β Starter accounts will hit the plan gate and be prompted to upgrade.
A note on what each plan can actually *do* with what the tracker surfaces:
- **Pro** can track every open position (including bot and copy legs if those exist on the account) and exit **paper** positions freely. Pro is fully sufficient if your live exposure is on platforms you manage directly.
- β’**Bot** adds live execution: closing real positions on Polymarket via the CLOB, plus [TWAP Orders](/docs/twap-orders) for working large exits into thin pre-resolution books without crushing the price. Automated bot positions and [Copy Trading](/docs/copy-trading) β the sources that most often fill this page β also require the Bot plan to run.
In short: Pro to *see and plan*, Bot to *automatically execute and exit live*.
## How It Connects to Other Features
The Resolution Tracker sits downstream of everything that opens a position and upstream of everything that closes one:
- **Inputs** come from [Paper Trading](/docs/paper-trading), your bots ([Bot Overview](/docs/bot-overview)), and [Copy Trading](/docs/copy-trading). Anything those create as an open position appears here automatically.
- β’**Decisions** are made on the market page, informed by [Reading Signals](/docs/reading-signals) and the [AI Probability](/docs/ai-probability) estimate β is the market still mispriced, or has it converged?
- β’**Exits** flow into [TWAP Orders](/docs/twap-orders) for size, and the outcome ultimately lands in your [Portfolio](/docs/portfolio) and [Trade Journal](/docs/trade-journal) once settled.
- β’**Sizing the next entry** ties back to the [Kelly Calculator](/docs/kelly-calculator): if the tracker shows your total exposure is already high, that should temper how much you stake on the next signal.
Used together, these turn position management from a memory exercise into a checklist.
## Related Docs
- [Paper Trading](/docs/paper-trading)
- β’[Copy Trading](/docs/copy-trading)
- β’[TWAP Orders](/docs/twap-orders)
- β’[Portfolio](/docs/portfolio)