AssetOverviewResponse
| Field | Type | Required | Description |
|---|---|---|---|
data | AssetOverview | Yes | The requested resource or collection; its schema is specific to this endpoint. |
Get asset activity overview
GET/v1/assets/{id}/overview
Chain-dependent response; compact chain headers identify the serving snapshot.
Example
curl 'https://api.tensorcash.org/v1/assets/<id>/overview'Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Exact 64-character hexadecimal model or asset identifier; use the corresponding list to discover IDs. |
min_height | query | integer | — | Optional minimum serving indexed height. Returns DATA_NOT_READY if no eligible source has reached it. |
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
AssetOverview
Lifetime asset activity and current holder count. Events are asset/transaction pairs with unit movements, including mint, transfer and burn; counts are not token quantities.
| Field | Type | Required | Description |
|---|---|---|---|
total | integer | Yes | Lifetime event total for this exact entity; equals the sum of series counts. |
through_height | integer | Yes | Indexed canonical height covered by the full history. |
bucket_size | integer | Yes | Number of block heights per interval, selected automatically to bound the series to at most 101 entries. |
series | RegistryHistoryBucket[] | Yes | Chronological activity-chart buckets for the selected window. |
asset_id | string | Yes | Asset identifier from the indexed protocol registration. |
first_height | integer | null | Yes | First indexed transaction height for this asset; null without unit movements. |
last_height | integer | null | Yes | Latest indexed transaction height for this asset; null without unit movements. |
holder_count | integer | Yes | Current addresses with a strictly positive balance of this asset; not a count of people. |
RegistryHistoryBucket
Nonempty height bucket. Missing intervals have zero events.
| Field | Type | Required | Description |
|---|---|---|---|
from_height | integer | Yes | Inclusive first block height of the interval. |
to_height | integer | Yes | Inclusive last block height, clipped to through_height for the newest interval. |
count | integer | Yes | Canonical model blocks or asset/transaction pairs in this interval, according to the resource. |
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