Common Network & Authentication (TronScan)
The Base URL and authentication method are consistent across all TronScan endpoints. This document provides a unified reference; individual endpoint pages do not repeat this information — they only provide METHOD path and link back here.
1. Networks & Base URLs
| Network | Base URL | API Key |
|---|---|---|
| Mainnet | https://apilist.tronscanapi.com | Required |
| Shasta Testnet | https://shastapi.tronscan.org | Unsupported |
| Nile Testnet | https://nileapi.tronscan.org | Unsupported |
An API Key is required for calling Mainnet endpoints. Calling without a Key is subject to extremely strict limitations (very low QPS, high risk of rate limits), and some endpoints may fail directly and return
401when called anonymously. Tier definitions are in §3.
2. Authentication
- Authentication header:
TRON-PRO-API-KEY: <your-key>(recommended for Mainnet; testnet does not accept a Key). - Injection: pass in the request header; examples use
<your-key>as a placeholder — do not put real Keys in documentation or examples.
3. API Key Tiers (tier definitions)
| Tier | Meaning |
|---|---|
| Required | Cannot be called without a Key |
| Required / Strongly Recommended | An API Key must be provided for normal calls; anonymous calls have very low QPS and some endpoints may directly fail |
| Optional | Works with or without a Key |
| Unsupported | This network does not accept a Key |
4. Application & Rate Limiting
- API Key application, injection method, and global quotas: see the TronScan developer portal / API Keys documentation.
- Rate limiting is global (not per-endpoint); when
429is triggered, back off perRetry-After(see Common Errors).
5. Reference Usage
Individual endpoint “Endpoint & Authentication” sections do not repeat this document. They only provide METHOD path + one line referencing this page. When a specific endpoint’s network/tier matches the table above, no additional description is needed; exceptions are noted inline on the endpoint page.