Kurulumun Geçerli Ücretlerini Al

Bir kurulumun entity bazında (sahip, platform sahibi, düğüm) geçerli ücretlerini, kurulumun ücret kontratına en son gönderildiği haliyle döner: çözümlenmiş oranlar, her oranın geldiği kapsam seviyesi ve ücret satırı, kategori bazlı override'lar ve bu gönderimin hâlâ pending, zincirde confirmed ya da failed olup olmadığı. Düğüm API anahtarınızın düğüm alt ağacında olmalı ve kurulum o düğüme ait olmalıdır.

Bir kurulum bu kayıtları kontratları dağıtıldığında alır; sonraki her ücret gönderimi onları yeniden yazar. Dağıtılmamış bir kurulum items: [] döner. Dağıtım olmadan neyin geçerli olacağını önizlemek için Geçerli Ücreti Al ucunu kullanın. Bkz. Ücretlere Genel Bakış.

Gerekli izin: fee:view

İstek

GET /v2/admin/fees/nodes/{node_id}/setups/{setup_id}/effective

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Kurulumun sahibi olan düğüm
setup_id	string	path	Zorunlu. Kurulum ID'si

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/fees/nodes/6a4bef2b1e781b11c22e9707/setups/6a552db09c6088e126a4be87/effective' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "items": [
    {
      "entity": 3,
      "value": {
        "tokenization": {
          "asset_tokenization": { "value": "3.5" },
          "tokenized_asset_sales": { "value": "1" },
          "management": { "value": "0.5" }
        },
        "secondary_market": {
          "buy_order": { "value": "1" },
          "sell_order": { "value": "1" },
          "otc_sale": { "value": "1.5" }
        },
        "lending": {
          "borrower": { "value": "0" },
          "lending": { "value": "0" },
          "liquidation": { "value": "0" }
        }
      },
      "sources": {
        "asset_tokenization": { "level": "setup", "fee_id": "6a5530c19c6088e126a4be9a" },
        "tokenized_asset_sales": { "level": "setup", "fee_id": "6a5530c19c6088e126a4be9a" },
        "management": { "level": "setup", "fee_id": "6a5530c19c6088e126a4be9a" },
        "buy_order": { "level": "node_network", "fee_id": "680be1f55d63bcee848d38e7" },
        "sell_order": { "level": "node_network", "fee_id": "680be1f55d63bcee848d38e7" },
        "otc_sale": { "level": "node_network", "fee_id": "680be1f55d63bcee848d38e7" },
        "borrower": { "level": "default", "fee_id": "680be1f55d63bcee848d38e5" },
        "lending": { "level": "default", "fee_id": "680be1f55d63bcee848d38e5" },
        "liquidation": { "level": "default", "fee_id": "680be1f55d63bcee848d38e5" }
      },
      "categories": [
        {
          "id": "667e9251ca818a2138ed4915",
          "int_id": 111,
          "path": "1.4.108.111",
          "is_leaf": true,
          "name": { "en": "Residential", "tr": "Konut" },
          "value": {
            "tokenization": {
              "asset_tokenization": { "value": "2" },
              "tokenized_asset_sales": { "value": "1" },
              "management": { "value": "0.5" }
            }
          }
        }
      ],
      "status": "confirmed",
      "transaction_hash": "0x9f2c1b7e4a0d3c5b6e8f1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f",
      "updated_at": "2026-10-02T09:14:27.512Z"
    }
  ]
}

Yanıt Alanları

Alan	Tip	Açıklama
items	array	Kurulumun geçerli ücreti bulunan her entity için bir kayıt
items[].entity	integer	1 sahip, 2 platform sahibi, 3 düğüm
items[].value	object	Kontratın tuttuğu oranlar; tokenization, secondary_market ve lending olarak gruplanmış
items[].value.<group>.<leaf>.value	string	Yüzde olarak oran. Hiçbir kapsamın fiyatlamadığı yaprak gelmez
items[].sources	object	Her oran için (yaprak adıyla, örneğin buy_order) nereden geldiği. Hiçbir kapsamın fiyatlamadığı oranın kaydı yoktur
items[].sources.<leaf>.level	string	Oranı sağlayan kapsam seviyesi: setup, node_network, node, network veya default
items[].sources.<leaf>.fee_id	string	Oranı sağlayan ücret satırı
items[].categories	array	Bu entity için gönderilen kategori bazlı override'lar
items[].categories[].id	string	Kategori ID'si
items[].categories[].int_id	integer	Kategorinin sayısal ID'si
items[].categories[].path	string	Kategori yolu
items[].categories[].is_leaf	boolean	Kategorinin yaprak olup olmadığı
items[].categories[].name	object	Kategorinin yerelleştirilmiş adı (en, tr). Kategori okunamadıysa gelmez
items[].categories[].value	object	Bu kategorinin oranları, value ile aynı biçimde
items[].status	string	pending (gönderim yapıldı, henüz onaylanmadı; kontrat hâlâ önceki oranları tutuyor olabilir), confirmed (kontrat bu oranları tutuyor) veya failed (gönderim başarısız; kontrat hâlâ önceki oranları tutuyor)
items[].transaction_hash	string	Bu oranları yazan işlemin hash'i. Bilinmiyorsa boş
items[].updated_at	string	Bu kaydın son değiştiği zaman

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın
400	10016	node_id veya setup_id 24 karakterlik bir hex ID değil
400	10001 (domain 2)	Düğüm bulunamadı ya da kurulum o düğüme ait değil
403	10005 (domain 2)	Düğüm, API anahtarınızın düğüm alt ağacının dışında
500	10000	Beklenmeyen sunucu hatası

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