MiningSeriesResponse
| Field | Type | Required | Description |
|---|---|---|---|
data | MiningSeries | Yes | The requested resource or collection; its schema is specific to this endpoint. |
Get bounded exact mining chart series
GET/v1/stats/mining/series
Chain-dependent response; compact chain headers identify the serving snapshot.
Example
curl 'https://api.tensorcash.org/v1/stats/mining/series'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 | "24h" | "7d" | "30d" | "all" | — | Existing TSCScan Home chart ranges only. |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful read from one Indexer snapshot | |
400 | Invalid argument or page conditions | |
401 | Authentication required | |
403 | Permission denied | |
404 | Absent in a ready indexed range | |
409 | Verified chain continuity invalidation | |
422 | Bounded response would exceed byte budget | |
429 | Quota exceeded; Retry-After supplied | |
503 | Data or eligible source not ready | |
504 | Bounded upstream query timed out |
Schemas
MiningSeries
Fixed-range, height-sampled exact work series. First and last relevant heights are retained; at most 360 points are returned.
| Field | Type | Required | Description |
|---|---|---|---|
range | "24h" | "7d" | "30d" | "all" | Yes | Selected named time range; the supported values are endpoint-specific. |
first_height | integer | Yes | First indexed or selected height represented by this resource. |
last_height | integer | Yes | Last height represented by this group or series. |
source_blocks | integer | Yes | Number of canonical blocks represented by the sampled mining series. |
coverage | MiningSeriesCoverage | Yes | Indexed coverage for this module or sampled chart series; incomplete data is explicit. |
items | MiningSeriesPoint[] | Yes | Resource items in the ordering specified by the endpoint. |
MiningSeriesCoverage
Coverage counts apply to sampled points, not every block between samples.
| Field | Type | Required | Description |
|---|---|---|---|
sampled_points | integer | Yes | Number of height-sampled chart points in this response; chart data, not the mempool. |
work_complete_points | integer | Yes | Number of sampled mining-series points with complete indexed work. |
rate_available_points | integer | Yes | Number of sampled chart points with a valid exact work rate. |
MiningSeriesPoint
Canonical height sample for the existing Home chart. Null values mean missing work or invalid observation, never zero.
| Field | Type | Required | Description |
|---|---|---|---|
height | integer | Yes | Zero-based canonical block height. |
time | integer | Yes | Unix timestamp in seconds; mempool items use Core arrival time and confirmed items use block time. |
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. |
proof_price_multiplier | MiningSeriesPrice | null | Yes | Protocol Proof price multiplier at the sampled block; null means unavailable. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places. |
work_rate_50 | MiningRate | null | Yes | Effective work per observed second over the recent 50-block window; null means unavailable. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places. |
work_window_blocks | integer | Yes | Number of canonical blocks used in this chart point's rate window. |
work_complete | boolean | Yes | Whether every block needed for this work calculation has exact indexed work. |
observed_seconds | integer | Yes | Observed timestamp span used as the work-rate denominator; zero cannot produce a valid rate. |
difficulty_trend_7 | MiningMedian | null | Yes | Median effective work across up to seven recent blocks as a decimal string; null means unavailable. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places. |
block_interval_seconds | integer | null | Yes | Observed difference between this block's timestamp and its predecessor. |
MiningSeriesPrice
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
MiningRate
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
MiningMedian
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
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