Get object statistics

Retrieve comprehensive statistics about smart objects and their usage patterns. This endpoint provides aggregate data including total object counts, creation trends, template distribution, and ownership analytics over specified time ranges for platform insights and reporting.

GET

Parameters

Query Parameters

Time_range
Time range for filtering statistics and analytics data
When_created[$gt]
When_created[$lt]
When_created[$gte]
When_created[$lte]
Template_id
Filter statistics by template ID
Wallet_id
Filter statistics by wallet ID
Status codeDescription
200Object statistics
400Bad request error - the request contains invalid parameters or malformed data
500Internal server error - an unexpected error occurred on the server
cURL
curl -L \
"https://blockv-labs.io/stats/objects?time_range={time_range}&when_created[$gt]={when_created[$gt]}&when_created[$lt]={when_created[$lt]}&when_created[$gte]={when_created[$gte]}&when_created[$lte]={when_created[$lte]}&template_id={template_id}&wallet_id={wallet_id}" \
-H 'Accept: application/json'
Response
{
"total": 1
}
json
{
"type": "object",
"required": [
"total",
"by_template"
],
"properties": {
"total": {
"type": "integer",
"format": "int64",
"description": "Total number of objects"
},
"by_template": {
"type": "object",
"additionalProperties": {
"type": "integer"
},
"description": "Objects broken down by template"
}
}
}