Token'ları Listele

Satıştaki token'ların (durum 6, listelenmiş) bir sayfasını en yeniden eskiye döndürür; her biri oran değişimleriyle ve üzerinde ne yapılabileceğini söyleyen bayraklarla gelir: is_public, is_open_to_secondary_market, is_open_to_otc ve is_external. node_id listeyi tek bir düğümün token'larına daraltır; verilmezse tüm düğümlerin token'ları listelenir. Hiçbir şeyle eşleşmeyen filtre boş bir sayfa döndürür.

Token'ı Getir ucunda olduğu gibi value ve metric, token'ın en son onaylanmış geçmiş kaydından okunur; zinciri bekleyen bir değişiklik henüz gösterilmez.

Gerekli izin: token:view

İstek

GET /v2/users/tokens

Parametreler

Ad	Tip	Konum	Açıklama
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100
node_id	string	query	Yalnızca bu düğümün token'ları (24 karakterlik hex ID)

Başlıklar

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

Örnek

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

Yanıt

{
  "data": [
    {
      "id": "68ae06cfcccf4e8fc19362d1",
      "category_id": "667e9251ca818a2138ed4885",
      "origin": 0,
      "standard": 0,
      "node_id": "665ae536a6392b75cfd40352",
      "created_by_id": "68d280bbc58073cdf5642d20",
      "node_name": "",
      "status": 6,
      "is_mintable": false,
      "is_public": false,
      "is_open_to_secondary_market": true,
      "is_open_to_otc": true,
      "is_external": false,
      "name": "Sample Token",
      "description": "A sample token for demonstration purposes",
      "token_name": "Sample",
      "token_symbol": "STK",
      "node_contract": {
        "diamond_address": "0x730d22ae2267fc5b40520605868ddb48c29331a7"
      },
      "meta": {
        "images": [
          {
            "url": "https://cdn.example.com/tokens/68ae06cfcccf4e8fc19362d1/cover.png",
            "is_default": true
          }
        ],
        "documents": []
      },
      "contract": {
        "address": "0x4ecde4b1b0a8f7a5d5c1e0f1a2b3c4d5e6f78387",
        "tx_hash": "0x9c1f0e7d3b5a2c4e6f8a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e"
      },
      "value": {
        "token_price": {
          "amount": "1.12",
          "decimal": 6,
          "symbol": "VUSD",
          "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
        },
        "total_value": {
          "amount": "11200",
          "decimal": 6,
          "symbol": "VUSD",
          "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
        },
        "salable_percentage": "100",
        "salable_value": {
          "amount": "11200",
          "decimal": 6,
          "symbol": "VUSD",
          "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
        },
        "max_supply": 10000,
        "listed_supply": 8000,
        "sold_supply": 1200
      },
      "distribution_token": null,
      "metric": {
        "term_duration_in_months": 12,
        "min_purchase_quantity": 1,
        "max_purchase_quantity": 100,
        "min_tokens_required_for_rental_income": 10,
        "rental_income": {
          "amount": "50",
          "decimal": 6,
          "symbol": "VUSD",
          "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
        },
        "rental_payment_period_in_days": 30,
        "rental_payment_start_date": "2026-12-01T00:00:00Z",
        "listing_date": "2026-11-01T00:00:00Z"
      },
      "hourly_rate_change": null,
      "daily_rate_change": {
        "start_date": "2026-11-09T00:05:12Z",
        "end_date": "2026-11-09T09:40:03Z",
        "start_value": "1.1",
        "end_value": "1.12",
        "rate": "1.81",
        "change_type": 1
      },
      "weekly_rate_change": null,
      "monthly_rate_change": null,
      "quarterly_rate_change": null,
      "created_at": "2026-10-30T12:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Her öğe Token'ı Getir sayfasında açıklanan token biçimindedir; tek fark, bu uçta node_name alanının boş olmasıdır.

Alan	Tip	Açıklama
data	array	Bu sayfadaki token'lar
total	integer	Filtreye uyan listelenmiş token sayısı
page	integer	İstenen sayfa
per_page	integer	İstenen sayfa boyutu

meta.documents[].url, belgeyi 15 dakika boyunca açan ve her okumada yeniden üretilen imzalı bir bağlantıdır; saklamak yerine yeni bir bağlantı için token'ı tekrar okuyun.

Hatalar

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

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