ChainAnalyticsService

Get Unified Asset Balances

Get unified asset total balance chart columns.

Method

GET

Path

/v1/chain/analytics/unified-asset-balances

Visibility

Public endpoint

GET

/v1/chain/analytics/unified-asset-balances

Request

Testnet

curl --request GET \ \
  --url 'https://api.testnet.polyester.com/v1/chain/analytics/unified-asset-balances?assetId=100' \
  --header 'Accept: */*'

Responses

{
  "assetId": 100,
  "bucket": "1m",
  "endTsSec": 1735689600,
  "points": 1,
  "range": "1d",
  "startTsSec": 1735689600,
  "totalBalance": [
    "0.0000001"
  ]
}

assetId integer (int32) required > 0

Unified asset identifier.

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

Optional bucket duration. Valid buckets depend on range and must keep chart density useful.

endTsSec integer (int32) > 0

Optional inclusive end timestamp in seconds since Unix epoch.

range enum must be defined value

History window. Defaults to 1d.

startTsSec integer (int32) > 0

Optional inclusive start timestamp in seconds since Unix epoch.

assetId integer (int32)

Unified asset identifier.

Example 100

bucket string

Resolved bucket duration.

Example 1m

endTsSec integer (int32)

Last bucket timestamp in seconds since Unix epoch.

Example 1735689600

points integer (int32)

Number of buckets represented by each value column.

Example 1

range enum

Resolved history window.

1d 7d 30d 90d 180d 365d

Example 1d

startTsSec integer (int32)

First bucket timestamp in seconds since Unix epoch.

Example 1735689600

totalBalance string[]

Total unified balance per bucket across public account surfaces, as decimal strings in asset units, for example '1250.5'.

Example ["0.0000001"]

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.