Tokenizasyon Hacmini Al

Bir düğümün ve tüm alt düğümlerinin tokenizasyon hacmi zaman serisini döndürür: üst düğümün rakamları alt düğümlerininkini de içerir. Hacim, alt ağaçtaki token'ların para birimi bazında toplam değeridir; sayı ise token sayısıdır. Her grup bunların ne kadar değiştiğini raporlar; bu yüzden değer düştüğünde volume ve count negatif olabilir. Rakamlar platformun periyodik olarak yenilediği istatistiklerden gelir; bu yüzden en yeni değişikliklerin görünmesi biraz zaman alabilir.

Seri zamana göre gruplanır ve para birimi tokenı bazında ayrılır. Hacimler ondalık string değerlerdir. Çoğu yanıtın aksine bu yanıt camelCase alan adları kullanır.

Gerekli izin: node:summary:view

İstek

GET /v2/admin/nodes/{node_id}/analytics/tokenization-volume?start_time={start_time}&end_time={end_time}

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Toplanacak alt ağacın en üstündeki düğüm
start_time	string	query	Pencerenin başlangıcı, RFC 3339 (2026-01-01T00:00:00Z). Varsayılan: şu andan on iki ay önce.
end_time	string	query	Pencerenin sonu, RFC 3339. Varsayılan: şu an.

Grup boyutu pencere uzunluğuna göre belirlenir: 2 güne kadar saatlik, 40 güne kadar haftalık, 400 güne kadar aylık, daha uzunsa yıllık.

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/analytics/tokenization-volume?start_time=2026-10-01T00:00:00Z&end_time=2026-10-31T23:59:59Z' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "volume": "2500000",
      "totalVolume": "14500000",
      "count": 2,
      "totalCount": 11,
      "createdAt": "2026-10-09T14:00:00Z",
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC"
    },
    {
      "volume": "-500000",
      "totalVolume": "14000000",
      "count": 0,
      "totalCount": 11,
      "createdAt": "2026-10-23T09:00:00Z",
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC"
    }
  ],
  "baselineVolume": "12000000",
  "baselineCount": 9,
  "summary": {
    "totalVolume": "14000000",
    "volume": "2000000",
    "totalCount": 11,
    "count": 2
  },
  "currencySummaries": [
    {
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC",
      "volume": "2000000",
      "count": 2,
      "totalVolume": "14500000",
      "totalCount": 11
    }
  ]
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Her (zaman grubu, para birimi tokenı) için bir öğe, eskiden yeniye. Pencerede veri yoksa [].
data[].volume	string	Bu gruptaki tokenize değer değişimi; negatif olabilir
data[].totalVolume	string	Bu grubun sonundaki tokenize değer
data[].count	integer	Bu gruptaki token sayısı değişimi; negatif olabilir
data[].totalCount	integer	Bu grubun sonundaki token sayısı
data[].createdAt	string	Gruptaki en yeni istatistik satırının zamanı (ISO 8601)
data[].currencyTokenId	string	Değerin cinsinden olduğu para birimi tokenı
data[].currencySymbol	string	Bu para birimi tokenının sembolü
baselineVolume	string	start_time öncesindeki tokenize değer. start_time gönderilmezse "0".
baselineCount	integer	start_time öncesindeki token sayısı. start_time gönderilmezse 0.
summary.volume	string	data[].volume toplamı: pencerenin değişimi
summary.count	integer	data[].count toplamı
summary.totalVolume	string	baselineVolume + summary.volume
summary.totalCount	integer	baselineCount + summary.count
currencySummaries	array	Pencerenin para birimi tokenı bazındaki rakamları. data boşsa gönderilmez.
currencySummaries[].currencyTokenId	string	Para birimi tokenı
currencySummaries[].currencySymbol	string	Sembolü
currencySummaries[].volume	string	Bu para birimindeki pencere değişimi
currencySummaries[].count	integer	Bu para birimindeki pencere token sayısı değişimi
currencySummaries[].totalVolume	string	Pencere boyunca bu para biriminde ulaşılan en yüksek tokenize değer
currencySummaries[].totalCount	integer	Pencere boyunca bu para biriminde ulaşılan en yüksek token sayısı

summary ve başlangıç değerleri (baseline) tüm para birimlerini birbirine ekler. Alt ağaç birden fazla para biriminde tokenize ediyorsa currencySummaries alanını okuyun ya da toplamadan önce her para birimini Döviz Kurlarını Al ile çevirin. start_time gönderilmezse başlangıç değerleri sıfırdır; bu durumda summary.totalVolume yalnızca varsayılan on iki aylık pencereyi kapsar.

Hatalar

Durum	Kod	Açıklama
400	10015	start_time veya end_time RFC 3339 biçiminde değil
400	10016	node_id geçerli bir id değil
400	10001	Düğüm bulunamadı
403	10005	Düğüm, API anahtarının düğüm hiyerarşisinin dışında

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.