List Platform Owner Wallets

Lists, per network, the platform owner's default payout wallet. When a setup is created on a network, this wallet is copied onto it as the setup's platform owner fee-recipient wallet, unless the node has its own override (see List Node Platform Owner Wallets). Creating a setup on a network with neither an override nor a default is refused with code 10025. Existing setups keep the wallet they were created with.

Only networks on a chain where the platform owner (root) node holds a wallet are listed, ordered by chain name then network name. A network with no default has an empty address and wallet_id.

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/platform-owner-wallets?page={page}&per_page={per_page}&search={search}

Parameters

Name	Type	In	Description
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100
search	string	query	Case-insensitive partial match on the network name or the chain name

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

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

Response

{
  "data": [
    {
      "network_id": "68fe7b31c2d94a5e8b1f0c63",
      "network_name": "Sepolia",
      "chain_id": "68fe7a90c2d94a5e8b1f0c11",
      "chain_name": "Ethereum",
      "address": "0x7De3a0B5C2f4E6d8A1b3C5e7F9a2B4d6E8f0A1c3",
      "wallet_id": "6907b0d3e2f1a4c5b6d7e8f9"
    },
    {
      "network_id": "68fe7b31c2d94a5e8b1f0c64",
      "network_name": "Amoy",
      "chain_id": "68fe7a90c2d94a5e8b1f0c12",
      "chain_name": "Polygon",
      "address": "",
      "wallet_id": ""
    }
  ],
  "total": 2,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	One row per network
data[].network_id	string	Network id
data[].network_name	string	Network name
data[].chain_id	string	Id of the network's chain record (not the numeric EVM chain id)
data[].chain_name	string	Chain name
data[].address	string	Default payout address on this network; empty when none is set
data[].wallet_id	string	The platform owner wallet behind address; empty when none is set or the address is not one of the platform owner's wallets
total	integer	Number of networks matching search
page	integer	Page returned
per_page	integer	Page size used

Errors

Status	Code	Description
400	10015	Validation failed: page or per_page missing or out of range
403	10005	The API key does not belong to the platform owner

See Errors for the error format and common codes.