Get Chains

Returns one page of the platform's chain catalog, sorted by name. A chain groups the networks whose wallets are interchangeable: a wallet is created on a chain and can sign on every network of that chain (see Get Networks).

Chains, networks and gas data are platform reference data that admin flows and user flows read alike, so they are served under /v2/chains, /v2/networks, /v2/gas-sponsor-wallets and /v2/blockchain rather than under /v2/admin or /v2/users.

Required permission: node:summary:view

Request

GET /v2/chains

Parameters

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

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

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

Response

{
  "data": [
    {
      "id": "6740e0a10000000000000101",
      "name": "EVM",
      "slug": "evm",
      "logo_url": "",
      "default_network_id": "6740e0a20000000000000102"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 25
}

Response Fields

Field	Type	Description
data	array	The chains on this page
data[].id	string	Chain id. Pass it as chain_id to Get Networks to list the chain's networks, and as chain_id when creating a node wallet
data[].name	string	Display name
data[].slug	string	Machine name (e.g. evm)
data[].logo_url	string	Logo URL. Empty when none is set
data[].default_network_id	string	id of the network chain-scoped operations land on when this chain is selected, such as creating a node wallet. Empty when the chain has no default network; such a chain cannot host a wallet
total	integer	Number of chains matching the filter
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
500	10000	Unexpected server-side failure

See Errors for the error format and common codes.