Dağıtım Token Bilgisini Getir
Bir token'ın dağıtım görünümünü döndürür: platform ücretleri dahil fiyatı, satın alma sınırları, kontratı, harici bir pazarın token'ı satın almak için yaptığı zincir üstü çağrı, ödendiği para birimi, görselleri ve belgeleri. Bir dağıtım token'ını harici bir sistemde listelemek için kullanılır.
Token bir dağıtım token'ı olmalıdır; diğer her token token not found ile yanıtlanır. Okuma çağıranın düğümüyle sınırlı değildir.
Gerekli izin: distribution:view
İstek
GET /v2/distributions/tokens/{token_id}
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
token_id | string | path | Zorunlu. Token'ın platformdaki id'si (24 karakterlik hex) |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request GET \
--url '{{baseUrl}}/v2/distributions/tokens/67d8774e903bfcbe7eb5d93e' \
--header 'Authorization: Bearer <access_token>'
Yanıt
abi string'i burada kısaltılmıştır; API ABI'nin tamamını döndürür.
{
"standard": 0,
"name": "Istanbul Commercial Lease #1",
"description": "12-month lease on a commercial real estate asset located in Istanbul.",
"symbol": "ICL",
"contract": {
"address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d",
"hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"
},
"rules": {
"max_purchase_limit": 100,
"min_purchase_limit": 1
},
"status": 2,
"integration": {
"network_id": 137,
"abi": "[...]",
"contract_address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
"function_name": "buy",
"currency_token_address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
"is_approved": true,
"args": [
{ "type": "bigint", "value": null, "description": "Quantity" },
{ "type": "address", "value": "0x073c0196e516a0e77b1c804d1825fb1bad23895d", "description": "TokenAddress" },
{ "type": "address", "value": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", "description": "CurrencyToken Address" },
{ "type": "string", "value": null, "description": "MarketID" }
]
},
"value": "102.5",
"total_value": "250000",
"supply": 2500,
"seller_address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
"currency_token": {
"name": "Tether USD",
"symbol": "USDT",
"decimals": 6,
"address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
},
"meta": {
"images": [
{
"id": "69120e5fe5064fdeaef6f101",
"url": "https://s3.tokenizationtr.com/tokens/67d8774e903bfcbe7eb5d93e/cover.png",
"is_default": true,
"hash": "9f2c4e1b7a3d58c06e2f1a4b9c7d3e5f8a0b2c4d6e8f0a1b3c5d7e9f1a2b3c4d",
"created_at": "2026-03-16T12:29:59.46Z"
}
],
"documents": [
{
"id": "69120e5fe5064fdeaef6f102",
"name": "Prospectus",
"url": "https://s3.tokenizationtr.com/tokens/67d8774e903bfcbe7eb5d93e/prospectus.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=604800&X-Amz-Signature=...",
"type": 6,
"hash": "3b8e1f0c2d4a6b8e0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d",
"created_at": "2026-03-16T12:30:04.12Z"
}
]
},
"external_id": "67d8774e903bfcbe7eb5d93e"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
standard | integer | Token standardı: 0 ERC-20, 1 ERC-721, 2 ERC-1155, 3 ERC-3643, 4 ERC-4380 |
name | string | Token'ın görünen adı |
description | string | Token açıklaması |
symbol | string | Token sembolü |
contract.address | string | Token'ın kontrat adresi |
contract.hash | string | Token kontratını deploy eden işlemin hash'i |
rules.max_purchase_limit | integer | Tek bir alımda alınabilecek en fazla token. Tanımlı değilse 0 |
rules.min_purchase_limit | integer | Tek bir alımda alınabilecek en az token. Tanımlı değilse 0 |
status | integer | Satış durumu: token satışa listelenmişse 2, diğer her durumda (taslak, işlemde, hatalı, listelenmemiş, listeden kaldırılmış, yakılmış, pasif) 4. Başka değer dönmez |
integration | object | Token'ı satın alan zincir üstü çağrı |
integration.network_id | integer | Token'ın ağının EVM zincir id'si (örn. 137); istek gövdelerinde kullanılan katalog id'si değildir (bkz. Ağları Listele). Token'ın ağı yoksa 0 |
integration.abi | string | Listeleme kontratının ABI'si, JSON string olarak |
integration.contract_address | string | Çağrılacak kontratın adresi: token oluşturulurken düğümünün deploy'undan kaydedilen token diamond'ı |
integration.function_name | string | Çağrılacak fonksiyon. Her zaman buy |
integration.currency_token_address | string | Token'ın ödendiği para biriminin kontrat adresi |
integration.is_approved | boolean | Her zaman true |
integration.args | array | buy fonksiyonunun argümanları, çağrı sırasıyla. Her birinin bir type (bigint, address, string), bir description ve bir value alanı vardır; değeri çağıranın doldurduğu argümanlarda (miktar ve pazar id'si) value null olur |
value | string | Platform ücretleri dahil bir token'ın fiyatı, ondalık string (bkz. Tutarlar ve Yüzdeler). Her ücret alıcısının payı para biriminin ondalık basamağına ayrı ayrı kırpılır ve birim fiyata eklenir |
total_value | string | Token'ın arkasındaki varlığın ücretsiz kayıtlı toplam değeri, ondalık string. value × supply değildir: genellikle varlığın yalnızca bir kısmı listelenir. Değer kaydedilmemişse "0" |
supply | integer | Satışa listelenen token sayısı |
seller_address | string | Token'ı satan adres: integration.contract_address ile aynı diamond |
currency_token | object | Token'ın ödendiği para birimi: name, symbol, decimals (integer) ve kontrat address'i. Para birimi okunamazsa boş string'ler ve 0 |
meta | object | Token'ın görselleri ve belgeleri. Token'ın ikisi de yoksa alan yer almaz |
meta.images[] | array | Her görselin id, url, is_default (boolean), hash (dosyanın SHA-256 özeti, hex) ve created_at alanları |
meta.documents[] | array | Her belgenin id, name, url, type, hash (dosyanın SHA-256 özeti, hex) ve created_at alanları |
meta.documents[].url | string | Belgeye imzalı bağlantı, 7 gün geçerlidir. Süresi dolmadan yeni bir bağlantı için token'ı yeniden okuyun |
meta.documents[].type | integer | 1 standart, 2 whitepaper, 3 kullanım koşulları, 4 gizlilik politikası, 5 hukuki sözleşme, 6 izahname, 7 denetim raporu, 8 lisans, 9 sertifika |
external_id | string | Token'ın platformdaki id'si (token_id ile aynı değer). Token'ı yeniden okumak için saklayın |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10016 | token_id geçerli bir 24 karakterlik hex id değil |
| 400 | 10001 | Bu id'ye sahip token yok ya da token bir dağıtım token'ı değil (domain 5, mesaj token not found) |
| 400 | 10001 | Token'ın kategorisi bulunamadı (domain 4, mesaj category not found) |
| 400 | 10004 | Token'ın kontratı yok (domain 5, mesaj token is not listed or delist) |
| 400 | 10014 | Token'ın diamond'ı deploy edilmemiş (domain 5, mesaj diamond address not exists) |
| 500 | 10000 | Beklenmeyen sunucu hatası |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.