Token Yatırımcısını Getir

Bir token'ın tek bir sahibini, Token Yatırımcılarını Getir satırı biçiminde döndürür. Aranan şey pozisyondur: token'dan hiç tutmayan bir kullanıcı (tüm pozisyonunu satmış biri dahil) bulunamadı olarak raporlanır.

Gerekli izin: token:view

İstek

GET /v2/admin/tokens/{token_id}/investors/{investor_id}

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token id'si.
investor_id	string	path	Zorunlu. Yatırımcının kullanıcı id'si.

Başlıklar

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

Örnek

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

Yanıt

{
  "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
  }
}

Yanıt Alanları

Alan	Tip	Açıklama
id	string	Kullanıcı id'si.
email	string	E-posta.
name	string	Ad. Kayıtta yoksa yer almaz.
surname	string	Soyad. Kayıtta yoksa yer almaz.
has_kyc_token	boolean	Kullanıcının cüzdanlarından en az biri bir KYC token'ı tutuyor.
created_at	string	Kullanıcının kayıt olduğu zaman.
holding.remaining_quantity	integer	Şu anda tutulan token'lar, kullanıcının cüzdanları üzerinden toplanmış.
holding.total_purchased	integer	Şimdiye kadar satın alınan token'lar.
holding.total_purchased_amount	string	total_purchased için ödenen tutar, ondalık string.
holding.wallet_count	integer	Kullanıcının bu token'ı tutan cüzdan sayısı.

Hatalar

Durum	Kod	Açıklama
400	10016	token_id ya da investor_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)
400	10001	Kullanıcı token'ı tutmuyor ya da yok (kullanıcı domain'i 1)

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