API Docs | VordScan

Overview

The VordScan API exposes two surfaces: a direct JSON-RPC passthrough to the VordiumBFT execution node, and a REST index of on-chain data compiled by the VordScan backend.

Chain ID713714 ConsensusVordiumBFT (HotStuff 2-phase) Block timetarget 8–10 ms post-launch, currently ~100 ms Gas limit1,000,000,000 per block Native tokenVORD (18 decimals)

Authentication

All public endpoints are open and rate-limited by IP. No API key is required for read operations. Write operations (contract verification, private tags) will require a per-account token at launch.

Base URLs

RESThttps://vordscan.io/api/v2 JSON-RPChttps://vordscan.io/api/eth WebSocketwss://vordscan.io/socket/v2

JSON-RPC — `POST /api/eth`

Standard Ethereum JSON-RPC surface. Routed directly to the Forge BFT node. All eth_*, net_*, web3_*, and debug_* methods supported by Reth 2.0 are available.

POST /api/eth

Standard JSON-RPC 2.0 request body.

# Get latest block number curl -X POST https://vordscan.io/api/eth \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Common JSON-RPC methods

eth_blockNumberLatest canonical block height eth_getBlockByNumberBlock header + optional txs by number/latest eth_getBlockByHashBlock header + optional txs by hash eth_getTransactionByHashTransaction object by hash eth_getTransactionReceiptReceipt with logs and status eth_getBalanceVORD balance of an address eth_getTransactionCountNonce of an address eth_callSimulate a call — used for ERC-20 name/symbol/decimals eth_gasPriceCurrent network gas price in wei eth_chainIdReturns 0xae432 (713714) debug_traceTransactionInternal trace (when tracing enabled)

GET `/api/v2/stats`

Aggregated network counters used by the homepage stats bar. Refreshed by the indexer every few seconds.

GET /api/v2/stats

curl https://vordscan.io/api/v2/stats

Response shape

{
  "total_blocks": "833914",
  "total_transactions": "0",
  "total_addresses": "9750",
  "average_block_time": 100.0,
  "gas_prices": { "slow": 0.01, "average": 0.01, "fast": 0.01 },
  "network_utilization_percentage": 0.0
}

GET `/api/v2/blocks`

Paginated list of the most recent blocks with metadata, transaction counts, miner (fee recipient) and gas usage.

GET /api/v2/blocks?type=block&items_count=25

typeblock | reorg | uncle (default: block) items_count1–100, default 25 block_numberpagination cursor

GET `/api/v2/blocks/:number_or_hash`

Full detail for a single block. Accepts block number or hash.

GET /api/v2/blocks/189088

GET `/api/v2/transactions`

Paginated list of recent transactions. Can be filtered by method, type, or status.

GET /api/v2/transactions?filter=validated

filtervalidated | pending typetransaction | token_transfer | contract_call method4-byte selector (0xa9059cbb) items_count1–100, default 25

GET `/api/v2/transactions/:hash`

Full detail for a single transaction, including logs, state changes, and gas accounting.

GET /api/v2/transactions/:hash

GET `/api/v2/addresses/:address`

Account-level information — balance, transaction count, first/last seen, token portfolio.

GET /api/v2/addresses/:address

Sub-resources

/transactionsAll transactions for this address (paginated) /token-transfersERC-20 / 721 / 1155 transfers in/out /internal-transactionsInternal calls when tracing enabled /logsEvent logs emitted where this address was the emitter /token-balancesCurrent token holdings /countersAggregated counters (tx count, gas used, etc.)

GET `/api/v2/tokens`

Listing of ERC-20, ERC-721 and ERC-1155 tokens indexed on the chain. Returns empty list until the first tokens are deployed.

GET /api/v2/tokens?type=ERC-20

typeERC-20 | ERC-721 | ERC-1155 qsearch query (name or address) items_countpagination size

GET `/api/v2/search`

Universal search endpoint — accepts any address, tx hash, block number, token symbol, or ENS name.

GET /api/v2/search?q=0x...

WebSocket — `/socket/v2`

Real-time stream of new blocks, transactions, and address events. Real-time WebSocket stream powered by VordScan backend.

wss://vordscan.io/socket/v2/websocket

Connect via Phoenix channels. Subscribe to topics:

blocks:new_block        — new block headers
transactions:new_transaction — new pending transactions
addresses:{address}     — balance changes for an address

Need help or found a bug? Join the Vordium developer channels or open an issue on GitHub.

GitHub →

VordScan API