Get Setup Owner Fee

Reads the owner's fee row (entity 1) for one setup. Owner fees are authored on the owner side and mirrored here once the owner's change is confirmed on-chain, so this endpoint is read-only. The node must be inside your API key's node subtree and the setup must belong to the node. See Fees Overview.

When the setup has no owner fee of its own, the response is 200 with the body null; the owner's broader rows then apply (list them with List Fees and entity=1).

Required permission: fee:view

Request

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

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/owner' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "id": "6a5541779c6088e126a4beb0",
  "entity": 1,
  "node_id": "6a4bef2b1e781b11c22e9707",
  "setup_id": "6a552db09c6088e126a4be87",
  "network_id": "6a4bf0a21e781b11c22e9712",
  "value": {
    "tokenization": {
      "asset_tokenization": { "id": 0, "value": "0.5" },
      "tokenized_asset_sales": { "id": 0, "value": "0.5" },
      "management": { "id": 0, "value": "0.5" }
    },
    "secondary_market": {
      "buy_order": { "id": 0, "value": "0.5" },
      "sell_order": { "id": 0, "value": "0.5" },
      "otc_sale": { "id": 0, "value": "0.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, or null.

Field	Type	Description
id	string	Fee row ID
entity	integer	1 (owner)
node_id	string	The node from the path
setup_id	string	The setup from the path
network_id	string	The setup's 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
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.