Market Guide: Understanding Price Feeds & Verification
Note: Market systems are battle-tested but expect occasional chaos during beta. All price data is publicly verifiable.
Primary Data Source
HyperLiquid Integration
Default price provider for all markets:
- Real-time order book data
- Latest executed trades
- Blockchain verification hashes
- Trade IDs for audit trails
How it works: Game subscribes to HyperLiquid's public order book endpoints. At each game pace interval (3s, 10s, 30s), system captures the latest executed order. All timers sync to UTC time matching exchange candle data.
Strategic impact: Price updates align with your game pace. Faster games see more price movements. All data publicly verifiable through blockchain hashes.
Data Captured Per Round
Each round records:
- Order ID (trade identifier)
- Execution price
- Timestamp (UTC)
- Blockchain hash
- Trade side (buy/sell)
- Volume/size
- Exchange identifier
How it works: Every round permanently stores order details in game history. Data accessible through game server and persists in database. Complete audit trail for every prediction.
Strategic impact: Disputes impossible - everything verifiable on-chain. Historical analysis reveals patterns. Transparency builds trust.
Backup Market Providers
Failover System
Automatic provider switching on failure:
- Primary: HyperLiquid
- Backup: Binance
- Future: Expanding DEX list
How it works: If HyperLiquid stops sending prices for 3 seconds, system automatically switches to Binance. Each round stamped with active provider and last order received. No manual intervention needed.
Strategic impact: Game continuity during outages. Different providers may have slight price variations. Provider switches visible in game HUD.
Provider Priority
Current hierarchy:
- HyperLiquid (Hyperliquid DEX ecosystem)
- Binance (High liquidity fallback)
- Future DEXs (Under development)
How it works: Priority list determines failover order. System tries primary first, then cascades through backups. Each provider must have public order book API for verification.
Strategic impact: DEX priority supports decentralization. CEX backup ensures reliability. Multi-provider redundancy prevents game interruptions.
Price Synchronization
UTC Time Alignment
All timing standardized to UTC:
- Round boundaries align to seconds
- Price captures at exact intervals
- Candle data matches exchange timeframes
How it works: Server clock syncs to UTC atomic time. Price captures happen at precise second boundaries (00, 03, 10, 30). Eliminates timezone confusion and timing disputes.
Strategic impact: Predictable price capture moments. Global fairness regardless of location. Alignment with technical analysis tools.
Order Book Mechanics
Latest trade determines price:
- Not mid-market average
- Actual executed trade
- Real market activity
How it works: System reads last completed trade from order book, not bid/ask spread. This reflects actual market movement rather than theoretical prices.
Strategic impact: Predictions based on real trades. More volatile during thin liquidity. Big trades create opportunities.
Transparency Features
Live HUD Information
Real-time display shows:
- Current price provider
- Last order ID
- Blockchain hash (abbreviated)
- Provider status indicator
- Sync state
How it works: HUD updates every price tick showing data source. Click for detailed order information. Color coding indicates provider health (green=primary, yellow=backup, red=issues).
Strategic impact: Always know your data source. Verify any suspicious price movement. Build confidence through transparency.
Public Verification
All data publicly auditable:
- Exchange order books open
- Blockchain explorers available
- Game history queryable
- Round data exportable
How it works: Every price point traceable to public exchange data. Export round history for analysis. Third-party verification always possible.
Strategic impact: No hidden manipulation possible. Build your own analysis tools. Community can audit fairness.
Error Handling
SYNC Mode
Automatic recovery mechanism:
- Triggered by data interruption
- Pauses current round
- Realigns to fresh price feed
- Resumes on next UTC second
How it works: If prices stop for 5+ seconds, game enters SYNC mode. Yellow banner appears. System attempts reconnection. Round resumes when stable feed returns.
Strategic impact: Brief pause preserves game integrity. No predictions during uncertainty. Fair restart for all players.
System Failure Protocol
Complete failover protection:
- All providers fail = game ends
- State marked as ERROR
- Smart contract unlocks
- Full refunds available
How it works: If no provider delivers prices for 30 seconds, game terminates safely. Settlement marked as system failure. Smart contract automatically enables withdrawal of all wagers.
Strategic impact: Your funds always protected. No losses from technical failures. Automatic refund mechanism.
Market Expansion Roadmap
Phase 1 (Current)
- HyperLiquid primary
- Binance backup
- Basic failover
- UTC synchronization
Phase 2 (Next)
- Additional DEX integration
- Multi-chain price feeds
- Weighted price averaging
- Provider voting
Phase 3 (Future)
- Custom oracle networks
- Community providers
- Decentralized verification
- Cross-chain validation
How it works: Gradual expansion of price sources. Community input on provider selection. Focus on decentralized, verifiable sources.
Strategic impact: More providers = more reliability. Decentralization reduces single points of failure. Community ownership of data integrity.
Provider-Specific Behaviors
HyperLiquid Characteristics
- Fastest updates (sub-second)
- On-chain verification
- Lower liquidity pairs volatile
- Direct DEX data
How it works: Direct websocket to HyperLiquid servers. Minimal latency. Every trade has blockchain proof. Smaller markets show larger price swings.
Strategic impact: Expect quick price changes. Volatility bonuses more common. Best for aggressive strategies.
Binance Characteristics
- Stable, high liquidity
- 1-second update intervals
- Smoothed price action
- CEX aggregation
How it works: REST API polling at 1-second intervals. High liquidity dampens volatility. Aggregated order book from global trading.
Strategic impact: More predictable movements. Fewer volatility bonuses. Better for conservative play.
Battle Testing Notice
Current Status
System reliability: 99.5% uptime
- Average failover time: <3 seconds
- Successful recoveries: 100%
- Refund success rate: 100%
Expect during beta:
- Occasional provider switches
- Brief SYNC pauses
- Rare system failures
- Rapid improvements
How it works: Every issue logged and analyzed. Fixes deployed within hours. Community feedback drives priority.
Strategic impact: Early players help refine system. Beta participants shape final product. Chaos creates opportunity for alert players.
Remember: Price integrity is paramount. Every prediction tied to verifiable public data. When providers fail, your funds are protected. Transparency eliminates doubt.