Token Dağıtımlarını Getir

Bir token'ın kira geliri dağıtımlarından bir sayfayı en yeniden eskiye döndürür. Her satır, Kira Geliri Dağıt ile başlatılmış bir dağıtımdır; arkasındaki zincir üstü işlemi ve ona eklenen belgeleri içerir. Bir dağıtımın tek tek ödemeleri Token Kira Ödemelerini Getir içindedir ve external_id ile eşleşir.

Gerekli izin: token:transactions:view

İstek

GET /v2/admin/tokens/{token_id}/deposits?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/deposits?page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6a8b6f02f9129816a6cc7b30",
      "token_id": "67d8774e903bfcbe7eb5d93e",
      "external_id": 3,
      "status": 0,
      "contract_created_at": "2025-05-01T10:00:12.381Z",
      "total_price": {
        "id": "68fe8c129367fd414b227c7a",
        "amount": "18",
        "decimal": 6,
        "symbol": "USDT",
        "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
      },
      "per_price": {
        "id": "68fe8c129367fd414b227c7a",
        "amount": "0.1",
        "decimal": 6,
        "symbol": "USDT",
        "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
      },
      "transaction": {
        "id": "6a8b5e13f9129816a6cc7a12",
        "node_id": "67d6c447f47ff3adafda700d",
        "user_id": "",
        "token_id": "67d8774e903bfcbe7eb5d93e",
        "hash": "0x998a217061da05cf1bf1998470613a488b10908f0964e76a123c4063f91d77c4",
        "type": 3,
        "status": 3,
        "error": null,
        "is_api": true,
        "created_at": "2025-05-01T09:59:58.104Z"
      },
      "documents": [
        {
          "id": "6a8b6f02f9129816a6cc7b31",
          "name": "invoice-2025-04.pdf",
          "url": "https://bucket.s3.amazonaws.com/dev/deposit/6a8b6f02f9129816a6cc7b30/invoice.pdf?X-Amz-Expires=900&X-Amz-Signature=...",
          "type": 1,
          "hash": "9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b",
          "tx_hash": null,
          "created_at": "2025-05-01T09:59:57.950Z"
        }
      ],
      "created_at": "2025-05-01T10:00:12.381Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data[].id	string	Dağıtım (deposit) id'si.
data[].token_id	string	Token id'si.
data[].external_id	integer	Dağıtımın zincir üstündeki id'si. Token Kira Ödemelerini Getir içindeki ödemeler aynı değeri taşır.
data[].status	integer	0 sonuçlandı (para hareket etti), 1 zincir onayı bekleniyor, 2 işlem başarısız olduğu için iptal edildi.
data[].contract_created_at	string	Dağıtımın zincire kaydedildiği zaman.
data[].total_price	price	Dağıtımın toplam ödediği tutar.
data[].per_price	price	Token başına ödenen tutar.
data[].transaction	object | null	Dağıtımın arkasındaki TokenRent işlemi, Token İşlemlerini Listele satırı biçiminde: status, hash ve error alanlarını okuyun. Dağıtım, işlemine bağlantıdan önce oluşturulmuşsa ve eşleşme bulunamazsa null.
data[].documents[]	array	Dağıtıma eklenen belgeler (fatura, makbuz): id, name, url, type, hash, tx_hash ve created_at. Kaldırılan belgeler yer almaz; her zaman bir dizidir.
data[].created_at	string	Satırın oluşturulduğu zaman.
total	integer	Dağıtım sayısı.
page	integer	İstekte gönderilen sayfa numarası.
per_page	integer	İstekte gönderilen sayfa boyutu.

documents[].url, belgeyi 15 dakika boyunca açan ve her okumada yeniden üretilen imzalı bir bağlantıdır; saklamayın. 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.