Fees Overview
A fee is a set of percentage rates that one party charges on the platform's operations. This page explains who charges a fee, the scopes a fee can be written at, how the rate that applies to a setup is resolved, and when a change reaches the chain. The endpoint pages in this section link back here.
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//defaults (?entity=3&nodeid=) and /fees/nodes/{nodeid}/platform-owner/defaults (?entity=2&nodeid=). See Fees Overview for entities and scopes.
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.
Get Effective Fee
Resolves what one entity charges at a given scope, live: the server walks setup → node + network → node → network → default and each level fills only the rates the more specific levels left unset (see Fees Overview). Leaving out an axis skips the levels that need it, which is how you ask what a broader scope resolves to. Because it reads the stored fee rows rather than a deployment, it also answers for scopes with no deployment yet, so you can preview a change before it is pushed. For what a deployed setup's contract actually holds, use Get Setup Effective Fees.
Get Affected Setups Count
Counts how many deployed setups a node- or network-wide fee change would be pushed to, before you make it. A change at those scopes is fanned out to every deployed setup that inherits it (see Fees Overview), so this is the number of setups whose on-chain fees may change.
Get Platform Owner Fee
Reads the platform owner's default fee: the entity 2 row with no node and no setup (see Fees Overview). Every API key may read it. The rates shown are the last values confirmed on-chain for this row when there are any, otherwise the stored values.
Upsert Platform Owner Fee
Creates or replaces the platform owner's default fee: the entity 2 row with no node and no setup (see Fees Overview). Only the platform owner node's own API key may call this; every other key gets 403.
Upsert Node Fee
Creates or replaces a node's own fee (entity 3) at a scope broader than one setup: the node-wide row, or the node's row on one network when the body carries network_id. The node must be inside your API key's node subtree. A per-setup override is written with Upsert Setup Fee instead.
Upsert Node Platform Owner Fee
Creates or replaces what the platform owner charges one node (entity 2): across every network, or on one network when the body carries network_id. Only the platform owner node's own API key may call this; every other key gets 403.
Update Fee by ID
Replaces the rates of one existing fee row, addressed by the row's own ID. The row keeps the scope it was written at (setup, node, node + network, network or default) whatever the body contains: an edit can never move a fee to another node, network or setup. To write at another scope, use the scope-addressed endpoints, which create the row there. See Fees Overview.
Get Setup Fee
Reads the node fee (entity 3) row that applies to one setup: the setup's own override when it has one, otherwise one of the node's rows that is not setup-scoped. The rates shown are the last values confirmed on-chain for that row when there are any, otherwise the stored values. The node must be inside your API key's node subtree and the setup must belong to the node.
Upsert Setup Fee
Creates or replaces a node's fee override (entity 3) for one setup. The row is scoped to the setup and stamped with the setup's network. The node must be inside your API key's node subtree and the setup must belong to the node. See Fees Overview.
Get Setup Effective Fees
Returns a setup's effective fees per entity (owner, platform owner, node) as they were last pushed to the setup's fee contract: the resolved rates, the scope level and fee row each rate came from, the per-category overrides, and whether that push is still pending, confirmed on-chain or failed. The node must be inside your API key's node subtree and the setup must belong to the node.
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.
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.
Upsert Setup Platform Owner Fee
Creates or replaces what the platform owner charges one setup (entity 2, scoped to the setup and stamped with the setup's network). Only the platform owner node's own API key may call this; every other key gets 403. The setup must belong to the node. See Fees Overview.