Upsert Node Fee

Creates or replaces a node's own fee (entity 3) at a scope broader than one setup: the node-wide row, or the node's row on one network when the body carries network_id. The node must be inside your API key's node subtree. A per-setup override is written with Upsert Setup Fee instead.

The row is saved and returned at once. Pushing it on-chain is asynchronous: every deployed setup of the node (on that network, when network_id is set) whose effective fee changes gets node transactions (types 10, 11) on the node. Call Get Affected Setups Count first to see how many setups that is, and poll Get Node Transactions for the result. See Fees Overview.

Required permission: fee:upsert

Request

PUT /v2/admin/fees/nodes/{node_id}

Parameters

Name	Type	In	Description
node_id	string	path	Required. Node whose fee is written

Headers

Name	Description
Authorization	Required. Bearer <access_token>
Content-Type	Required. application/json

Body

Field	Type	Required	Description
network_id	string or null	No	Network to scope the row to. Omit or send null for the node-wide row that every network falls back to. The network must exist
value	object	Yes	The nine rates. All nine leaves are required: tokenization.asset_tokenization, tokenization.tokenized_asset_sales, tokenization.management, secondary_market.buy_order, secondary_market.sell_order, secondary_market.otc_sale, lending.borrower, lending.lending, lending.liquidation
value.<group>.<leaf>.value	string	Yes	Rate in percent, "0" to "100", at most one decimal (for example "2.5"). See Amounts and Percentages
categories	array or null	No	Per-asset-category overrides. An override on a parent category is applied to its leaf categories
categories[].id	string	Yes	Category ID (24-character hex)
categories[].value	object	Yes	Rates for this category, same shape as value

Scope is taken from the route and network_id only: entity, node_id or platform_owner_id in the body are ignored.

Example

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/fees/nodes/6a4bef2b1e781b11c22e9707' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "network_id": "6a4bf0a21e781b11c22e9712",
    "value": {
      "tokenization": {
        "asset_tokenization": { "value": "2.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" }
      }
    },
    "categories": null
  }'

Response

{
  "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
}

Response Fields

The saved fee row, in the same shape as Get Fee by ID.

Field	Type	Description
id	string	Fee row ID. Use it with Update Fee by ID
entity	integer	3 (node)
node_id	string	The node from the path
network_id	string	The network from the body. Omitted for the node-wide row
value	object	The saved rates. Each leaf is { "id": 0, "value": "<percent>" }
categories	array or null	The saved per-category overrides, expanded to leaf categories (id, int_id, path, value)

Errors

Status	Code	Description
400	10015	Validation failed — see details. Also returned when network_id names no network, and for a malformed rate
400	10016	node_id or network_id is not a 24-character hex ID
400	10001 (domain 2)	Node not found
400	10002 (domain 9)	value does not contain all nine rates
400	10001 (domain 4)	A categories[].id does not exist
403	10005 (domain 2)	The node is outside your API key's node subtree
500	10000	Unexpected server error

See Errors for the error format and common codes.