Get asset

GET/v1/assets/{id}

TSCScan API v1.0.0 · Assets · also at /api/v1/mainnet/assets/{id}

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

Example

curl 'https://api.tensorcash.org/v1/assets/<id>'

Parameters

NameInTypeRequiredDescription
idpathstringYesExact 64-character hexadecimal model or asset identifier; use the corresponding list to discover IDs.
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

AssetDetailResponse

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

AssetDetail

FieldTypeRequiredDescription
idstringYesCanonical identifier of the requested or resolved resource.
symbolObservedFieldYesObserved asset ticker; unsupported or unavailable states are explicit.
precisionObservedPrecisionYesDecimal places for the smallest-unit amount. TSC uses 8; assets use their indexed precision.
parent_idObservedOptionalIdYesResolved root asset identifier for a child ticker, or explicit unknown/unsupported state.
governanceObservedFieldYesObserved asset policy bitmask; unsupported or unavailable values are explicit.
coverageModuleCoverageYesIndexed coverage for this module or sampled chart series; incomplete data is explicit.
policy_bitsinteger—Raw on-chain asset permission bitmask.
first_seen_heightinteger | null—First indexed issuer registration height; null if unavailable.
registration_txidstring—Latest issuer registration transaction.
updated_heightinteger—Height of the latest indexed asset registration.

ObservedField

Explicit status for protocol/Core-derived fields pending source validation.

Type: object | object | object

ObservedPrecision

Type: object | object | object

ObservedOptionalId

No parent is distinct from an unknown or unavailable parent source.

Type: object | object | object | object

ModuleCoverage

FieldTypeRequiredDescription
state"complete" | "partial" | "unsupported"YesAvailability or confirmation state. Use the declared enum/constant; unknown or unavailable never means numeric zero.
through_heightinteger | nullYesHighest canonical height covered by this module; -1 means no indexed coverage.
scope"chain_wide" | "current_state" | "wallet_scoped" | "none"YesCoverage scope. chain_wide means every required block from genesis through the reported height.

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