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

Cüzdanın bir ağda tuttuğu tek bir varlığı okur: para birimi token'ının bilgileri ve bu cüzdanda tutulan miktar. Kullanıcı Cüzdanının Ağdaki Varlıklarını Getir listesinin tekil okumasıdır: asset_id değerini oradaki bir assets[].id değerinden alın. Ağın native coin'inin ID'si yoktur ve yalnızca o listeden okunabilir.

Varlık aktif, deploy edilmiş ve belirtilen ağda olmalı, ağ da cüzdanın zincirinde olmalıdır; aksi hâlde cevap sıfır bakiye değil "bulunamadı" olur. Listeden farklı olarak bu okuma en iyi çaba ile yapılmaz: okunamayan bir bakiye isteği başarısız kılar. GET /v2/users/{user_id}/wallets/{wallet_id}/currency-tokens/{currency_token_id} ucunun yerini alır.

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/{asset_id}

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. Kullanıcı ID'si
wallet_id	string	path	Zorunlu. Cüzdan ID'si
network_id	string	path	Zorunlu. Ağ ID'si; varlığın ağı olmalı ve cüzdanın zincirinde bulunmalı
asset_id	string	path	Zorunlu. Para birimi token ID'si (listedeki bir assets[].id)

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

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

Yanıt

{
  "currency_token": {
    "id": "6900a1fd2a4de1c5748e9dcc",
    "node_id": "665ae536a6392b75cfd40352",
    "type": 1,
    "status": 3,
    "name": "USD Coin",
    "symbol": "USDC",
    "total_supply": "0",
    "description": "Stablecoin pegged to USD",
    "decimals": 6,
    "meta": {
      "logo": {
        "url": "https://s3.tokenizationtr.com/currencies/usdc.svg"
      }
    },
    "contract": {
      "address": "0x6810572a2e15fd1508b485b053417e9397e70f49"
    },
    "is_active": true,
    "created_at": "2025-10-28T10:59:09.752Z",
    "updated_at": "2025-10-28T10:59:09.752Z"
  },
  "amount": "988.4805"
}

Yanıt Alanları

Alan	Tip	Açıklama
currency_token	object	Varlık
currency_token.id	string	Para birimi token ID'si
currency_token.node_id	string	Para birimi token'ının sahibi olan düğüm
currency_token.type	integer	1 Stable, 2 Utility, 3 Native
currency_token.status	integer	1 Draft, 2 InProgress, 3 Active, 4 Error, 5 Passive (burada her zaman 3)
currency_token.name	string	Ad
currency_token.symbol	string	Sembol
currency_token.total_supply	string	Toplam arz
currency_token.description	string	Açıklama
currency_token.decimals	integer	Ondalık basamak
currency_token.meta.logo	object | null	Logo; url görsel adresidir
currency_token.contract.address	string	Kontrat adresi
currency_token.is_active	boolean	Aktiflik bayrağı
currency_token.created_at	string	ISO 8601 oluşturulma zamanı
currency_token.updated_at	string	ISO 8601 son değişiklik zamanı
amount	string	Cüzdanın bu varlıktaki bakiyesi

Hatalar

Durum	Kod	Açıklama
400	10016	wallet_id geçerli bir ID değil
400	10000	asset_id geçerli bir ID değil
400	10001	Cüzdan bulunamadı ya da bu kullanıcıya ait değil (domain 1, mesaj user not found)
404	10001	Domain 15: varlık bulunamadı, asset is not on this network ya da network does not belong to this wallet's chain
400	10005	Varlık aktif değil (domain 15)
400	10004	Varlığın kontratı deploy edilmemiş (domain 15)
400	10015	network not found / currency token has no network

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