Ana içeriğe geç

Kullanıcı Cüzdanının Ağdaki Varlıklarını Getir

Bir cüzdanın tek bir ağdaki varlıklarını döndürür:

  • ağın native coin'i (sembol, logo, ondalık basamak ve cüzdanın bakiyesi; USD ve TRY olarak değerlenmiş) satır içinde. ID'si yoktur, çünkü deploy edilmiş bir kontrat değil zincirin kendi coin'idir;
  • assets: o ağdaki her aktif, deploy edilmiş stabil para birimi token'ı, cüzdanın bakiyesiyle ve USD/TRY değeriyle. Bir satırın id değeri Kullanıcı Cüzdanının Ağdaki Varlığını Getir çağrısının aldığı değerdir.

network_id cüzdanın zincirine ait olmalıdır (bkz. Kullanıcı Cüzdanı Ağlarını Getir). Bakiyeler ve değerlemeler en iyi çaba ile okunur: custody okunamazsa native bakiye "0" olur, token bakiyeleri okunamazsa assets boş gelir, spot fiyat yoksa USD / TRY alanları gelmez. Düğüm tarafındaki GET /v2/admin/wallets/{wallet_id}/networks/{network_id}/assets ile aynı okuma ve aynı biçimdir.

Cüzdan bu kullanıcıya ait olmalıdır. Başka bir kullanıcının (ya da bir düğümün) cüzdanı "bulunamadı" olarak bildirilir.

Gerekli izin: user:view

İstek​

GET /v2/users/{user_id}/wallets/{wallet_id}/networks/{network_id}/assets

Parametreler​

AdTipKonumAçıklama
user_idstringpathZorunlu. Kullanıcı ID'si
wallet_idstringpathZorunlu. Cüzdan ID'si
network_idstringpathZorunlu. Ağ ID'si; cüzdanın zincirinde olmalı

Başlıklar​

AdAçıklama
AuthorizationZorunlu. Bearer <access_token>

Örnek​

curl --request GET \
--url '{{baseUrl}}/v2/users/6a87455ad5f439809d488ac3/wallets/6a8754e187be1d0e22aa6d83/networks/6740e0a20000000000000103/assets' \
--header 'Authorization: Bearer <access_token>'

Yanıt​

{
"network_id": "6740e0a20000000000000103",
"network_name": "Ethereum Sepolia",
"native_currency_symbol": "ETH",
"native_currency_logo": "https://s3.tokenizationtr.com/currencies/eth.svg",
"native_currency_decimal": 18,
"balance_native": "0.8006712018779228",
"balance_native_usd": "2802.35",
"balance_native_try": "96120.4",
"assets": [
{
"id": "6900a1fd2a4de1c5748e9dcc",
"name": "USD Coin",
"symbol": "USDC",
"logo": "https://s3.tokenizationtr.com/currencies/usdc.svg",
"decimal": 6,
"amount": "988.4805",
"amount_usd": "988.48",
"amount_try": "33901.2"
}
]
}

Yanıt Alanları​

AlanTipAçıklama
network_idstringAğ ID'si
network_namestringAğın görünen adı
native_currency_symbolstringNative coin sembolü
native_currency_logostringNative coin logo URL'i
native_currency_decimalintegerNative coin ondalık basamağı
balance_nativestringCüzdanın native coin bakiyesi
balance_native_usdstringİsteğe bağlı. Native bakiyenin USD değeri
balance_native_trystringİsteğe bağlı. Native bakiyenin TRY değeri
assetsarrayBu ağdaki para birimi token'ları ve cüzdanın bakiyesi. Hiçbir zaman null değil
assets[].idstringPara birimi token ID'si (tekil okumanın asset_id değeri ve para çekmenin currency_token_id değeri)
assets[].namestringToken adı
assets[].symbolstringToken sembolü
assets[].logostringLogo URL'i; yoksa boş
assets[].decimalintegerToken ondalık basamağı
assets[].amountstringCüzdanın bakiyesi
assets[].amount_usdstringİsteğe bağlı. Bakiyenin USD değeri
assets[].amount_trystringİsteğe bağlı. Bakiyenin TRY değeri

Hatalar​

DurumKodAçıklama
40010016wallet_id geçerli bir ID değil
40010001Cüzdan bulunamadı ya da bu kullanıcıya ait değil (domain 1, mesaj user not found)
40010001network_id cüzdanın zincirindeki bir ağ değil (domain 2, mesaj node not found)

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