Get Setup Fee

Reads the node fee (entity 3) row that applies to one setup: the setup's own override when it has one, otherwise one of the node's rows that is not setup-scoped. The rates shown are the last values confirmed on-chain for that row when there are any, otherwise the stored values. The node must be inside your API key's node subtree and the setup must belong to the node.

This returns a single stored row, not a resolution across scopes. For the resolved rates use Get Effective Fee; for what the deployed contract holds use Get Setup Effective Fees. See Fees Overview.

Required permission: fee:view

Request

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

Parameters

Name	Type	In	Description
node_id	string	path	Required. Node that owns the setup
setup_id	string	path	Required. Setup ID

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

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

Response

{
  "id": "6a5530c19c6088e126a4be9a",
  "entity": 3,
  "node_id": "6a4bef2b1e781b11c22e9707",
  "setup_id": "6a552db09c6088e126a4be87",
  "network_id": "6a4bf0a21e781b11c22e9712",
  "value": {
    "tokenization": {
      "asset_tokenization": { "id": 0, "value": "3.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

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

Field	Type	Description
id	string	Fee row ID
entity	integer	3 (node)
node_id	string	Node of the row
setup_id	string	This setup when the row is its override. Omitted when the node's row was returned instead
network_id	string	Network of the row. Omitted when the row has no network
value	object	The nine rates. Each leaf is { "id": 0, "value": "<percent>" }
categories	array or null	Per-category overrides (id, int_id, path, value)

Errors

Status	Code	Description
400	10015	Validation failed — see details
400	10016	node_id or setup_id is not a 24-character hex ID
400	10001 (domain 2)	Node not found, or the setup does not belong to the node
400	10001 (domain 9)	Neither the setup nor the node has a node fee row
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.