get_inclusion_proof

com.twmarketdata/tw-market-data · Verify this server

Prove a row was in the snapshot TWMD published — and check it yourself. Returns the Merkle sibling path, the signed root, and the checkpoint it belongs to. It returns the PATH rather than a yes/no on purpose: a service that answers "yes, it is included, trust me" is the opposite of verifiable. Recompute the root from the leaf and the path; the verifier is ~30 lines and is written out in docs/VERIFIABLE_DATA.md. ★ WHAT IT PROVES: integrity (the row was not altered after publication) and origin (the root was signed by TWMD). **It does NOT prove the numbers are correct** — if the exchange published a wrong figure, TWMD faithfully committed to the wrong figure. Do not present a passing proof as a correctness guarantee. ★ THREE STATUSES, and they must not be collapsed: ok proof enclosed; verify it. not_in_snapshot that row_key was NOT a leaf of the snapshot. A true answer, NOT a failure and NOT evidence of tampering. no_checkpoint no snapshot was ever built for that dataset/version. Args: dataset: e.g. 'daily_price'. row_key: the dataset's LOGICAL key joined by '|', e.g. '2330|2026-08-14'. snapshot_version: omit for the most recent checkpoint.