Get Token History by ID

Retrieves the history of changes for a specific token with pagination and optional filtering by date range and changed_by.

Request

GET /v2/admin/tokens/{tokenID}/history

Parameters

Name	Type	In	Description
tokenID	string	path	Required. The ID of the token

Query Parameters

Name	Type	Required	Description
page	integer	No	Page number (default: 1)
per_page	integer	No	Items per page (default: 20)
start_date	string	No	Start date filter in ISO 8601 format (e.g., 2025-01-01T00:00:00Z)
end_date	string	No	End date filter in ISO 8601 format (e.g., 2025-12-31T23:59:59Z)
changed_by	string	No	Filter by the ID of the supervisor who made the change

Headers

Name	Description
Authorization	Required. Bearer token for authentication
Content-Type	Required. Must be application/json

Example

curl --location 'http://localhost:3453/v2/admin/tokens/6901599cbd0fb7ece2803764/history?page=1&per_page=20&start_date=2025-01-01T00%3A00%3A00Z&end_date=2025-12-31T23%3A59%3A59Z' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJRCI6IjhmMzEwOWExLTYyMmMtNDVhZC1hYjI4LTg0ODE5N2ZiMDYwYSIsImV4cGlyYXRpb24iOjE3NjMwNzg1MjQsInN1cGVydmlzb3JFbWFpbCI6InViZXJAYXBleC5jb20iLCJzdXBlcnZpc29ySUQiOiI2NjViMzcyZjNhNzJkN2QwNzkxNTk2YmEiLCJzdXBlcnZpc29yTm9kZUlEIjoiNjY1YWU1MzZhNjM5MmI3NWNmZDQwMzUyIiwic3VwZXJ2aXNvck5vZGVJbnRJRCI6MSwic3VwZXJ2aXNvck5vZGVQYXRoIjoiMSIsInN1cGVydmlzb3JSb2xlSUQiOiI2NjVhZTc5NjEwY2UyMTZkYmMzNWM5M2IiLCJzdXBlcnZpc29yUm9sZVByaW9yaXR5IjoxMDB9.5e1neSV0QQmYGIs42Z9qarTKY3pkSQWutDnl34xYg04'

Response

{
    "data": [
        {
            "id": "698619c3309c93aca937c695",
            "token_id": "6983383ae2cb4cfb988cacaf",
            "node_id": "698333bbe2cb4cfb988cacab",
            "value": {
                "token_price": {
                    "id": "695f5f89281d52b947e8f5a7",
                    "amount": 1.12,
                    "decimal": 6,
                    "symbol": "VUSD",
                    "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
                },
                "max_supply": 10000,
                "total_value": {
                    "id": "695f5f89281d52b947e8f5a7",
                    "amount": 11200,
                    "decimal": 6,
                    "symbol": "VUSD",
                    "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
                },
                "salable_percentage": 100,
                "salable_value": {
                    "id": "695f5f89281d52b947e8f5a7",
                    "amount": 11200,
                    "decimal": 6,
                    "symbol": "VUSD",
                    "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
                },
                "purchased_supply": 0,
                "listed_supply": 9000,
                "sold_supply": 15,
                "total_fee_supply": 300
            },
            "metric": {
                "term_duration_in_months": 12,
                "min_purchase_quantity": 1,
                "max_purchase_quantity": 1000,
                "min_tokens_required_for_rental_income": 10,
                "rental_income": {
                    "id": "695f5f89281d52b947e8f5a7",
                    "amount": 1,
                    "decimal": 6,
                    "symbol": "VUSD",
                    "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
                },
                "rental_payment_period_in_days": 30,
                "rental_payment_start_date": "2026-03-06T12:17:20.996Z",
                "listing_date": "2026-02-04T12:17:20.996Z",
                "expiration_date": "2027-02-04T12:17:20.996Z"
            },
            "created_at": "2026-02-06T16:41:39.864Z"
        },
        {
            "id": "69833840768b481e22b3d79b",
            "token_id": "6983383ae2cb4cfb988cacaf",
            "node_id": "698333bbe2cb4cfb988cacab",
            "changed_by": "665b372f3a72d7d0791596ba",
            "value": {
                "token_price": {
                    "id": "695f5f89281d52b947e8f5a7",
                    "amount": 1,
                    "decimal": 6,
                    "symbol": "VUSD",
                    "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
                },
                "max_supply": 10000,
                "total_value": {
                    "id": "695f5f89281d52b947e8f5a7",
                    "amount": 10000,
                    "decimal": 6,
                    "symbol": "VUSD",
                    "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
                },
                "salable_percentage": 100,
                "salable_value": {
                    "id": "695f5f89281d52b947e8f5a7",
                    "amount": 10000,
                    "decimal": 6,
                    "symbol": "VUSD",
                    "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
                },
                "purchased_supply": 0,
                "listed_supply": 0,
                "sold_supply": 0,
                "total_fee_supply": 300
            },
            "metric": null,
            "created_at": "2026-02-04T12:14:56.893Z"
        }
    ],
    "total": 2,
    "page": 1,
    "per_page": 20
}

Response Fields

Field	Type	Description
data	array	List of token history records
data[].id	string	Unique identifier for the history record
data[].token_id	string	ID of the token
data[].node_id	string	ID of the associated node
data[].changed_by	string	ID of the supervisor who made the change (optional; may be omitted)
data[].value	object	Token value snapshot at the time of change
data[].metric	object | null	Token metric snapshot at the time of change
data[].created_at	string	ISO 8601 timestamp when the change was made
total	integer	Total number of history records
page	integer	Current page number
per_page	integer	Number of items per page

Value Data Fields (data[].value)

Field	Type	Description
token_price	object	Price object for 1 token value
max_supply	integer	Max supply of the token
total_value	object	Total value (price object)
salable_percentage	number	Percentage of tokens that are salable
salable_value	object	Salable value (price object)
purchased_supply	integer	Purchased supply of the token
listed_supply	integer	Listed supply of the token
sold_supply	integer	Sold supply of the token
total_fee_supply	integer	Total fee supply of the token

Metric Data Fields (data[].metric)

Field	Type	Description
term_duration_in_months	integer | null	Duration of the token term in months
min_purchase_quantity	integer	Minimum purchase quantity
max_purchase_quantity	integer	Maximum purchase quantity
min_tokens_required_for_rental_income	integer	Minimum tokens required for rental income
rental_income	object	Rental income (price object)
rental_payment_period_in_days	integer	Rental payment period in days
rental_payment_start_date	string | null	ISO 8601 timestamp when rental payments start
listing_date	string | null	ISO 8601 timestamp when token is listed
expiration_date	string | null	ISO 8601 timestamp when token expires

Status Codes

Status Code	Description
200	Success - Token history retrieved successfully
400	Bad Request - Invalid request parameters
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Token ID does not exist
500	Internal Server Error