Chainstack · Schema

ChainstackNode

Schema for a Chainstack-managed blockchain node as exposed by the Platform API.

BlockchainMulti-ChainRPCNode InfrastructureWeb3CryptoEthereumSolanaBitcoinDeFiMEVTrader NodeArchive DataMCPAI Agents

Properties

Name	Type	Description
id	string	Stable Chainstack node identifier.
name	string	Human-readable node name.
type	string	Node deployment archetype.
protocol	string	Blockchain protocol (e.g. ethereum, solana, bitcoin, bnb, polygon, arbitrum, base, optimism, avalanche, ton, sui, tron, starknet, zksync, hyperliquid).
network	string	Network ID this node serves (e.g. ethereum-mainnet, polygon-amoy, solana-devnet).
region	string	Deployment region.
status	string	Lifecycle status of the node.
details	object	Per-protocol node details including HTTPS RPC URL, WSS URL, and any chain-specific properties.
configuration	object	Deployment configuration (machine size, archive add-on, MEV protection, etc.).
created_at	string
updated_at	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/chainstack/main/json-schema/chainstack-node-schema.json",
  "title": "ChainstackNode",
  "description": "Schema for a Chainstack-managed blockchain node as exposed by the Platform API.",
  "type": "object",
  "required": ["id", "name", "type", "protocol", "network", "status"],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^nd-[0-9]{3}-[0-9]{3}-[0-9]{3}$",
      "description": "Stable Chainstack node identifier."
    },
    "name": {
      "type": "string",
      "description": "Human-readable node name."
    },
    "type": {
      "type": "string",
      "enum": ["global", "dedicated", "unlimited", "trader"],
      "description": "Node deployment archetype."
    },
    "protocol": {
      "type": "string",
      "description": "Blockchain protocol (e.g. ethereum, solana, bitcoin, bnb, polygon, arbitrum, base, optimism, avalanche, ton, sui, tron, starknet, zksync, hyperliquid)."
    },
    "network": {
      "type": "string",
      "description": "Network ID this node serves (e.g. ethereum-mainnet, polygon-amoy, solana-devnet)."
    },
    "region": {
      "type": "string",
      "enum": ["us-east", "us-west", "eu-west", "eu-central", "ap-southeast", "ap-northeast"],
      "description": "Deployment region."
    },
    "status": {
      "type": "string",
      "enum": ["pending", "running", "stopped", "error", "deleting"],
      "description": "Lifecycle status of the node."
    },
    "details": {
      "type": "object",
      "description": "Per-protocol node details including HTTPS RPC URL, WSS URL, and any chain-specific properties.",
      "properties": {
        "https_endpoint": {
          "type": "string",
          "format": "uri",
          "description": "Authenticated HTTPS RPC URL."
        },
        "wss_endpoint": {
          "type": "string",
          "format": "uri",
          "description": "Authenticated WSS RPC URL."
        },
        "client": {
          "type": "string",
          "description": "Underlying node client (e.g. geth, erigon, nethermind, reth, solana-validator, bitcoin-core)."
        },
        "archive": {
          "type": "boolean",
          "description": "Whether this node serves archive (historical state) requests."
        },
        "extra_namespaces": {
          "type": "array",
          "items": {"type": "string"},
          "description": "Extended namespaces enabled on this node (e.g. debug, trace, txpool)."
        }
      }
    },
    "configuration": {
      "type": "object",
      "description": "Deployment configuration (machine size, archive add-on, MEV protection, etc.)."
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}