Ücret Gelirini Al

Bir düğümün ve tüm alt düğümlerinin ücret geliri zaman serisini döndürür: üst düğümün rakamları alt düğümlerinin kazancını da içerir. Her düğümün satırları, o düğümün onaylanmış satın almalarındaki alıcı ve satıcı ücretlerinden aldığı payı; platform sahibi düğümünün satırları ise platform sahibinin tüm satın almalardaki payını kaydeder. 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/fee-revenue?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/fee-revenue?start_time=2026-08-01T00:00:00Z&end_time=2026-10-31T23:59:59Z' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "volume": "1250.5",
      "totalVolume": "8420.75",
      "count": 14,
      "totalCount": 96,
      "createdAt": "2026-08-31T23:00:00Z",
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC"
    },
    {
      "volume": "980",
      "totalVolume": "9400.75",
      "count": 11,
      "totalCount": 107,
      "createdAt": "2026-09-30T23:00:00Z",
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC"
    }
  ],
  "baselineVolume": "7170.25",
  "baselineCount": 82,
  "summary": {
    "totalVolume": "9400.75",
    "volume": "2230.5",
    "totalCount": 107,
    "count": 25
  },
  "currencySummaries": [
    {
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC",
      "volume": "2230.5",
      "count": 25,
      "totalVolume": "9400.75",
      "totalCount": 107
    }
  ]
}

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 grupta kazanılan ücret geliri
data[].totalVolume	string	Bu grubun sonundaki tüm zamanların kümülatif ücret geliri
data[].count	integer	Bu grupta sayılan satın alma sayısı
data[].totalCount	integer	Bu grubun sonundaki tüm zamanların kümülatif sayısı
data[].createdAt	string	Gruptaki en yeni istatistik satırının zamanı (ISO 8601)
data[].currencyTokenId	string	Rakamların cinsinden olduğu para birimi tokenı
data[].currencySymbol	string	Bu para birimi tokenının sembolü
baselineVolume	string	start_time öncesindeki kümülatif ücret geliri. 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 geliri
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 geliri
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 gelir
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. Alt ağaç birden fazla para biriminde kazanıyorsa 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.