Token Getir

Tek bir token'ı etkin (silinmemiş) görselleri ve belgeleriyle döndürür. Token alanları yanıtın kökündedir; include_category_data=true token'ın kategorisini de yanlarına ekler. Çağıranın düğümü, token'ın sahibi olan düğümü kapsamalıdır.

Gerekli izin: token:view

İstek

GET /v2/admin/tokens/{token_id}

Parametreler

Ad	Tip	Konum	Açıklama
`token_id`	string	path	Zorunlu. Token id'si.
`include_category_data`	boolean	query	İsteğe bağlı. `true` ise token'ın `category` nesnesi (`tokenization_rules` ile birlikte) yanıta eklenir.

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e?include_category_data=true' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "id": "67d8774e903bfcbe7eb5d93e",
  "category_id": "667e9251ca818a2138ed4915",
  "node_id": "67d6c447f47ff3adafda700d",
  "created_by_id": "665b372f3a72d7d0791596ba",
  "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": false,
  "is_open_to_otc": true,
  "is_open_to_secondary_market": false,
  "is_mintable": false,
  "oracle": {
    "id": "677ed6e3cc111aea14a3dfc3",
    "code": "IOG"
  },
  "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": {
    "term_duration_in_months": 12,
    "min_purchase_quantity": 1,
    "max_purchase_quantity": 100,
    "min_tokens_required_for_rental_income": 10,
    "rental_income": {
      "id": "68fe8c129367fd414b227c7a",
      "amount": "100",
      "decimal": 6,
      "symbol": "USDT",
      "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
    },
    "rental_payment_period_in_days": 30,
    "rental_payment_start_date": "2025-04-01T00:00:00Z",
    "listing_date": "2025-03-18T09:12:44.512Z"
  },
  "distribution_token": null,
  "created_at": "2025-03-17T19:26:06.905Z",
  "deleted_at": null,
  "category": {
    "id": "667e9251ca818a2138ed4915",
    "parent_id": null,
    "name": { "en": "Real Estate", "tr": "Gayrimenkul" },
    "path": "1",
    "int_id": 1,
    "image_svg": null,
    "image_url": null,
    "is_leaf": true,
    "show_on_dashboard": true,
    "tokenization_rules": {
      "lock_salable_percentage_at_100": false,
      "rental_income_as_percentage": false,
      "sync_max_supply_with_total_value": false,
      "rental_payment_period_days": 30,
      "disallow_min_purchase_quantity": false,
      "disallow_max_purchase_quantity": false,
      "disallow_min_tokens_required_for_rental_income": false
    },
    "created_at": "2024-06-28T10:02:57.112Z"
  }
}

Yanıt Alanları

Token nesnesi

Alan	Tip	Açıklama
`id`	string	Token id'si.
`category_id`	string	Token'ın kayıtlı olduğu kategori.
`node_id`	string	Token'ın oluşturulduğu düğüm.
`created_by_id`	string	Token'ı oluşturan supervisor; bir API istemcisi oluşturduysa `""`.
`network_id`	string	Token kontratlarının bulunduğu ağ (kurulumunun ağı); token'ların bir ağa bağlanmasından önce oluşturulmuş bir token için `""`.
`setup_id`	string	Token'ın üzerinde tokenize edildiği kurulum (setup; düğümün tek bir cüzdan ve ağ üzerindeki dağıtımı); kurulum bağlamasından önce oluşturulmuş bir token için `""`.
`status`	integer	Yaşam döngüsü durumu, bkz. Token durumu.
`origin`	integer	`0` platform (burada ihraç edildi), `1` harici (bir owner kurulumundan dağıtıldı).
`standard`	integer	Zincir standardı: `0` ERC-20, `1` ERC-721, `2` ERC-1155, `3` ERC-3643, `4` ERC-4380. Bu API ile oluşturulan token'lar `0`'dır.
`name`	string	Görünen ad.
`description`	string	Açıklama.
`token_name`	string	Zincir üzerindeki token adı.
`token_symbol`	string	Zincir üzerindeki token sembolü.
`is_public`	boolean	Token sahipleri token'ı serbestçe transfer edebilir. Token Genel Transferi ile değişir.
`is_api`	boolean	Token, partner API üzerinden bir supervisor değil bir API istemcisi tarafından oluşturuldu.
`is_open_to_otc`	boolean	Token tezgâh üstü (OTC) teklif edilebilir. Token'ı OTC'ye Aç ile değişir.
`is_open_to_secondary_market`	boolean	Token ikincil piyasada listelenebilir. Token'ı İkincil Piyasaya Aç ile değişir.
`is_mintable`	boolean	Token kontratı mint edilebilir olarak dağıtıldı. Bu API ile oluşturulan token'larda `false`'tur.
`oracle`	object \| null	Token'ın izlediği fiyat oracle'ı: `id` (oracle id'si) ve `code` (oracle'ın entegrasyon kodu).
`meta.images[]`	array	Etkin görseller: `url` ve `is_default` (ilk yüklenen görsel varsayılandır).
`meta.documents[]`	array	Etkin belgeler: `id`, `name` (dosya adı), `url`, `type` (`1` standart belge) ve `tx_hash` (belgenin hash'i zincire yazıldığında bulunur).
`contract`	object \| null	Token kontratının `address` değeri ve dağıtım `tx_hash` değeri. Tokenizasyon sonuçlanana kadar `null`.
`value`	object	Fiyat ve arz, aşağıya bakın.
`metric`	object \| null	Satın alma sınırları ve kira koşulları, aşağıya bakın. Token Metriğini Güncelle ayarlayana kadar `null`.
`distribution_token`	object \| null	Harici bir token'da bulunur: `agent` (`1` Gen, `2` Brickken, `3` Rudiq Brokerage) ve `integration` (`network_id`, `abi`, `contract_address`, `function_name`, `currency_token_address`, `is_approved`, `type`, `value`, `description` alanlı `args[]`).
`created_at`	string	Oluşturulma zamanı (RFC 3339).
`deleted_at`	string \| null	Silinme zamanı; token var olduğu sürece `null`.
`category`	object	Yalnızca `include_category_data=true` ile: `id`, `parent_id`, `name` (`en`, `tr`), `path`, `int_id`, `image_svg`, `image_url`, `is_leaf`, `show_on_dashboard`, `tokenization_rules` (kategorinin kuralları varsa) ve `created_at` alanlı kategori.

meta.documents[].url, belgeyi 15 dakika boyunca açan ve her okumada yeniden üretilen imzalı bir bağlantıdır: belgeler özel nesnelerdir ve token kaydı yalnızca anahtarlarını tutar. Saklamak yerine yeni bir bağlantı için token'ı tekrar okuyun. Harici bir token'ın belgesi, geldiği owner kurulumu tarafından imzalanır; owner'a ulaşılamadığında owner'ın gönderdiği bağlantı kaydedildiği gibi döner.

`value`

Alan	Tip	Açıklama
`token_price`	price	Bir token'ın fiyatı: `salable_value` bölü `max_supply`.
`total_value`	price	Varlığın tamamının değeri, oluşturma sırasında seçilen para birimi token'ı cinsinden.
`salable_percentage`	string	Varlığın satışa sunulan payı, `"0"` ile `"100"` arası.
`salable_value`	price	`total_value` × `salable_percentage`.
`max_supply`	integer	Toplam token sayısı.
`listed_supply`	integer	Birincil satışa sunulan token'lar.
`sold_supply`	integer	Birincil piyasada yatırımcılara satılan token'lar.
`purchased_supply`	integer	OTC üzerinden yatırımcılardan geri alınan token'lar; satılabilir havuza geri döner.

Bir price nesnesi {id, amount, decimal, symbol, address} biçimindedir: para birimi token'ının id'si, ondalık string olarak tutar, para biriminin ondalık basamak sayısı, sembolü ve kontrat adresi. Bkz. Tutarlar ve Yüzdeler.

`metric`

Alan	Tip	Açıklama
`term_duration_in_months`	integer \| null	Varlığın ay cinsinden vadesi.
`min_purchase_quantity`	integer	Satın alma başına en az token.
`max_purchase_quantity`	integer	Satın alma başına en çok token.
`min_tokens_required_for_rental_income`	integer	Bir sahibin kira geliri alması için gereken en az token.
`rental_income`	price	Dağıtım başına kira geliri. `rental_income_as_percentage` kuralı açık bir kategoride `amount`, toplam değerin yüzdesidir.
`rental_payment_period_in_days`	integer	Dağıtımlar arasındaki gün sayısı.
`rental_payment_start_date`	string \| null	Kira ödemelerinin başladığı zaman.
`listing_date`	string \| null	Token'ın listelendiği zaman.

Token durumu

Değer	Ad	Anlamı
`0`	None	Durum atanmamış.
`1`	Draft	Oluşturuldu, tokenizasyon henüz başlamadı.
`2`	InProgress	Tokenizasyon işlemi sürüyor.
`3`	Error	Tokenizasyon başarısız oldu. Token'ı Yeniden Tokenize Et ile yeniden deneyin.
`4`	NotListed	Tokenize edildi, satışa sunulmadı.
`5`	Delisted	Token Listelemesini Kaldır ile satıştan kaldırıldı.
`6`	Listed	Token'ı Listele ile birincil satışa sunuldu.
`7`	Passive	Token'ı Pasife Al ile durduruldu.
`8`	Burn	Yakıldı; token sahiplerine ödeme yapılır (bkz. Yakma Ödemelerini Getir).

Hatalar

Durum	Kod	Açıklama
400	`10016`	`token_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`)

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

İstek​

Parametreler​

Başlıklar​

Örnek​

Yanıt​

Yanıt Alanları​

Token nesnesi​

value​

metric​

Token durumu​

Hatalar​