API Reference

All endpoints are read-only JSON over HTTPS. No authentication is required for read access. Responses are served from chainscaner.com/api/tronread. Scan results are cached server-side for 5 minutes.

Multi-chain address scan

POST /api/tronread

Returns native balances, detected token holdings (with USD valuation, dust and spam marking), active token approvals toward known spender contracts, and reputation flags across 6 EVM networks.

# request
{ "scan": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }

# response (truncated)
{
  "ok": true, "addr": "0xd8dA…", "took_ms": 1280,
  "chains": [
    { "id": "ethereum", "name": "Ethereum", "native": "ETH",
      "nativeRaw": 6717900000000000000, "nativeUsd": 18068.2,
      "tokens": [{ "sym": "USDT", "ca": "0xdAC1…", "bal": 291.36, "usd": 291.3, "spam": false }],
      "tokenTotal": 292, "spamCount": 4,
      "approvals": [{ "sym": "DAI", "label": "Permit2", "spender": "0x0000…8BA3", "unlimited": true }],
      "explorer": "https://etherscan.io" }
  ],
  "flags": {} }

TRON endpoints

Request body	Returns
`{"account":"T…"}`	Account state, TRX balance, available energy
`{"trx":"T…"}`	TRX balance (SUN)
`{"owner":"T…","token":"usdt"}`	TRC-20 balance
`{"owner":"T…","spender":"T…","token":"usdt"}`	Token balance + current allowance

Reputation flags

Request body	Returns
`{"flags":1}`	Full public flag list
`{"flag":"0x…"\|"T…"}`	Single-address lookup
`{"flagsIn":["0x…","T…"]}`	Batch lookup (max 60)

Flag entries contain reason, sev (low / high / critical) and a timestamp.

Fair use

The service is free during beta. Please keep request rates reasonable; abusive clients may be throttled. All queries are read-only — the API never creates or broadcasts transactions.

Scanner · Wallet Screening · About · Privacy · Terms