Oracle Özetini Getir

Bir fiyat oracle'ının kaynağından tek bir seriyi okur ve tokenizasyon formunun ön doldurduğu bilgileri döndürür: varlığın adı ve sembolü, toplam değeri ve bir token'ın fiyatı. Tutarların ikisi de platformun, oracle'ın fiat_currency değerine karşılık gelen aktif currency token'ı cinsindendir.

• code kaynağa olduğu gibi gönderilir. Oracle'da en az bir kod tanımlı olmalıdır, ancak istenen kodun bunlardan biri olması gerekmez.
• Tanımlayıcı alanlarda önce kaynağın yayımladığı değer, yoksa oracle kaydı kullanılır: name (kaynağın adı ya da başlığı, yoksa oracle'ın name değeri), description, code (yoksa istenen kod) ve symbol (varlığın kendi sembolü, yoksa kod).
• Özet, oracle ve kod başına oracle'ın summary_cache_ttl_seconds süresi (varsayılan 12 saat) boyunca önbellekte tutulur. Önbellekteki özet kaynak yeniden okunmadan döndürülür; Oracle Önbelleğini Temizle ile silebilirsiniz.

Tutarlar ondalık string'dir; bkz. Tutarlar ve Yüzdeler.

Gerekli izin: oracle:view

İstek

GET /v2/admin/oracles/{oracle_id}/summary

Parametreler

Ad	Tip	Konum	Açıklama
oracle_id	string	path	Zorunlu. Oracle ID'si (24 karakterlik hex)
code	string	query	Zorunlu. Okunacak seri kodu (ör. fon kodu)

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/oracles/677ed6e3cc111aea14a3dfc3/summary?code=IOG' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "name": "İŞ PORTFÖY GÜMÜŞ SERBEST FON",
  "symbol": "IOG",
  "code": "IOG",
  "description": "TEFAS Gümüş Fonu",
  "total_value": {
    "id": "68fe8c129367fd414b227c7a",
    "amount": "9724632629.88",
    "decimal": 6,
    "symbol": "ISCN",
    "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
  },
  "per_price": {
    "id": "68fe8c129367fd414b227c7a",
    "amount": "9.951079",
    "decimal": 6,
    "symbol": "ISCN",
    "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
  },
  "total_supply": 977244083
}

Yanıt Alanları

Alan	Tip	Açıklama
name	string	Varlık adı; token adını ön doldurur
symbol	string	Varlığın kendi sembolü; token sembolünü ön doldurur. Para birimi sembolü değildir
code	string	Seri kodu
description	string	Varlık açıklaması
total_value	object	Varlığın toplam değeri
total_value.id	string	Currency token ID'si
total_value.amount	string	Toplam değer, ondalık string
total_value.decimal	integer	Currency token'ın ondalık basamak sayısı
total_value.symbol	string	Currency token sembolü
total_value.address	string	Currency token sözleşme adresi (yoksa boş)
per_price	object	Bir token'ın fiyatı; alanları total_value ile aynıdır
total_supply	integer	Kaynağın seri için bildirdiği arz (purchased_supply değeri)

Hatalar

Durum	Kod	Açıklama
400	10015	code eksik — details alanına bakın
400	10000	oracle_id geçerli bir 24 karakterlik hex ID değil
400	10001	Oracle bulunamadı ya da silinmiş (domain 5)
400	-1	Özet oluşturulamadı: oracle'da tanımlı kod yok, fiat_currency için aktif currency token yok ya da kaynak kod için kullanılabilir bir total_value, token_price veya purchased_supply döndürmedi. Hangisi olduğunu message söyler
500	10000	Kaynağa ya da bir depoya ulaşılamadı

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