List Fees

Lists the fee rows one entity is priced at, optionally narrowed to one node and/or one network. This is the only fee listing: it replaced /fees/owner (now ?entity=1), /fees/platform-owner/defaults (?entity=2), /fees/nodes/{node_id}/defaults (?entity=3&node_id=) and /fees/nodes/{node_id}/platform-owner/defaults (?entity=2&node_id=). See Fees Overview for entities and scopes.

• entity=1 lists the owner's rows that carry no node (its default and per-network rows). node_id is refused.
• entity=2 is readable by the platform owner node's API key only. Without node_id it lists every platform-owner row that is not setup-scoped; with node_id only that node's.
• entity=3 requires node_id, and the node must be inside your API key's node subtree. Per-setup overrides are returned only with include_setups=true.

Required permission: fee:view

Request

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

Parameters

Name	Type	In	Description
entity	integer	query	Required. Whose fees to list: 1 owner, 2 platform owner, 3 node
node_id	string	query	Only this node's rows (24-character hex). Required for entity=3, optional for entity=2, refused for entity=1
network_id	string	query	Only rows scoped to this network (24-character hex). Rows without a network are left out
include_setups	boolean	query	entity=3 only: also return the node's per-setup overrides. Default false. Ignored for entity=1 and entity=2
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

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>'

Response

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

Response Fields

Field	Type	Description
data	array	Fee rows on this page
data[].id	string	Fee row ID
data[].entity	integer	1 owner, 2 platform owner, 3 node
data[].platform_owner_id	string	Omitted unless the row carries a platform owner scope
data[].node_id	string	Node the row is scoped to. Omitted when the row has no node
data[].setup_id	string	Setup the row overrides. Omitted for rows that are not setup-scoped
data[].network_id	string	Network the row is scoped to. Omitted when the row has no network
data[].value	object	The nine rates, grouped as tokenization, secondary_market and lending (see Fees Overview)
data[].value.<group>.<leaf>.value	string	Rate in percent, for example "2.5"
data[].value.<group>.<leaf>.id	integer	Always 0 in responses; identify a leaf by its key
data[].categories	array or null	Per-category overrides: id, int_id, path and a value of the same shape as value
data[].network	object	Present when the row is network-scoped: id and the network's name
data[].node	object	Present when the row is node-scoped: id
data[].setup	object	Present when the row is setup-scoped: id
total	integer	Number of rows matching the filter
page	integer	Current page
per_page	integer	Items per page

A row with no network, node or setup is the entity-wide default.

Errors

Status	Code	Description
400	10015	Validation failed — see details. Also returned for node_id with entity=1, and for entity=3 without node_id
400	10001 (domain 2)	Node not found
403	10005 (domain 2)	The node is outside your API key's node subtree
403	10003 (domain 9)	entity=2 was requested by a key that is not the platform owner node's
500	10000	Unexpected server error

See Errors for the error format and common codes.