Get total amount of an asset
An asset, often referred to as a token, represents a digital artifact on the TEOS platform that can be stored, managed, and verified on blockchain.
This endpoint returns both the total number of Sparks and the total number of natural units associated with the asset identified by the provided uniqueAssetId.
📘 Learn more about natural units of measure and Sparks.
Request Endpoint:​
GET /odata/v1.0/Assets({key})/TotalAmount
Parameters​
| Parameter | Type | Description | Mandatory |
|---|---|---|---|
| key | string | UniqueAssetId of the asset | ✅ |
Example Request:
GET /odata/v1.0/Assets('0x86766979FD04114E1F90001')/TotalAmount
Response Body:​
application/json — Returns total Sparks and Units
| Parameter | Type | Description |
|---|---|---|
| TotalSparks | string | Total number of Sparks for the asset |
| TotalUnits | string | Total number of natural units for the asset |
Example Response:​
{
"TotalSparks": "1000000",
"TotalUnits": "1000"
}
Response Codes:​
| Code | Description |
|---|---|
| 200 | The asset's total amount was successfully retrieved. |
| 400 | The request is invalid. Error details are included. |
| 401 | Unauthorized. |
| 404 | The asset was not found using the provided uniqueAssetId. |