List blocks

GET/v1/blocks

TSCScan API v1.0.0 · Blocks · also at /api/v1/mainnet/blocks

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

Example

curl 'https://api.tensorcash.org/v1/blocks'

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.
`limit`	query	`integer`	—	Default 25; server may apply a smaller resource cap.
`page`	query	`integer`	—	One-based page number, default 1. Responses include number, limit, total and total_pages. Preserve the filters and limit when changing page.

Responses

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

`BlockSummaryPage`

Field	Type	Required	Description
`data`	`BlockListItem[]`	Yes	The requested resource or collection; its schema is specific to this endpoint.
`page`	`PageInfo`	Yes	Pagination metadata separate from resource rows.

`BlockListItem`

Compact indexed fields for the existing Blocks table. Confirmations derive from the response watermark.

Field	Type	Required	Description
`height`	`integer`	Yes	Zero-based canonical block height.
`hash`	`string`	Yes	64-character hexadecimal block hash.
`time`	`integer`	Yes	Unix timestamp in seconds; mempool items use Core arrival time and confirmed items use block time.
`tx_count`	`integer`	Yes	Number of transactions in this canonical block, including coinbase.
`miner_address`	`string \| null`	Yes	Address of the attributed coinbase payout, or null when unattributed.
`miner_reward`	`Amount`	Yes	Exact attributed coinbase payout in TSC smallest units.
`size_bytes`	`integer`	Yes	Serialized block or transaction size in bytes.
`difficulty`	`string \| null`	Yes	Exact indexed effective difficulty as a decimal string; null when unavailable.
`proof`	`BlockProofSummary \| null`	Yes	Compact Proof facts, or Proof-module availability/coverage, as specified by this schema.

`Amount`

Exact smallest-unit decimal. Known zero is units '0'.

Type: KnownAmount | UnknownAmount | UnavailableAmount

`KnownAmount`

Field	Type	Required	Description
`units`	`string`	Yes	Exact decimal string in smallest units; signed where the schema permits. Divide by 10^precision only for display.
`precision`	`integer`	Yes	Decimal places for the smallest-unit amount. TSC uses 8; assets use their indexed precision.

`UnknownAmount`

Field	Type	Required	Description
`state`	`"unknown"`	Yes	Availability or confirmation state. Use the declared enum/constant; unknown or unavailable never means numeric zero.
`units`	`null`	Yes	Exact decimal string in smallest units; signed where the schema permits. Divide by 10^precision only for display.
`precision`	`integer \| null`	Yes	Decimal places for the smallest-unit amount. TSC uses 8; assets use their indexed precision.

`UnavailableAmount`

Field	Type	Required	Description
`state`	`"unavailable"`	Yes	Availability or confirmation state. Use the declared enum/constant; unknown or unavailable never means numeric zero.
`units`	`null`	Yes	Exact decimal string in smallest units; signed where the schema permits. Divide by 10^precision only for display.
`precision`	`integer \| null`	Yes	Decimal places for the smallest-unit amount. TSC uses 8; assets use their indexed precision.

`BlockProofSummary`

A missing price is null; no multiplier is inferred from the Proof version.

Field	Type	Required	Description
`version`	`integer \| null`	Yes	Exact Core header/transaction version or indexed Proof version, according to the enclosing resource.
`price_multiplier`	`ExactPriceRatio \| null`	Yes	Protocol Proof price multiplier, e.g. '2' means 2x. Separate from Market prices; null means unavailable. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places.

`ExactPriceRatio`

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

`PageInfo`

Numbered pagination. Page defaults to 1. Totals and rows belong to the same database snapshot; current-state collections may move between requests. Empty collections have one page.

Field	Type	Required	Description
`limit`	`integer`	Yes	Requested maximum number of rows in this page.
`number`	`integer`	Yes	One-based requested page number, default 1.
`total`	`integer`	Yes	Exact number of rows in the collection at the selected snapshot.
`total_pages`	`integer`	Yes	Number of numbered pages, with a minimum of 1 for an empty collection.

`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