Get confirmed activity statistics

GET/v1/stats/activity

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

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

Example

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

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	`"24h" \| "7d" \| "30d"`	—	Requested time window; defaults to 24h.

Status	Description	Body
`200`	Successful read from one Indexer snapshot	application/json `ActivityStatisticsResponse`
`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`

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

Field	Type	Required	Description
`range`	`"24h" \| "7d" \| "30d"`	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.
`coverage_start_time`	`integer`	Yes	Timestamp of the first canonical indexed block, in Unix seconds.
`bucket_seconds`	`integer`	Yes	Duration in seconds of each activity-chart bucket.
`current`	`ActivityTotals`	Yes	Totals for the selected current activity window.
`previous`	`ActivityTotals \| null`	Yes	Totals for the preceding equal-length activity window, or null when unavailable.
`active_addresses`	`integer`	Yes	Distinct addresses with confirmed activity in the selected period.
`produced_units`	`string`	Yes	Exact cumulative base subsidy issuance in TSC smallest units.
`produced_blocks`	`integer`	Yes	Number of canonical blocks used to calculate cumulative subsidy issuance.
`series`	`ActivityPoint[]`	Yes	Chronological activity-chart buckets for the selected window.

Field	Type	Required	Description
`blocks`	`integer`	Yes	Number of blocks, or block-module availability/coverage, as specified by the enclosing schema.
`transactions`	`integer`	Yes	Complete observed mempool count, confirmed transaction count or transaction-module availability/coverage, according to this schema.
`transfers`	`integer`	Yes	Number of confirmed non-coinbase transactions in the selected activity bucket/window.
`output_units`	`string`	Yes	Exact sum of confirmed non-coinbase outputs in TSC smallest units.
`fee_units`	`string`	Yes	Exact sum of confirmed non-coinbase fees in TSC smallest units.

Field	Type	Required	Description
`blocks`	`integer`	Yes	Number of blocks, or block-module availability/coverage, as specified by the enclosing schema.
`transactions`	`integer`	Yes	Complete observed mempool count, confirmed transaction count or transaction-module availability/coverage, according to this schema.
`transfers`	`integer`	Yes	Number of confirmed non-coinbase transactions in the selected activity bucket/window.
`output_units`	`string`	Yes	Exact sum of confirmed non-coinbase outputs in TSC smallest units.
`fee_units`	`string`	Yes	Exact sum of confirmed non-coinbase fees in TSC smallest units.
`time`	`integer`	—	Unix timestamp in seconds; mempool items use Core arrival time and confirmed items use block time.

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.