Ana içeriğe geç

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​

AdTipKonumAçıklama
token_idstringpathZorunlu. Token'ın platformdaki id'si (24 karakterlik hex)

Başlıklar​

AdAçıklama
AuthorizationZorunlu. 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ı​

AlanTipAçıklama
standardintegerToken standardı: 0 ERC-20, 1 ERC-721, 2 ERC-1155, 3 ERC-3643, 4 ERC-4380
namestringToken'ın görünen adı
descriptionstringToken açıklaması
symbolstringToken sembolü
contract.addressstringToken'ın kontrat adresi
contract.hashstringToken kontratını deploy eden işlemin hash'i
rules.max_purchase_limitintegerTek bir alımda alınabilecek en fazla token. Tanımlı değilse 0
rules.min_purchase_limitintegerTek bir alımda alınabilecek en az token. Tanımlı değilse 0
statusintegerSatış 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
integrationobjectToken'ı satın alan zincir üstü çağrı
integration.network_idintegerToken'ı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.abistringListeleme kontratının ABI'si, JSON string olarak
integration.contract_addressstringÇağrılacak kontratın adresi: token oluşturulurken düğümünün deploy'undan kaydedilen token diamond'ı
integration.function_namestringÇağrılacak fonksiyon. Her zaman buy
integration.currency_token_addressstringToken'ın ödendiği para biriminin kontrat adresi
integration.is_approvedbooleanHer zaman true
integration.argsarraybuy 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
valuestringPlatform ü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_valuestringToken'ı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"
supplyintegerSatışa listelenen token sayısı
seller_addressstringToken'ı satan adres: integration.contract_address ile aynı diamond
currency_tokenobjectToken'ın ödendiği para birimi: name, symbol, decimals (integer) ve kontrat address'i. Para birimi okunamazsa boş string'ler ve 0
metaobjectToken'ın görselleri ve belgeleri. Token'ın ikisi de yoksa alan yer almaz
meta.images[]arrayHer görselin id, url, is_default (boolean), hash (dosyanın SHA-256 özeti, hex) ve created_at alanları
meta.documents[]arrayHer belgenin id, name, url, type, hash (dosyanın SHA-256 özeti, hex) ve created_at alanları
meta.documents[].urlstringBelgeye imzalı bağlantı, 7 gün geçerlidir. Süresi dolmadan yeni bir bağlantı için token'ı yeniden okuyun
meta.documents[].typeinteger1 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_idstringToken'ın platformdaki id'si (token_id ile aynı değer). Token'ı yeniden okumak için saklayın

Hatalar​

DurumKodAçıklama
40010016token_id geçerli bir 24 karakterlik hex id değil
40010001Bu id'ye sahip token yok ya da token bir dağıtım token'ı değil (domain 5, mesaj token not found)
40010001Token'ın kategorisi bulunamadı (domain 4, mesaj category not found)
40010004Token'ın kontratı yok (domain 5, mesaj token is not listed or delist)
40010014Token'ın diamond'ı deploy edilmemiş (domain 5, mesaj diamond address not exists)
50010000Beklenmeyen sunucu hatası

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