# Token blocks

Token blocks are periodic snapshots of token-related data captured at specific blockchain blocks. These are used in vault logic and on-chain analytics.

## Structure

Each token block object includes:

* `_id` *(string)* — Unique identifier
* `tokenId` *(string)* — ID of the associated token
* `tokenAddress` *(string)* — Ethereum address of the token (0x... format)
* `price` *(string)* — Price of the token at this block
* `block` *(object)* —
  * `number` *(number)* — Block number
  * `timestamp` *(number)* — Unix timestamp (UTC)
* `createdAt`, `updatedAt` *(string)* — ISO timestamps
* `createdBy`, `updatedBy` *(string)* — Actor IDs

{% openapi src="<https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FkzbkpCvUQifQK8BMU1n4%2FTokenBlocks.yaml?alt=media&token=dbc0764d-a59a-4457-a14a-bb05f5d5b3fb>" path="/token-blocks" method="get" %}
[TokenBlocks.yaml](https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FkzbkpCvUQifQK8BMU1n4%2FTokenBlocks.yaml?alt=media\&token=dbc0764d-a59a-4457-a14a-bb05f5d5b3fb)
{% endopenapi %}

{% openapi src="<https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FkzbkpCvUQifQK8BMU1n4%2FTokenBlocks.yaml?alt=media&token=dbc0764d-a59a-4457-a14a-bb05f5d5b3fb>" path="/token-blocks/{tokenBlockId}" method="get" %}
[TokenBlocks.yaml](https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FkzbkpCvUQifQK8BMU1n4%2FTokenBlocks.yaml?alt=media\&token=dbc0764d-a59a-4457-a14a-bb05f5d5b3fb)
{% endopenapi %}