OTC Hacmini Al

Bir düğümün ve tüm alt düğümlerinin OTC hacmi zaman serisini döndürür: üst düğümün rakamları alt düğümlerininkini de içerir. Hacim, alt ağacın kabul edilmiş OTC tekliflerinin satılan miktar × fiyat toplamıdır; sayı ise satılan token sayısıdır (teklif sayısı değil). Rakamlar platformun periyodik olarak yenilediği istatistiklerden gelir; bu yüzden en yeni işlemlerin 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/otc-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/otc-volume?start_time=2026-11-01T00:00:00Z&end_time=2026-11-02T23:59:59Z' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "volume": "36000",
      "totalVolume": "512000",
      "count": 30,
      "totalCount": 420,
      "createdAt": "2026-11-01T14:00:00Z",
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC"
    }
  ],
  "baselineVolume": "476000",
  "baselineCount": 390,
  "summary": {
    "totalVolume": "512000",
    "volume": "36000",
    "totalCount": 420,
    "count": 30
  },
  "currencySummaries": [
    {
      "currencyTokenId": "68fe8c129367fd414b227c7a",
      "currencySymbol": "TRYC",
      "volume": "36000",
      "count": 30,
      "totalVolume": "512000",
      "totalCount": 420
    }
  ]
}

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 OTC hacmi
data[].totalVolume	string	Bu grubun sonundaki tüm zamanların kümülatif OTC hacmi
data[].count	integer	Bu grupta satılan token sayısı
data[].totalCount	integer	Bu grubun sonundaki tüm zamanların kümülatif satılan token sayısı
data[].createdAt	string	Gruptaki en yeni istatistik satırının zamanı (ISO 8601)
data[].currencyTokenId	string	Tekliflerin fiyatlandığı 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 satılan token sayısı. 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 biriminde pencerede satılan token 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. Alt ağaç birden fazla para biriminde işlem yapı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.