Skip to main content
GET
/
fixtures
/
batch-validation
Get a Merkle proof for an entire hourly batch of fixtures
curl --request GET \
  --url https://api.example.com/fixtures/batch-validation
{
  "metadata": {},
  "proof": [
    {}
  ],
  "totalUpdateCount": {},
  "numUniqueFixtures": {},
  "overallBatchStartTs": {},
  "overallBatchEndTs": {}
}

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.

Fixture data is grouped into hourly batches. Each batch is represented by a Merkle Tree, and its root hash is published on-chain. This Merkle root is contained within the batch’s metadata. This endpoint allows you to validate the integrity of the batch metadata itself. It returns the metadata for the specified hourly batch, along with a Merkle proof. A user can take this proof and the metadata (which includes the final Merkle root) and use it to verify against a higher-level tree or commitment, thus cryptographically proving the integrity of the entire batch’s claimed state.

​
Query Parameters

​
epochDay
integer
required
The day since the Unix epoch for the desired batch.
​
hourOfDay
integer
required
The hour of the day (UTC, 0-23) for the desired batch.

​
Response

Returns a FixtureBatchValidation object.
​
metadata
BatchMetadata
required
Metadata for the hourly batch
​
proof
array
required
Merkle proof nodes for validating the batch

​
BatchMetadata Object

​
totalUpdateCount
int32
required
Total number of updates in the batch
​
numUniqueFixtures
int32
required
Number of unique fixtures in the batch
​
overallBatchStartTs
int64
required
Start timestamp of the batch
​
overallBatchEndTs
int64
required
End timestamp of the batch