MarketsResolution Rules

Resolution Rules

Every market on Cupdiction has a resolution rule written at creation time. This rule is the single source of truth for what determines YES or NO.


Where to find the rule

Open any market page and scroll to the Resolution rule section at the bottom. It explains:

  • What data source is used
  • What condition triggers YES
  • What condition triggers NO
  • What happens if data is unavailable

General principles

  1. Rules are set at creation and never changed. The resolution rule is part of the market contract. It cannot be modified after the market opens.

  2. Data sources are specified in advance. Cupdiction does not exercise editorial judgment about outcomes. The oracle fetches data from a pre-specified source and applies the rule mechanically.

  3. If data is unavailable, the market waits. An unavailable data source at resolution time triggers Pending Recheck — not an arbitrary decision.

  4. Conflicts trigger review, not arbitrary settlement. If two required data sources disagree, the market enters Needs Review and requires admin verification before settling.


Graduation markets — resolution rule

Resolves YES if:

  • Bags.fm API reports status: MIGRATED for the token AND
  • The DAMM v2 pool address from the Bags.fm API is confirmed to exist on-chain via Helius RPC

Resolves NO if:

  • The deadline passes with the token still not graduated

Resolves Pending Recheck if:

  • Bags.fm reports MIGRATED but no DAMM v2 pool key is available
  • Helius RPC is unavailable at resolution time

Resolves Needs Review if:

  • Bags.fm reports MIGRATED, a pool key exists, but the on-chain account does not exist
⚠️

Both the Bags.fm API and Helius on-chain check must confirm graduation. A market will not settle YES on API status alone.


Fee race markets — resolution rule

Resolves YES if:

  • Token A’s fee delta > Token B’s fee delta during the market window

Resolves NO if:

  • Token B’s fee delta > Token A’s fee delta

Resolves Needs Review if:

  • Both tokens have identical fee deltas (tie)

Resolves Pending Recheck if:

  • Bags.fm lifetime-fees API is unavailable at resolution time

Fee delta definition:

delta = lifetime_fees_at_deadline - lifetime_fees_at_market_open

Total historical fees are irrelevant. Only fee growth during the market window counts.


Void conditions

A market may be voided (all stakes refunded) if:

  • The underlying event is cancelled or doesn’t take place
  • A critical data source is permanently unavailable
  • The market was created with an error in the resolution rule

Voiding requires admin action and is rare.