ChainAnalyticsService

Get Unified Asset Balances

Get unified asset total balance chart columns.

Method

GET

Path

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

Visibility

Authentication required

Authentication

Session token or API key

MFA Requirement

Not required

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&asset_id=100&bucket=1m&endTsSec=1735689600&end_ts_sec=1735689600&range=1d&startTsSec=1735689600&start_ts_sec=1735689600' \
  --header 'Accept: */*' \
  --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
  --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
  --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'

Responses

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

assetId integer > 0

Unified asset identifier.

asset_id 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 > 0

Optional inclusive end timestamp in seconds since Unix epoch.

end_ts_sec 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 > 0

Optional inclusive start timestamp in seconds since Unix epoch.

start_ts_sec 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, scaled by AssetConfig.quantity_scale from SpotConfig for asset_id. Decode: total_balance_q / 10^quantity_scale.

Example ["0.0000001"]

Possible errors: 5

Key	Status	Error	When
unauthenticated	401	Unauthenticated	Authentication required.
permission-denied	403	Permission Denied	Permission denied.
invalid-argument	400	Invalid Argument	Invalid argument.
not-found	404	Not Found	Not found.
unavailable	503	Unavailable	Service unavailable.

Polyester is best experienced on desktop.

Request

Responses