Prediction Stack docs Open the Stack
Reference

Changelog

The first release is 1.0.0. The pair matcher carries its own version number (0.3.0). Commits titled board: refresh … are data refreshes written by the job.

1.0.0 (first release)#

First release. Read-only prediction-market analytics: nothing in it places, signs or routes an order, connects a wallet or holds funds.

  • Spread Scanner: single-venue Kalshi spreads with every fee counted on every leg and annualised over the lock-up; the cross-venue matcher 0.3.0 (settlement, year, subject, source, predicate, threshold and party vetoes); venue health; the pair review queue.
  • Prediction Terminal: Polymarket fills, fees and builder-code attribution decoded from the exchange contract's logs on Polygon; flow per block, top tokens, attribution by builder code, latest fills, large fills (top 2% by notional). Market titles from Polymarket's API, resolved on the GitHub runner.
  • Category filter: Sports, Esports and Up/Down (short-term) markets are hidden by default. The operator changes the list in the admin (Categories); the pages apply it at load and the refresh job skips hidden markets. See Categories.
  • Refresh job (.github/workflows/refresh.yml): manual start, optional schedule, integrity checks that fail the run if it would publish rows it could not have fetched; optional own Polygon RPC through the secret POLYGON_RPC_URL.
  • Operator admin on the MIKODES Admin Kit 0.4.0 (admin/packages/admin-kit/, with its console source in ui-src/): brand, legal, access, venues, categories, integrations with a connection test, notifications, Scanner run and pair review, status checks, audit log, history, team, two-factor sign-in, export and import. One-time setup code for the first owner.
  • config/public.json contract (mikodes-prediction-public/1), read by the landing page, the Scanner, the Terminal and the refresh job.
  • Security: Content-Security-Policy without 'unsafe-inline' or 'unsafe-eval' on the public pages (vercel.json) and the admin; no inline script or style in any page; no API key in the code; market images are not loaded from the venue's image host.
  • Tests: matcher, Polymarket adapter, category filter, Polygon RPC handling, admin settings, policies and pair review routes. See Developer guide.
MIKODES Prediction Stack documentation. Written from the code in this repository; where the code and older notes disagree, the code wins. Nothing here is financial, legal or tax advice.