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
-
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.
-
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.
-
If data is unavailable, the market waits. An unavailable data source at resolution time triggers Pending Recheck — not an arbitrary decision.
-
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: MIGRATEDfor 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_openTotal 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.