Getting Started

Place your first bet on Vision in under 5 minutes

Getting Started

Your first prediction. It will probably be wrong. All first predictions are. The protocol does not care. It treats the novice and the veteran with the same indifference — which is, if you think about it, a form of respect.

By the end of this page, you will have joined a batch, placed UP/DOWN bets on real markets, and understood how to claim rewards. Whether you deserve rewards is between you and the price feeds.

Prerequisites

Before you can wager against the future, you need two things:

• An EVM-compatible wallet (MetaMask, Rabby, or similar) connected to Index L3
• WUSDC on Index L3 (18 decimals — this is bridged USDC on the L3 Orbit chain)

Vision runs on Index L3 (chain ID 111222333), an Arbitrum Orbit chain. Add it to your wallet: RPC https://rpc.generalmarket.io/, chain ID 111222333, symbol ETH. WUSDC on L3 uses 18 decimals, not 6.

Step 1: Browse Active Batches

Navigate to generalmarket.io/vision. The Vision page lists all active batches — each one a small arena where strangers pool money against each other’s opinions. Each batch shows:

• Markets — the assets being tracked (e.g., BTC/USD, ETH/USD, SOL/USD)
• Tick duration — how often the batch resolves (5 min, 1 hour, 1 day, etc.)
• Player count — how many people have decided, independently, that they know something
• TVL — total USDC deposited across all players

Click on any batch to expand its details and see per-market stats.

Step 2: Understand a Batch

Each batch is a self-contained prediction game. Like a parlay. Like a prayer — multiple requests, one outcome, usually disappointing. Its parameters:

Parameter	Description
Markets	The asset pairs players predict on (e.g., BTC/USD, ETH/USD)
Tick duration	The time interval between resolutions (5 min to 30 days)
Resolution type	How outcomes are determined — e.g., UP_0 (any upward move), UP_30 (must move +30bps)
Min stake	Minimum USDC per tick (0.1 USDC)

Start with a batch that has a longer tick duration (1 hour or 1 day). Fast intervals punish hesitation, and you will hesitate. Everyone does the first time.

Step 3: Place Your Predictions

For each market in the batch, choose UP or DOWN. That is the entire decision. The universe, reduced to binary:

• UP — you predict the asset price will be higher at the end of the tick
• DOWN — you predict the asset price will be lower at the end of the tick

Your predictions are combined into a bitmap — a compact binary encoding where 1 = UP and 0 = DOWN. The bitmap is hashed and submitted on-chain so nobody can see your bets before the tick closes. Your convictions are sealed. You cannot take them back.

Step 4: Deposit USDC and Join

Now you must put money behind your opinions. This is the step that separates conviction from commentary.

1. Set your deposit amount — the total USDC to allocate to this batch.
2. Set your stake per tick — how much USDC to wager per tick interval. Your deposit covers multiple ticks.
3. Approve the Vision contract to spend your USDC (first time only).
4. Confirm the join transaction. Your bitmap hash and deposit are recorded on-chain.

Your deposit is split across ticks automatically. If you deposit 10 USDC with a 1 USDC stake per tick, you are covered for 10 ticks. You can top up or withdraw at any time. The protocol is patient with those who are not.

Step 5: Wait for Tick Resolution

Now comes the part no one enjoys: waiting. The tick ends. The world is measured. Oracles fetch live prices and determine the outcome for each market:

• If the price went up and you bet UP, you win that market.
• If the price went down and you bet DOWN, you win that market.
• Winners on each market split the losers’ stakes proportionally, minus a 0.05% fee on profits.

Your balance updates automatically after each tick. Check the batch detail page to see per-tick results and your running PnL. The numbers do not lie, though you may wish they would.

Step 6: Claim Rewards

If you have won — and someone must, that is the mathematics of it — you may collect:

1. Navigate to My Positions in the Vision page.
2. Click Withdraw on the batch you want to exit.
3. The oracle network generates a BLS-signed balance proof for your current balance. Three machines sign your balance. If two agree, you can claim.
4. Confirm the withdrawal transaction. Your USDC is returned to your wallet.

You can also claim partial amounts — you do not need to exit the batch entirely. Withdrawn funds are available in your wallet immediately. The protocol does not ask why you are leaving.

Programmatic Access

For those who prefer their despair automated, Vision has a full REST API. Here are two common operations:

Fetch Active Batches

cURL

curl -s https://generalmarket.io/api/vision/batches | jq .

Python

import requests

resp = requests.get("https://generalmarket.io/api/vision/batches")
batches = resp.json()

for batch in batches:
    print(f"Batch {batch['id']}: {batch['market_count']} markets, "
          f"{batch['player_count']} players, TVL: {batch['tvl']}")

TypeScript

const res = await fetch("https://generalmarket.io/api/vision/batches");
const batches = await res.json();

for (const batch of batches) {
  console.log(
    `Batch ${batch.id}: ${batch.market_count} markets, ` +
    `${batch.player_count} players, TVL: ${batch.tvl}`
  );
}

Check Your Balance

cURL

BATCH_ID=1
PLAYER=0xYourAddress
curl -s "https://generalmarket.io/api/vision/balance/$BATCH_ID/$PLAYER" | jq .

Python

import requests

batch_id = 1
player = "0xYourAddress"
resp = requests.get(
    f"https://generalmarket.io/api/vision/balance/{batch_id}/{player}"
)
balance = resp.json()
print(f"Balance: {balance['balance']} (WUSDC raw, 18 decimals)")

TypeScript

const batchId = 1;
const player = "0xYourAddress";
const res = await fetch(
  `https://generalmarket.io/api/vision/balance/${batchId}/${player}`
);
const balance = await res.json();
console.log(`Balance: ${balance.balance} (WUSDC raw, 18 decimals)`);

What’s Next?

You have placed a prediction. You have committed money to an opinion about the future. The future has not yet arrived. In the meantime, you might as well understand the machinery that will judge you.

Concepts: Batches & Bitmaps

How batches are created, how bitmaps encode predictions, and how tick resolution works. The mechanics of organized uncertainty.

Build a Bot

Register a bot on-chain and automate your prediction strategy. The machine will not second-guess itself. Whether that is wisdom or blindness depends on the market.

API Reference

Full endpoint documentation: batches, bitmaps, balances, ticks, leaderboard. Everything the protocol knows, which is everything except what happens next.