> ## Documentation Index
> Fetch the complete documentation index at: https://txline-docs.txodds.com/llms.txt
> Use this file to discover all available pages before exploring further.

# American Football Feed

> TxODDS US Football Feed documentation

## Coverage

US football score encodings and feed semantics are documented below. Use the shared [Schedule](/documentation/scores/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:**

| Name | ID | Description |
| - | - | - |
| NS | 1 | Not started |
| Q1 | 2 | Quarter 1 in play |
| Q1B | 3 | Quarter 1 break |
| Q2 | 4 | Quarter 2 in play |
| HT | 5 | Halftime |
| Q3 | 6 | Quarter 3 in play |
| Q3B | 7 | Quarter 3 break |
| Q4 | 8 | Quarter 4 in play |
| F | 9 | Ended (finished) |
| WO | 10 | Waiting for Overtime |
| OT | 11 | Overtime |
| OB | 12 | Overtime Break |
| FO | 13 | Ended after Overtime |
| I | 14 | Interrupted |
| A | 15 | Abandoned |
| C | 16 | Cancelled |
| TXCC | 17 | TX Coverage Cancelled |
| TXCS | 18 | TX Coverage Suspended |

**Overtime Phases:**

| Name | ID | Description |
| - | - | - |
| OT1 | 1011 | Overtime 1 |
| OB1 | 1012 | Overtime 1 break |
| OT2 | 2011 | Overtime 2 |
| OB2 | 2012 | Overtime 2 break |
| ... | ... | (continues to OT12) |

### 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):**

| Key | Statistic |
| - | - |
| 1 | Participant 1 Total Score |
| 2 | Participant 2 Total Score |
| 3 | Participant 1 Total Touchdowns |
| 4 | Participant 2 Total Touchdowns |
| 5 | Participant 1 Total Field Goals |
| 6 | Participant 2 Total Field Goals |
| 7 | Participant 1 Total 1pt Conversions |
| 8 | Participant 2 Total 1pt Conversions |
| 9 | Participant 1 Total 2pt Conversions |
| 10 | Participant 2 Total 2pt Conversions |
| 11 | Participant 1 Total Safeties |
| 12 | Participant 2 Total Safeties |
| 13 | Participant 1 Total 1pt Safeties |
| 14 | Participant 2 Total 1pt Safeties |
| 15 | Participant 1 Total Defensive 2pt Conversions |
| 16 | Participant 2 Total Defensive 2pt Conversions |

**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

<Card title="Download" icon="file-pdf" href="https://txodds.github.io/tx-on-chain/assets/txodds-us-football-feed-v1.17.4.pdf">
  Complete documentation for the TxODDS US Football data feed
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.