Token'ı Getir

Bir istemcinin bir token'ı göstermek ve üzerinde neler sunabileceğine karar vermek için ihtiyaç duyduğu her şeyle birlikte tek bir token döndürür. Son kısmı dört bayrak yanıtlar: is_public (transferler açık), is_open_to_secondary_market ve is_open_to_otc (o piyasanın token için açık olup olmadığı; piyasa ilanları yalnızca şu anda satışta olanı söyler) ve is_external (token burada basılmak yerine bir partner entegrasyonu üzerinden alınır; origin alanının 1 ile ifade ettiği bilgi). Token'ları Listele ucundan farklı olarak silinmemiş her token, durumu ne olursa olsun döndürülür.

value ve metric doğrudan token'dan okunmaz: token'ın en son geçmiş kaydından gelir. Bu nedenle zinciri bekleyen bir yönetici değişikliği onaylanana kadar gösterilmez; zincir dışı bir düzenleme bir sonraki okumada görünür.

Gerekli izin: token:view

İstek

GET /v2/users/tokens/{token_id}

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token ID'si

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users/tokens/68ae06cfcccf4e8fc19362d1' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "id": "68ae06cfcccf4e8fc19362d1",
  "category_id": "667e9251ca818a2138ed4885",
  "origin": 0,
  "standard": 0,
  "node_id": "665ae536a6392b75cfd40352",
  "created_by_id": "68d280bbc58073cdf5642d20",
  "node_name": "Uber",
  "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": [
      {
        "id": "68ae07a1cccf4e8fc19362d4",
        "name": "Valuation report",
        "url": "https://files.example.com/tokens/68ae06cfcccf4e8fc19362d1/valuation.pdf?X-Amz-Expires=900&X-Amz-Signature=...",
        "type": 1
      }
    ]
  },
  "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"
}

Yanıt Alanları

Alan	Tip	Açıklama
id	string	Token ID'si
category_id	string	Kategori ID'si
origin	integer	0 platform token'ı, 1 harici token
standard	integer	Token standardı: 0 ERC-20, 1 ERC-721, 2 ERC-1155, 3 ERC-3643, 4 ERC-4380
node_id	string	Token'ı çıkaran düğüm
created_by_id	string	Token'ı oluşturan yönetici; kaydedilmemişse boş
node_name	string	Token'ı çıkaran düğümün üstündeki hesap düğümünün adı ya da çıkaran düğümün kendi adı
status	integer	0 yok, 1 taslak, 2 işlemde, 3 hata, 4 listelenmemiş, 5 listeden kaldırılmış, 6 listelenmiş, 7 pasif, 8 yakılmış
is_mintable	boolean	Daha fazla arz basılıp basılamayacağı
is_public	boolean	Token transferlerinin açık olup olmadığı
is_open_to_secondary_market	boolean	Token'ın ikincil piyasada ilana çıkarılıp çıkarılamayacağı
is_open_to_otc	boolean	Token üzerinde OTC teklifi verilip verilemeyeceği
is_external	boolean	Bir partner entegrasyonu üzerinden alınan token için true (origin = 1)
name	string	Görünen ad
description	string	Açıklama
token_name	string	Zincir üstü token adı
token_symbol	string	Zincir üstü token sembolü
node_contract.diamond_address	string | null	Token'ı çıkaran düğümün diamond kontratı
meta.images[]	array	Görseller: url, is_default
meta.documents[]	array	Belgeler: id, name, url, type (1 standart belge). 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
contract	object | null	Token kontratı: address ve dağıtımın tx_hash değeri. Dağıtılana kadar null
value.token_price	object	Bir token'ın fiyatı: ödeme para biriminin amount (ondalık string), decimal, symbol, address değerleri
value.total_value	object	Varlığın toplam değeri, aynı biçimde
value.salable_percentage	string	Değerin satışa sunulan payı, yüzde olarak
value.salable_value	object	Satışa sunulan değer, token_price ile aynı biçimde
value.max_supply	integer	En yüksek arz
value.listed_supply	integer	Satışa sunulan arz
value.sold_supply	integer	Satılan arz
distribution_token	object | null	Harici bir token'ın partner entegrasyonu ayarları: agent ve integration altında network_id, abi, contract_address, function_name, currency_token_address, is_approved ve args[] (type, value, description). Token'da yoksa null
metric	object | null	Token metrikleri, aşağıda. Tanımlı değilse null
metric.term_duration_in_months	integer | null	Ay cinsinden vade
metric.min_purchase_quantity	integer	Token'da tanımlı en düşük satın alma miktarı
metric.max_purchase_quantity	integer	Birincil Piyasadan Satın Al ucunun uyguladığı kullanıcı başına elde tutma sınırı. 0 sınır yok demektir
metric.min_tokens_required_for_rental_income	integer	Bir sahibin kira alması için gereken token sayısı
metric.rental_income	object	Kira geliri, token_price ile aynı biçimde
metric.rental_payment_period_in_days	integer	Gün cinsinden kira ödeme dönemi
metric.rental_payment_start_date	string | null	İlk kira ödeme tarihi (RFC 3339)
metric.listing_date	string | null	Listeleme tarihi (RFC 3339)
hourly_rate_change, daily_rate_change, weekly_rate_change, monthly_rate_change, quarterly_rate_change	object | null	İçinde bulunulan saat, gün, hafta, ay ve çeyrekteki fiyat hareketi. Biçimi Token Oranlarını Getir sayfasındadır; pencerede geçmiş yoksa null
created_at	string	Oluşturma zamanı (RFC 3339)

Hatalar

Durum	Kod	Açıklama
400	10016	token_id geçerli 24 karakterlik hex ID değil
400	10001	Token bulunamadı (domain 5)
500	10000	Beklenmeyen sunucu hatası

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