Skip to main content

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​

NameTypeInDescription
node_idstringpathRequired. Node that owns the setup
setup_idstringpathRequired. Setup ID

Headers​

NameDescription
AuthorizationRequired. 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.

FieldTypeDescription
idstringFee row ID
entityinteger2 (platform owner)
node_idstringThe node from the path
setup_idstringThis setup when the row is its override. Omitted when the node's row was returned instead
network_idstringNetwork of the row. Omitted when the row has no network
valueobjectThe nine rates. Each leaf is { "id": 0, "value": "<percent>" }
categoriesarray or nullPer-category overrides (id, int_id, path, value)

Errors​

StatusCodeDescription
40010015Validation failed — see details
40010016node_id or setup_id is not a 24-character hex ID
40010001 (domain 2)Node not found, or the setup does not belong to the node
40010001 (domain 9)The platform owner has no row for this setup or its node
40310005 (domain 2)The node is outside your API key's node subtree
50010000Unexpected server error

See Errors for the error format and common codes.