Get Setup Platform Owner Fee
Reads the platform owner's fee row (entity 2) that applies to one setup: the platform owner's override for this setup when there is one, otherwise the platform owner's row for the setup's node that is not setup-scoped. 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 with entity=2. See Fees Overview.
Required permission: fee:view
Request
GET /v2/admin/fees/nodes/{node_id}/setups/{setup_id}/platform-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/platform-owner' \
--header 'Authorization: Bearer <access_token>'
Response
{
"id": "6a553c449c6088e126a4bea7",
"entity": 2,
"node_id": "6a4bef2b1e781b11c22e9707",
"setup_id": "6a552db09c6088e126a4be87",
"network_id": "6a4bf0a21e781b11c22e9712",
"value": {
"tokenization": {
"asset_tokenization": { "id": 0, "value": "2.1" },
"tokenized_asset_sales": { "id": 0, "value": "1.1" },
"management": { "id": 0, "value": "1.2" }
},
"secondary_market": {
"buy_order": { "id": 0, "value": "1.3" },
"sell_order": { "id": 0, "value": "1.4" },
"otc_sale": { "id": 0, "value": "1.5" }
},
"lending": {
"borrower": { "id": 0, "value": "1.6" },
"lending": { "id": 0, "value": "1.7" },
"liquidation": { "id": 0, "value": "1.8" }
}
},
"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 | 2 (platform owner) |
node_id | string | The node from the path |
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) | The platform owner has no row for this setup or its 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.