Get Fee by ID

Reads one fee row by its own ID, whatever scope it was written at (setup, node, network or default). The row's own scope decides who may read it: a node fee (entity 3) needs the node inside your API key's node subtree; an owner or platform-owner fee (entity 1 or 2) needs the platform owner node's API key. See Fees Overview.

An ID that matches no fee answers 200 with the body null.

Required permission: fee:view

Request

GET /v2/admin/fees/{fee_id}

Parameters

Name	Type	In	Description
fee_id	string	path	Required. Fee row ID (24-character hex)

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/fees/6a5530c19c6088e126a4be9a' \
  --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": "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

Field	Type	Description
id	string	Fee row ID
entity	integer	1 owner, 2 platform owner, 3 node
platform_owner_id	string	Omitted unless the row carries a platform owner scope
node_id	string	Node the row is scoped to. Omitted when the row has no node
setup_id	string	Setup the row overrides. Omitted for rows that are not setup-scoped
network_id	string	Network the row is scoped to. Omitted when the row has no network
value	object	The nine rates, grouped as tokenization, secondary_market and lending
value.<group>.<leaf>.value	string	Rate in percent
value.<group>.<leaf>.id	integer	Always 0 in responses; identify a leaf by its key
categories	array or null	Per-category overrides
categories[].id	string	Category ID
categories[].int_id	integer	Category numeric ID
categories[].path	string	Category path
categories[].value	object	Rates for this category, same shape as value

Errors

Status	Code	Description
400	10015	Validation failed — see details
400	10016	fee_id is not a 24-character hex ID
400	10001 (domain 2)	The node the row is scoped to was not found
403	10005 (domain 2)	The row's node is outside your API key's node subtree
403	10003 (domain 9)	An owner or platform-owner row 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.