Get network overview

GET/v1/network/overview

TSCScan API v1.0.0 · Network · also at /api/v1/mainnet/network/overview

One bounded indexed snapshot, at most 51 block rows. Shared cached payload, 500 ms maximum age, invalidated by committed tip/reorg changes. Equivalent concurrent misses coalesce. Market refresh runs independently. No query parameters.

Example

curl 'https://api.tensorcash.org/v1/network/overview'

Parameters

No parameters.

Responses

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

`NetworkOverviewResponse`

Field	Type	Required	Description
`data`	`NetworkOverview`	Yes	Operation result.

`NetworkOverview`

Field	Type	Required	Description
`network`	`"mainnet" \| "testnet"`	Yes	Selected deployment network.
`status`	`"ready" \| "catching_up" \| "upstream_unavailable"`	Yes	Synchronization relative to a fresh Core observation. upstream_unavailable means Core height is unknown; indexed chain data remains valid at height/hash.
`height`	`integer`	Yes	Committed indexed height used by all chain fields.
`hash`	`string`	Yes	Indexed tip hash.
`core_height`	`integer \| null`	Yes	Fresh observed Core height; null when the upstream observation has expired or failed. Null when unavailable.
`latest_block_time`	`integer`	Yes	Indexed tip timestamp in Unix seconds.
`base_difficulty`	`string \| null`	Yes	Latest block base target-derived work, in expected proofs. Null when unavailable.
`effective_difficulty`	`string \| null`	Yes	Latest block effective target-derived work after model/Proof adjustments. Null when unavailable.
`confirmed_transactions`	`integer`	Yes	Confirmed transaction count, including coinbases.
`inference`	`object`	Yes	Inference speed estimate.
`hashrate`	`object`	Yes	Network effective proof rate.
`average_block_time_50`	`object`	Yes	50-block average interval.
`reward`	`RewardStatistics`	Yes	Current base subsidy schedule; next reduction uses Core 3/5 recurrence, not a literal 50% halving.
`latest_blocks`	`OverviewBlock[]`	Yes	At most ten latest canonical blocks from the same committed snapshot.
`time_since_last_block_seconds`	`integer`	Yes	Seconds since latest indexed block at as_of_unix.
`as_of_unix`	`integer`	Yes	Overview assembly time; clock-derived fields cached for at most 500 ms.
`market`	`OverviewMarket \| null`	Yes	Optional separate market adapter snapshot; null if disabled, unavailable or expired. Null when unavailable.

`OverviewRatio`

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

`RewardStatistics`

TensorCash Core subsidy recurrence at the indexed tip. Amounts are exact 8-decimal TSC base-unit strings; terminal zero has no next epoch or time estimate.

Field	Type	Required	Description
`height`	`integer`	Yes	Zero-based canonical block height.
`terminal`	`boolean`	Yes	Whether the subsidy has reached zero and no future reward epoch exists.
`current_reward_units`	`string`	Yes	Exact base block subsidy at this height, in TSC smallest units; transaction fees are excluded.
`next_reward_units`	`string`	Yes	Exact next-epoch base subsidy in TSC smallest units.
`epoch_start_height`	`integer \| null`	Yes	First height in the current reward epoch; null in the terminal state.
`epoch_length_blocks`	`integer \| null`	Yes	Length of the current reward epoch; null in the terminal zero-subsidy state.
`epoch_progress`	`RewardEpochProgress \| null`	Yes	Elapsed fraction of the current reward epoch, e.g. '0.5' means 50%; null in the terminal state. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places.
`next_reduction_height`	`integer \| null`	Yes	Height at which the next subsidy epoch begins; null in the terminal state.
`blocks_remaining`	`integer \| null`	Yes	Blocks until the next subsidy reduction; null after the subsidy becomes zero.

`RewardEpochProgress`

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

`OverviewBlock`

Field	Type	Required	Description
`height`	`integer`	Yes	Canonical block height.
`hash`	`string`	Yes	Canonical block hash.
`time`	`integer`	Yes	Header time in Unix seconds.
`tx_count`	`integer`	Yes	Block transactions including coinbase.
`miner`	`string \| null`	Yes	Attributed coinbase payout address. Null when unavailable.
`age_seconds`	`integer`	Yes	Seconds since header timestamp at as_of_unix, clamped to zero.

`OverviewMarket`

Field	Type	Required	Description
`pair`	`"TSC/USDT"`	Yes	Trading pair.
`price_usdt`	`string`	Yes	Exact observed market price in USDT per TSC.
`price_change_percent_24h`	`string \| null`	Yes	Reported 24-hour percentage change. Null when unavailable.
`volume_24h_usdt`	`string \| null`	Yes	Reported 24-hour quote volume. Null when unavailable.
`volume_24h_tsc`	`string \| null`	Yes	Reported 24-hour base volume. Null when unavailable.
`source`	`string \| null`	Yes	Market adapter source label. Null when unavailable.
`observed_at_unix`	`integer`	Yes	Source price observation time.

`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