Documentation Index Fetch the complete documentation index at: https://docs.generalmarket.io/llms.txt
Use this file to discover all available pages before exploring further.
Browsing Sources Ninety-eight windows into the world. Each one measures something. None of them measure what matters — but together, they approximate a portrait of reality sufficient for wagering.
Vision draws from 90+ real-world data sources spanning 10 categories. The Sources browser is the main entry point for discovering what you can bet on.
There are two main pages:
Sources listing (/) — grid of all source cards, filterable by categorySource detail (/source/[sourceId]) — individual source with live markets, price charts, batch info, and leaderboard
┌─────────────────────────────────────────────────────────────────────────────┐ │ SOURCES BROWSER OVERVIEW │ │ │ │ ┌──────────────────────────┐ ┌──────────────────────────┐ │ │ │ │ │ │ │ │ │ SOURCES LISTING │ click │ SOURCE DETAIL │ │ │ │ / │ -------> │ /source/coingecko │ │ │ │ │ │ │ │ │ │ - Category nav bar │ │ - Hero banner │ │ │ │ - Sort bar │ │ - Batch tick bar │ │ │ │ - Source cards grid │ │ - Markets table │ │ │ │ - Bitmap overlay │ │ - Price history charts │ │ │ │ │ │ - Top players board │ │ │ │ │ │ - Batch entry panel │ │ │ └──────────────────────────┘ └──────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────────┘
The Sources Listing Page When you land on the Vision home page, you see a grid of source cards. Each card is a doorway into a different corner of the measurable world — cryptocurrency prices, earthquake magnitudes, train delays, ice cream machine failures. The diversity of what can be quantified is itself a kind of revelation.
Category Navigation A horizontal pill bar across the top lets you filter by category. Each pill shows the source count for that category.
┌─────────────────────────────────────────────────────────────────────────────┐ │ CATEGORY NAV BAR │ │ │ │ ┌─────────┐ ┌────────────┐ ┌──────────┐ ┌──────────┐ ┌───────────────┐ │ │ │ All 98 │ │Finance 14 │ │Econ. 11 │ │ Tech 8 │ │Entertain. 15 │ │ │ └─────────┘ └────────────┘ └──────────┘ └──────────┘ └───────────────┘ │ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌───────────┐ ┌───────────┐ │ │ │Geophysic. 15 │ │Transport 16 │ │Nature 4 │ │ Space 3 │ │ │ └──────────────┘ └──────────────┘ └───────────┘ └───────────┘ │ │ ┌──────────────┐ ┌────────────────┐ │ │ │Regulatory 4 │ │ Academic 3 │ │ │ └──────────────┘ └────────────────┘ │ └─────────────────────────────────────────────────────────────────────────────┘
The 10 categories are:
Category Count Examples Finance 14 CoinGecko, Finnhub Stocks, Polymarket, Zillow Economic 11 FRED, US Treasury, ECB, Bureau of Labor Stats Regulatory 4 SEC Filings, Congress Votes, Federal Courts Tech 8 GitHub, npm, PyPI, Hacker News, Cloudflare Entertainment 15 Twitch, Steam, TMDB, Reddit, Esports Geophysical 15 USGS Earthquakes, NOAA Weather, Wildfires Transport 16 Global Flights, Deutsche Bahn, NYC Subway Nature 4 eBird, Wildlife Tracking, Animal Shelters Academic 3 OpenAlex, Crossref, PubMed Space 3 Space Weather, ISS Tracker, Military Aircraft
Sort Options Below the category nav, a sort bar lets you reorder the source cards:
Trending — sources with the most recent activityNew — most recently added sourcesMost Assets — sources with the highest market countVolume — sources with the most trading volume
Source Cards Each source is rendered as a card in the grid. Here is what a single card looks like:
┌─────────────────────────────────────────┐ │ │ │ ┌───────────────────┐ │ │ │ │ │ │ │ [ Source Logo ] │ FINANCE │ │ │ │ │ │ └───────────────────┘ │ │ │ ├─────────────────────────────────────────┤ │ │ │ CoinGecko Crypto * Live │ │ Cryptocurrency market data -- │ │ prices, volumes, market caps... │ │ │ ├─────────────┬───────────┬───────────────┤ │ MARKETS │ TYPE │ UPDATED │ │ 2,400 │ Price │ 2m ago │ ├─────────────┼───────────┼───────────────┤ │ MARKETS │ BATCH │ DETAILS │ └─────────────┴───────────┴───────────────┘
Each card displays:
Element Description Logo area Brand-colored background with the source’s logo. Category badge in the top-right corner. Status dot Green = Live, Yellow = Stale, Grey = Dead/Pending Name & description Source name and a one-line description of what it tracks Markets Total number of individual assets/markets in this source Type The value label — what the source measures (Price, Viewers, Magnitude, etc.) Updated How recently the data was refreshed (e.g., “2m ago”, “1h ago”) Action buttons Markets, Batch, Details — all link to the source detail page
Hover Overlay When you hover over a source card’s logo area, a scrollable overlay slides in showing the actual market list with live values:
┌─────────────────────────────────────────┐ │ CoinGecko Crypto 2400 │ ├─────────────────────────────────────────┤ │ | Bitcoin $67,432.10 │ │ | Ethereum $3,891.55 │ │ | Solana $142.33 │ │ | BNB $612.40 │ │ | XRP $0.62 │ │ | Dogecoin $0.15 │ │ | Cardano $0.45 │ │ ... │ │ +2,393 more │ ├─────────────────────────────────────────┤ │ 1,200 UP 1,200 DN 0 -- │ └─────────────────────────────────────────┘
Markets are sorted by value (highest first), capped at 100 entries. The left border of each row is color-coded:
Green — you have set this market to UP in your bitmapRed — you have set this market to DOWNNone — not yet set
You can click to toggle a market between UP, DOWN, and empty. You can also drag-paint across rows to quickly set many markets at once.
The Source Detail Page Click any source card (or the Markets/Batch/Details buttons) to reach the dedicated source page at /source/[sourceId].
┌─────────────────────────────────────────────────────────────────────────────┐ │ CATEGORY NAV BAR │ │ [All 98] [Finance 14] [Economic 11] ... [Space 3] │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────────────────────────┬──────────────────────────────────┐ │ │ │ │ │ │ │ │ FINANCE * LIVE │ ┌──────────────────┐ │ │ │ │ │ │ │ │ │ │ │ CoinGecko Crypto │ │ [ Source Logo ] │ │ │ │ │ Cryptocurrency market data -- │ │ │ │ │ │ │ prices, volumes, market caps │ └──────────────────┘ │ │ │ │ for thousands of tokens. │ │ │ │ │ │ │ │ │ └──────────────────────────────────┴──────────────────────────────────┘ │ │ SOURCE HERO │ │ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ TICK PLAYERS POOL [=====> ] MULT SET TMR │ │ │ │ #1,247 42 $12.5K ███████░░░░░░░░ 1.2x 18/24 4:32│ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ BATCH BAR │ │ │ │ ┌─────────────────────────────────────┐ ┌────────────────────────────┐ │ │ │ │ │ │ │ │ │ MARKETS TABLE │ │ BATCH ENTRY PANEL │ │ │ │ │ │ │ │ │ │ Asset Value 24h Bet │ │ Set your predictions │ │ │ │ ───── ───── ─── ─── │ │ and join the batch. │ │ │ │ BTC-USD $67.4K +2.1% [UP] │ │ │ │ │ │ ETH-USD $3.8K -0.5% [DN] │ │ Deposit: [____] USDC │ │ │ │ SOL-USD $142 +4.2% [UP] │ │ Stake/tick: [__] USDC │ │ │ │ ... │ │ │ │ │ │ │ │ [ Approve & Join ] │ │ │ │ ┌─ Price History ───────────────┐ │ │ │ │ │ │ │ . .. │ │ │ │ │ │ │ │ . . . . . │ │ └────────────────────────────┘ │ │ │ │ . . . . . │ │ │ │ │ │ . .. │ │ │ │ │ └───────────────────────────────┘ │ │ │ │ │ │ │ ├─────────────────────────────────────┤ │ │ │ TOP PLAYERS │ │ │ │ │ │ │ │ #1 0xAb..12 $1,240 profit │ │ │ │ #2 0x7F..89 $890 profit │ │ │ │ #3 0xCd..56 $654 profit │ │ │ │ ... │ │ │ └─────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────────┘
Source Hero The top banner shows the source identity at a glance:
Category badge (e.g., “FINANCE”, “TRANSPORT”)Live/Offline indicator with colored dotSource name and full descriptionBrand logo on a colored background
Batch Tick Bar A horizontal bar below the hero shows the live state of the active batch for this source:
┌────────┬─────────┬────────┬──────────────────────┬──────┬───────┬───────┐ │ TICK │ PLAYERS │ POOL │ PROGRESS BAR │ MULT │ SET │ TIMER │ │ #1,247 │ 42 │$12.5K │ ████████░░░░░░░░░░░ │ 1.2x │ 18/24│ 4:32 │ └────────┴─────────┴────────┴──────────────────────┴──────┴───────┴───────┘
Field Meaning Tick Current tick number (increments each resolution cycle) Players Active players in this batch Pool Total USDC staked across all players Progress bar Visual fill showing how far through the current tick. Turns red when locked (no more bets accepted) Multiplier Current reward multiplier — increases as the tick progresses, incentivizing early bets Set How many of this source’s markets you have set (e.g., “18/24” means you chose UP or DOWN on 18 of 24 markets) Timer Countdown to tick resolution (e.g., “4:32” = 4 minutes 32 seconds remaining)
Markets Table The main content area lists every market (asset) in the source with:
┌──────────────────────────────────────────────────────────────────────┐ │ ASSET VALUE 24H CHANGE YOUR BET │ ├──────────────────────────────────────────────────────────────────────┤ │ BTC-USD $67,432.10 +2.14% [UP] │ │ │ │ ┌─ 24h Price History ──────────────────────────────────────────┐ │ │ │ . . . │ │ │ │ . . . . . │ │ │ │ . . . . . . │ │ │ │ . . . . . │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ ├──────────────────────────────────────────────────────────────────────┤ │ ETH-USD $3,891.55 -0.52% [DOWN] │ │ ... │ └──────────────────────────────────────────────────────────────────────┘
Each row shows:
Asset name — the human-readable market identifier (e.g., “BTC-USD”, “berlin_hbf”, “northern”)Current value — formatted with the source’s value label and unit (e.g., “$67,432.10” for prices, “4.2 M” for magnitudes, “23 min” for delays)24h change — percentage change over the last 24 hours, color-coded green/redYour bet — click to toggle between UP, DOWN, or unset
Clicking on a market row expands an inline price history chart showing the last 24 hours of data points. The chart uses the same value formatting as the table (prices get $ prefix, percentages get % suffix, etc.).
The value label and unit vary by source. A CoinGecko market shows “Price (USD)”. A Deutsche Bahn market shows “Avg Delay (min)”. A McBroken market shows ”% Broken (%)”. This is all configured in the source registry.
Batch Entry Panel On the right side (sticky on desktop), the batch entry panel lets you join the batch directly from the source detail page:
Review your UP/DOWN selections across all markets
Set your deposit amount and stake per tick
Approve the Vision contract (first time only)
Confirm your join transaction
Top Players Leaderboard Below the markets table, a leaderboard shows the top-performing players in this source’s batch, ranked by cumulative profit.
Finding Specific Markets By Category Filter Use the category nav bar to narrow down to a category (e.g., “Transport” to see only transit-related sources), then browse the cards.
By Hover Scan Hover over source cards to preview their market lists without navigating away. Markets are sorted by value, so the most actively traded or highest-value assets appear first.
By Market ID Every market has a predictable ID formed from a source prefix + asset name :
┌─────────────────────────────────────────────────────────────────┐ │ MARKET ID ANATOMY │ │ │ │ crypto_BTC-USD │ │ ├──────┤├───────┤ │ │ prefix asset │ │ │ │ earthquake_california │ │ ├──────────┤├──────────┤ │ │ prefix asset │ │ │ │ db_trains_berlin_hbf │ │ ├─────────┤├─────────┤ │ │ prefix asset │ │ │ │ mcbroken_chicago │ │ ├────────┤├───────┤ │ │ prefix asset │ └─────────────────────────────────────────────────────────────────┘
If you know the source prefix, you know where to find the market. The prefix determines the source, category, value label, and unit.
Understanding Price Charts When you expand a market row in the markets table, the price history chart shows raw data points from the Data Node over the last 24 hours.
┌──────────────────────────────────────────────────────────────────┐ │ Price History: BTC-USD (24h) │ │ │ │ $68,000 ─┤ │ │ │ . . │ │ $67,500 ─┤ . . . . │ │ │ . . . . . │ │ $67,000 ─┤ . . . . . │ │ │ . . . │ │ $66,500 ─┤ . │ │ │ │ │ $66,000 ─┤ │ │ └──┬──────┬──────┬──────┬──────┬──────┬──────┬──── │ │ 00:00 04:00 08:00 12:00 16:00 20:00 now │ └──────────────────────────────────────────────────────────────────┘
Key things to know:
Time axis — last 24 hours, most recent on the rightValue axis — auto-scaled to the data range, with the source’s native unitTooltips — hover over any point to see exact value and timestampResolution context — the chart helps you judge whether a market is trending UP or DOWN for the current tick
Value Types by Source Different sources track fundamentally different things. The chart axis labels and formatting adapt automatically:
┌────────────────────┬──────────────┬─────────┬──────────────────────┐ │ Source │ Value Label │ Unit │ Example Value │ ├────────────────────┼──────────────┼─────────┼──────────────────────┤ │ CoinGecko │ Price │ USD │ $67,432.10 │ │ Finnhub Stocks │ Price │ USD │ $189.52 │ │ Polymarket │ Probability │ % │ 73.2% │ │ USGS Earthquakes │ Magnitude │ M │ 4.2 M │ │ Deutsche Bahn │ Avg Delay │ min │ 8.3 min │ │ Steam Gaming │ Players │ online │ 1.2M online │ │ McBroken │ % Broken │ % │ 12.5% │ │ GitHub │ Stars │ -- │ 45.2K │ │ NOAA Tides │ Water Level │ ft │ 2.34 ft │ │ London Underground │ Disruption │ 0-8 │ 3 │ │ Air Quality │ AQI │ 0-500 │ 42 │ │ NRC Nuclear │ Power │ % │ 98.5% │ │ Theme Park Waits │ Avg Wait │ min │ 45 min │ │ Border Wait Times │ Wait Time │ min │ 32 min │ └────────────────────┴──────────────┴─────────┴──────────────────────┘
Market Resolution Each market resolves based on whether its value went UP or DOWN (or stayed FLAT ) over the tick interval. The world moved, or it did not. The resolution is indifferent to your reasons for betting:
┌────────────────────────────────────────────────────────────────────┐ │ TICK RESOLUTION FLOW │ │ │ │ Tick Start Tick End │ │ ~~~~~~~~~~ ~~~~~~~~ │ │ │ │ BTC-USD = $67,432.10 BTC-USD = $67,891.55 │ │ │ │ ┌─────────────────────────────────────────┐ │ │ │ Tick Duration (e.g. 10 min) │ │ │ │ │ │ │ │ $67.4K ─ . . │ │ │ │ . . │ │ │ │ . │ │ │ │ . . . │ │ │ │ . . . $67.9K │ │ │ │ │ │ │ └─────────────────────────────────────────┘ │ │ │ │ Delta = +$459.45 │ │ Result = UP │ │ │ │ Players who bet UP --> win │ │ Players who bet DOWN --> lose │ │ Winners split losers' stakes (minus 0.05% fee on profits) │ │ │ └────────────────────────────────────────────────────────────────────┘
The same resolution logic applies to everything. The universe makes no distinction between asset classes:
Bitcoin price went UP $459 —> UP wins
Berlin Hauptbahnhof average delay went DOWN 2 minutes —> DOWN wins
McDonald’s ice cream broken percentage went UP 3% —> UP wins
USGS earthquake magnitude stayed FLAT —> resolved based on batch rules
Source Health Monitoring There is also a monitoring page at /sources that shows health metrics for every source. A dashboard of the machinery that watches the world — and a reminder that the watchers, too, can fail:
┌─────────────────────────────────────────────────────────────────────┐ │ SOURCE MONITORING │ │ Live health status of all data sources feeding market prices. │ │ │ │ ┌──────────┬──────────┬──────────┬──────────┬───────────┬───────┐ │ │ │ SOURCES │ HEALTHY │ STALE │ DEAD │LIVE ASSETS│UPDATED│ │ │ │ 98 │ 94 │ 3 │ 1 │ 4,200/4,500│14:32 │ │ │ └──────────┴──────────┴──────────┴──────────┴───────────┴───────┘ │ │ │ │ ┌──────────────┬────────┬────────┬──────────┬──────────┬────────┐ │ │ │ Source │ Status │ Assets │ Stale │ Zero │ Age │ │ │ ├──────────────┼────────┼────────┼──────────┼──────────┼────────┤ │ │ │ coingecko │ * OK │ 2,400 │ 0 │ 0 │ 30s │ │ │ │ earthquake │ * OK │ 12 │ 0 │ 0 │ 45s │ │ │ │ steam │ ! STALE│ 85 │ 3 │ 0 │ 25m │ │ │ │ ... │ │ │ │ │ │ │ │ └──────────────┴────────┴────────┴──────────┴──────────┴────────┘ │ └─────────────────────────────────────────────────────────────────────┘
Publicly accessible. Click any row to open a detail modal with per-asset health data and collection history charts. Transparency about the infrastructure’s fragility — the most honest feature a system can offer.
What’s Next?
Data Sources Reference The full directory: 90+ sources, their prefixes, value labels, units, update frequencies. The catalog of measurable things.
Getting Started Five minutes from nothing to your first prediction. Whether you are ready is another question.
