Adrese Göre Token Bulma
Bir token'ı zincir üstü kontrat adresiyle bulur ve kısa bir özet döndürür: ad, sembol, görsel, güncel fiyat ve ağ. Adres eşleşmesi büyük/küçük harf duyarsızdır. Arama yalnızca dağıtım token'larını değil, platformda bu kontrat adresine sahip her token'ı kapsar ve çağıranın düğümüyle sınırlı değildir.
Gerekli izin: distribution:view
İstek
GET /v2/distributions/tokens/addresses/{address}
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
address | string | path | Zorunlu. Token'ın kontrat adresi |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request GET \
--url '{{baseUrl}}/v2/distributions/tokens/addresses/0x073c0196e516a0e77b1c804d1825fb1bad23895d' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d",
"name": "Istanbul Commercial Lease #1",
"symbol": "ICL",
"decimal": 18,
"image": "https://s3.tokenizationtr.com/tokens/67d8774e903bfcbe7eb5d93e/cover.png",
"price": {
"id": "6913307ec95e268b239b2d8b",
"amount": "100",
"decimal": 6,
"symbol": "USDT",
"address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
},
"network_id": 137
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
address | string | Token'ın kontrat adresi |
name | string | Zincir üstü token adı |
symbol | string | Token sembolü |
decimal | integer | Token ondalık basamak sayısı. Her zaman 18 |
image | string | Token'ın ilk aktif görselinin URL'si. Görseli yoksa boş |
price | object | Bir token'ın birim fiyatı |
price.id | string | Fiyatın belirlendiği ödeme token'ının id'si |
price.amount | string | Token başına fiyat, ondalık string (bkz. Tutarlar ve Yüzdeler) |
price.decimal | integer | Ödeme token'ının ondalık basamak sayısı |
price.symbol | string | Ödeme token'ının sembolü |
price.address | string | Ödeme token'ının kontrat adresi |
network_id | integer | Token'ın ağının EVM zincir id'si (örn. 137 Polygon); istek gövdelerinde kullanılan katalog id'si değildir (bkz. Ağları Listele). Token'ın ağı yoksa 0 |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10001 | Bu kontrat adresine sahip token yok (domain 5, mesaj token not found) |
| 500 | 10000 | Beklenmeyen sunucu hatası |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.