Skip to main content

Endpoint Discovery

Use dwellir endpoints to browse and search all available blockchain networks on Dwellir.

List all endpoints#

dwellir endpoints list

This returns every supported chain and network with connection details.

Search by name#

Find endpoints matching a keyword:

dwellir endpoints search ethereum
dwellir endpoints search polkadot

The search matches against chain names and network identifiers.

Get a specific chain#

Retrieve details for a single chain:

dwellir endpoints get base

If no match is found, the CLI returns a helpful error:

dwellir endpoints get nonexistent --json
{
  "ok": false,
  "error": {
    "code": "not_found",
    "message": "No endpoints found for 'nonexistent'.",
    "help": "Run 'dwellir endpoints list' to see all available chains."
  }
}

Filtering#

Narrow results using filter flags. These work with list, search, and get:

FlagExample valuesDescription
--ecosystemevm, substrate, cosmos, move, hyperliquid, otherFilter by blockchain ecosystem
--networkmainnet, testnet, or a specific network nameFilter by network name (case-insensitive substring match)
--node-typefull, archiveFilter by node type (case-insensitive match)
--protocolhttps, wssFilter by connection protocol
--keykey name or value (optional)Insert an API key into endpoint URLs. Pass a key name to select a specific key, or use --key alone to auto-select (requires exactly one key).

Examples#

List all EVM chains:

dwellir endpoints list --ecosystem evm

Show only mainnet endpoints for Ethereum:

dwellir endpoints search ethereum --network mainnet

List archive nodes in the Substrate ecosystem:

dwellir endpoints list --ecosystem substrate --node-type archive

Combine multiple filters:

dwellir endpoints list --ecosystem evm --network mainnet --node-type archive

Get ready-to-use URLs with your API key inserted:

dwellir endpoints search ethereum --key my-key-name --protocol https

JSON output#

Use --json to get structured data for scripting:

dwellir endpoints search ethereum --protocol https --json
{
  "ok": true,
  "data": [
    {
      "id": 41,
      "name": "Ethereum",
      "ecosystem": "evm",
      "networks": [
        {
          "id": 43,
          "name": "Mainnet",
          "nodes": [
            {
              "id": 404,
              "https": "https://api-ethereum-mainnet.n.dwellir.com/<key>",
              "wss": "wss://api-ethereum-mainnet.n.dwellir.com/<key>",
              "node_type": { "name": "Archive" }
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "command": "endpoints.search",
    "timestamp": "2026-02-26T12:00:00Z"
  }
}

The response is organized as chains containing networks, each with one or more nodes. Each node includes https and wss URLs where <key> is your API key.

Next steps#