---
title: "OpenTimestamps proof for one day of the index"
method: GET
path: "/indices/proof"
tags: ["Receipts"]
---

# OpenTimestamps proof for one day of the index

`GET /indices/proof`

## Request

- Base URL: `https://tickerz.com/api/v1`
- URL: `https://tickerz.com/api/v1/indices/proof`
- Auth: none declared

The proof of one day of the Tickerz Index: every complete period written or revised since the proof before, hashed and stamped in Bitcoin. JSON metadata, or the .ots file with format=ots. Verify sha256(canonical_json) against digest_sha256 and check the .ots file with the OpenTimestamps client or opentimestamps.org. Until a Bitcoin height is known the stamp is calendar-pending.

## Query parameters

- `day` string, date
- `format` 'ots'

## Response `200`

Proof metadata, or the .ots file when format=ots

- IndexProof
  - `day` string, date
  - `digest_sha256` string: SHA-256 of canonical_json
  - `canonical_json` string: the exact bytes that were hashed
  - `stamped_at` string, date-time
  - `bitcoin_height` integer, nullable
  - `bitcoin_block_time` string, date-time, nullable
  - `ots_proof_base64` string
  - `ots_url` string
  - `verify` string

## Other responses

- `400`: bad_day
- `404`: not_found: no proof for that day
- `429`: rate_limited
- `500`: proof_unreadable

---

[API](https://skmtc.dev/tickerz/apis/tickerz-api.md) · [All operations](https://skmtc.dev/tickerz/apis/tickerz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickerz/apis/tickerz-api/revisions/075e6b98557d?raw)
