get_universe
The coverage picture: the last complete day, how many markets are in the universe for a scope, how much history sits behind them, and how densely it is populated. A compact SUMMARY by default — pass top_n (1..50) only if you need the per-market day counts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| day | No | The day to describe, `YYYY-MM-DD` or `latest`. | |
| scope | No | `crypto` (the default), `hip3`, or `all`. | |
| top_n | No | Per-market detail is off by default; passing a value (1..50) returns that many markets, listed by name, alongside the summary. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | Yes | The day the per-population counts describe. | |
| coins | No | Per-market detail, only when requested. Markets are listed by name. | |
| notes | Yes | ||
| scope | Yes | ||
| source | Yes | ||
| min_day | Yes | The oldest day the counts below cover: the published range start, or the caller's history floor when the plan clips it (the response says so in `notes`). | |
| day_count | Yes | Distinct days in the range. | |
| row_count | Yes | Rows in scope over the whole range. | |
| truncated | Yes | True when more markets exist than the detail list returned. | |
| months_covered | Yes | ||
| coin_count_hip3 | Yes | Markets with a deployer prefix on the described day. | |
| coin_count_total | Yes | Distinct markets in scope over the whole range. | |
| max_complete_day | Yes | The newest complete day — the day `latest` resolves to. | |
| coin_count_crypto | Yes | Markets without a deployer prefix on the described day, whatever scope was asked for. | |
| rows_per_market_day | Yes | `row_count` divided by (days × markets) — how densely the range is populated. Below 1.0 means some markets are missing some days. | |
| coverage_from_manifest | Yes | True when the day range came from the published coverage manifest, false when it had to be read from the data itself. |