chain.analytics.v1.ChainAnalyticsService

GetUnifiedAssetBalances

Get unified asset total balance chart columns.

Method

POST

Path

chain.analytics.v1.ChainAnalyticsService/GetUnifiedAssetBalances

Service

chain.analytics.v1.ChainAnalyticsService

Visibility

Public endpoint

POST

chain.analytics.v1.ChainAnalyticsService/GetUnifiedAssetBalances

Request

Testnet

curl --request POST \ \
  --url 'https://api.testnet.polyester.com/chain.analytics.v1.ChainAnalyticsService/GetUnifiedAssetBalances' \
  --header 'Content-Type: application/json' \
  --header 'Connect-Protocol-Version: 1' \
  --data '{
  "assetId": 100,
  "bucket": "1m",
  "endTsSec": 1735689600,
  "range": "DAY_1",
  "startTsSec": 1735689600
}'

Responses

{
  "assetId": 100,
  "bucket": "1m",
  "endTsSec": 1735689600,
  "points": 1,
  "range": "DAY_1",
  "startTsSec": 1735689600,
  "totalBalanceQ": [
    "1"
  ]
}

Request

chain.analytics.v1.GetUnifiedAssetBalancesRequest

Response

chain.analytics.v1.GetUnifiedAssetBalancesResponse

assetId integer (int32) > 0

Unified asset identifier.

range enum must be defined value

Standard history window. Defaults to 1 day when unspecified.

bucket string max 3 chars /^$|^(1…h|1d)$/

Optional explicit bucket. Allowed values are 1m, 5m, 10m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, or 1d. Valid buckets depend on range to keep chart payloads near 1k points. When omitted, the server picks the default bucket for the selected range.

startTsSec integer (int32) > 0

Optional inclusive start timestamp in seconds since Unix epoch.

endTsSec integer (int32) > 0

Optional inclusive end timestamp in seconds since Unix epoch.

assetId integer (int32)

Unified asset identifier.

range enum

Resolved history window.

DAY_1 DAY_7 DAY_30 DAY_90 DAY_180 DAY_365

bucket string

Resolved bucket duration.

startTsSec integer (int32)

First bucket timestamp in seconds since Unix epoch.

endTsSec integer (int32)

Last bucket timestamp in seconds since Unix epoch.

points integer (int32)

Number of buckets represented by each value column.

totalBalanceQ string[] (uint64)

Total unified balance per bucket across public account surfaces, scaled by AssetConfig.quantity_scale from SpotConfig for asset_id. Decode: total_balance_q / 10^quantity_scale.

Possible errors: 5

Key	HTTP status	Connect code	Error	When
unauthenticated	401	unauthenticated	Unauthenticated	Authentication required.
permission-denied	403	permission_denied	Permission Denied	Permission denied.
invalid-argument	400	invalid_argument	Invalid Argument	Invalid argument.
not-found	404	not_found	Not Found	Not found.
unavailable	503	unavailable	Unavailable	Service unavailable.