Skip to main content
GET
/
odds
/
validation
Get a Merkle proof for a specific odds update
curl --request GET \
  --url https://api.example.com/odds/validation
{
  "odds": {},
  "summary": {},
  "subTreeProof": [
    {}
  ],
  "mainTreeProof": [
    {}
  ],
  "FixtureId": {},
  "MessageId": "<string>",
  "Ts": {},
  "Bookmaker": "<string>",
  "BookmakerId": {},
  "SuperOddsType": "<string>",
  "InRunning": true,
  "fixtureId": {},
  "updateStats": {},
  "oddsSubTreeRoot": {},
  "updateCount": {},
  "minTimestamp": {},
  "maxTimestamp": {}
}

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.

Each odds update is part of a batch whose state is committed to the blockchain via a Merkle root. This endpoint returns the cryptographic proof for a single odds update, identified by its unique messageId. The proof consists of the hashes along the branch of the Merkle tree, which can be used to reconstruct the root. A user can then use this proof and the odds record in an on-chain transaction to cryptographically verify that the odds update was published by the TxLINE as confirmed by the on-chain Merkle root.

​
Query Parameters

​
messageId
string
required
The unique message ID of the odds update to validate.
​
ts
int64
required
Timestamp of the odds message.

​
Response

Returns an OddsValidation object.
​
odds
Odds
required
The odds record being validated
​
summary
OddsBatchSummary
required
Summary information about the odds batch
​
subTreeProof
array
required
Merkle proof nodes for the sub-tree
​
mainTreeProof
array
required
Merkle proof nodes for the main tree

​
Odds Object

​
FixtureId
int64
required
Fixture identifier
​
MessageId
string
required
Unique message identifier for the odds update
​
Ts
int64
required
Timestamp of the odds update
​
Bookmaker
string
required
Bookmaker name
​
BookmakerId
int32
required
Bookmaker identifier
​
SuperOddsType
string
required
Type of odds market
​
InRunning
boolean
required
Indicates if the fixture is currently in play

​
OddsBatchSummary Object

​
fixtureId
int64
required
Fixture identifier for the batch
​
updateStats
OddsUpdateStats
required
Statistics about updates in this batch
​
oddsSubTreeRoot
binary
required
Root hash of the odds sub-tree

​
OddsUpdateStats Object

​
updateCount
int32
required
Number of updates in the batch
​
minTimestamp
int64
required
Earliest update timestamp
​
maxTimestamp
int64
required
Latest update timestamp