{"openapi":"3.1.0","info":{"title":"TRC-20 Token API","version":"1.0.0","description":"Read live data on TRON's TRC-20 tokens — the standard that settles the largest share of the world's USDT (Tether) — straight from the public TronScan API, no key. Resolve any TRC-20 contract to its name, symbol, decimals, total supply, holder count, on-chain verification status and live market data (USD price, market cap, 24-hour volume); stream a token's most recent transfers decoded into from / to / amount; and rank the whole TRC-20 universe by market cap, holders or volume. Where TRON wallet APIs show an account's activity, this is the token-level view — what a token is and how it moves. The TRC-20 data layer every wallet, explorer, trading tool and analytics dashboard needs. Live; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/trc20-api","description":"oanor gateway"}],"tags":[{"name":"TRC-20"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/ranking":{"get":{"operationId":"get_v1_ranking","tags":["TRC-20"],"summary":"Top TRC-20 tokens by market cap / holders / volume","description":"","parameters":[{"name":"order","in":"query","required":false,"description":"Sort: marketcap, holders or volume","schema":{"type":"string"},"example":"marketcap"},{"name":"limit","in":"query","required":false,"description":"How many (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"TRC-20 tokens ranked by marketcap (market cap, holders or volume). Filterable via the order parameter.","count":25,"order":"marketcap","total":124737,"source":"TronScan","tokens":[{"name":"Wrapped TRX","symbol":"WTRX","holders":14322,"contract":"TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR","decimals":6,"verified":true,"price_usd":0.3161475774075891,"transfers":20556830,"market_cap_usd":1339782907.133206,"volume_24h_usd":362072208.552265},{"name":"Wrapped BTT","symbol":"WBTT","holders":47193,"contract":"TKfjV9RNKJJCqPvBtK8L7Knykh7DNWvnYt","decimals":6,"verified":true,"transfers":2041587},{"name":"Bitcoin","symbol":"BTC","holders":43039,"contract":"TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9","decimals":8,"verified":true,"price_usd":64379.64164535553,"transfers":1409965,"market_cap_usd":1129564236.357002,"volume_24h_usd":17730390535.61408},{"name":"Ethereum","symbol":"ETH","holders":27439,"contract":"THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF","decimals":18,"verified":true,"price_usd":1674.8469951604557,"transfers":974046,"market_cap_usd":813183799.054484,"volume_24h_usd":6063180657.029447},{"name":"Tether USD","symbol":"USDT","holders":74442335,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","decimals":6,"verified":true,"price_usd":0.9994104987675522,"transfers":3445370495,"market_cap_usd":89288907060.13535,"volume_24h_usd":42560039612.05911},{"name":"USD Coin Old","symbol":"USDCOLD","holders":382121,"contract":"TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8","decimals":6,"verified":true,"price_usd":0.9996507807242039,"transfers":3462096,"market_cap_usd":28134991.161352,"volume_24h_usd":4803114977.106784},{"name":"WINkLink","symbol":"WIN","holders":809051,"contract":"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7","decimals":6,"verified":true,"price_usd":1.7630639128995e-5,"transfers":12529793,"market_cap_usd":17519598.882132,"volume_24h_usd":6113923.104486},{"name":"JUST Stablecoin","symbol":"USDJ","holders":21793,"contract":"TMwFHYXLJaRUPeW6421aqXL4ZEzPRFGkGT","decimals":18,"verified":true,"price_usd":0.502821950787,"transfers":1501918,"market_cap_usd":1258909.665772,"volume_24h_usd":188.598788},{"name":"TrueUSD","symbol":"TUSD","holders":312375,"contract":"TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4","decimals":18,"verified":true,"price_usd":0.9987721091397069,"transfers":1724696,"market_cap_usd":168306538.007478,"volume_24h_usd":17790775.265889},{"name":"JUST","symbol":"JST","holders":441633,"contract":"TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9","decimals":18,"verified":true,"price_usd":0.07531975807296798,"transfers":7549745,"market_cap_usd":745665604.922383,"volume_24h_usd":25739306.279554},{"name":"SUN","symbol":"SUN","holders":82751,"contract":"TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S","decimals":18,"verified":true,"price_usd":0.016775333430497297,"transfers":2696576,"market_cap_usd":333841381.2603,"volume_24h_usd":64734424.317392},{"name":"SUNOLD","symbol":"SUNOLD","holders":163578,"contract":"TKkeiboTkxXKJpbmVFbv4a8ov5rAfRDMf9","decimals":18,"verified":true,"price_usd":16.775333430497298,"transfers":4945484,"market_cap_usd":333841381.2603,"volume_24h_usd":64734424.317392},{"name":"AINFT","symbol":"NFT","holders":2151637,"contract":"TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq","decimals":6,"verified":true,"price_usd":2.62666875225e-7,"transfers":7899975,"market_cap_usd":262664248.556248,"volume_24h_usd":6821868.919166},{"name":"HuobiToken","symbol":"HT","holders":16145,"contract":"TDyvndWuvX5xTBwHPYJi7J3Yq8pq8yh62h","decimals":18,"verified":true,"price_usd":0.0375176597555244,"transfers":368457,"market_cap_usd":750353.19511,"volume_24h_usd":340765.044934},{"name":"Dogecoin","symbol":"DOGE","holders":982,"contract":"THbVQp8kMjStKNnf2iCY6NEzThKMK5aBHg","decimals":8,"verified":true,"price_usd":0.08716554259902982,"transfers":30510,"market_cap_usd":2664806.91664,"volume_24h_usd":522765517.922661},{"name":"BitTorrent","symbol":"BTT","holders":249620,"contract":"TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4","decimals":18,"verified":true,"price_usd":2.6572016753e-7,"transfers":3310406,"market_cap_usd":263062965.8547,"volume_24h_usd":4852731.761827},{"name":"PYUSD0","symbol":"PYUSD0","holders":8,"contract":"TKkvjWuAYrNQkbo3onBDhCU77WtNPByD5a","decimals":6,"verified":true,"price_usd":0.9995952005987984,"transfers":0,"market_cap_usd":23.005335,"volume_24h_usd":22893859.606867},{"name":"MooDeng","symbol":"MooDeng","holders":646,"contract":"TSJzGxAZndouVCSFeXT84uTZDLQnoBkDYC","decimals":18,"verified":true,"price_usd":2.0530828e-5,"transfers":5955,"market_cap_usd":20530.828,"volume_24h_usd":235.35248},{"name":"ARES","symbol":"ARES","holders":2549,"contract":"TNzAJtKNmphXvkComBUazKMvZurEQRt2tn","decimals":18,"verified":true,"price_usd":4.0444775e-5,"transfers":64894,"market_cap_usd":40444.775,"volume_24h_usd":502.900453},{"name":"TTCOIN","symbol":"TC","holders":8311,"contract":"TCMwzYUUCxLkTNpXjkYSBgXgqXwt7KJ82y","decimals":4,"verified":true,"price_usd":0.000117829520267009,"transfers":32904,"market_cap_usd":706977.121602,"volume_24h_usd":318012.607045},{"name":"Klever","symbol":"KLV","holders":176841,"contract":"TVj7RNVHy6thbM7BWdSe9G6gXwKhjhdNZS","decimals":6,"verified":true,"price_usd":0.000574726706651842,"transfers":18116530,"market_cap_usd":919503.471881,"volume_24h_usd":142118.523824},{"name":"IBStoken","symbol":"IBS","holders":193,"contract":"TKtj2eCBiRKZ4EBHnu4YgwrPfVftZz1Y4x","decimals":18,"verified":true,"price_usd":0.00069801896523338,"transfers":2916,"market_cap_usd":1047028.44785,"volume_24h_usd":146865.31212},{"name":"Litecoin","symbol":"LTC","holders":5995,"contract":"TR3DLthpnDdCGabhVDbD3VMsiJoCXY3bZd","decimals":8,"verified":true,"price_usd":43.999799531627644,"transfers":197697,"market_cap_usd":4181534.4124,"volume_24h_usd":197357885.211579},{"name":"United Stables","symbol":"U","holders":64,"contract":"TFNirp6PbqYE1ZTtWuCMUKJWLNZkoCoeFJ","decimals":18,"verified":true,"price_usd":1.0000695095627137,"transfers":440,"market_cap_usd":55004023.039851,"volume_24h_usd":85147938.717457},{"name":"RealLink","symbol":"REAL","holders":11441,"contract":"TGBfBt6Y2Dm3RHdNpZAdqywBsvfdysf834","decimals":6,"verified":true,"price_usd":0.060455754885535784,"transfers":84014,"market_cap_usd":198330482.952791,"volume_24h_usd":6483493.779936}]},"meta":{"timestamp":"2026-06-14T08:04:04.902Z","request_id":"5e8c6fd2-ddbd-4c49-aa09-379f7ee0ade0"},"status":"ok","message":"Ranking retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/token":{"get":{"operationId":"get_v1_token","tags":["TRC-20"],"summary":"Full TRC-20 token metadata + market data","description":"","parameters":[{"name":"contract","in":"query","required":true,"description":"TRC-20 contract address (base58, starts with T)","schema":{"type":"string"},"example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"icon":"https://static.tronscan.org/production/logo/usdtlogo.png","name":"Tether USD","note":"Live TRC-20 token metadata and market data from TronScan. total_supply is the raw integer (with decimals applied); divide by decimals for the human amount.","source":"TronScan","symbol":"USDT","holders":74396776,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","decimals":6,"verified":false,"price_usd":0.9994104987675522,"volume_24h":42668573581.89,"total_supply":"89341574028133753","liquidity_24h":162078686.81751904,"market_cap_usd":89288907060.13535,"issue_timestamp":0},"meta":{"timestamp":"2026-06-14T08:04:05.130Z","request_id":"649fde03-eca6-437c-bc6c-2b8b448e6d6e"},"status":"ok","message":"Token retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/transfers":{"get":{"operationId":"get_v1_transfers","tags":["TRC-20"],"summary":"A token's most recent transfers, decoded","description":"","parameters":[{"name":"contract","in":"query","required":true,"description":"TRC-20 contract address","schema":{"type":"string"},"example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The token's most recent TRC-20 transfers, decoded into from / to / amount (raw integer). This is the token's transfer feed, not a single wallet's.","count":20,"total":10000,"source":"TronScan","contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","transfers":[{"to":"TU3PYfKxNLb4kUVTmimtZHPGxqzW7g1W8L","from":"TEbfjUjsQudgJVPeVSbZsBx4RYqWsoQAmP","block":83584976,"amount":"9619999","confirmed":false,"timestamp":1781424240000,"transaction_id":"3c3c27dd6346abc4478fa4c9c05fed8cb57ab2b94698c02005590a8e9189608a"},{"to":"TXe31JpKEjb9Jr1sqNnSssD6gTZd9RHUtJ","from":"TBm4GqjqYsKKLjSJhxwPUqn927qDGhAbj7","block":83584976,"amount":"7001000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"90558e61c042ccae2cfb02bb930433a715c8553fdbc0b301d81b5483f7e9b540"},{"to":"TGemQhixbXegnw5AucUL5bhisZwVaJFU7A","from":"TEVbXxJ9mCnv1jWaaTBmCx5bpEpv67rb2U","block":83584976,"amount":"1701050000","confirmed":false,"timestamp":1781424240000,"transaction_id":"6817ee8e49dbb2c8d4c3795b55d71ae1f7c605f2a366af615a3910a06d6d779b"},{"to":"TVv5WViURydvCVbTzXMyBYvduErNnJSC5b","from":"TLk9o9sdMmtx27mGhWuaWet4nV4eDfBp2R","block":83584976,"amount":"231000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"7e940c2543713363c71501eb08f7f080e64292d2919c68e21f1ffa7985425ec4"},{"to":"TTaJTS6M6ihgYXPBAmxE48h4p6SPyybVYM","from":"TCfvdBVA6U6DdYm27mLheVvSjMD7dyhZ1y","block":83584976,"amount":"10000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"5fb79ef26178251a8c0c6f9d93314a618b88e41e4b2d2ab86efa0b5a14523f2d"},{"to":"TRpoEJk9XAS5LiV3ybaWtLFpPNYomY9LwX","from":"TQw6rHJNzGMJ9VjTZrbGVHkvnq4Vif7YDH","block":83584976,"amount":"140000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"053dcf444936fd0a3b1c3417ae7af995e0bac73a5f672aef482499089dcb098c"},{"to":"TVsNtUobZjL3DkWTzS58D1tAUgJXyW3Jyy","from":"TPTLx3Z7bokUW5YUQjeifLDkqX4x56zQAB","block":83584976,"amount":"25900000","confirmed":false,"timestamp":1781424240000,"transaction_id":"8949bbe33404cb75f155a6d8f87e166d1c4a26ba8b4d27affd7e39593b6ead1c"},{"to":"TPt7SQ8BvhyxDE7MTJ1VrHVHrmVuLaGjRS","from":"TArexWbA3fsYmm4XvTuchrhqx96NTzxSV9","block":83584976,"amount":"73520000","confirmed":false,"timestamp":1781424240000,"transaction_id":"89e0c2cb3a4c257a40466496dad229c4f214d3a5ce2563fda8e9ea109623d0cb"},{"to":"TZBdZSgqU9jj52WHuDouHqjw9fPX888888","from":"TDEnrtGcFyuwApDrXAwoWdbnXs4vpCUzDH","block":83584976,"amount":"100000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"47e26f5597b9f994d2423ce337744ebfca7b7e6531a288969df1c75509da3ea2"},{"to":"TSYEpT3q5n5kTfnp5BzSacBxGFqtzBt1jW","from":"TZG7k7WjAbefsRb9QV1mw4EKBehe5ewdux","block":83584976,"amount":"19323000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"92a6c9817d7f7ca9e7b714e8660a0057cacff14bb9bfe6c0404876101df0375c"},{"to":"TWUP7cwgmMeqP6B18AxJA9tivaBWQWBDV3","from":"TDsxnT3cybUbTZ2khsNwqZ816hKxBNro11","block":83584976,"amount":"497000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"5121b59252658336b000c58131ac4b573a305a7e96104077192d927062c0aa6e"},{"to":"TWjPT5cQ8WxPHRst97T1RaounDENPb8cCi","from":"TT6Avoru8dmgMKMJV8qT3kosAXdv44o4ib","block":83584976,"amount":"1687600000","confirmed":false,"timestamp":1781424240000,"transaction_id":"72157150d3d0a4cc276417e09b91fb0c7a585331a10424a563ebaacbe6edb676"},{"to":"TUwC6tTfcurdwvqRykWWavYRVgR4tGFtEu","from":"TM6RHB796TnijFZpgmMUagD8mSR8BJ6yDg","block":83584976,"amount":"144000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"e8b90d5b0ffa821daea5ce4324d2c307907b4df00b9f7321dcf275ab39066f38"},{"to":"TBhTpZkLJ9iKgvgtGBTyUjEQo2PkfWkyXJ","from":"TBHfCYi8yaky7fe9nMKvgjDeWxEbgYjc9H","block":83584976,"amount":"100000000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"ce307b44fba13ad36904a374f751471e94db8d0cf374b57f45210814ee25e1c4"},{"to":"TFZHdPZtk2JdZedG3w1q6HpheTyqFZGYvg","from":"TDoXUNZ6PajKuiUkcYg3EDSV9bnqGqsbcf","block":83584976,"amount":"600000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"8ec2195993d621d2555041215a5634dc5027a819ac2ebfc0270381558b3f8790"},{"to":"TFMDt7dZ15CvDgGSiQRxEKuLSNvan61Xtj","from":"THu42jk29AvZnZqywhxzZxLLciFogErXwr","block":83584976,"amount":"25000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"88d33435cafe05139019b0fe715ab16af4fbb41fe29ba197c6625a80e6e001d9"},{"to":"TPdY5kMA88wK8gkyhLmijXShWkhrLUx4ZD","from":"TVaby8485Pr6wMoB1DBbkBWMY999999999","block":83584976,"amount":"2000000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"314f9171308d63a2c142b548c9d3b531b1e00f3217641105039b92851c80dad3"},{"to":"THbYZMdLKC4QZFmqzXBuZjJmPn1NS7TpB3","from":"TCv7xEajwgPhsYkuvWj2WNaH2UKySzVn77","block":83584976,"amount":"1000000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"97e9f88ac40ad56bc5371eb00760075280f2c0b2a36f501dc00d0e738990c714"},{"to":"TEhwZPRRB5rZCgTL9npnvMFNDMAaZHbFKP","from":"TFjDn9hACXUvA1Mv3zoGVpWfzjvi2zwXdS","block":83584976,"amount":"700000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"626f005b673af7208643627cbc8540360bf31981ac07a4de16b69b897644b140"},{"to":"TUMemXRjj5HVwZGspAmx68KZbme4YSqvGi","from":"TWJB1GCiGXC8FnygMs33HEkbUmmeMqzuKZ","block":83584976,"amount":"800000000","confirmed":false,"timestamp":1781424240000,"transaction_id":"b4ef5bf888ec5eb44dafed05c551a90046029a96769d3b2df2935e0296e961f7"}]},"meta":{"timestamp":"2026-06-14T08:04:05.376Z","request_id":"a20aafb2-a401-4729-a37e-e341f8df585e"},"status":"ok","message":"Transfers retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"symbol":"USDT","holders":74396776},"source":"public TronScan API (apilist.tronscanapi.com), keyless","service":"trc20-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/token":"Full TRC-20 token metadata + market data (contract=TR7NHqj...).","GET /v1/ranking":"Top TRC-20 tokens by market cap / holders / volume (order, limit).","GET /v1/transfers":"A token's most recent transfers decoded (contract, limit)."},"description":"Read live TRC-20 token data on TRON from the public TronScan API: resolve any contract to name/symbol/decimals/supply/holders/verification plus live USD price, market cap and volume; stream a token's recent transfers; or rank the TRC-20 universe by market cap or holders. The token-level view for TRON wallets, explorers and trading tools. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:05.476Z","request_id":"f90ad65b-3c56-45dd-a9b6-c4b58fbf7ab4"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6600,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1260,"monthly_call_quota":127000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4050,"monthly_call_quota":780000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":11800,"monthly_call_quota":4900000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/trc20-api"}