Get model
GET/v1/models/{id}
TSCScan API v1.0.0 · Models · also at /api/v1/mainnet/models/{id}
Chain-dependent response; compact chain headers identify the serving snapshot.
Example
curl 'https://api.tensorcash.org/v1/models/<id>'
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
ModelDetailResponse
| Field | Type | Required | Description |
|---|
data | ModelDetail | Yes | The requested resource or collection; its schema is specific to this endpoint. |
ModelDetail
| Field | Type | Required | Description |
|---|
id | string | Yes | Canonical identifier of the requested or resolved resource. |
name | ObservedField | Yes | Observed model name; unavailable and unsupported states are explicit. |
registration_height | ObservedHeight | Yes | Observed model registration height; unsupported or unavailable states are explicit. |
owner | ObservedField | Yes | Observed model owner; unsupported or unavailable values are explicit. |
verifiable_state | ObservedField | Yes | Observed model verification status; unsupported or unavailable states are explicit. |
coverage | ModuleCoverage | Yes | Indexed coverage for this module or sampled chart series; incomplete data is explicit. |
commit | string | — | Official model revision identifier. |
difficulty | string | — | Exact integer model difficulty parameter from registration. |
is_default | boolean | — | Built-in genesis model, with no registration deposit transaction. |
cid | string | null | — | Registered content reference, or null. |
registration | object | — | Observed registration lifecycle. Default models have no deposit; verdict_height is null after the pending window closes. |
challenge | object | — | Current challenge window. Resolved challenges remain visible in event history. |
ObservedField
Explicit status for protocol/Core-derived fields pending source validation.
Type: object | object | object
ObservedHeight
Type: object | object | object
ModuleCoverage
| Field | Type | Required | Description |
|---|
state | "complete" | "partial" | "unsupported" | Yes | Availability or confirmation state. Use the declared enum/constant; unknown or unavailable never means numeric zero. |
through_height | integer | null | Yes | Highest canonical height covered by this module; -1 means no indexed coverage. |
scope | "chain_wide" | "current_state" | "wallet_scoped" | "none" | Yes | Coverage scope. chain_wide means every required block from genesis through the reported height. |
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. |
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