Kira Özetini Getir

Bir token'ın bir sonraki kira geliri dağıtımının ne ödeyeceğini ve kaç sahibe ödeyeceğini gösterir. Kira Geliri Dağıt çağrısından önce okuyun. Sayılar yalnızca ödeme alacak sahipleri kapsar: min_tokens_for_income altında kalan bir sahip (cüzdanları toplandıktan sonra) hiçbir şey almaz ve dışarıda kalır; bu yüzden investor_count genellikle sahip sayısından düşüktür.

Kira koşulları olmayan bir token da aynı biçimde yanıt verir: rental_configured false ve fiyatlar sıfırdır.

Gerekli izin: token:transactions:view

İstek

GET /v2/admin/tokens/{token_id}/rental-summary

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token id'si.

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/rental-summary' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "token_id": "67d8774e903bfcbe7eb5d93e",
  "investor_count": 12,
  "total_token_count": 180,
  "distribution_per_token": {
    "id": "68fe8c129367fd414b227c7a",
    "amount": "0.1",
    "decimal": 6,
    "symbol": "USDT",
    "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
  },
  "total_distribution": {
    "id": "68fe8c129367fd414b227c7a",
    "amount": "18",
    "decimal": 6,
    "symbol": "USDT",
    "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
  },
  "min_tokens_for_income": 10,
  "rental_configured": true
}

Yanıt Alanları

Alan	Tip	Açıklama
token_id	string	Token id'si.
investor_count	integer	Ödeme alacak sahipler. rental_configured false olduğunda sahip sayısı.
total_token_count	integer	Bu sahiplerin tuttuğu token'lar. rental_configured false olduğunda 0.
distribution_per_token	price	Bir token'ın tek dağıtımda kazandığı tutar.
total_distribution	price	distribution_per_token × total_token_count: dağıtımın hareket ettireceği tutar.
min_tokens_for_income	integer	Token'ın metric.min_tokens_required_for_rental_income değeri; sayıların filtrelendiği eşik.
rental_configured	boolean	Token için kira geliri ayarlanmamışsa false.

Bir price, amount alanı ondalık string olan {id, amount, decimal, symbol, address} nesnesidir; bkz. Tutarlar ve Yüzdeler.

Hatalar

Durum	Kod	Açıklama
400	10016	token_id geçerli bir id değil
400	10001	Token bulunamadı (token domain'i 5)
403	10005	Çağıranın düğümü token'ın düğümünü kapsamıyor (düğüm domain'i 2)

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