API reference · Public
The sealed days, newest first
GET/api/receipts/commitmentsNo key
Each sealed UTC day's root, the header it is the hash of, the margin its totals imply and where it was published. Read from the commitments only. `committing` says whether this deployment is sealing days now. Public, 60 requests a minute per address.
Parameters
| Field | Type | What it is |
|---|---|---|
| limit (query) | integer | How many days. Default 30. From 1 to 366. |
Answer 200
The sealed days.
| Field | Type | What it is |
|---|---|---|
| object | string | One of "list". |
| committing | boolean | |
| data | array of object | |
| data[] | string | One of "receipt_commitment". |
| data[] | integer | |
| data[] | string | |
| data[] | string | |
| data[] | object | The day header. The day's root is SHA-256 of the byte 0x02 followed by the UTF-8 of the JSON array ["am-day-v1", day, usage_root, usage_count, ledger_root, ledger_count, billed_micros, upstream_micros, unmeasured_count]. |
| data[] | string | The UTC day. |
| data[] | string | |
| data[] | integer | |
| data[] | string | |
| data[] | integer | |
| data[] | integer | What the meter billed that day, micro USD. |
| data[] | integer | What the upstreams charged, micro USD; a usage row nobody measured counts at its billed figure. |
| data[] | integer | Usage rows with no measured upstream cost. |
| data[] | integer | Billed minus upstream. |
| data[] | integer or null | The margin over the upstream cost, basis points; null when nothing was measured. |
| data[] | integer | |
| data[] | object or null | Where the root was published: a transaction from the operator's signer to itself whose calldata is the UTF-8 text `antimatter receipts v1 <day> <root>`. Null while it is not on chain, which is always the case where the operator has not switched publishing on. |
Errors
- 429OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.