Get Tokenization Volume

Returns the tokenization volume time series of a node and all its descendants: a parent's figures include its children's. The volume is the total value of the subtree's tokens, per currency, and the count is the number of tokens; each bucket reports how much they changed, so volume and count can be negative when value is removed. The figures come from statistics the platform refreshes periodically, so the newest changes can take a while to appear.

The series is bucketed by time and split per currency token. Volumes are decimal strings. Unlike most responses, this one uses camelCase field names.

Required permission: node:summary:view

Request

GET /v2/admin/nodes/{node_id}/analytics/tokenization-volume?start_time={start_time}&end_time={end_time}

Parameters

Name	Type	In	Description
node_id	string	path	Required. The node at the top of the subtree to aggregate
start_time	string	query	Start of the window, RFC 3339 (2026-01-01T00:00:00Z). Default: twelve months before now.
end_time	string	query	End of the window, RFC 3339. Default: now.

The bucket size follows the window length: hourly up to 2 days, weekly up to 40 days, monthly up to 400 days, yearly beyond.

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/analytics/tokenization-volume?start_time=2026-10-01T00:00:00Z&end_time=2026-10-31T23:59:59Z' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "volume": "2500000",
      "totalVolume": "14500000",
      "count": 2,
      "totalCount": 11,
      "createdAt": "2026-10-09T14:00:00Z",
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC"
    },
    {
      "volume": "-500000",
      "totalVolume": "14000000",
      "count": 0,
      "totalCount": 11,
      "createdAt": "2026-10-23T09:00:00Z",
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC"
    }
  ],
  "baselineVolume": "12000000",
  "baselineCount": 9,
  "summary": {
    "totalVolume": "14000000",
    "volume": "2000000",
    "totalCount": 11,
    "count": 2
  },
  "currencySummaries": [
    {
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC",
      "volume": "2000000",
      "count": 2,
      "totalVolume": "14500000",
      "totalCount": 11
    }
  ]
}

Response Fields

Field	Type	Description
data	array	One item per (time bucket, currency token), oldest first. [] when the window has no data.
data[].volume	string	Change in tokenized value during this bucket; may be negative
data[].totalVolume	string	Tokenized value at the end of this bucket
data[].count	integer	Change in the number of tokens during this bucket; may be negative
data[].totalCount	integer	Number of tokens at the end of this bucket
data[].createdAt	string	Time of the newest statistics row in the bucket (ISO 8601)
data[].currencyTokenId	string	Currency token the value is in
data[].currencySymbol	string	Symbol of that currency token
baselineVolume	string	Tokenized value before start_time. "0" when start_time is not sent.
baselineCount	integer	Number of tokens before start_time. 0 when start_time is not sent.
summary.volume	string	Sum of data[].volume: the window's change
summary.count	integer	Sum of data[].count
summary.totalVolume	string	baselineVolume + summary.volume
summary.totalCount	integer	baselineCount + summary.count
currencySummaries	array	The window's figures per currency token. Omitted when data is empty.
currencySummaries[].currencyTokenId	string	Currency token
currencySummaries[].currencySymbol	string	Its symbol
currencySummaries[].volume	string	Window change in this currency
currencySummaries[].count	integer	Window change in token count in this currency
currencySummaries[].totalVolume	string	Highest tokenized value reached in this currency during the window
currencySummaries[].totalCount	integer	Highest token count reached in this currency during the window

summary and the baseline add every currency together. When the subtree tokenizes in more than one currency, read currencySummaries, or convert each currency with Get Exchange Rates before adding. Without start_time the baseline is zero, so summary.totalVolume then covers only the default twelve-month window.

Errors

Status	Code	Description
400	10015	start_time or end_time is not an RFC 3339 time
400	10016	node_id is not a valid id
400	10001	Node not found
403	10005	The node is outside the API key's node hierarchy

See Errors for the error format and common codes.