Oracle Metrik Özetini Getir

Bir metrik sağlayıcısının kaynağından tek bir seriyi okur ve tokenizasyon formunun ön doldurduğu piyasa listeleme değerlerini döndürür. Kaynak her istekte okunur; hiçbir şey önbelleğe alınmaz.

• Kaynağın yayımlamadığı bir değer hiçbir zaman 0 olarak değil, null olarak döner; böylece yayımlanmış bir sıfır "değer yok" durumundan ayırt edilebilir: bu girişleri olduğu gibi bırakın.
• name ve description, varsa sağlayıcının codes listesindeki code kaydından, yoksa sağlayıcının kendisinden gelir.
• rental_income para birimini taşır: platformun, sağlayıcının fiat_currency değerine karşılık gelen aktif currency token'ı cinsindendir.

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

Gerekli izin: oracle:view

İstek

GET /v2/admin/oracle-metrics/{oracle_metric_id}/summary

Parametreler

Ad	Tip	Konum	Açıklama
oracle_metric_id	string	path	Zorunlu. Metrik sağlayıcısı ID'si (24 karakterlik hex)
code	string	query	Zorunlu. Okunacak seri kodu

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/oracle-metrics/6a5d0206379ebd02e53bf1a1/summary?code=TOGG1' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "name": "Togg Şarj İstasyonu 1",
  "code": "TOGG1",
  "description": "İstanbul Ataşehir hızlı şarj istasyonu",
  "term_duration_in_months": 36,
  "min_purchase_quantity": 1,
  "max_purchase_quantity": null,
  "min_tokens_required_for_rental_income": 10,
  "rental_payment_period_in_days": 30,
  "listed_supply": 5000,
  "rental_income": {
    "id": "68fe8c129367fd414b227c7a",
    "amount": "12500.75",
    "decimal": 6,
    "symbol": "ISCN",
    "address": "0x073c0196e516a0e77b1c804d1825fb1bad23895d"
  }
}

Yanıt Alanları

Alan	Tip	Açıklama
name	string	Serinin görünen adı
code	string	İstenen kod
description	string	Serinin açıklaması
term_duration_in_months	integer | null	Varlığın ay cinsinden vadesi
min_purchase_quantity	integer | null	Satın alma başına asgari token
max_purchase_quantity	integer | null	Satın alma başına azami token
min_tokens_required_for_rental_income	integer | null	Bir sahibin kira geliri alması için gereken token sayısı
rental_payment_period_in_days	integer | null	Gün cinsinden kira ödeme periyodu
listed_supply	integer | null	Listelenen token sayısı
rental_income	object | null	Sağlayıcının fiat_currency değerinin currency token'ı cinsinden kira geliri
rental_income.id	string	Currency token ID'si
rental_income.amount	string	Kira geliri, ondalık string
rental_income.decimal	integer	Currency token'ın ondalık basamak sayısı
rental_income.symbol	string	Currency token sembolü
rental_income.address	string	Currency token sözleşme adresi (yoksa boş)

Hatalar

Durum	Kod	Açıklama
400	10015	code eksik — details alanına bakın
400	10000	oracle_metric_id geçerli bir 24 karakterlik hex ID değil
400	10001	Metrik sağlayıcısı bulunamadı ya da silinmiş (domain 53)
400	-1	Özet oluşturulamadı: kaynakta kod için veri yok, bir değer sayı değil ya da kaynak kira geliri yayımlıyor ama sağlayıcının fiat_currency değeri için aktif currency token yok. 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.