# TronScan API

> TronScan blockchain explorer public API. On-chain data queries: accounts, transactions, transfers, contracts, tokens, blocks, super representatives, statistics, deep analysis, protocol revenue, security services. Designed for direct AI Agent access.

- Base URL (mainnet): `https://apilist.tronscanapi.com` (Shasta `https://shastapi.tronscan.org` · Nile `https://nileapi.tronscan.org`)
- Documentation site: https://docs.tronscan.org/en/api
- Authentication: Header `TRON-PRO-API-KEY` (recommended for mainnet; required by some endpoints — calls without a Key return 401; not supported on testnets)
- Global conventions (defer to each endpoint's field table for specifics): amounts are usually raw sun values (1 TRX = 1e6 sun) · timestamps are usually milliseconds (a few endpoints use seconds — see field notes) · large numbers use strings · error contract = HTTP status codes (parameter violations are often silently handled and return 200)
- Endpoint docs (current): live HTML pages `https://docs.tronscan.org/en/api/<category>/<slug>` (e.g. `GET /api/account/list` → https://docs.tronscan.org/en/api/account/account-list)
- Endpoint doc pattern (target, enabled once .md leaves ship): `https://docs.tronscan.org/llms/<method>-<path>.md`

## Guides
- [Network & Authentication](https://docs.tronscan.org/en/api/common-network-auth): Base URL (three networks), authentication header, four API Key tiers, endpoints requiring a Key, application/injection, global rate limiting
- [Errors & HTTP Status Codes](https://docs.tronscan.org/en/api/common-errors): HTTP codes, silent-200 behavior, empty result ≠ error

## Endpoints

### Account
- [GET /api/account/list](https://docs.tronscan.org/en/api/account/account-list): Get account list
- [GET /api/accountv2](https://docs.tronscan.org/en/api/account/account-detail): Get account details
- [GET /api/account/tokens](https://docs.tronscan.org/en/api/account/account-tokens): Get account token list
- [GET /api/vote](https://docs.tronscan.org/en/api/account/vote-list): Get vote list
- [GET /api/account/resource](https://docs.tronscan.org/en/api/account/account-resource): Get account resource list (Stake 1.0)
- [GET /api/account/resourcev2](https://docs.tronscan.org/en/api/account/account-resource-v2): Get account resource list (Stake 2.0)
- [GET /api/account/approve/list](https://docs.tronscan.org/en/api/account/approve-list): Get approval list
- [GET /api/account/approve/change](https://docs.tronscan.org/en/api/account/approve-change): Get account approval change records
- [GET /api/account/analysis](https://docs.tronscan.org/en/api/account/account-analysis): Get account daily analysis data list
- [GET /api/participate_project](https://docs.tronscan.org/en/api/account/participate-project): Get projects participated in by an account
- [GET /api/account/token_asset_overview](https://docs.tronscan.org/en/api/account/token-asset-overview): Get account wallet token overview
- [GET /api/multiple/chain/query](https://docs.tronscan.org/en/api/account/multiple-chain-query): Query whether an address exists on other chains

### Block
- [GET /api/block](https://docs.tronscan.org/en/api/block/block-list): Get block list or single block details
- [GET /api/block/statistic](https://docs.tronscan.org/en/api/block/block-statistic): Get block statistics

### Contract
- [GET /api/contracts](https://docs.tronscan.org/en/api/contract/contracts-list): Get contract list
- [GET /api/contract](https://docs.tronscan.org/en/api/contract/contract-detail): Get contract details
- [POST /api/contracts/smart-contract-triggers-batch](https://docs.tronscan.org/en/api/contract/smart-contract-triggers-batch): Get contract event info
- [GET /api/onecontractenergystatistic](https://docs.tronscan.org/en/api/contract/contract-energy-statistic): Get contract energy statistics
- [GET /api/contracts/top_call](https://docs.tronscan.org/en/api/contract/contracts-top-call): Get contract call statistics
- [GET /api/onecontractcallerstatistic](https://docs.tronscan.org/en/api/contract/contract-caller-statistic): Get daily unique caller count for a contract
- [GET /api/onecontracttriggerstatistic](https://docs.tronscan.org/en/api/contract/contract-trigger-statistic): Get daily trigger count list for a contract
- [GET /api/contract/analysis](https://docs.tronscan.org/en/api/contract/contract-analysis): Get contract daily analysis data list
- [GET /api/onecontractcallers](https://docs.tronscan.org/en/api/contract/contract-callers): Get all callers list for a contract
- [GET /api/contracts/trigger](https://docs.tronscan.org/en/api/contract/contracts-trigger): Get trigger transaction list

### Transactions
- [GET /api/transaction](https://docs.tronscan.org/en/api/transactions/transaction-list): Get transaction list
- [GET /api/transaction-info](https://docs.tronscan.org/en/api/transactions/transaction-info): Get transaction details by hash
- [GET /api/token_trc20/transfers](https://docs.tronscan.org/en/api/transactions/token-trc20-transfers): Get TRC20 & TRC721 transfer list
- [GET /api/token_trc1155/transfers](https://docs.tronscan.org/en/api/transactions/token-trc1155-transfers): Get TRC1155 transfer list
- [GET /api/transfer](https://docs.tronscan.org/en/api/transactions/trx-trc10-transfers): Get TRX & TRC10 transfer list
- [GET /api/internal-transaction](https://docs.tronscan.org/en/api/transactions/internal-transaction): Get internal transaction list
- [GET /api/token_trc20/transfers-with-status](https://docs.tronscan.org/en/api/transactions/trc20-transfers-with-status): Get account transaction data
- [GET /api/transaction/statistics](https://docs.tronscan.org/en/api/transactions/transaction-statistics): Get transaction statistics
- [GET /api/transfer/statistics](https://docs.tronscan.org/en/api/transactions/transfer-statistics): Get transfer distribution statistics

### Token
- [GET /api/tokens/overview](https://docs.tronscan.org/en/api/tokens/tokens-overview): Get token list
- [GET /api/token_trc20](https://docs.tronscan.org/en/api/tokens/token-trc20): Get TRC20/TRC721/TRC1155 token details
- [GET /api/token](https://docs.tronscan.org/en/api/tokens/token-trc10): Get TRC10 token details
- [GET /api/token_trc20/holders](https://docs.tronscan.org/en/api/tokens/token-trc20-holders): Get TRC20/TRC721/TRC1155 token holders
- [GET /api/tokenholders](https://docs.tronscan.org/en/api/tokens/token-trc10-holders): Get TRC10 token holders
- [GET /api/tokens/position-distribution](https://docs.tronscan.org/en/api/tokens/position-distribution): Get holder token position distribution
- [GET /api/token/price](https://docs.tronscan.org/en/api/tokens/token-price): Get price info for a specific token
- [GET /api/getAssetWithPriceList](https://docs.tronscan.org/en/api/tokens/asset-with-price-list): Get token list with prices
- [GET /api/trc721/transfers](https://docs.tronscan.org/en/api/tokens/trc721-transfers): Get TRC721 tokenId transfer list
- [GET /api/asset/transfer](https://docs.tronscan.org/en/api/tokens/asset-transfer): Get TRC10/TRX transfer info
- [GET /api/trc1155/inventory](https://docs.tronscan.org/en/api/tokens/trc1155-inventory): Get TRC1155 inventory info
- [GET /api/trc1155/token/inventory](https://docs.tronscan.org/en/api/tokens/trc1155-token-inventory): Get TRC1155 tokenId position info
- [GET /api/token_trc20/totalSupply](https://docs.tronscan.org/en/api/tokens/trc20-total-supply): Get TRC20 token circulating supply
- [GET /api/trc721/token](https://docs.tronscan.org/en/api/tokens/trc721-token): Get TRC721 inventory info

### Wallet
- [GET /api/transfer/trx](https://docs.tronscan.org/en/api/wallet/transfer-trx): Get TRX transfer list for a specific address
- [GET /api/transfer/token10](https://docs.tronscan.org/en/api/wallet/transfer-token10): Get TRC10 token transfer list for a specific address
- [GET /api/transfer/trc20](https://docs.tronscan.org/en/api/wallet/transfer-trc20): Get TRC20 token transfer list for a specific address
- [GET /api/account/wallet](https://docs.tronscan.org/en/api/wallet/account-wallet): Get account web wallet token info
- [GET /api/account/resource/unfreeze](https://docs.tronscan.org/en/api/wallet/account-resource-unfreeze): Get unfreezeble TRX amount for an address

### Witness
- [GET /api/pagewitness](https://docs.tronscan.org/en/api/witness/pagewitness): Get super representative list
- [GET /api/account/votes](https://docs.tronscan.org/en/api/witness/account-votes): Get account vote list
- [GET /api/chainparameters](https://docs.tronscan.org/en/api/witness/chainparameters): Get chain parameter list
- [GET /api/proposal](https://docs.tronscan.org/en/api/witness/proposal): Get proposal list
- [GET /api/vote/witness](https://docs.tronscan.org/en/api/witness/vote-witness): Get super representative current vote info
- [GET /api/witness/general-info](https://docs.tronscan.org/en/api/witness/witness-general-info): Get super representative homepage statistics

### Homepage
- [GET /api/system/homepage-bundle](https://docs.tronscan.org/en/api/homepage/homepage-bundle): Get TronScan homepage data
- [GET /api/search/bar](https://docs.tronscan.org/en/api/homepage/search-bar): Get popular search info
- [GET /api/search/v2](https://docs.tronscan.org/en/api/homepage/search-v2): Search tokens/contracts/accounts
- [GET /api/system/tps](https://docs.tronscan.org/en/api/homepage/system-tps): Get current TPS
- [GET /api/search/hot](https://docs.tronscan.org/en/api/homepage/search-hot): Get hot search info
- [GET /api/nodemap](https://docs.tronscan.org/en/api/homepage/nodemap): Get node info

### Statistics
- [GET /api/energydailystatistic](https://docs.tronscan.org/en/api/statistics/energydailystatistic): Get contract energy consumption data
- [GET /api/energystatistic](https://docs.tronscan.org/en/api/statistics/energystatistic): Get energy consumption distribution
- [GET /api/top10](https://docs.tronscan.org/en/api/statistics/top10): Get top 10 statistics
- [GET /api/triggeramountstatistic](https://docs.tronscan.org/en/api/statistics/triggeramountstatistic): Get contract trigger amount statistics
- [GET /api/tokenTvc](https://docs.tronscan.org/en/api/statistics/token-tvc): Get token trading volume statistics
- [GET /api/contract_caller_statistic](https://docs.tronscan.org/en/api/statistics/contract-caller-statistic-stats): Get contract caller statistics
- [GET /api/triggerstatistic](https://docs.tronscan.org/en/api/statistics/triggerstatistic): Get contract trigger statistics
- [GET /api/overview/dailyaccounts](https://docs.tronscan.org/en/api/statistics/dailyaccounts): Get daily account data
- [GET /api/funds](https://docs.tronscan.org/en/api/statistics/funds): Get TRX supply data
- [GET /api/trx/volume/sourceList](https://docs.tronscan.org/en/api/statistics/trx-volume-source-list): Get TRX trading volume source list
- [GET /api/turnover](https://docs.tronscan.org/en/api/statistics/turnover): Get circulating supply data
- [GET /api/trx/volume](https://docs.tronscan.org/en/api/statistics/trx-volume): Get TRX trading volume
- [GET /api/overview/accountswithtrx](https://docs.tronscan.org/en/api/statistics/accountswithtrx): Get count of accounts holding TRX
- [GET /api/calleraddressstatistic](https://docs.tronscan.org/en/api/statistics/calleraddressstatistic): Get contract caller address statistics
- [GET /api/freezeresource](https://docs.tronscan.org/en/api/statistics/freezeresource): Get staked resource data
- [GET /api/overview/dailyavgblockSize](https://docs.tronscan.org/en/api/statistics/dailyavgblocksize): Get daily average block size
- [GET /api/acquisition_cost_statistic](https://docs.tronscan.org/en/api/statistics/acquisition-cost-statistic): Get user acquisition cost statistics
- [GET /api/tokenTransfer/analysis](https://docs.tronscan.org/en/api/statistics/token-transfer-analysis): Get token transfer analysis data
- [GET /api/overview/dailytransactionnum](https://docs.tronscan.org/en/api/statistics/dailytransactionnum): Get daily transaction count
- [GET /api/account/active_statistic](https://docs.tronscan.org/en/api/statistics/account-active-statistic): Get account activity statistics
- [GET /api/overview/transactionnum](https://docs.tronscan.org/en/api/statistics/transactionnum): Get total transaction count trend
- [GET /api/netstatistic](https://docs.tronscan.org/en/api/statistics/netstatistic): Get network bandwidth statistics
- [GET /api/defiTvl](https://docs.tronscan.org/en/api/statistics/defi-tvl): Get DeFi TVL data
- [GET /api/overview/totalblockchainsize](https://docs.tronscan.org/en/api/statistics/totalblockchainsize): Get total blockchain size
- [GET /api/token/analysis](https://docs.tronscan.org/en/api/statistics/token-analysis): Get token analysis data
- [GET /api/stats/overview](https://docs.tronscan.org/en/api/statistics/stats-overview): Get statistics overview data

### Deep Analysis
- [GET /api/deep/account/relatedAccount](https://docs.tronscan.org/en/api/deep/deep-related-account): Get related accounts
- [GET /api/stableCoin/holder/balance/overview](https://docs.tronscan.org/en/api/deep/deep-holder-balance-overview): Get holder balance overview
- [GET /api/stableCoin/holder/change](https://docs.tronscan.org/en/api/deep/deep-holder-change): Get holder change data
- [GET /api/deep/account/holderToken/basicInfo/trc20/transfer](https://docs.tronscan.org/en/api/deep/deep-holder-trc20-transfer): Get holder account TRC20 transfers
- [GET /api/deep/stableCoin/liquidity/transaction](https://docs.tronscan.org/en/api/deep/deep-liquidity-transaction): Get liquidity transaction data
- [GET /api/account/tag](https://docs.tronscan.org/en/api/deep/deep-account-tag): Get account tag info
- [GET /api/stableCoin/transferAmount](https://docs.tronscan.org/en/api/deep/deep-stable-transfer-amount): Get stablecoin transfer amount
- [GET /api/stableCoin/holder/top](https://docs.tronscan.org/en/api/deep/deep-holder-top): Get top stablecoin holders
- [GET /api/stableCoin/pool/overview](https://docs.tronscan.org/en/api/deep/deep-pool-overview): Get liquidity pool overview
- [GET /api/deep/stableCoin/bigAmount](https://docs.tronscan.org/en/api/deep/deep-stable-big-amount): Get stablecoin large transactions
- [GET /api/stableCoin/totalSupply/change](https://docs.tronscan.org/en/api/deep/deep-total-supply-change): Get total supply change
- [GET /api/deep/stableCoin/totalSupply/keyEvents](https://docs.tronscan.org/en/api/deep/deep-key-events): Get supply key events
- [GET /api/stableCoin/totalSupply](https://docs.tronscan.org/en/api/deep/deep-total-supply): Get stablecoin total supply
- [GET /api/stableCoin/pool/info](https://docs.tronscan.org/en/api/deep/deep-pool-info): Get liquidity pool info
- [GET /api/stableCoin/blackList](https://docs.tronscan.org/en/api/deep/deep-blacklist): Get blacklist
- [GET /api/stableCoin/distribution/change](https://docs.tronscan.org/en/api/deep/deep-distribution-change): Get holding distribution change
- [GET /api/account/holderToken/basicInfo](https://docs.tronscan.org/en/api/deep/deep-holder-token-basic-info): Get basic info for held tokens
- [GET /api/stableCoin/distribution](https://docs.tronscan.org/en/api/deep/deep-distribution): Get stablecoin holding distribution
- [GET /api/account/holderToken/asset/valueInfo](https://docs.tronscan.org/en/api/deep/deep-holder-token-value-info): Get value info for held tokens
- [GET /api/account/holderToken/asset/changeBalance](https://docs.tronscan.org/en/api/deep/deep-holder-token-change-balance): Get balance change for held tokens
- [GET /api/stableCoin/tokenSupply/turnover](https://docs.tronscan.org/en/api/deep/deep-token-supply-turnover): Get supply turnover rate
- [GET /api/stableCoin/pool/trend](https://docs.tronscan.org/en/api/deep/deep-pool-trend): Get liquidity pool trend
- [GET /api/stableCoin/pool/change](https://docs.tronscan.org/en/api/deep/deep-pool-change): Get liquidity pool change
- [GET /api/stableCoin/overview](https://docs.tronscan.org/en/api/deep/deep-stable-overview): Get stablecoin overview
- [GET /api/stableCoin/tvl](https://docs.tronscan.org/en/api/deep/deep-stable-tvl): Get stablecoin TVL
- [GET /api/deep/account/transferAmount](https://docs.tronscan.org/en/api/deep/deep-transfer-amount): Get account transfer amount analysis
- [GET /api/deep/account/token/bigAmount](https://docs.tronscan.org/en/api/deep/deep-token-big-amount): Get large token transactions for an account

### Protocol Revenue
- [GET /api/turnover/new](https://docs.tronscan.org/en/api/revenue/turnover-new): Get updated circulating supply data
- [GET /api/consumption/statistic](https://docs.tronscan.org/en/api/revenue/consumption-statistic): Get consumption statistics

### Security Service
- [GET /api/security/account/data](https://docs.tronscan.org/en/api/security/security-account): Account security check
- [GET /api/security/token/data](https://docs.tronscan.org/en/api/security/security-token): Token security check
- [GET /api/security/url/data](https://docs.tronscan.org/en/api/security/security-url): URL security check
- [GET /api/security/transaction/data](https://docs.tronscan.org/en/api/security/security-transaction): Transaction security check
- [GET /api/security/sign/data](https://docs.tronscan.org/en/api/security/security-sign): Signature security check
- [GET /api/security/auth/data](https://docs.tronscan.org/en/api/security/security-auth): Authorization security check
- [GET /api/token/all](https://docs.tronscan.org/en/api/security/token-all): Get all token list

## Other Surfaces
- [MCP Server](https://docs.tronscan.org/zh/mcp) · [Skills](https://docs.tronscan.org/zh/skills) · [CLI](https://docs.tronscan.org/zh/cli)