ID ile Token Geçmişi

Belirtilen token için değişiklik geçmişini sayfalama ve isteğe bağlı olarak tarih aralığı ve changed_by ile filtreleme seçenekleriyle getirir.

İstek

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

Parametreler

Ad	Tip	Konum	Açıklama
tokenID	string	path	Zorunlu. Token kimliği

Sorgu Parametreleri

Ad	Tip	Zorunlu	Açıklama
page	integer	Hayır	Sayfa numarası (varsayılan: 1)
per_page	integer	Hayır	Sayfa başına öğe sayısı (varsayılan: 20)
start_date	string	Hayır	Başlangıç tarihi filtresi ISO 8601 formatında (örn., 2025-01-01T00:00:00Z)
end_date	string	Hayır	Bitiş tarihi filtresi ISO 8601 formatında (örn., 2025-12-31T23:59:59Z)
changed_by	string	Hayır	Değişikliği yapan denetçinin kimliğine göre filtre

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Kimlik doğrulama için Bearer token
Content-Type	Zorunlu. application/json olmalı

Örnek

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'

Yanıt

{
    "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
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Token geçmişi kayıtlarının listesi
data[].id	string	Geçmiş kaydı için benzersiz tanımlayıcı
data[].token_id	string	Token kimliği
data[].node_id	string	İlişkili node kimliği
data[].changed_by	string	Değişikliği yapan denetçinin kimliği (opsiyonel; olmayabilir)
data[].value	object	Değişiklik anındaki token değer anlık görüntüsü
data[].metric	object | null	Değişiklik anındaki token metrik anlık görüntüsü
data[].created_at	string	Değişikliğin yapıldığı ISO 8601 zaman damgası
total	integer	Toplam geçmiş kayıt sayısı
page	integer	Mevcut sayfa numarası
per_page	integer	Sayfa başına öğe sayısı

Değer Veri Alanları (data[].value)

Alan	Tip	Açıklama
token_price	object	1 token değerini temsil eden fiyat nesnesi
max_supply	integer	Token maksimum arzı
total_value	object	Toplam değer (fiyat nesnesi)
salable_percentage	number	Satılabilir token yüzdesi
salable_value	object	Satılabilir değer (fiyat nesnesi)
purchased_supply	integer	Satın alınan arz
listed_supply	integer	Listelenen arz
sold_supply	integer	Satılan arz
total_fee_supply	integer	Toplam ücret arzı

Metrik Veri Alanları (data[].metric)

Alan	Tip	Açıklama
term_duration_in_months	integer | null	Token süresinin ay cinsinden süresi
min_purchase_quantity	integer	Minimum satın alma miktarı
max_purchase_quantity	integer	Maksimum satın alma miktarı
min_tokens_required_for_rental_income	integer	Kira geliri için gerekli minimum token sayısı
rental_income	object	Kira geliri (fiyat nesnesi)
rental_payment_period_in_days	integer	Kira ödeme dönemi (gün cinsinden)
rental_payment_start_date	string | null	Kira ödemelerinin başlayacağı ISO 8601 zaman damgası
listing_date	string | null	Token listeleme ISO 8601 zaman damgası
expiration_date	string | null	Token bitiş/son kullanma ISO 8601 zaman damgası

Durum Kodları

Durum Kodu	Açıklama
200	Başarılı - Token geçmişi başarıyla getirildi
400	Hatalı İstek - Geçersiz istek parametreleri
401	Yetkisiz - Geçersiz veya eksik kimlik doğrulama token'ı
404	Bulunamadı - Token kimliği mevcut değil
500	Sunucu Hatası