Get Proof price statistics

GET/v1/stats/proof

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

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

Example

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

Parameters

NameInTypeRequiredDescription
min_heightqueryinteger—Optional minimum serving indexed height. Returns DATA_NOT_READY if no eligible source has reached it.

Responses

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

Schemas

ProofStatisticsResponse

FieldTypeRequiredDescription
dataProofStatisticsYesThe requested resource or collection; its schema is specific to this endpoint.

ProofStatistics

A partial coverage flag means these statistics include observed priced blocks only. Null prices never imply 1x.

FieldTypeRequiredDescription
coverageobjectYesIndexed coverage for this module or sampled chart series; incomplete data is explicit.
priced_blocksintegerYesNumber of blocks with exact indexed Proof price evidence.
v3_blocksintegerYesNumber of indexed blocks with Proof protocol version 3.
v4_blocksintegerYesNumber of indexed blocks with Proof protocol version 4.
above_2xintegerYesNumber of priced blocks whose exact Proof price exceeds 2.
average_price_multiplierAveragePriceRatio | nullYesMean 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.
median_price_multiplierExactPriceRatio | nullYesMedian protocol Proof price multiplier; null means unavailable. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places.
max_price_multiplierExactPriceRatio | nullYesMaximum protocol Proof price multiplier; null means unavailable. Finite ratios are exact; only repeating decimals are rounded half away from zero to 12 places.
latestobject | nullYesLatest indexed priced block and its Proof version/ratio; null when no priced block exists.

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

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

Problem

FieldTypeRequiredDescription
typestringYesProblem type URI; about:blank is used for the current error family.
titlestringYesShort human-readable problem title, normally the stable error code.
statusintegerYesHTTP 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"YesStable machine-readable error code; use this instead of matching message text.
request_idstringYesIdentifier also supplied in X-Request-ID; include it when reporting an error.
detailstring—Human-readable explanation of the error.
retry_after_secondsinteger—Suggested wait in seconds before retrying; where present, agrees with Retry-After.
Source
TSCScan public API v1.0.0 (12f98c5) · rHuhu · MIT