Token Detaylarını Alma
Belirli bir token hakkında detaylı bilgi alır.
İstek
GET /v2/admin/token/{token_id}
Parametreler
| İsim | Tür | Konum | Açıklama |
|---|---|---|---|
token_id | string | path | Gerekli. Alınacak token'ın ID'si |
Başlıklar
| İsim | Açıklama |
|---|---|
Authorization | Gerekli. Kimlik doğrulama için Bearer token |
Örnek
curl --request GET \
--url '\{\{baseUrl\}\}/v2/admin/token/67d8774e903bfcbe7eb5d93e' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
--header 'User-Agent: insomnia/10.3.1'
Yanıt
{
"id": "67d8774e903bfcbe7eb5d93e",
"category_id": "667e9251ca818a2138ed4915",
"node_id": "67d6c447f47ff3adafda700d",
"type": 0,
"status": 4,
"is_public": false,
"name": "TKN Token Name 6 Updated",
"description": "Token Description 222",
"token_name": "tkn",
"token_symbol": "TKN",
"oracle": {
"id": "677ed6e3cc111aea14a3dfc3",
"code": "IOG"
},
"meta": {
"images": [
{
"id": "67d8aac52b32e33603246a1f",
"url": "https://fra1.digitaloceanspaces.com/apex/dev/token/67d8774e903bfcbe7eb5d93e/images/9fa561ea-d5c6-494a-ab1f-8aeabe211e7e.jpeg",
"is_default": false,
"hash": "b9edd305d6e628fa06f4f2ae33f649cb9b57cbbc4156cde981fef512df3367ab",
"created_at": "2025-03-17T23:05:41.969Z",
"deleted_at": null
}
],
"documents": [
{
"id": "67d8aac62b32e33603246a20",
"name": "Ws_20240201.pdf",
"url": "https://fra1.digitaloceanspaces.com/apex/dev/token/67d8774e903bfcbe7eb5d93e/documents/47ffece9-4d07-4c14-a422-144ab6832df1.pdf",
"type": 1,
"hash": "cdb85002d5c946b618bbf9694916df129d1f570e2e763c117de425383c83af58",
"created_at": "2025-03-17T23:05:42.97Z",
"deleted_at": null
}
]
},
"contract": {
"address": "0xaffdea8c3fdd521681bb5e7d44e3ae57871093e4",
"tx_hash": "0x998a217061da05cf1bf1998470613a488b10908f0964e76a123c4063f91d77c4"
},
"value": {
"token_price": {
"id": "68fe8c129367fd414b227c7a",
"amount": 30,
"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,
"purchased_supply": 150,
"listed_supply": 800,
"sold_supply": 200,
"total_fee_supply": 50
},
"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-01-01T00:00:00Z",
"listing_date": "2025-01-01T00:00:00Z",
"expiration_date": "2026-01-01T00:00:00Z"
},
"is_open_to_secondary_market": false,
"is_open_to_otc": false,
"secondary_market": {
"min_sell_price": 25.5,
"max_sell_price": 35.5
},
"distribution_token": {
"id": "690d004e8f95a5c7b2614658",
"external_id": "EXT123",
"priority": 50,
"agent": 1
},
"fee": {
"platform_owner_amount": 10,
"node_owner_amount": 5,
"node_amount": 15
},
"node_contract": {
"listing_contract_address": "0xb6627b1685d1199E3087D2247d5F432fb1721c34",
"rent_contract_address": "0x57327F5C456B661Fc0D337473ec8F14a4ADccfb3",
"burn_contract_address": "0x222CB82947be52A91a88B1A2E116abf4D9bA6eed",
"fee_contract_address": "0x333CB82947be52A91a88B1A2E116abf4D9bA6eee",
"secondary_contract_address": "0x444CB82947be52A91a88B1A2E116abf4D9bA6fff",
"otc_contract_address": "0x555CB82947be52A91a88B1A2E116abf4D9bA6000"
},
"created_at": "2025-03-17T19:26:06.562Z",
"deleted_at": null
}
Yanıt Alanları
Token Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
id | string | Token'ın benzersiz tanımlayıcısı |
category_id | string | Token'ın kategori ID'si |
node_id | string | İlişkili node'un ID'si |
type | integer | Token tipi (0 = standart, 1 = özel) |
status | integer | Token durum kodu |
name | string | Token'ın görünen adı |
description | string | Token'ın açıklaması |
token_name | string | Token adı |
token_symbol | string | Token sembolü |
is_public | boolean | Token'ın herkese açık olup olmadığı |
is_open_to_secondary_market | boolean | Token'ın ikincil pazara açık olup olmadığı |
is_open_to_otc | boolean | Token'ın OTC ticarete açık olup olmadığı |
oracle | object/null | Fiyat referansı için oracle bilgisi |
oracle.id | string | Oracle ID'si |
oracle.code | string | Oracle kodu |
meta | object | Görseller ve belgeleri içeren metadata |
contract | object/null | Token kontrat bilgisi |
node_contract | object/null | Node kontrat adresleri |
value | object | Token değeri ve arz bilgisi |
metric | object/null | Token metrikleri ve kiralama bilgisi |
secondary_market | object/null | İkincil pazar fiyat kısıtlamaları |
distribution_token | object/null | Dağıtım token bilgisi |
fee | object/null | Token ücret dağıtım bilgisi |
created_at | string | Token'ın oluşturulduğu ISO 8601 zaman damgası |
updated_at | string | Token'ın güncellendiği ISO 8601 zaman damgası |
deleted_at | string/null | Token'ın silindiği ISO 8601 zaman damgası |
Meta Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
images | array | Görsel objelerinin dizisi |
documents | array | Belge objelerinin dizisi |
Görsel Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
id | string | Görselin benzersiz tanımlayıcısı |
url | string | Görselin URL'si |
is_default | boolean | Bunun varsayılan görsel olup olmadığı |
hash | string | Görsel dosyasının hash'i |
created_at | string | Görselin oluşturulduğu ISO 8601 zaman damgası |
deleted_at | string/null | Görselin silindiği ISO 8601 zaman damgası |
Belge Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
id | string | Belgenin benzersiz tanımlayıcısı |
name | string | Belge adı |
url | string | Belge URL'si |
type | integer | Belge tipi (1 = Standart) |
hash | string | Belge dosyasının hash'i |
created_at | string | Belgenin oluşturulduğu ISO 8601 zaman damgası |
deleted_at | string/null | Belgenin silindiği ISO 8601 zaman damgası |
Kontrat Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
address | string | Token kontrat adresi |
tx_hash | string | İşlem hash'i |
Değer Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
token_price | object | Token fiyat bilgisi (Fiyat objesi) |
total_value | object | Toplam değer bilgisi (Fiyat objesi) |
salable_percentage | number | Satılabilir token yüzdesi (0-100) |
salable_value | object | Satılabilir değer bilgisi (Fiyat objesi) |
max_supply | integer | Token'ların maksimum arzı |
purchased_supply | integer | Satın alınan token sayısı |
listed_supply | integer | Listelenen token sayısı |
sold_supply | integer | Satılan token sayısı |
total_fee_supply | integer | Ücretler için ayrılan toplam token sayısı |
Fiyat Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
id | string | Para birimi token ID'si |
amount | number | Fiyat miktarı |
decimal | integer | Ondalık basamak sayısı |
symbol | string | Fiyat sembolü (örn., USDT) |
address | string | Fiyat token'ının kontrat adresi |
Metrik Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
term_duration_in_months | integer/null | Token süresinin ay cinsinden uzunluğu |
min_purchase_quantity | integer | Minimum satın alma miktarı |
max_purchase_quantity | integer | Maksimum satın alma miktarı |
min_tokens_required_for_rental_income | integer | Kiralama geliri için gerekli minimum token sayısı |
rental_income | object | Kiralama geliri bilgisi (Fiyat objesi) |
rental_payment_period_in_days | integer | Kiralama ödeme dönemi (gün cinsinden) |
rental_payment_start_date | string/null | Kiralama ödeme başlangıç tarihinin ISO 8601 zaman damgası |
listing_date | string/null | Listeleme tarihinin ISO 8601 zaman damgası |
expiration_date | string/null | Son kullanma tarihinin ISO 8601 zaman damgası |
Node Kontrat Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
listing_contract_address | string/null | Listeleme kontrat adresi |
rent_contract_address | string/null | Kiralama kontrat adresi |
burn_contract_address | string/null | Yakma kontrat adresi |
fee_contract_address | string/null | Ücret kontrat adresi |
secondary_contract_address | string/null | İkincil pazar kontrat adresi |
otc_contract_address | string/null | OTC kontrat adresi |
İkincil Pazar Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
min_sell_price | number/null | İkincil pazarda minimum satış fiyatı |
max_sell_price | number/null | İkincil pazarda maksimum satış fiyatı |
Dağıtım Token Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
id | string | Dağıtım token ID'si |
external_id | string | Harici tanımlayıcı |
priority | integer | Öncelik değeri (1-100, düşük değer daha yüksek öncelik) |
agent | integer | Dağıtım ajanı (1 = Gen, 2 = Brickken) |
Ücret Objesi Alanları
| Alan | Tür | Açıklama |
|---|---|---|
platform_owner_amount | integer | Platform sahibine ayrılan miktar |
node_owner_amount | integer | Node sahibine ayrılan miktar |
node_amount | integer | Node'a ayrılan miktar |
Token Tipleri
| Değer | Açıklama |
|---|---|
| 0 | Standart Token |
| 1 | Özel Token |
Durum Kodları
| Durum Kodu | Açıklama |
|---|---|
| 200 | Başarılı |
| 401 | Yetkisiz - Geçersiz veya eksik kimlik doğrulama token'ı |
| 404 | Bulunamadı - Token ID mevcut değil |
| 500 | Dahili Sunucu Hatası |
Token Durumları
Yanıttaki status alanı, token'ın sistemdeki mevcut durumunu gösterir. Aşağıda olası durum değerleri bulunmaktadır:
| Durum Kodu | Durum Adı | Açıklama |
|---|---|---|
| 1 | Draft | Blok zinciri dağıtımından önceki token'ın ilk durumu. Token detayları kaydedilmiş ancak henüz blok zincirine gönderilmemiştir. |
| 2 | InProgress | Token blok zincirine dağıtım sürecinde. İşlemler beklemede. |
| 3 | Error | Token dağıtımı veya işlem sürecinde bir hata oluştu. Blok zinciri işlemi başarısız oldu. |
| 4 | NotListed | Token başarıyla blok zincirine dağıtıldı ancak henüz pazaryerinde listelenmiyor. |
| 5 | Delisted | Token daha önce listelenmiş ancak pazaryerinden kaldırılmış. |
| 6 | Listed | Token başarıyla dağıtılmış ve pazaryerinde aktif olarak listeleniyor. |
| 7 | Passive | Token pasif durumda. Blok zincirinde mevcut ancak aktif olarak takas edilebilir değil. |
| 8 | Burn | Token blok zincirinde kalıcı olarak yakılmış/imha edilmiş. |