Skip to main content

List Node Platform Owner Wallets

Lists, per network, the platform owner payout wallet pinned for one node. When the node creates a setup on a network, this override is used instead of the network-wide default from List Platform Owner Wallets. A network where the node has no override has an empty address and wallet_id: the node inherits the default there.

The rows are the same networks as the network-wide listing: networks on a chain where the platform owner (root) node holds a wallet, ordered by chain name then network name.

Only the platform owner's API key may call this endpoint; any other key gets 403.

Required permission: node:summary:view

Request​

GET /v2/admin/nodes/{node_id}/platform-owner-wallets?page={page}&per_page={per_page}&search={search}

Parameters​

NameTypeInDescription
node_idstringpathRequired. The node whose overrides to list
pageintegerqueryRequired. Page number, starting at 1
per_pageintegerqueryRequired. Items per page, 1–100
searchstringqueryCase-insensitive partial match on the network name or the chain name

Headers​

NameDescription
AuthorizationRequired. Bearer <access_token>

Example​

curl --request GET \
--url '{{baseUrl}}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/platform-owner-wallets?page=1&per_page=20&search=sepolia' \
--header 'Authorization: Bearer <access_token>'

Response​

{
"data": [
{
"network_id": "68fe7b31c2d94a5e8b1f0c63",
"network_name": "Sepolia",
"chain_id": "68fe7a90c2d94a5e8b1f0c11",
"chain_name": "Ethereum",
"address": "0x2B4d6E8f0A1c37De3a0B5C2f4E6d8A1b3C5e7F9a",
"wallet_id": "6907b0d3e2f1a4c5b6d7e8fa"
}
],
"total": 1,
"page": 1,
"per_page": 20
}

Response Fields​

FieldTypeDescription
dataarrayOne row per network
data[].network_idstringNetwork id
data[].network_namestringNetwork name
data[].chain_idstringId of the network's chain record (not the numeric EVM chain id)
data[].chain_namestringChain name
data[].addressstringThe node's override payout address on this network; empty when the node inherits the default
data[].wallet_idstringThe platform owner wallet behind address; empty when no override is set
totalintegerNumber of networks matching search
pageintegerPage returned
per_pageintegerPage size used

Errors​

StatusCodeDescription
40010015Validation failed: page or per_page missing or out of range
40010016node_id is not a valid id
40310005The API key does not belong to the platform owner

See Errors for the error format and common codes.