Token Kira Ödemelerini Getir

Bir token'ın ürettiği tek tek kira geliri ödemelerinden bir sayfayı döndürür: tüm dağıtımlar boyunca sahip ve dağıtım başına bir satır, en yeniden eskiye. Satırları bir dağıtımla eşleştirmek için external_id alanına göre gruplayın ve Token Dağıtımlarını Getir ile karşılaştırın.

Gerekli izin: token:transactions:view

İstek

GET /v2/admin/tokens/{token_id}/rents?page=1&per_page=20

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token id'si.
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar.
per_page	integer	query	Zorunlu. Sayfa boyutu, 1 ile 100 arası.

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/rents?page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6a8b6f05f9129816a6cc7b44",
      "user_id": "6a2f0b7e1c9d4e3f2a1b0c9d",
      "token_id": "67d8774e903bfcbe7eb5d93e",
      "deposit_id": "6a8b6f02f9129816a6cc7b30",
      "external_id": 3,
      "per_price": {
        "id": "68fe8c129367fd414b227c7a",
        "amount": "0.1",
        "decimal": 6,
        "symbol": "USDT",
        "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
      },
      "total_price": {
        "id": "68fe8c129367fd414b227c7a",
        "amount": "2.5",
        "decimal": 6,
        "symbol": "USDT",
        "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
      },
      "contract_created_at": "2025-05-01T10:00:12.381Z",
      "created_at": "2025-05-01T10:00:13.002Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data[].id	string	Ödeme id'si.
data[].user_id	string	Ödeme alan sahip.
data[].token_id	string	Token id'si.
data[].deposit_id	string	Ödemenin ait olduğu dağıtım.
data[].external_id	integer	Dağıtımın zincir üstündeki id'si; dağıtımın external_id değeriyle eşleşir.
data[].per_price	price | null	Bir token'ın kazandığı tutar.
data[].total_price	price | null	per_price × sahibin dağıtım anındaki miktarı.
data[].contract_created_at	string | null	Dağıtımın zincire kaydedildiği zaman.
data[].created_at	string	Satırın oluşturulduğu zaman.
total	integer	Ödeme sayısı.
page	integer	İstekte gönderilen sayfa numarası.
per_page	integer	İstekte gönderilen sayfa boyutu.

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	10015	Doğrulama başarısız (page ya da per_page eksik veya aralık dışı) — details alanına bakın
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.