Lux Docs

Bootnode Quick Start

Your first Lux Cloud API call

Get an API Key

Sign up at lux.cloud to get an API key.

Get Block Number

curl -X POST https://api.lux.cloud/v1/rpc/lux \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Get Balance

curl -X POST https://api.lux.cloud/v1/rpc/lux \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc":"2.0",
    "method":"eth_getBalance",
    "params":["0x9011E888251AB053B7bD1cdB598Db4f9DEd94714", "latest"],
    "id":1
  }'

Get Token Balances

curl "https://api.lux.cloud/v1/tokens/balances?address=0x9011E888..." \
  -H "Authorization: Bearer YOUR_API_KEY"

Subscribe to New Blocks (WebSocket)

const ws = new WebSocket("wss://api.lux.cloud/v1/ws/lux");

ws.onopen = () => {
  ws.send(JSON.stringify({
    jsonrpc: "2.0",
    method: "eth_subscribe",
    params: ["newHeads"],
    id: 1,
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log("New block:", data.params?.result?.number);
};

Supported Chains

ChainRPC Path
Lux C-Chain/v1/rpc/lux
Zoo/v1/rpc/zoo
Hanzo/v1/rpc/hanzo
SPC/v1/rpc/spc
Pars/v1/rpc/pars
Ethereum/v1/rpc/ethereum

Rate Limits

PlanRequests/secWebSocket connections
Free102
Pro10010
EnterpriseUnlimitedUnlimited

On this page