Token'ları Listele

Bir düğümün token'larından bir sayfayı en yeniden eskiye döndürür; kategori, köken, durum ve bayrak filtreleri isteğe bağlıdır. Liste her zaman tek bir düğümle (node_id) sınırlıdır ve çağıranın düğümü bu düğüm ya da onun üst düğümlerinden biri olmalıdır. Hiçbir şeyle eşleşmeyen bir filtre 404 değil, boş bir sayfa döndürür.

Gerekli izin: token:view

İstek

GET /v2/admin/tokens?node_id={node_id}&page=1&per_page=20

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	query	Zorunlu. Token'ları listelenecek düğüm.
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar.
per_page	integer	query	Zorunlu. Sayfa boyutu, 1 ile 100 arası.
category_id	string	query	İsteğe bağlı. Yalnızca bu kategorideki token'lar. Birden fazlası için parametreyi tekrarlayın (?category_id=a&category_id=b). Yaprak olmayan bir kategori tüm dalı kapsar: alt kategorilerine kayıtlı token'lar da döner. Bilinmeyen bir kategori reddedilir.
origin	integer	query	İsteğe bağlı. Yalnızca bu kökendeki token'lar: 0 platform, 1 harici.
statuses	integer	query	İsteğe bağlı. Yalnızca bu token durumları (bkz. Token durumu). Birden fazlası için tekrarlayın (?statuses=4&statuses=6).
is_rental_payment_active	boolean	query	İsteğe bağlı. true ise yalnızca metric.rental_payment_start_date alanı dolu olan token'lar.
is_expiration_active	boolean	query	İsteğe bağlı. true ise yalnızca metric.expiration_date alanı dolu ve geçmişte kalan token'lar.
is_not_deleted	boolean	query	İsteğe bağlı. true ise silinmiş token'lar dışarıda kalır. Gönderilmezse silinmiş token'lar da deleted_at dolu olarak listelenir.

Bir bayrağı false göndermek yerine hiç göndermeyin: false, gönderilmemiş gibi okunur.

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/tokens?node_id=67d6c447f47ff3adafda700d&page=1&per_page=20&statuses=6&is_not_deleted=true' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "67d8774e903bfcbe7eb5d93e",
      "category_id": "667e9251ca818a2138ed4915",
      "node_id": "67d6c447f47ff3adafda700d",
      "created_by_id": "",
      "network_id": "6740e0a20000000000000103",
      "setup_id": "6a837bb62998e4fbfed7f52a",
      "status": 6,
      "origin": 0,
      "standard": 0,
      "name": "TKN Token Name",
      "description": "Token Description",
      "token_name": "tkn",
      "token_symbol": "TKN",
      "is_public": false,
      "is_api": true,
      "is_open_to_otc": false,
      "is_open_to_secondary_market": false,
      "is_mintable": false,
      "oracle": null,
      "meta": {
        "images": [
          {
            "url": "https://cdn.example.com/dev/token/67d8774e903bfcbe7eb5d93e/images/9e6e15fc-57ea-4de9-a2e1-9ee945908ce1.png",
            "is_default": true
          }
        ],
        "documents": [
          {
            "id": "67d8774e903bfcbe7eb5d940",
            "name": "prospectus.pdf",
            "url": "https://bucket.s3.amazonaws.com/dev/token/67d8774e903bfcbe7eb5d93e/documents/0d295c7d-fff2-40fc-a184-3119c14ef61a.pdf?X-Amz-Expires=900&X-Amz-Signature=...",
            "type": 1,
            "tx_hash": "0x5b1d0c2e7f3a9b84c6d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"
          }
        ]
      },
      "contract": {
        "address": "0x730d22ae2267fc5b40520605868ddb48c29331a7",
        "tx_hash": "0x4ecde457e62f7d6b296bf9f798bff25e62c7b9971dab89d07edcf16a073b8387"
      },
      "value": {
        "token_price": {
          "id": "68fe8c129367fd414b227c7a",
          "amount": "9.6",
          "decimal": 6,
          "symbol": "USDT",
          "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
        },
        "total_value": {
          "id": "68fe8c129367fd414b227c7a",
          "amount": "12000",
          "decimal": 6,
          "symbol": "USDT",
          "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
        },
        "salable_percentage": "80",
        "salable_value": {
          "id": "68fe8c129367fd414b227c7a",
          "amount": "9600",
          "decimal": 6,
          "symbol": "USDT",
          "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
        },
        "max_supply": 1000,
        "listed_supply": 800,
        "sold_supply": 200,
        "purchased_supply": 0
      },
      "metric": null,
      "distribution_token": null,
      "created_at": "2025-03-17T19:26:06.905Z",
      "deleted_at": null
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Bu sayfadaki token'lar; biçimi Token Getir yanıtıyla aynıdır (category olmadan). Silinmiş görsel ve belgeler yer almaz.
total	integer	Filtrelerle eşleşen token sayısı.
page	integer	İstekte gönderilen sayfa numarası.
per_page	integer	İstekte gönderilen 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 (node_id, page ya da per_page eksik veya aralık dışı) — details alanına bakın
400	10016	node_id ya da bir category_id geçerli bir id değil
400	10001	Düğüm bulunamadı (düğüm domain'i 2)
403	10005	Çağıranın düğümü bu düğümü kapsamıyor (düğüm domain'i 2)
400	10001	Bir category_id hiçbir kategoriye karşılık gelmiyor (kategori domain'i 4)

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