Ücretleri Listele

Bir entity'nin fiyatlandığı ücret satırlarını listeler; isteğe bağlı olarak tek bir düğüme ve/veya tek bir ağa daraltılabilir. Tek ücret listesi budur: /fees/owner (artık ?entity=1), /fees/platform-owner/defaults (?entity=2), /fees/nodes/{node_id}/defaults (?entity=3&node_id=) ve /fees/nodes/{node_id}/platform-owner/defaults (?entity=2&node_id=) uçlarının yerini aldı. Entity ve kapsamlar için Ücretlere Genel Bakış sayfasına bakın.

• entity=1, sahibin düğüm taşımayan satırlarını (varsayılanını ve ağ bazlı satırlarını) listeler. node_id reddedilir.
• entity=2 yalnızca platform sahibi düğümün API anahtarıyla okunabilir. node_id olmadan kurulum kapsamlı olmayan tüm platform sahibi satırlarını, node_id ile yalnızca o düğümünkileri listeler.
• entity=3 için node_id zorunludur ve düğüm API anahtarınızın düğüm alt ağacında olmalıdır. Kurulum bazlı override'lar yalnızca include_setups=true ile döner.

Gerekli izin: fee:view

İstek

GET /v2/admin/fees?entity={entity}&page={page}&per_page={per_page}

Parametreler

Ad	Tip	Konum	Açıklama
entity	integer	query	Zorunlu. Kimin ücretleri listelenecek: 1 sahip, 2 platform sahibi, 3 düğüm
node_id	string	query	Yalnızca bu düğümün satırları (24 karakter hex). entity=3 için zorunlu, entity=2 için isteğe bağlı, entity=1 için reddedilir
network_id	string	query	Yalnızca bu ağa kapsamlı satırlar (24 karakter hex). Ağı olmayan satırlar dışarıda kalır
include_setups	boolean	query	Yalnızca entity=3: düğümün kurulum bazlı override'larını da döndürür. Varsayılan false. entity=1 ve entity=2 için yok sayılır
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/fees?entity=3&node_id=6a4bef2b1e781b11c22e9707&include_setups=true&page=1&per_page=20' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "680be1f55d63bcee848d38e7",
      "entity": 3,
      "node_id": "6a4bef2b1e781b11c22e9707",
      "network_id": "6a4bf0a21e781b11c22e9712",
      "value": {
        "tokenization": {
          "asset_tokenization": { "id": 0, "value": "2.5" },
          "tokenized_asset_sales": { "id": 0, "value": "1" },
          "management": { "id": 0, "value": "0.5" }
        },
        "secondary_market": {
          "buy_order": { "id": 0, "value": "1" },
          "sell_order": { "id": 0, "value": "1" },
          "otc_sale": { "id": 0, "value": "1.5" }
        },
        "lending": {
          "borrower": { "id": 0, "value": "0" },
          "lending": { "id": 0, "value": "0" },
          "liquidation": { "id": 0, "value": "0" }
        }
      },
      "categories": null,
      "network": { "id": "6a4bf0a21e781b11c22e9712", "name": "Sepolia" },
      "node": { "id": "6a4bef2b1e781b11c22e9707" }
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Bu sayfadaki ücret satırları
data[].id	string	Ücret satırı ID'si
data[].entity	integer	1 sahip, 2 platform sahibi, 3 düğüm
data[].platform_owner_id	string	Satır bir platform sahibi kapsamı taşımıyorsa gelmez
data[].node_id	string	Satırın kapsamlandığı düğüm. Satırın düğümü yoksa gelmez
data[].setup_id	string	Satırın override ettiği kurulum. Kurulum kapsamlı olmayan satırlarda gelmez
data[].network_id	string	Satırın kapsamlandığı ağ. Satırın ağı yoksa gelmez
data[].value	object	tokenization, secondary_market ve lending olarak gruplanmış dokuz oran (bkz. Ücretlere Genel Bakış)
data[].value.<group>.<leaf>.value	string	Yüzde olarak oran, örneğin "2.5"
data[].value.<group>.<leaf>.id	integer	Yanıtlarda her zaman 0; yaprağı anahtarından tanıyın
data[].categories	array veya null	Kategori bazlı override'lar: id, int_id, path ve value ile aynı biçimde bir value
data[].network	object	Satır ağ kapsamlıysa bulunur: id ve ağın name alanı
data[].node	object	Satır düğüm kapsamlıysa bulunur: id
data[].setup	object	Satır kurulum kapsamlıysa bulunur: id
total	integer	Filtreye uyan satır sayısı
page	integer	Geçerli sayfa
per_page	integer	Sayfa başına kayıt

network, node veya setup taşımayan satır, entity genelindeki varsayılandır.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın. entity=1 ile node_id gönderildiğinde ve entity=3 node_id olmadan istendiğinde de döner
400	10001 (domain 2)	Düğüm bulunamadı
403	10005 (domain 2)	Düğüm, API anahtarınızın düğüm alt ağacının dışında
403	10003 (domain 9)	entity=2, platform sahibi düğüme ait olmayan bir anahtarla istendi
500	10000	Beklenmeyen sunucu hatası

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