Resolution Types

The 8 resolution types that determine how Vision markets are settled

A resolution type defines the win condition for a market within a batch. Each market in a batch has its own resolution type, stored as a uint8 in the resolutionTypes array. The resolution type determines how much the price must move for a market to resolve as UP, DOWN, or FLAT.

Resolution Type Table

Value	Name	Threshold	UP Wins When	DOWN Wins When	FLAT When
0	UP_0	0%	price > 0%	price < 0%	price = 0%
1	UP_30	0.30%	price > +0.30%	price < -0.30%	-0.30% to +0.30%
2	UP_X	Custom	price > +X%	price < -X%	-X% to +X%
3	DOWN_0	0%	price > 0%	price < 0%	price = 0%
4	DOWN_30	0.30%	price > +0.30%	price < -0.30%	-0.30% to +0.30%
5	DOWN_X	Custom	price > +X%	price < -X%	-X% to +X%
6	FLAT_0	0.01%	price > +0.01%	price < -0.01%	abs(price) < 0.01%
7	FLAT_X	Custom	price > +X%	price < -X%	abs(price) < X%

UP_0 and DOWN_0 produce identical results. They are separate enum values for semantic clarity — UP_0 is named to suggest “will it go up?” while DOWN_0 suggests “will it go down?”. The resolution logic is the same.

Enum Definition

In the Solidity interface:

enum ResolutionType {
    UP_0,     // 0
    UP_30,    // 1
    UP_X,     // 2
    DOWN_0,   // 3
    DOWN_30,  // 4
    DOWN_X,   // 5
    FLAT_0,   // 6
    FLAT_X    // 7
}

How Resolution Works

At tick resolution, the issuer computes the percentage change for each market:

pct_change = (end_price - start_price) / start_price * 100

Then applies the resolution type’s threshold to determine the outcome:

match resolution_type {
    UP_0  => if pct > 0.0 { Up } else if pct < 0.0 { Down } else { Flat },
    UP_30 => if pct > 0.3 { Up } else if pct < -0.3 { Down } else { Flat },
    UP_X  => if pct > threshold { Up } else if pct < -threshold { Down } else { Flat },
    // DOWN types work identically
    FLAT_0 => if pct.abs() < 0.01 { Flat } else if pct > 0.0 { Up } else { Down },
    FLAT_X => if pct.abs() < threshold { Flat } else if pct > 0.0 { Up } else { Down },
}

Custom Thresholds

Resolution types ending in _X (UP_X, DOWN_X, FLAT_X) use custom thresholds. These are passed in the customThresholds array when creating a batch, stored as basis points (1/100th of a percent).

Basis Points	Percentage
10	0.10%
30	0.30%
50	0.50%
100	1.00%
500	5.00%

The threshold is applied symmetrically: a threshold of 100 basis points (1%) means the price must move more than +1% for UP or more than -1% for DOWN.

Example: Create a batch where BTC needs to move more than 1% and ETH needs to move more than 0.5%:

const marketIds = [
  keccak256(toUtf8Bytes("BTC-USD")),
  keccak256(toUtf8Bytes("ETH-USD")),
];

const resolutionTypes = [2, 2]; // UP_X for both
const tickDuration = 3600;      // 1 hour
const customThresholds = [
  100,  // BTC: 1.00% threshold (100 basis points)
  50,   // ETH: 0.50% threshold (50 basis points)
];

await vision.createBatch(marketIds, resolutionTypes, tickDuration, customThresholds);

The customThresholds array must be parallel to marketIds. Each entry corresponds to the market at the same index. For non-custom resolution types (like UP_0 or UP_30), the threshold value is ignored but a placeholder (e.g., 0) should still be provided to maintain array alignment.

Examples with Real Price Movements

Example 1: UP_0 (Any Movement)

BTC-USD moves from $60,000 to$60,050 (+0.083%):

• Resolution type: UP_0 (value 0)
• Percentage change: +0.083%
• Outcome: UP (any positive movement counts)
• Players who predicted UP win; DOWN loses.

Example 2: UP_30 (0.30% Threshold)

ETH-USD moves from $3,000 to$3,005 (+0.167%):

• Resolution type: UP_30 (value 1)
• Percentage change: +0.167%
• Outcome: FLAT (did not exceed +0.30% or -0.30%)
• All players are refunded.

Example 3: UP_X with 1% Threshold

SOL-USD moves from $100 to$98.50 (-1.5%):

• Resolution type: UP_X (value 2), threshold = 100 bps (1%)
• Percentage change: -1.5%
• Outcome: DOWN (exceeded -1% threshold)
• Players who predicted DOWN win; UP loses.

Example 4: FLAT_0 (Near Zero)

AVAX-USD moves from $25.00 to$25.002 (+0.008%):

• Resolution type: FLAT_0 (value 6)
• Percentage change: +0.008%
• Outcome: FLAT (absolute change < 0.01%)
• All players are refunded.

Example 5: FLAT_X with 0.5% Threshold

BTC-USD moves from $60,000 to$60,200 (+0.333%):

• Resolution type: FLAT_X (value 7), threshold = 50 bps (0.5%)
• Percentage change: +0.333%
• Outcome: FLAT (absolute change < 0.5%)
• All players are refunded.

Choosing a Resolution Type

Higher thresholds mean more FLAT outcomes and fewer winning/losing rounds. Choose based on the expected volatility of your markets and the tick duration:

• Short ticks (1-10 min): Use UP_0 or DOWN_0 for maximum action. Small price movements still produce winners.
• Medium ticks (1 hour): Use UP_30 or DOWN_30 to filter out noise. Only meaningful moves count.
• Long ticks (1 day+): Use custom thresholds (UP_X) to require substantial moves, since daily volatility is higher.
• Flat markets: Use FLAT_0 or FLAT_X when you want the game to reward stability detection.