GET/v1/addresses
Current funded-address ranking by exact descending balance and ascending address. Each row contains confirmed activity count and latest activity, plus nullable signed rolling 7/30-day net flows. Null means no activity in that window; known zero means activity netted to zero. Numbered pages use the current indexed chain state. Numbered pages and first pages can advance from a valid canonical ancestor; summary contains their current funded count and supply. Only limit, page and min_height are accepted. Chart distribution and optional Market conversion are separate reads.
curl 'https://api.tensorcash.org/v1/addresses'| 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. |
| 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 |
FundedAddressPage| Field | Type | Required | Description |
|---|---|---|---|
data | FundedAddress[] | Yes | The requested resource or collection; its schema is specific to this endpoint. |
page | PageInfo | Yes | Pagination metadata separate from resource rows. |
summary | AddressRankingSummary | — | Compact exact counters from the same snapshot as the ranked address page. |
FundedAddressCurrent funded balance and compact confirmed activity. Flows use rolling 7/30-day windows of 86400-second days from read time; null means no observed activity in that window, while known zero means activity netted to zero. Numbered pages describe the current indexed state.
| Field | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Chain address text; null represents an unattributed output where allowed. |
balance | KnownAmount | Yes | Exact current confirmed balance in the declared smallest units. |
transaction_count | integer | Yes | Exact number of confirmed transactions/activities represented by this resource; pending activity is excluded unless explicitly stated. |
last_activity | object | null | Yes | Latest confirmed address activity height and timestamp; null when none exists. |
net_flow_7d | KnownAmount | null | Yes | Signed confirmed net flow over the preceding 7 x 86400 seconds; null means no activity, known zero means activity netted to zero. |
net_flow_30d | KnownAmount | null | Yes | Signed confirmed net flow over the preceding 30 x 86400 seconds; null means no activity, known zero means activity netted to zero. |
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. |
PageInfoNumbered 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. |
AddressRankingSummaryCounters from the same current database snapshot as the ranking rows.
| Field | Type | Required | Description |
|---|---|---|---|
funded_addresses | integer | Yes | Exact number of indexed addresses with a positive confirmed balance. |
indexed_supply | IndexedSupply | Yes | Exact sum of indexed address balances in TSC smallest units; not a fiat value or an estimate of unassigned outputs. |
IndexedSupplyExact sum of indexed address balances in TSC base units; not an estimate of unassigned outputs.
| 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 | 8 | 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. |