Skip to main content

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.

Vision

You are about to bet on whether German trains will be late. They will be. The question is whether enough other people agree with you. This is Vision.
  ┌──────────────────────────────────────────────────────────────────────────────┐
  │                                                                              │
  │                         V   I   S   I   O   N                                │
  │                                                                              │
  │                    Predict Anything. Win USDC.                                │
  │                                                                              │
  │   ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
  │   │  Crypto  │  │ Weather  │  │  Trains  │  │  Quakes  │  │  GitHub  │     │
  │   │  9,963   │  │ 161,125  │  │  1,200   │  │   300    │  │  1,500   │     │
  │   │ markets  │  │ markets  │  │ markets  │  │ markets  │  │ markets  │     │
  │   └──────────┘  └──────────┘  └──────────┘  └──────────┘  └──────────┘     │
  │   ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
  │   │   npm    │  │  Twitch  │  │  Movies  │  │  Steam   │  │  Flights │     │
  │   │  9,183   │  │  57,523  │  │  37,502  │  │  5,000   │  │  2,400   │     │
  │   │ markets  │  │ markets  │  │ markets  │  │ markets  │  │ markets  │     │
  │   └──────────┘  └──────────┘  └──────────┘  └──────────┘  └──────────┘     │
  │   ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
  │   │  Stocks  │  │  Reddit  │  │  DeFi    │  │  Buoys   │  │ Nuclear  │     │
  │   │  3,200   │  │  4,800   │  │  2,100   │  │   850    │  │    63    │     │
  │   │ markets  │  │ markets  │  │ markets  │  │ markets  │  │ markets  │     │
  │   └──────────┘  └──────────┘  └──────────┘  └──────────┘  └──────────┘     │
  │                                                                              │
  │        90+ Sources   *   400,000+ Markets   *   Sealed Bets                  │
  │                                                                              │
  └──────────────────────────────────────────────────────────────────────────────┘
Vision is a sealed parimutuel prediction market. Players bet on whether values move UP or DOWN over fixed time intervals. The subject matter is almost comically vast — 90+ real-world data sources spanning earthquakes, ice cream machines, train delays, npm downloads, Twitch viewership, nuclear reactor output, and hundreds more. The universe reduced to a binary wager, repeated every ten minutes, across four hundred thousand markets. Winners split the losers’ stakes, minus a 0.05% fee. All commitments are sealed on-chain to prevent front-running. Every claim is verified with BLS aggregate signatures. The mechanism is elegant. Whether the participants deserve elegance is another question entirely.

How It Works

Four steps separate you from the consequences of your convictions.
    ┌─────────────────────────────────────────────────────────────────────────┐
    │                         THE FOUR STEPS                                  │
    └─────────────────────────────────────────────────────────────────────────┘

    STEP 1                 STEP 2                 STEP 3                 STEP 4
    Browse                 Seal                   Resolve                Claim
    ~~~~~~                 ~~~~                   ~~~~~~~                ~~~~~

    ┌─────────────┐       ┌─────────────┐       ┌─────────────┐       ┌─────────────┐
    │             │       │             │       │             │       │             │
    │  Pick a     │       │  Predict    │       │  Tick ends  │       │  Withdraw   │
    │  batch from │──────>│  UP or DOWN │──────>│  Oracles    │──────>│  winnings   │
    │  90+ source │       │  per market │       │  fetch real │       │  with BLS   │
    │  categories │       │  Sealed as  │       │  data and   │       │  verified   │
    │             │       │  hash on-   │       │  resolve    │       │  balance    │
    │  Crypto?    │       │  chain      │       │  outcomes   │       │  proof      │
    │  Weather?   │       │             │       │             │       │             │
    │  Trains?    │       │  keccak256  │       │  Winners    │       │  Claim any  │
    │  Quakes?    │       │  (bitmap)   │       │  split the  │       │  time. No   │
    │             │       │             │       │  losers'    │       │  lockup.    │
    │             │       │  No one can │       │  stakes     │       │             │
    │             │       │  see your   │       │             │       │             │
    │             │       │  bets       │       │  2/3+       │       │             │
    │             │       │             │       │  consensus  │       │             │
    └─────────────┘       └─────────────┘       └─────────────┘       └─────────────┘
         |                      |                      |                      |
         v                      v                      v                      v
    Browse active          Encode into a          Real prices from       BLS aggregate
    batches across         compact bitmap         external APIs          signature from
    all categories         and commit hash        determine UP/DOWN      oracle network
Your predictions are sealed — you submit a hash of your bitmap on-chain, then reveal the actual bytes to oracles off-chain. Nobody can see or copy your bets before the tick closes. Your folly is your own until the moment of reckoning.

What Makes Vision Different

Most prediction markets let you bet on elections and football. Vision lets you bet on whether an ice cream machine in Chicago is broken. This is not a limitation of imagination but an excess of it.
    ┌─────────────────────────────────────────────────────────────────────────┐
    │                                                                         │
    │   TYPICAL PREDICTION MARKET              VISION                        │
    │   ~~~~~~~~~~~~~~~~~~~~~~~~~~             ~~~~~~                        │
    │                                                                         │
    │   Categories:                            Categories:                   │
    │     - Politics                             - Finance (14 sources)      │
    │     - Sports                               - Economic (11 sources)    │
    │     - Crypto (maybe)                       - Regulatory (4 sources)   │
    │                                            - Tech (8 sources)         │
    │                                            - Entertainment (14)       │
    │   Markets: ~500                            - Geophysical (15)         │
    │                                            - Transport (16 sources)   │
    │   Bets visible to all                      - Nature (4 sources)       │
    │                                            - Academic (3 sources)     │
    │   Manual only                              - Space (3 sources)        │
    │                                                                         │
    │   High fees                              Markets: 400,000+            │
    │                                                                         │
    │                                          Sealed commitments            │
    │                                                                         │
    │                                          Bot framework included        │
    │                                                                         │
    │                                          0.05% fee on profits only     │
    │                                                                         │
    └─────────────────────────────────────────────────────────────────────────┘

90+ Data Sources

Crypto, weather, earthquakes, train delays, Twitch streams, npm downloads, nuclear reactors, ice cream machines, military aircraft. The catalogue of measurable phenomena is vast. The catalogue of predictable ones is smaller. See the full source directory.

Sealed Commitments

Players submit keccak256(bitmap) on-chain before revealing actual predictions to oracles. No front-running, no copying. Your mistakes are at least original.

Bot-Friendly

Free registration with registerBot(). Poll for batches, encode bitmaps, and join programmatically. Delegate your hubris to a machine — it will lose money faster and without complaint.

Low Fees

0.05% fee on profits only. If you lose, you pay nothing extra. The protocol taxes fortune, not misfortune.

BLS-Verified Claims

Every claim and withdrawal requires a valid aggregated BLS signature from the oracle network. Trust is a threshold, not an emotion.

Points (Season 1)

Earn points for every tick you participate in. Season 1 is live. Points accrue for presence, not for being right. The protocol rewards those who show up.

Flexible Batches

Anyone can create a batch with custom market selections, tick durations (5 minutes to 30 days), and resolution types. The freedom to construct your own instrument of ruin.

Backtesting

Test your prediction strategies against historical data before committing real USDC. The past is the only place where certainty exists, and even there it is debatable.

What Can You Predict?

The breadth is the point. Anything that produces a number can become a wager. Here are some real markets live on Vision right now — each one a small confession that someone, somewhere, believes they know what happens next:
    ┌──────────────────────────────────────────────────────────────────────┐
    │                                                                      │
    │   "Will Bitcoin be higher in 5 minutes?"          crypto_BTC-USD     │
    │                                                                      │
    │   "Will it rain more in Tokyo tomorrow?"          weather_tokyo      │
    │                                                                      │
    │   "Will an earthquake hit California?"            earthquake_calif   │
    │                                                                      │
    │   "Will the Northern Line have disruptions?"      tfl_tube_northern  │
    │                                                                      │
    │   "Will Counter-Strike 2 gain players?"           steam_cs2          │
    │                                                                      │
    │   "Will npm react downloads increase?"            npm_react          │
    │                                                                      │
    │   "Will McDonald's ice cream break in Chicago?"   mcbroken_chicago   │
    │                                                                      │
    │   "Will this GitHub repo get more stars?"         github_rust-lang   │
    │                                                                      │
    │   "Will Deutsche Bahn trains be late in Berlin?"  db_trains_berlin   │
    │                                                                      │
    │   "Will Palo Verde nuclear output change?"        nrc_palo-verde-1   │
    │                                                                      │
    │   "Will wave height increase at buoy 41002?"      ndbc_41002         │
    │                                                                      │
    │   "Will LA air quality worsen?"                   airnow_los-angeles │
    │                                                                      │
    └──────────────────────────────────────────────────────────────────────┘
Every market follows the same mechanic: a data source produces a number, you predict whether it goes UP or DOWN, and the outcome is resolved from real-world data. The universe does not care about your prediction. It moves, or it does not. You are paid accordingly.

The Data Pipeline

Ninety-eight APIs feed numbers into a Rust process that feeds them into a database that feeds them into smart contracts that redistribute money between strangers. The architecture is sound. The premise is absurd. Both things are true.
    External APIs (90+ sources)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
        │         │         │         │         │
        │ USGS    │ CoinGecko│ TFL    │ GitHub  │ ...
        │         │         │         │         │
        └────┬────┘    ┌────┘    ┌────┘    ┌────┘
             │         │         │         │
             ▼         ▼         ▼         ▼
        ┌────────────────────────────────────────┐
        │          DATA NODE  (Rust)             │
        │                                        │
        │   Collect ──> Validate ──> Store       │
        │     HTTP       bounds      Postgres    │
        │                staleness               │
        └──────────────────┬─────────────────────┘


        ┌────────────────────────────────────────┐
        │            ORACLES (3x)                │
        │                                        │
        │   Read prices ──> Resolve ticks        │
        │                ──> BLS sign            │
        │                ──> 2/3+ consensus      │
        └──────────────────┬─────────────────────┘


        ┌────────────────────────────────────────┐
        │          SMART CONTRACTS               │
        │                                        │
        │   VisionPool.sol  ──  sealed bitmaps   │
        │   VisionClaim.sol ──  BLS claims       │
        │   VisionReserve   ──  USDC custody     │
        └──────────────────────────────────────── ┘

Who Is Vision For?

Everyone who has ever looked at a number and felt, with irrational certainty, that they knew which way it would go next.
    ┌────────────────────┬───────────────────────────────────────────────────┐
    │  AUDIENCE          │  USE CASE                                         │
    ├────────────────────┼───────────────────────────────────────────────────┤
    │                    │                                                   │
    │  Bot developers    │  Build automated prediction strategies.           │
    │                    │  Free registration, full API access,              │
    │                    │  programmatic bitmap encoding and batch joining.  │
    │                    │  Python framework included.                       │
    │                    │                                                   │
    ├────────────────────┼───────────────────────────────────────────────────┤
    │                    │                                                   │
    │  Manual traders    │  Browse batches in the web UI, pick UP/DOWN       │
    │                    │  per market, and deposit USDC.                    │
    │                    │  No coding required.                              │
    │                    │                                                   │
    ├────────────────────┼───────────────────────────────────────────────────┤
    │                    │                                                   │
    │  Quant researchers │  Backtest bitmap strategies against historical    │
    │                    │  tick data across 90+ sources.                    │
    │                    │  Validate edge before deploying capital.          │
    │                    │                                                   │
    ├────────────────────┼───────────────────────────────────────────────────┤
    │                    │                                                   │
    │  Data enthusiasts  │  Explore 400,000+ real-world data feeds.          │
    │                    │  Discover obscure markets (ocean buoys,           │
    │                    │  bird observations, nuclear output).              │
    │                    │  Find alpha where nobody else is looking.         │
    │                    │                                                   │
    └────────────────────┴───────────────────────────────────────────────────┘
You have read this far, which means either curiosity or recklessness. Both are welcome here.

Getting Started

Your first prediction. It will probably be wrong. All first predictions are.

Data Sources

Ninety-eight ways to measure the world. The absurdity is the point.

Batches & Bitmaps

How markets are grouped, predictions encoded, and outcomes determined.

Build a Bot

Automate your strategy. The machine will not hesitate where you would.

Points & Rewards

Points accrue for participation, not for being right. Presence is its own reward.

API Reference

The full endpoint documentation, for those who prefer to commune with the protocol directly.