Token Yatırımcılarını Getir

Bir token'ı şu anda tutan kullanıcılardan bir sayfayı, en büyük pozisyondan başlayarak döndürür. Yalnızca mevcut sahipler listelenir: satın alıp ardından her şeyini satan biri artık yatırımcı değildir. Birden fazla cüzdanı olan bir sahip, pozisyonu bu cüzdanlar üzerinden toplanmış tek bir satırdır.

Gerekli izin: token:view

İstek

GET /v2/admin/tokens/{token_id}/investors?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ı.
search	string	query	İsteğe bağlı. Kullanıcının adı, soyadı ya da e-postasıyla eşleşir.

Başlıklar

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

Örnek

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

Yanıt

{
  "data": [
    {
      "id": "6a2f0b7e1c9d4e3f2a1b0c9d",
      "email": "investor@example.com",
      "name": "Ayse",
      "surname": "Yilmaz",
      "has_kyc_token": true,
      "created_at": "2025-02-11T14:20:05.118Z",
      "holding": {
        "remaining_quantity": 25,
        "total_purchased": 40,
        "total_purchased_amount": "384",
        "wallet_count": 2
      }
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data[].id	string	Kullanıcı id'si (yatırımcı id'si).
data[].email	string	E-posta.
data[].name	string	Ad. Kayıtta yoksa yer almaz.
data[].surname	string	Soyad. Kayıtta yoksa yer almaz.
data[].has_kyc_token	boolean	Kullanıcının cüzdanlarından en az biri bir KYC token'ı tutuyor. KYC kullanıcı kaydına değil cüzdana aittir.
data[].created_at	string	Kullanıcının kayıt olduğu zaman.
data[].holding.remaining_quantity	integer	Şu anda tutulan token'lar, kullanıcının cüzdanları üzerinden toplanmış.
data[].holding.total_purchased	integer	Şimdiye kadar satın alınan token'lar. Kullanıcı sattığında remaining_quantity değerinden farklılaşır.
data[].holding.total_purchased_amount	string	total_purchased için ödenen tutar, ondalık string.
data[].holding.wallet_count	integer	Kullanıcının bu token'ı tutan cüzdan sayısı.
total	integer	Eşleşen yatırımcı sayısı.
page	integer	İstekte gönderilen sayfa numarası.
per_page	integer	İstekte gönderilen sayfa boyutu.

Yanıt cüzdan adresi içermez: adresler kullanıcının cüzdanlarına aittir.

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.