REST API v2 — Network Data

Public, read-only REST API for indexed blockchain data. No authentication required.

This API serves indexed data — blocks, transactions, addresses, tokens, smart contracts, and network statistics. It follows the Blockscout v2 API specification, so existing Blockscout-compatible tooling works against it unchanged.

Base URL: https://xdcscan.io/api/v2

Interactive documentation with live examples: xdcscan.io/api-docs


Endpoint groups

GroupBase pathDescription
Stats/api/v2/statsChain-wide counters: total blocks, transactions, gas price
Blocks/api/v2/blocksRecent blocks and block details
Transactions/api/v2/transactionsTransactions, receipts, and internal transactions
Addresses/api/v2/addresses/{hash}Balances, counters, and per-address histories
Tokens/api/v2/tokensToken catalog, transfers, and holders
Smart contracts/api/v2/smart-contractsVerified contracts, source code, and ABIs
Search/api/v2/searchUnified search across addresses, tokens, blocks, and txs

Popular endpoints:

  • GET /api/v2/stats — network statistics
  • GET /api/v2/blocks — latest blocks
  • GET /api/v2/transactions/{hash} — transaction details
  • GET /api/v2/addresses/{hash} — address overview
  • GET /api/v2/addresses/{hash}/transactions — address transaction history
  • GET /api/v2/tokens/{hash}/holders — token holders

Example

Terminal window
curl https://xdcscan.io/api/v2/stats
{
"total_blocks": "89123456",
"total_transactions": "512345678",
"total_addresses": "2456789",
"average_block_time": 2000,
"coin_price": "0.052",
"network_utilization_percentage": 12.4
}

Authentication and rate limits

Anonymous requests share a fair-use rate limit. For production workloads, create an API key (see the Account API) and pass it as a bearer token. Details: API Keys & Rate Limits.

Pagination

List endpoints return up to 50 items per page and include next_page_params when more results are available. Pass those parameters back as query strings to fetch the next page. See the Search & Filtering Guide for a pagination walkthrough.

Reference pages