Tokens API Reference

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

List tokens

GET /api/v2/tokens

Query parameters:

curl "https://xdcscan.io/api/v2/tokens?q=usd&type=ERC-20"

Response (truncated):

{
  "items": [
    {
      "address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "name": "USD Stablecoin",
      "symbol": "USDS",
      "decimals": "18",
      "type": "ERC-20",
      "holders": "48213",
      "total_supply": "1200000000000000000000000000",
      "circulating_market_cap": "1200000000.00",
      "icon_url": "https://xdcscan.io/token-icon/usds.png"
    }
  ],
  "next_page_params": {
    "fiat_value": "1200000000.00",
    "holders_count": 48213,
    "items_count": 50,
    "name": "USD Stablecoin"
  }
}

Get a token

GET /api/v2/tokens/{address_hash}

curl https://xdcscan.io/api/v2/tokens/0xabcdefabcdefabcdefabcdefabcdefabcdefabcd

Returns the token’s metadata: name, symbol, decimals, standard, total supply, holder count, and icon.

Token transfers

GET /api/v2/tokens/{address_hash}/transfers

curl https://xdcscan.io/api/v2/tokens/0xabcdefabcdefabcdefabcdefabcdefabcdefabcd/transfers

Each transfer item includes from, to, timestamp, tx_hash, and a total object with the transferred value and token_id (for NFTs).

Token holders

GET /api/v2/tokens/{address_hash}/holders

curl https://xdcscan.io/api/v2/tokens/0xabcdefabcdefabcdefabcdefabcdefabcdefabcd/holders

{
  "items": [
    {
      "address": {
        "hash": "0x1234567890abcdef1234567890abcdef12345678",
        "name": null,
        "is_contract": false
      },
      "value": "987654321000000000000000"
    }
  ],
  "next_page_params": {
    "items_count": 50,
    "value": "987654321000000000000000"
  }
}

Token balances for an address

GET /api/v2/addresses/{address_hash}/tokens

Query parameters:

curl "https://xdcscan.io/api/v2/addresses/0x1234567890abcdef1234567890abcdef12345678/tokens?type=ERC-20"

Each item pairs a token object with the address’s value (raw balance in the token’s smallest unit).

Token transfers for an address

GET /api/v2/addresses/{address_hash}/token-transfers

Query parameters:

curl "https://xdcscan.io/api/v2/addresses/0x1234567890abcdef1234567890abcdef12345678/token-transfers?type=ERC-20&filter=to"

Pagination

All list endpoints above paginate with next_page_params. Append each key/value pair to the query string of the next request; when next_page_params is null, you have reached the end. See the Search & Filtering Guide for a complete example.

Notes

• Token amounts are returned as integers in the token’s smallest unit — divide by 10^decimals for display.
• NFT endpoints (/api/v2/tokens/{hash}/instances) list individual token IDs with metadata links.
• Full schemas for every field are in the API Reference and the interactive docs at xdcscan.io/api-docs.