Get Networks

Returns one page of the platform's network catalog, sorted by EVM chain id (network_id) ascending. Each row carries the network's identity, the chain it belongs to and its native-currency display fields. Narrow the list to one chain with chain_id, the list a chain-scoped network picker needs.

Required permission: node:summary:view

Using network_id

A network's id from this catalog is the value every request body sends as network_id. It is a 24-character hex id, not the EVM chain id: Polygon is "6740e0a20000000000000102" in a request, while 137 is only its network_id field here.

• The caller always selects the network. Every operation that signs on chain takes the network it runs on, and the wallet that signs, from the request: deploying a node setup (POST /v2/admin/nodes/{node_id}/setups), creating a currency token (POST /v2/admin/currency-tokens), creating a KYC token (POST /v2/admin/kyc-tokens), a node or user withdraw (POST /v2/admin/nodes/{node_id}/withdraw, POST /v2/users/{user_id}/withdraw) all require both network_id and wallet_id.
• The network is never derived server-side. The API does not take it from the node, and does not pick a wallet for you even when the node holds a single wallet on the chain. A missing network_id or wallet_id is refused with 10015; a wallet that is not on the network's chain is refused as well.
• A record that already names its network keeps it. A token is created on a setup, which is a (wallet, network) pair: POST /v2/admin/tokens takes setup_id plus a network_id that must match the setup's network. Its later on-chain operations run on that network, and user operations on it (buy, sell, burn, claim) still name the user's signing wallet with wallet_id.
• Wallets belong to a chain, not to a network. One wallet signs on every network of its chain. Creating a node wallet (POST /v2/admin/nodes/{node_id}/wallets) is the one place you select a chain instead: the wallet is created on the chain's default_network_id (see Get Chains).

A few reads use the numeric EVM chain id under the name network_id: Get Gas Fee takes it as a query parameter, and the distribution token reads return it. Those pages say so.

Request

GET /v2/networks

Parameters

Name	Type	In	Description
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100
chain_id	string	query	Only the networks of this chain (chain id from Get Chains, 24-character hex)
name	string	query	Case-insensitive "contains" match on the network name

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/networks?page=1&per_page=25&chain_id=6740e0a10000000000000101' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6740e0a20000000000000101",
      "chain_id": "6740e0a10000000000000101",
      "network_id": 1,
      "name": "Ethereum",
      "slug": "ethereum",
      "logo_url": "https://s3.tokenizationtr.com/networks/ethereum-mainnet.png",
      "native_currency_symbol": "ETH",
      "native_currency_logo_url": "https://s3.tokenizationtr.com/currencies/eth.svg",
      "native_currency_decimals": 18
    },
    {
      "id": "6740e0a20000000000000102",
      "chain_id": "6740e0a10000000000000101",
      "network_id": 137,
      "name": "Polygon",
      "slug": "polygon",
      "logo_url": "https://s3.tokenizationtr.com/networks/polygon-mainnet.png",
      "native_currency_symbol": "POL",
      "native_currency_logo_url": "https://s3.tokenizationtr.com/currencies/pol.svg",
      "native_currency_decimals": 18
    }
  ],
  "total": 2,
  "page": 1,
  "per_page": 25
}

Response Fields

Field	Type	Description
data	array	The networks on this page
data[].id	string	Network id. This is the value request bodies send as network_id
data[].chain_id	string	id of the chain the network belongs to
data[].network_id	integer	EVM chain id (e.g. 1 Ethereum, 137 Polygon)
data[].name	string	Display name
data[].slug	string	Machine name (e.g. polygon)
data[].logo_url	string	Network logo URL
data[].native_currency_symbol	string	Symbol of the native currency that pays gas (e.g. ETH, POL)
data[].native_currency_logo_url	string	Native currency logo URL
data[].native_currency_decimals	integer	Decimals of the native currency
total	integer	Number of networks matching the filters
page	integer	Page number echoed back
per_page	integer	Page size echoed back

Errors

Status	Code	Description
400	10015	page or per_page is missing or out of range — see details
400	10016	chain_id is not a valid 24-character hex id
500	10000	Unexpected server-side failure

See Errors for the error format and common codes.