Get work-weighted Pool statistics

GET/v1/stats/pool

TSCScan API v1.0.0 · Statistics · also at /api/v1/mainnet/stats/pool

Chain-dependent response; compact chain headers identify the serving snapshot.

Example

curl 'https://api.tensorcash.org/v1/stats/pool'

Parameters

Name	In	Type	Required	Description
`min_height`	query	`integer`	—	Optional minimum serving indexed height. Returns DATA_NOT_READY if no eligible source has reached it.
`range`	query	`"12h" \| "24h" \| "48h" \| "7d"`	—	Existing TSCScan Pool ranges only.

Responses

Status	Description	Body
`200`	Successful read from one Indexer snapshot	application/json `PoolStatisticsResponse`
`400`	Invalid argument or page conditions	application/problem+json `Problem`
`401`	Authentication required	application/problem+json `Problem`
`403`	Permission denied	application/problem+json `Problem`
`404`	Absent in a ready indexed range	application/problem+json `Problem`
`409`	Verified chain continuity invalidation	application/problem+json `Problem`
`422`	Bounded response would exceed byte budget	application/problem+json `Problem`
`429`	Quota exceeded; Retry-After supplied	application/problem+json `Problem`
`503`	Data or eligible source not ready	application/problem+json `Problem`
`504`	Bounded upstream query timed out	application/problem+json `Problem`

Schemas

`PoolStatisticsResponse`

Field	Type	Required	Description
`data`	`PoolStatistics`	Yes	The requested resource or collection; its schema is specific to this endpoint.

`PoolStatistics`

Exact work-weighted Pool totals for a fixed recent range. Incomplete work yields null total and share fields; never infer zero or 1x.

Field	Type	Required	Description
`range`	`"12h" \| "24h" \| "48h" \| "7d"`	Yes	Selected named time range; the supported values are endpoint-specific.
`start_time`	`integer`	Yes	Start of the selected time window in Unix seconds.
`end_time`	`integer`	Yes	End of the selected window in Unix seconds.
`start_height`	`integer \| null`	Yes	First inclusive canonical height represented by the window or candle.
`end_height`	`integer`	Yes	Final inclusive canonical height represented by the window or candle.
`observed_seconds`	`integer`	Yes	Observed timestamp span used as the work-rate denominator; zero cannot produce a valid rate.
`total_blocks`	`integer`	Yes	Total observed canonical blocks in the selected miner window.
`active_miners`	`integer`	Yes	Number of payout-address groups with observed blocks in the window.
`unknown_blocks`	`integer`	Yes	Observed blocks lacking required indexed work evidence.
`work_complete`	`boolean`	Yes	Whether every block needed for this work calculation has exact indexed work.
`base_work_complete`	`boolean`	Yes	Whether every block in the window has indexed base work.
`total_work`	`string \| null`	Yes	Exact summed effective work in the selected window as a decimal string.
`base_total_work`	`string \| null`	Yes	Exact summed base work for the selected window, encoded as a decimal string.
`known_work_share`	`WorkShare \| null`	Yes	Fraction of work with indexed evidence; null means incomplete work. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places.
`items`	`PoolMiner[]`	Yes	Resource items in the ordering specified by the endpoint.
`remainder`	`PoolRemainder \| null`	Yes	Other miner groups combined without losing their exact work/count totals.

`WorkShare`

Readable decimal string. Finite ratios retain all digits; only repeating decimals are rounded half away from zero to 12 places. Trailing zeroes are omitted. No floating-point intermediate is used.

Type: string

`PoolMiner`

Field	Type	Required	Description
`address`	`string \| null`	Yes	Chain address text; null represents an unattributed output where allowed.
`block_count`	`integer`	Yes	Number of blocks represented by this resource or group.
`base_work`	`string \| null`	Yes	Exact target-derived work before Proof pricing, encoded as a decimal string.
`effective_work`	`string \| null`	Yes	Exact Proof-priced work as a decimal string; null when required evidence is unavailable.
`work_share`	`WorkShare \| null`	Yes	Fraction of total effective work, e.g. '0.25' means 25%; null means incomplete work. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places.
`last_height`	`integer`	Yes	Last height represented by this group or series.
`last_time`	`integer`	Yes	Unix timestamp of this miner group's latest observed block.
`average_price_multiplier`	`AveragePriceRatio \| null`	Yes	Mean protocol Proof price multiplier for this block or work window; null means unavailable. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places.

`AveragePriceRatio`

Readable decimal string. Finite ratios retain all digits; only repeating decimals are rounded half away from zero to 12 places. Trailing zeroes are omitted. No floating-point intermediate is used.

Type: string

`PoolRemainder`

Combined remainder when more than 100 miner groups are in the range.

Field	Type	Required	Description
`group_count`	`integer`	Yes	Number of miner groups combined into the remainder.
`block_count`	`integer`	Yes	Number of blocks represented by this resource or group.
`base_work`	`string \| null`	Yes	Exact target-derived work before Proof pricing, encoded as a decimal string.
`effective_work`	`string \| null`	Yes	Exact Proof-priced work as a decimal string; null when required evidence is unavailable.
`work_share`	`WorkShare \| null`	Yes	Fraction of total effective work, e.g. '0.25' means 25%; null means incomplete work. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places.

`Problem`

Field	Type	Required	Description
`type`	`string`	Yes	Problem type URI; about:blank is used for the current error family.
`title`	`string`	Yes	Short human-readable problem title, normally the stable error code.
`status`	`integer`	Yes	HTTP status code for this problem response.
`code`	`"INVALID_ARGUMENT" \| "UNAUTHORIZED" \| "FORBIDDEN" \| "RESOURCE_NOT_FOUND" \| "CHAIN_ANCHOR_INVALIDATED" \| "RATE_LIMITED" \| "DATA_NOT_READY" \| "SERVICE_UNAVAILABLE" \| "UPSTREAM_TIMEOUT" \| "RESPONSE_TOO_LARGE" \| "CORE_UNAVAILABLE" \| "CORE_METHOD_UNAVAILABLE" \| "CORE_DATA_NOT_READY" \| "CORE_CAPACITY" \| "TRANSACTION_CAPACITY" \| "TRANSACTION_STATE_CHANGED" \| "TRANSACTION_REJECTED" \| "BROADCAST_OUTCOME_UNKNOWN" \| "UNSUPPORTED_ASSET_POLICY"`	Yes	Stable machine-readable error code; use this instead of matching message text.
`request_id`	`string`	Yes	Identifier also supplied in X-Request-ID; include it when reporting an error.
`detail`	`string`	—	Human-readable explanation of the error.
`retry_after_seconds`	`integer`	—	Suggested wait in seconds before retrying; where present, agrees with Retry-After.

Source: TSCScan public API v1.0.0 (12f98c5) · rHuhu · MIT
OpenAPI spec (JSON): /docs/api/tscscan-v1.openapi.json