Docs

Endpoint Discovery

Discover and search Dwellir's 150+ blockchain endpoints from the command line.

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

List all endpoints

Bash
dwellir endpoints list

This returns every supported chain and network with connection details.

Search by name

Find endpoints matching a keyword:

Bash
dwellir endpoints search ethereum
Bash
dwellir endpoints search polkadot

The search matches against chain names and network identifiers.

Get a specific chain

Retrieve details for a single chain:

Bash
dwellir endpoints get base

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

Bash
dwellir endpoints get nonexistent --json
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:

Bash
dwellir endpoints list --ecosystem evm

Show only mainnet endpoints for Ethereum:

Bash
dwellir endpoints search ethereum --network mainnet

List archive nodes in the Substrate ecosystem:

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

Combine multiple filters:

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

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

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

JSON output

Use --json to get structured data for scripting:

Bash
dwellir endpoints search ethereum --protocol https --json
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