Overview

ZAN Node Service provides reliable and robust blockchain infrastructure solutions with enterprise-grade performance and security. This guide helps you get started with our API services quickly.

Supported Ecosystems

Ethereum

Network	Endpoint
Ethereum Mainnet	https://api.zan.top/node/v1/eth/mainnet/{apiKey}
Ethereum Sepolia	https://api.zan.top/node/v1/eth/sepolia/{apiKey}
Ethereum Hoodi	https://api.zan.top/node/v1/eth/hoodi/{apiKey}

Solana

Network	Endpoint
Solana Mainnet	https://api.zan.top/node/v1/solana/mainnet/{apiKey}
Solana Devnet	https://api.zan.top/node/v1/solana/devnet/{apiKey}

BNB Smart Chain

Network	Endpoint
BSC Mainnet	https://api.zan.top/node/v1/bsc/mainnet/{apiKey}
BSC Testnet	https://api.zan.top/node/v1/bsc/testnet/{apiKey}

Polygon

Network	Endpoint
Polygon Mainnet	https://api.zan.top/node/v1/polygon/mainnet/{apiKey}
Polygon Amoy	https://api.zan.top/node/v1/polygon/amoy/{apiKey}

Optimism

Network	Endpoint
Optimism Mainnet	https://api.zan.top/node/v1/opt/mainnet/{apiKey}
Optimism Sepolia	https://api.zan.top/node/v1/opt/sepolia/{apiKey}

Arbitrum

Network	Endpoint
Arbitrum One	https://api.zan.top/node/v1/arb/one/{apiKey}
Arbitrum Sepolia	https://api.zan.top/node/v1/arb/sepolia/{apiKey}

Ton

Network	Endpoint
Ton Mainnet	https://api.zan.top/node/v1/ton/mainnet/{apiKey}

Base

Network	Endpoint
Base Mainnet	https://api.zan.top/node/v1/base/mainnet/{apiKey}
Base Sepolia	https://api.zan.top/node/v1/base/sepolia/{apiKey}

zkSync Era

Network	Endpoint
zkSync Mainnet	https://api.zan.top/node/v1/zksync/mainnet/{apiKey}

Starknet

Network	Endpoint
Starknet Mainnet	https://api.zan.top/node/v1/starknet/mainnet/{apiKey}

Tron

Network	Endpoint
Tron Mainnet	https://api.zan.top/node/v1/tron/mainnet/{apiKey}/jsonrpc
Tron Nile Testnet	https://api.zan.top/node/v1/tron/nile/{apiKey}/jsonrpc

Avalanche

Network	Endpoint
Avalanche Mainnet	https://api.zan.top/node/v1/avax/mainnet/{apiKey}/ext/bc/C/rpc
Avalanche Fuji	https://api.zan.top/node/v1/avax/fuji/{apiKey}/ext/bc/C/rpc

Fantom

Network	Endpoint
Fantom Mainnet	https://api.zan.top/node/v1/ftm/mainnet/{apiKey}

Taiko

Network	Endpoint
Taiko Mainnet	https://api.zan.top/node/v1/taiko/mainnet/{apiKey}

Mantle

Network	Endpoint
Mantle Mainnet	https://api.zan.top/node/v1/mantle/mainnet/{apiKey}

Bitcoin

Network	Endpoint
Bitcoin Mainnet	https://api.zan.top/node/v1/btc/mainnet/{apiKey}
Bitcoin Testnet	https://api.zan.top/node/v1/btc/testnet/{apiKey}

Sui

Network	Endpoint
Sui Mainnet	https://api.zan.top/node/v1/sui/mainnet/{apiKey}
Sui Testnet	https://api.zan.top/node/v1/sui/testnet/{apiKey}

Aptos

Network	Endpoint
Aptos Mainnet	https://api.zan.top/node/v1/aptos/mainnet/{apiKey}/v1
Aptos Testnet	https://api.zan.top/node/v1/aptos/testnet/{apiKey}/v1

Core

Network	Endpoint
Core Mainnet	https://api.zan.top/node/v1/core/mainnet/{apiKey}

Pharos

Network	Endpoint
Pharos Atlantic	https://api.zan.top/node/v1/pharos/atlantic/{apiKey}
Pharos Mainnet	https://api.zan.top/node/v1/pharos/mainnet/{apiKey}

Mint

Network	Endpoint
Mint Mainnet	https://api.zan.top/node/v1/mint/mainnet/{apiKey}

Gravity Alpha

Network	Endpoint
Gravity Alpha Mainnet	https://api.zan.top/node/v1/gravity_alpha/mainnet/{apiKey}

Jovay

Network	Endpoint
Jovay Mainnet	https://api.zan.top/node/v1/jovay/mainnet/{apiKey}
Jovay Testnet	https://api.zan.top/node/v1/jovay/testnet/{apiKey}

Near

Network	Endpoint
Near Mainnet	https://api.zan.top/node/v1/near/mainnet/{apiKey}
Near Testnet	https://api.zan.top/node/v1/near/testnet/{apiKey}

X Layer

Network	Endpoint
X Layer Mainnet	https://api.zan.top/node/v1/xlayer/mainnet/{apiKey}

Hyperliquid

Network	Endpoint
Mainnet	https://api.zan.top/node/v1/hyperliquid/mainnet/{apiKey}/evm
Testnet	https://api.zan.top/node/v1/hyperliquid/testnet/{apiKey}/evm

Monad

Network	Endpoint
Mainnet	https://api.zan.top/node/v1/monad/mainnet/{apiKey}
Testnet	https://api.zan.top/node/v1/monad/testnet/{apiKey}

Basic Usage Instructions

ZAN Node Service provides a set of JSON-RPC APIs for you to interact with the blockchain, which are similar to the JSON-RPC APIs provided by the native node client. The easiest way to use the APIs is directly sending an HTTP POST request with the API key in the URL. Here's an example to use curl to send an HTTP POST request to get the latest block number of Ethereum mainnet.

## JSON-RPC over HTTP POST
## Replace {apiKey} with the API key you obtained from the ZAN dashboard.
## You can also replace the "eth" and "mainnet" with any other supported networks.
curl https://api.zan.top/node/v1/eth/mainnet/{apiKey} \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

And here's an example to use wscat to send a WebSocket request for the same purpose.

## JSON-RPC over WSS
## Replace {apiKey} with the API key you obtained from the ZAN dashboard.
## You can also replace the "eth" and "mainnet" with any other supported networks.
wscat -c wss://api.zan.top/node/ws/v1/eth/mainnet/{apiKey}
>{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}

See Supported Ecosystems for the endpoint URLs of the currently supported ecosystems.
See the API reference of each ecosystem for more information about the available APIs.

Authentication Methods

API Key Authentication

All API requests must be authenticated using your API key. Follow the instructions on Quickstart Guide to obtain your API key from the ZAN Node Service Console .

HTTP Header Method (Recommended)

Authorization: Bearer YOUR_API_KEY

Example with cURL:

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

Query Parameter Method

GET https://api.zan.top/node/v1/eth/mainnet?apiKey=YOUR_API_KEY

📘
Security Recommendation:
Use HTTP Header method for production environments as it's more secure and doesn't expose API keys in URLs.

Request Signing (Advanced Security)

For enhanced security, you can sign your requests using your API key secret:

const crypto = require('crypto');
const axios = require('axios');

async function sendSignedRequest() {
  const apiKey = 'YOUR_API_KEY';
  const apiSecret = 'YOUR_API_SECRET';
  const timestamp = Date.now();
  const method = 'POST';
  const path = '/node/v1/eth/mainnet';
  const body = JSON.stringify({
    jsonrpc: "2.0",
    method: "eth_blockNumber",
    params: [],
    id: 1
  });

  // Generate signature
  const message = `${timestamp}${method}${path}${body}`;
  const signature = crypto
    .createHmac('sha256', apiSecret)
    .update(message)
    .digest('hex');

  const response = await axios.post(
    `https://api.zan.top${path}`,
    body,
    {
      headers: {
        'Content-Type': 'application/json',
        'X-API-Key': apiKey,
        'X-Timestamp': timestamp,
        'X-Signature': signature
      }
    }
  );
  
  return response.data;
}

WebSocket Authentication

For real-time data streams using WebSocket connections:

const WebSocket = require('ws');

// Establish WebSocket connection
const ws = new WebSocket('wss://ws.zan.top/node/v1/eth/mainnet');

ws.on('open', function open() {
  // Send authentication message
  const authMessage = {
    action: 'authenticate',
    apiKey: 'YOUR_API_KEY',
    timestamp: Date.now()
  };
  
  // Sign the authentication message if using request signing
  const signature = generateSignature(authMessage, 'YOUR_API_SECRET');
  authMessage.signature = signature;
  
  ws.send(JSON.stringify(authMessage));
  
  // Subscribe to events after authentication
  ws.send(JSON.stringify({
    action: 'subscribe',
    channel: 'newBlocks'
  }));
});

ws.on('message', function incoming(data) {
  console.log('Received:', JSON.parse(data));
});

API Key + Secret Dual Encryption

Enforce additional security by requiring an API key secret for all requests, see Configuring secret-based two-factor authentication.

HTTPS

curl --user :{secretKey} \
  https://api.zan.top/node/ws/v1/eth/mainnet/{apiKey} \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

WebSocket

wscat -c wss://api.zan.top/node/ws/v1/eth/mainnet/{apiKey} --auth ":{secretKey}"
> {"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}

First Request Example

Prerequisites

Before making your first API call, ensure you have:

ZAN Account: Sign up at ZAN console.
API Key: Follow the instructions on Quickstart Guide to obtain your API key.
Development Environment:
- cURL or HTTP client
- Programming language of choice (Node.js, Python, etc.)
- Required libraries (see below )

Step-by-Step Guide

Get your API key and URL endpoint, for detail see Get Your API Key.

Make your first request, for detail see Verify the validity of the API Key.

Basic cURL Example:

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

Expected Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xf4240"
}

Popular Blockchain Libraries

If you plan to use the APIs in a programming language, there are plenty of libraries to help with that, including:

web3.js (for JavaScript)

var Web3 = require('web3');
var provider = 'https://api.zan.top/node/v1/eth/mainnet/{apiKey}';
var web3Provider = new Web3.providers.HttpProvider(provider);
var web3 = new Web3(web3Provider);
web3.eth.getBlockNumber().then((result) => {
  console.log("getBlockNumber(): ",result);
});

For more information, see: https://web3js.readthedocs.io.

Ethers (for JavaScript)

var ethers = require('ethers');
var url = 'https://api.zan.top/node/v1/eth/mainnet/{apiKey}';
var customHttpProvider = new ethers.providers.JsonRpcProvider(url);
customHttpProvider.getBlockNumber().then((result) => {
    console.log("getBlockNumber(): " + result);
});

For more information, see: https://docs.ethers.org.

web3.py (for Python)

from web3 import Web3, HTTPProvider
connection = Web3(HTTPProvider('https://api.zan.top/node/v1/eth/mainnet/{apiKey}'))
print ("getBlockNumber():", connection.eth.blockNumber)

For more information, see: https://web3py.readthedocs.io.

web3j (for Java/Kotlin/Scala)

Web3j client = Web3j.build(new HttpService("https://api.zan.top/node/v1/eth/mainnet/{apiKey}"));
EthBlockNumber ethBlockNumber = client.ethBlockNumber().sendAsync().get();
System.out.println("getBlockNumber(): "+ethBlockNumber.getBlockNumber());

For more information, see: https://docs.web3j.io.

Related

Quickstart Guide (Free) — Make your first API call in 5 minutes.
Error Codes — Common errors, causes, and troubleshooting steps.
Batch Requests — Send multiple JSON-RPC calls in a single HTTP request.