American Football Feed

​

Coverage

US football score encodings and feed semantics are documented below. Use the shared Schedule and fixtures snapshot API for current US football fixture availability.

​

On-Chain Specifications

These specifications define how football game phases and statistics are encoded for on-chain operations, including cryptographic validation and trading settlement.

​

Game Phase Encoding

Standard Phases: Overtime Phases:

​

Stat Period Encoding

Stats are encoded with a formula: (half * 1000 OR quarter * 10000) + base_key These encodings are used for on-chain validation proofs and trading settlement. Full Game Stats (Keys 1-16): Period-Specific Stats - Add period multiplier to base keys:

• First Half (H1): Add 1000 (e.g., key 1001 = Participant 1 1st Half Score)
• Second Half (H2): Add 2000 (e.g., key 2001 = Participant 1 2nd Half Score)
• Quarter 1: Add 10000 (e.g., key 10001 = Participant 1 Q1 Score)
• Quarter 2: Add 20000 (e.g., key 20001 = Participant 1 Q2 Score)
• Quarter 3: Add 30000 (e.g., key 30001 = Participant 1 Q3 Score)
• Quarter 4: Add 40000 (e.g., key 40001 = Participant 1 Q4 Score)

Usage: These encodings are required when validating score data against on-chain Merkle roots, creating trading offers, or settling trades with cryptographic proofs.

​

Documentation