Token'a Göre Kiraları Listele

Kullanıcı için bir token'da kaydedilmiş kira ödemelerini en yeniden eskiye döndürür. Operatör bir kira yatırımını dağıttığında, token'ın min_tokens_required_for_rental_income değeri kadar ya da daha fazlasını tutan her sahip için bir ödeme satırı yazılır. Bir satırı talep etmek için onun external_id değerini rent_id olarak kullanın.

Token'da ödemesi olmayan kullanıcı 404 değil, boş bir sayfa alır.

Gerekli izin: rent:view

İstek

GET /v2/users/{user_id}/rents/tokens/{token_id}

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. Kullanıcı ID'si
token_id	string	path	Zorunlu. Token ID'si
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users/680c02896d91ca0145cfeb81/rents/tokens/68ae06cfcccf4e8fc19362d1?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6913c40155654191dede3810",
      "user_id": "680c02896d91ca0145cfeb81",
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "deposit_id": "6913c3f855654191dede380e",
      "external_id": 1,
      "total_price": {
        "id": "6913307ec95e268b239b2d8b",
        "amount": "2.5",
        "decimal": 6,
        "symbol": "VUSD",
        "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
      },
      "per_price": {
        "id": "6913307ec95e268b239b2d8b",
        "amount": "0.1",
        "decimal": 6,
        "symbol": "VUSD",
        "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
      },
      "contract_created_at": null,
      "created_at": "2026-11-09T09:40:03Z",
      "updated_at": "2026-11-09T09:40:03Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data[].id	string	Ödeme satırı ID'si
data[].user_id	string	Ödemenin ait olduğu sahip
data[].token_id	string	Kiranın ödendiği token
data[].deposit_id	string	Ödemenin geldiği kira yatırımı
data[].external_id	integer	Kira yatırımının zincir üstü ID'si. Kira Talep Et ucuna rent_id olarak gönderin
data[].total_price	object | null	Kullanıcının ödemesi: per_price × dağıtım anında tutulan tam token sayısı. {id, amount, decimal, symbol, address}; amount ondalık string'dir
data[].per_price	object | null	Token başına kira, aynı biçimde
data[].contract_created_at	string | null	Kaydedilmişse zincir üstü oluşturma zamanı (RFC 3339)
data[].created_at	string	Ödemenin kaydedildiği zaman (RFC 3339)
data[].updated_at	string	Son değişiklik (RFC 3339)
total	integer	Ödeme satırı sayısı
page	integer	İstenen sayfa
per_page	integer	İstenen sayfa boyutu

Satırlar bir ödemenin daha önce talep edilip edilmediğini söylemez. Zaten talep edilmiş bir ödemenin talebi 10002 ile reddedilir (bkz. Kira Talep Et).

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (page, per_page) — details alanına bakın
400	10016	user_id ya da token_id geçerli 24 karakterlik hex ID değil
500	10000	Beklenmeyen sunucu hatası

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