Satın Alma Hacmini Al

Bir düğümün ve tüm alt düğümlerinin satın alma hacmi zaman serisini döndürür: üst düğümün rakamları alt düğümlerininkini de içerir. Hacim, alt ağacın tüm pazarlardaki sonuçlanmış satın almalarının miktar × fiyat toplamıdır; sayı ise satın alma sayısıdır. Rakamlar platformun periyodik olarak yenilediği istatistiklerden gelir; bu yüzden en yeni satın almaların 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/purchase-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/purchase-volume?start_time=2026-08-01T00:00:00Z&end_time=2026-10-31T23:59:59Z' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "volume": "185000",
      "totalVolume": "1240000",
      "count": 37,
      "totalCount": 212,
      "createdAt": "2026-09-30T23:00:00Z",
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC"
    },
    {
      "volume": "4200.5",
      "totalVolume": "4200.5",
      "count": 3,
      "totalCount": 3,
      "createdAt": "2026-10-28T16:00:00Z",
      "currencyTokenId": "6901a7c2e4b5d6f708a9b0c1",
      "currencySymbol": "USDC"
    }
  ],
  "baselineVolume": "1055000",
  "baselineCount": 175,
  "summary": {
    "totalVolume": "1244200.5",
    "volume": "189200.5",
    "totalCount": 215,
    "count": 40
  },
  "currencySummaries": [
    {
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC",
      "volume": "185000",
      "count": 37,
      "totalVolume": "1240000",
      "totalCount": 212
    },
    {
      "currencyTokenId": "6901a7c2e4b5d6f708a9b0c1",
      "currencySymbol": "USDC",
      "volume": "4200.5",
      "count": 3,
      "totalVolume": "4200.5",
      "totalCount": 3
    }
  ]
}

Örnek, birden fazla para birimi olduğunda summary alanının neden tek bir tutar olarak okunmaması gerektiğini gösteriyor: TRYC ile USDC'yi birbirine ekler. currencySummaries alanını kullanın ya da Döviz Kurlarını Al ile çevirin.

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 satın alma hacmi
data[].totalVolume	string	Bu grubun sonundaki tüm zamanların kümülatif satın alma hacmi
data[].count	integer	Bu gruptaki satın alma sayısı
data[].totalCount	integer	Bu grubun sonundaki tüm zamanların kümülatif satın alma sayısı
data[].createdAt	string	Gruptaki en yeni istatistik satırının zamanı (ISO 8601)
data[].currencyTokenId	string	Satın almaların ödendiği para birimi tokenı
data[].currencySymbol	string	Bu para birimi tokenının sembolü
baselineVolume	string	start_time öncesindeki kümülatif hacim. start_time gönderilmezse "0".
baselineCount	integer	start_time öncesindeki kümülatif sayı. start_time gönderilmezse 0.
summary.volume	string	data[].volume toplamı: pencerenin hacmi
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 hacmi
currencySummaries[].count	integer	Bu para birimindeki pencere sayısı
currencySummaries[].totalVolume	string	Pencere boyunca bu para biriminde ulaşılan en yüksek kümülatif hacim
currencySummaries[].totalCount	integer	Pencere boyunca bu para biriminde ulaşılan en yüksek kümülatif sayı

summary ve başlangıç değerleri (baseline) tüm para birimlerini birbirine ekler. 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.