Düğüm Yatırımcılarını Listele

Düğümün (node) token'larından pozitif bakiye tutan kullanıcıları sayfalı olarak listeler. Satırlar varlık başına değil yatırımcı başınadır: düğümün birden çok token'ını tutan ya da bunları birden çok cüzdanda tutan bir kullanıcı bir kez görünür.

Gerekli izin: node:investors:view

İstek

GET /v2/admin/nodes/{node_id}/investors

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Düğümün kimliği
search	string	query	Kullanıcının adı, soyadı veya e-postasında büyük/küçük harf duyarsız kısmi eşleşme
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/admin/nodes/6a4bef2b1e781b11c22e9707/investors?page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6a60b2d1c3e4f50012ab9f01",
      "email": "investor@example.com",
      "name": "John",
      "surname": "Smith",
      "has_kyc_token": true,
      "created_at": "2026-05-04T10:15:42.3Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Yatırımcılar
data[].id	string	Kullanıcı kimliği
data[].email	string	E-posta adresi
data[].name	string	Ad. Ayarlanmamışsa gönderilmez
data[].surname	string	Soyad. Ayarlanmamışsa gönderilmez
data[].has_kyc_token	boolean	Kullanıcının cüzdanlarından en az biri KYC token'ı tutuyorsa true. KYC kullanıcıya değil cüzdana aittir
data[].created_at	string	Kullanıcının kayıt zamanı (ISO 8601)
total	integer	Filtreye uyan yatırımcı sayısı
page	integer	Sayfa numarası
per_page	integer	Sayfa başına kayıt

Satırlar adres taşımaz: kullanıcının adresleri cüzdanlarına aittir ve bir yatırımcı düğümün token'larını birden çok cüzdanda tutabilir.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (örneğin eksik page veya per_page) — details alanına bakın
400	10016	node_id geçerli bir kimlik değil
400	10001	Düğüm bulunamadı (düğüm domain'i 2)
403	10005	Düğüm, hiyerarşide sizin erişebildiğiniz kısmın dışında (düğüm domain'i 2)

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