Get a Merkle proof for fixture statistics
This endpoint provides a deep cryptographic proof for statistics within a single scores update. The TxODDS Oracle data is structured in a three-level Merkle hierarchy:
- A main batch contains summaries for multiple fixtures.
- Each fixture summary is the root of a sub-tree of all score update events for that fixture.
- Each score update event is the root of a sub-tree of all the individual statistics it contains.
This endpoint returns the full set of proofs needed to connect the stat(s) all the way to the main batch root published on-chain.
Request Modes
The endpoint supports two mutually exclusive request formats:
- Legacy Mode (
statKey,statKey2): Returns aScoresStatValidationpayload containing proofs for one or two specific statistics. - V2 Mode (
statKeys): Accepts a comma-separated list of keys and returns aScoresStatValidationV2payload supporting dynamic N-dimensional proofs across any number of requested statistics.
On-Chain Execution
With the returned data, the user can execute an on-chain transaction to validate that a supplied strategy holds against the extracted stats. For example, validating that a team’s score exceeded a threshold, or that the difference between two scores meets a specific binary condition.
Authorizations
User's session JWT.
The user's long-lived API token, obtained from the activation endpoint.
Headers
Bearer token for the user's session JWT.
The user's long-lived API token.
Query Parameters
The ID of the fixture for the scores event.
The sequence number of the specific scores event within the fixture's history.
Legacy Mode: The key identifying the specific statistic to validate (e.g., 1 for 'Participant1_Score').
Legacy Mode: The key identifying an optional second statistic to validate for two-stat predicates.
V2 Mode: Comma-separated list of stat keys used in N-stat validation strategies.
Response
- ScoresStatValidation
- ScoresStatValidationV2
- Nil · object
- ProofNode · object[]
- Nil · object
- ProofNode · object[]
- Nil · object
- ProofNode · object[]
- Nil · object
- ProofNode · object[]