TRONSCAN API Documentation
Home
  • GETTING STARTED
    • API Keys
  • API ENDPOINTS
    • Account
    • Contract
    • Transactions and Transfers
    • Block
    • Tokens
    • Witness
    • Homepage & Search
    • Wallet
    • Statistics
    • Deep Analysis
  • TOTAL PROTOCOL REVENUE
    • Protocol Revenue Service API
  • Security Service
    • Security Service API
  • SUPPORT
    • Advanced Security Settings
Powered by GitBook
On this page
  • Get token list
  • Get details of all TRC20/TRC721/TRC1155 tokens or specified TRC20/TRC721/TRC1155 tokens
  • Get details of all TRC10 tokens or specified TRC10 tokens
  • Get the holder of a TRC20/TRC721/TRC1155 token
  • Get the holder of a TRC10 token
  • Get the distribution of token amounts held by holders
  • Get the price information of a specific token
  • Get a list of priced tokens
  • Get the transfer list of one TRC721 tokenId
  • Get one TRC10/TRX transfer information
  • Get inventory information of a TRC1155
  • Get the holding information of a certain tokenId in TRC1155.
  • Get the circulation of a TRC20 token
  • Get inventory information of a TRC721
  1. API ENDPOINTS

Tokens

PreviousBlockNextWitness

Last updated 1 year ago

Get token list

Returns the token info.

Note : The maximum value for limit is 500.

https://apilist.tronscanapi.com/api/tokens/overview?start=0&limit=2&verifier=all&order=desc&filter=top&sort=&showAll=1&field=

Try this endpoint in your

Query Parameters

Parameter
Description

start

Start number. Default 0

limit

Number of items per page. Default 20

order

Default in descending order; optional parameter: "desc", "asc"

filter

Token filtering, default value is "all". Optional parameter: "trc10", "trc20", "trc721", "trc1155", "all", "top"

sort

Sorting field, default is "marketcap". Optional parameter: "priceInTrx", "gain", "volume24hInTrx", "holderCount", "marketcap"

showAll

Returned data type. 0: only whitelist. 1: all. 2: exclude blacklist

field

Field names to be returned, separated by commas. If left blank, all fields will be returned

verifier

By default, tokens with type=auto are not returned. When set to "all", all tokens are returned.

Sample response

{
    "all": 82625,
    "currentWeekAll": 81,
    "currentWeekTotalAll": 57,
    "tokens": [
        {
            "abbr": "USDT",
            "announcement": "",
            "blueTag": "",
            "canShow": 1,
            "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "contractAddressLower": "tr7nhqjekqxgtci8q8zy4pl8otszgjlj6t",
            "dateCreated": 1555400628,
            "decimal": 6,
            "description": "USDT is the official stablecoin issued by Tether on the TRON network.",
            "email": "",
            "extra": "vip",
            "gain": -0.0001,
            "github": "",
            "greyTag": "",
            "imgUrl": "https://static.tronscan.org/production/logo/usdtlogo.png",
            "isTop": true,
            "issueTime": "2019-04-16 20:41:20",
            "level": "2",
            "marketcap": 676296055758.162651744384498500774922,
            "name": "Tether USD",
            "nrOfTokenHolders": 22119750,
            "ownerAddress": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
            "pairUrl": "https://sunswap.com/#/home?tokenAddress=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&type=swap",
            "priceInTrx": 15.326791179538664037,
            "priceInUsd": 1.000177699841053200,
            "projectSite": "https://tron.network/usdt",
            "publicTag": "",
            "recentTransferCount": 1773045,
            "redTag": "",
            "social_media": "[{\"method\":\"Facebook\",\"link\":\"\"},{\"method\":\"Twitter\",\"link\":\"https://twitter.com/Tether_to\"},{\"method\":\"Telegram\",\"link\":\"\"},{\"method\":\"Reddit\",\"link\":\"\"},{\"method\":\"Steem\",\"link\":\"\"},{\"method\":\"Medium\",\"link\":\"\"},{\"method\":\"Linkedin\",\"link\":\"\"},{\"method\":\"Wechat\",\"link\":\"\"},{\"method\":\"Weibo\",\"link\":\"\"}]",
            "supply": 44125091014.551106,
            "tokenType": "trc20",
            "transferCount": 967552226,
            "verifier": "robot",
            "vip": true,
            "volume24hInTrx": 352411988502.470404503170441975634585,
            "whitePaper": "https://tether.to/wp-content/uploads/2016/06/TetherWhitePaper.pdf"
        },
        {
            "abbr": "TRON",
            "canShow": 1,
            "contractAddress": "_",
            "dateCreated": 1529891469,
            "decimal": 6,
            "description": "Official Token of TRON Protocol",
            "gain": -0.008,
            "github": "https://github.com/tronprotocol",
            "imgUrl": "https://static.tronscan.org/production/logo/trx.png",
            "isTop": true,
            "level": "2",
            "marketcap": 90995853639.549692000000000000000000,
            "name": "TRX",
            "nrOfTokenHolders": 76422658,
            "ownerAddress": "-",
            "pairUrl": "https://sunswap.com/#/home",
            "priceInTrx": 1.000000000000000000,
            "priceInUsd": 0.06525682304436267,
            "projectSite": "https://tron.network/",
            "social_media": "[{\"method\":\"Twitter\",\"active\":true,\"link\":[\"twitter.com\\/Tronfoundation\"]}]",
            "supply": 90995853639.549692,
            "tokenId": 0,
            "tokenType": "trc10",
            "transferCount": 1856514990,
            "verifier": "robot",
            "vip": true,
            "volume24hInTrx": 2802517616.92402058534612123063458110,
            "whitePaper": "https://tron.network/static/doc/white_paper_v_2_0.pdf"
        }
    ],
    "total": 21,
    "total10": 3638,
    "total1155": 20,
    "total20": 77411,
    "total721": 1556,
    "totalAll": 21,
    "totalAllCount": 82625,
    "updateTime": 1680502383192,
    "valueAtLeast": 10000
}

Get details of all TRC20/TRC721/TRC1155 tokens or specified TRC20/TRC721/TRC1155 tokens

Returns the detail information of TRC20/TRC721/TRC1155 tokens.

https://apilist.tronscanapi.com/api/token_trc20?contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&showAll=1&start=&limit=

Query Parameters

Parameter
Description

contract

TRC20/TRC721/TRC1155 contract address

showAll

Returned data type. 0: only whitelist. 1: all. 2: exclude blacklist

start

Start number. Default 0

limit

Number of items per page. Default 30

Sample response

{
    "total": 1,
    "contractMap": {
        "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t": true,
        "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC": false
    },
    "rangeTotal": 1,
    "trc20_tokens": [
        {
            "issue_ts": 0,
            "symbol": "USDT",
            "totalTurnOver": "44125091014551106",
            "greyTag": "",
            "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "redTag": "",
            "publicTag": "",
            "gain": "",
            "home_page": "https://tron.network/usdt",
            "inTvcToken": true,
            "token_desc": "USDT is the official stablecoin issued by Tether on the TRON network.",
            "justSwapVolume24h": 6518772.3895511908,
            "price_trx": 0,
            "git_hub": "",
            "price": "",
            "total_supply_with_decimals": "44125091014551106",
            "transfer24h": 2193222,
            "social_media_list": [
                {
                    "name": "Twitter",
                    "url": "https://twitter.com/Tether_to"
                }
            ],
            "justSwapVolume24h_rate": -0.1373,
            "vip": true,
            "volume24h_rate": 0.033,
            "email": "",
            "announcement": "",
            "icon_url": "https://static.tronscan.org/production/logo/usdtlogo.png",
            "liquidity24h_rate": 0.0157,
            "total_supply": 0,
            "level": "2",
            "total_supply_str": "",
            "volume24h": 21231115612.35,
            "index": 1,
            "contract_name": "TetherToken",
            "blueTag": "",
            "transfer24h_rate": 0.2494,
            "market_info": {
                "fPrecision": 6,
                "fShortName": "USDT",
                "fTokenAddr": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
                "filter": false,
                "gain": -0.0001,
                "liquidity": 46903104.780281,
                "pairUrl": "https://sunswap.com/#/scanv2/detail/TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ",
                "priceInTrx": 15.323038898864725314,
                "priceInUsd": 1.000116842294540100,
                "sPrecision": 6,
                "sShortName": "TRX",
                "volume24hInTrx": 352344274662.928904839525251926296585
            },
            "volume": 0,
            "issue_address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
            "transfer_num": 967710206,
            "holders_count": 22126100,
            "liquidity24h": 116088399.898259,
            "tokenPriceLine": {
                "total": 25,
                "data": [
                    {
                        "priceUsd": "1.0002796372275067",
                        "time": "1680415200"
                    },
                    {
                        "priceUsd": "1.0000974872551347",
                        "time": "1680418800"
                    },
                    {
                        "priceUsd": "1.000138043197331",
                        "time": "1680422400"
                    },
                    {
                        "priceUsd": "0.9999265063962244",
                        "time": "1680426000"
                    },
                    {
                        "priceUsd": "1.0001346782486058",
                        "time": "1680429600"
                    },
                    {
                        "priceUsd": "1.0002122082714684",
                        "time": "1680433200"
                    },
                    {
                        "priceUsd": "0.9999236651990658",
                        "time": "1680436800"
                    },
                    {
                        "priceUsd": "1.0000648239263978",
                        "time": "1680440400"
                    },
                    {
                        "priceUsd": "1.0001626290075225",
                        "time": "1680444000"
                    },
                    {
                        "priceUsd": "1.0001840597690648",
                        "time": "1680447600"
                    },
                    {
                        "priceUsd": "1.0000984347430235",
                        "time": "1680451200"
                    },
                    {
                        "priceUsd": "1.000076358199888",
                        "time": "1680454800"
                    },
                    {
                        "priceUsd": "1.0002692505162616",
                        "time": "1680458400"
                    },
                    {
                        "priceUsd": "1.0002583194059205",
                        "time": "1680462000"
                    },
                    {
                        "priceUsd": "0.9998965460592819",
                        "time": "1680465600"
                    },
                    {
                        "priceUsd": "1.0001585781722102",
                        "time": "1680469200"
                    },
                    {
                        "priceUsd": "1.0000793177874543",
                        "time": "1680472800"
                    },
                    {
                        "priceUsd": "1.0002166615764838",
                        "time": "1680476400"
                    },
                    {
                        "priceUsd": "1.0003329925470987",
                        "time": "1680480000"
                    },
                    {
                        "priceUsd": "1.0000403422275217",
                        "time": "1680483600"
                    },
                    {
                        "priceUsd": "1.0000132523664897",
                        "time": "1680487200"
                    },
                    {
                        "priceUsd": "1.0000686978200908",
                        "time": "1680490800"
                    },
                    {
                        "priceUsd": "0.9999889036408812",
                        "time": "1680494400"
                    },
                    {
                        "priceUsd": "1.0000084591079286",
                        "time": "1680498000"
                    },
                    {
                        "priceUsd": "1.0002307515458442",
                        "time": "1680501600"
                    }
                ]
            },
            "decimals": 6,
            "name": "Tether USD",
            "issue_time": "2019-04-16 20:41:20",
            "tokenType": "trc20",
            "white_paper": "https://tether.to/wp-content/uploads/2016/06/TetherWhitePaper.pdf",
            "social_media": ""
        }
    ]
}

Get details of all TRC10 tokens or specified TRC10 tokens

Returns the detail information of TRC10 tokens.

https://apilist.tronscanapi.com/api/token?id=1002000&showAll=1&order=0&owner=&start=&limit=&id_gt=&totalAll=&name=&field=

Query Parameters

Parameter
Description

start

Start number. Default 0

limit

Number of items per page. Default 10

owner

TRC10 issuer address

id

TRC10 token ID. If id is set to 0, the token is TRX

id_gt

The ID of the returned token must be greater than this parameter value

showAll

Returned data type. 0: only whitelist. 1: all. 2: exclude blacklist

fields

Field names to be returned, separated by commas. If left blank, all fields will be returned

totalAll

When totalAll=1, the totalAll in the return value is the total number of all tokens. Otherwise, it is the number of filtered tokens

name

TRC10 token name

Sample response

{
    "total": 1,
    "data": [
        {
            "country": "no_message",
            "tokenID": 1002000,
            "participated": 0,
            "precision": 6,
            "num": 1,
            "available": 0,
            "reputation": "Ok",
            "description": "Official Token of BitTorrent Protocol",
            "issuedPercentage": 99.9988307105801,
            "nrOfTokenHolders": 16419593,
            "voteScore": 0,
            "dateCreated": 1547950149000,
            "price": 1,
            "percentage": 0,
            "startTime": 1548000000000,
            "id": 1002000,
            "issued": 9.899884240347429E17,
            "trxNum": 1,
            "abbr": "BTTOLD",
            "email": "",
            "website": "www.bittorrent.com",
            "github": "https://github.com/bittorrent",
            "level": "2",
            "announcement": "",
            "blueTag": "",
            "greyTag": "",
            "redTag": "",
            "publicTag": "",
            "availableSupply": 0,
            "totalSupply": 990000000000000000,
            "totalTurnOver": "951421714286000000.000000",
            "frozenTotal": 0,
            "frozen": [],
            "frozen_supply": [],
            "canShow": "1",
            "remaining": 11544872000000,
            "url": "www.bittorrent.com",
            "market_info": {
                "sTokenAddr": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",
                "sPrecision": 6,
                "priceInUsd": 0.000602778680780651,
                "pairUrl": "https://juststable.tronscan.org/#/wbtt",
                "volume24hGain": -26.027,
                "gain": -0.0409,
                "fShortName": "BTTOLD",
                "filter": false,
                "fPrecision": 6,
                "priceFrom": "CMC",
                "priceInTrx": 0.009235322096783673,
                "volume24hInTrx": 2207585.19516434931338253853651861,
                "fTokenAddr": "1002000",
                "sShortName": "TRX"
            },
            "frozenPercentage": 0,
            "imgUrl": "https://static.tronscan.org/production/logo/1002000.png",
            "isBlack": false,
            "new_social_media": "",
            "remainingPercentage": 0,
            "name": "BitTorrent Old",
            "ownerAddress": "TF5Bn4cJCT6GVeUgyCN4rBhDg42KBrpAjg",
            "endTime": 1548000001000,
            "white_paper": "https://www.bittorrent.com/btt/btt-docs/BitTorrent_(BTT)_White_Paper_v0.8.7_Feb_2019.pdf",
            "social_media": [
                {
                    "name": "Weibo",
                    "url": ""
                },
                {
                    "name": "Telegram",
                    "url": ""
                },
                {
                    "name": "Reddit",
                    "url": ""
                },
                {
                    "name": "Medium",
                    "url": ""
                },
                {
                    "name": "Steam",
                    "url": ""
                },
                {
                    "name": "Webchat",
                    "url": ""
                },
                {
                    "name": "Twitter",
                    "url": "twitter.com/BitTorrent"
                },
                {
                    "name": "Facebook",
                    "url": ""
                }
            ],
            "rank_order": 1000000,
            "totalTransactions": 64316999,
            "transfer24h": 24,
            "transfer24h_rate": -0.5385,
            "volume24h": 161311.88,
            "volume24h_rate": -0.2178,
            "vip": true,
            "index": 1,
            "tokenPriceLine": {
                "total": 25,
                "data": [
                    {
                        "priceUsd": "0.0006316053556967662",
                        "time": "1680415200"
                    },
                    {
                        "priceUsd": "0.0006308130697251012",
                        "time": "1680418800"
                    },
                    {
                        "priceUsd": "0.0006311042568403031",
                        "time": "1680422400"
                    },
                    {
                        "priceUsd": "0.0006228133827365995",
                        "time": "1680426000"
                    },
                    {
                        "priceUsd": "0.0006236274191620396",
                        "time": "1680429600"
                    },
                    {
                        "priceUsd": "0.0006189536918566661",
                        "time": "1680433200"
                    },
                    {
                        "priceUsd": "0.000619123616553515",
                        "time": "1680436800"
                    },
                    {
                        "priceUsd": "0.0006190714179651086",
                        "time": "1680440400"
                    },
                    {
                        "priceUsd": "0.0006184358337004404",
                        "time": "1680444000"
                    },
                    {
                        "priceUsd": "0.0006174167756009061",
                        "time": "1680447600"
                    },
                    {
                        "priceUsd": "0.0006140810775272205",
                        "time": "1680451200"
                    },
                    {
                        "priceUsd": "0.0006163849813292473",
                        "time": "1680454800"
                    },
                    {
                        "priceUsd": "0.0006156292788830611",
                        "time": "1680458400"
                    },
                    {
                        "priceUsd": "0.0006134302410101393",
                        "time": "1680462000"
                    },
                    {
                        "priceUsd": "0.0006111879329999076",
                        "time": "1680465600"
                    },
                    {
                        "priceUsd": "0.0006087101484248602",
                        "time": "1680469200"
                    },
                    {
                        "priceUsd": "0.0006093943859266943",
                        "time": "1680472800"
                    },
                    {
                        "priceUsd": "0.0006104765254933169",
                        "time": "1680476400"
                    },
                    {
                        "priceUsd": "0.0006099403665782191",
                        "time": "1680480000"
                    },
                    {
                        "priceUsd": "0.0006109640660564479",
                        "time": "1680483600"
                    },
                    {
                        "priceUsd": "0.0006074928932305812",
                        "time": "1680487200"
                    },
                    {
                        "priceUsd": "0.0006060351206330105",
                        "time": "1680490800"
                    },
                    {
                        "priceUsd": "0.0006051950190059078",
                        "time": "1680494400"
                    },
                    {
                        "priceUsd": "0.0006054012163700168",
                        "time": "1680498000"
                    },
                    {
                        "priceUsd": "0.0006032700515948471",
                        "time": "1680501600"
                    }
                ]
            }
        }
    ],
    "contractMap": {
        "TF5Bn4cJCT6GVeUgyCN4rBhDg42KBrpAjg": false
    },
    "totalAll": 1
}

Get the holder of a TRC20/TRC721/TRC1155 token

Returns the holder information of TRC20/TRC721/TRC1155 tokens.

https://apilist.tronscanapi.com/api/token_trc20/holders?start=0&limit=5&contract_address=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&holder_address=

Query Parameters

Parameter
Description

contract_address

TRC20/TRC721/TRC1155 contract address

holder_address

Token holder address

start

Start number. Default 0

limit

Number of items per page. Default 10

Sample response

{
    "total": 10000,
    "contractMap": {
        "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9": false,
        "TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb": false,
        "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t": true,
        "TV6MuMXfmLbBqPZvBHdwFsDnQeVfnmiuSi": false,
        "TT1DyeqXaaJkt6UhVYFWUXBXknaXnBudTK": false,
        "TJCo98saj6WND61g1uuKwJ9GMWMT9WkJFo": false
    },
    "trc20_tokens": [
        {
            "srTag": false,
            "srName": "",
            "balance": "9873546646139600",
            "updateBlock": 49750607,
            "addressTag": "Binance-Cold 2",
            "addressTagLogo": "https://coin.top/production/upload/logo/Binance.png",
            "holder_address": "TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb",
            "foundationTag": false,
            "analysisShow": true,
            "updateTime": 1679864391000
        },
        {
            "srTag": false,
            "srName": "",
            "balance": "3999333220555150",
            "updateBlock": 47774475,
            "addressTag": "Binance-Cold 1",
            "addressTagLogo": "https://coin.top/production/upload/logo/Binance.png",
            "holder_address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
            "foundationTag": false,
            "analysisShow": true,
            "updateTime": 1673921982000
        },
        {
            "srTag": false,
            "srName": "",
            "balance": "2061340659212102",
            "updateBlock": 49963704,
            "addressTag": "Binance-Hot",
            "addressTagLogo": "https://coin.top/production/upload/logo/Binance.png",
            "holder_address": "TV6MuMXfmLbBqPZvBHdwFsDnQeVfnmiuSi",
            "foundationTag": false,
            "analysisShow": true,
            "updateTime": 1680503880000
        },
        {
            "srTag": false,
            "srName": "",
            "balance": "1964997579001000",
            "updateBlock": 46568617,
            "addressTag": "Binance-Cold",
            "addressTagLogo": "https://coin.top/production/upload/logo/Binance.png",
            "holder_address": "TT1DyeqXaaJkt6UhVYFWUXBXknaXnBudTK",
            "foundationTag": false,
            "analysisShow": true,
            "updateTime": 1670293782000
        },
        {
            "srTag": false,
            "srName": "",
            "balance": "1351361948804180",
            "updateBlock": 49456132,
            "addressTag": "Binance",
            "addressTagLogo": "",
            "holder_address": "TJCo98saj6WND61g1uuKwJ9GMWMT9WkJFo",
            "foundationTag": false,
            "analysisShow": true,
            "updateTime": 1678980243000
        }
    ],
    "rangeTotal": 22127141
}

Get the holder of a TRC10 token

Returns the holder information of TRC10 tokens.

https://apilist.tronscanapi.com/api/tokenholders?sort=-balance&limit=20&start=0&address=TF5Bn4cJCT6GVeUgyCN4rBhDg42KBrpAjg&holder_address=

Query Parameters

Parameter
Description

start

Start number. Default 0

limit

Number of items per page. Default 10

sort

Sort fields, only supports sorting by block number. The descending order is adopted with a hyphen (-). Default: '-number'

address

TRC10 issuer address

holder_address

TRC10 holder address

Sample response

{
    "total": 10000,
    "rangeTotal": 16419593,
    "data": [
        {
            "address": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",
            "name": "BitTorrent",
            "balance": "598625477691368189",
            "updateTime": 1680485589000,
            "index": 1,
            "srTag": false,
            "foundationTag": false,
            "srName": "",
            "addressTag": "Black hole: Address(0) without private key, often used for token burn.",
            "addressTagLogo": "",
            "analysisShow": false
        },
        {
            "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
            "name": "BitTorrent",
            "balance": "136571760289947896",
            "updateTime": 1661146485000,
            "index": 2,
            "srTag": false,
            "foundationTag": false,
            "srName": "",
            "addressTagLogo": "",
            "analysisShow": false
        },
        {
            "address": "TV9p7kGr2JNiBYfuyyem6CuHrbfJXEQpFj",
            "name": "BitTorrent",
            "balance": "36748380903107404",
            "updateTime": 1656886977000,
            "index": 3,
            "srTag": false,
            "foundationTag": false,
            "srName": "",
            "addressTagLogo": "",
            "analysisShow": false
        },
        {
            "address": "TTR9YAXwFCfLKboX8e9eg5fY8eDMrSgE6V",
            "name": "BitTorrent",
            "balance": "34809332880751229",
            "updateTime": 1656903228000,
            "index": 4,
            "srTag": false,
            "foundationTag": false,
            "srName": "",
            "addressTagLogo": "",
            "analysisShow": false
        },
        {
            "address": "TSSxr68yauhJoQ97rVDnuEE75zpmdUHh1X",
            "name": "BitTorrent",
            "balance": "33617131557189593",
            "updateTime": 1656799344000,
            "index": 5,
            "srTag": false,
            "foundationTag": false,
            "srName": "",
            "addressTagLogo": "",
            "analysisShow": false
        }
    ],
    "contractMap": {
        "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5": false,
        "TV9p7kGr2JNiBYfuyyem6CuHrbfJXEQpFj": false,
        "TTR9YAXwFCfLKboX8e9eg5fY8eDMrSgE6V": false,
        "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb": false,
        "TSSxr68yauhJoQ97rVDnuEE75zpmdUHh1X": false
    }
}

Get the distribution of token amounts held by holders

Returns the distribution of token holdings among token holders.

https://apilist.tronscanapi.com/api/tokens/position-distribution?tokenId=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

Query Parameters

Parameter
Description

tokenId

Token address or token ID

Sample response

{
    "expire": 1680505803648,
    "rank1-10": "21339396114270443",
    "rank11-50": "2762355558731794",
    "rank51-100": "963739140448814",
    "rank101-500": "2949416190422246"
}

Get the price information of a specific token

Returns token price information.

https://apilist.tronscanapi.com/api/token/price?token=trx

Query Parameters

Parameter
Description

token

Token abbreviation, default is "trx"

Sample response

{
    "price_in_trx": "1.000000000000000000",
    "percent_change_24h": "-1.32633933",
    "market_cap": "5924627157.48",
    "volume_percent_change_24h": "-14.5509",
    "price_in_usd": "0.06510875200109231",
    "volume_24h": "185091667.4531934",
    "market_cap_percent_change_24h": "-1.3392",
    "from": "coinmarketcap",
    "time": 1680505501491,
    "token": "trx"
}

Get a list of priced tokens

Returns the list of tokens that have price.

https://apilist.tronscanapi.com/api/getAssetWithPriceList

No parameters required.

Sample response

{
    "data": [
        {
            "name": "Wrapped TRX",
            "logo": "https://static.tronscan.org/production/upload/logo/TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR.png?t=1598430824415",
            "id": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR",
            "abbr": "WTRX",
            "type": "trc20",
            "vip": true
        }
    ],
    "number": 1
}

Get the transfer list of one TRC721 tokenId

Returns the transfer list of a specific TRC721 token.

https://apilist.tronscanapi.com/api/trc721/transfers?limit=20&start=0&contract=THjYwnDDN6aYxrzKb88CSMTEYjBuHpoYxS&tokenId=965650

Query Parameters

Parameter
Description

start

Start number. Default 0

limit

Number of items per page. Default 20

contract

TRC721 contract address

tokenId

The ID of a TRC721 token

Sample response

{
    "token_id_info": {
        "tokenIdName": "965650",
        "tokenIdImage": "https://static.tronscan.org/production/upload/logo/00/0078186f4893cb0b57c5799da8bec800.png"
    },
    "total": 1,
    "contractMap": {
        "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb": false,
        "TNLjmMrKwAxPXabtgdLGdF1DG17kQKHZg2": false
    },
    "rangeTotal": 1,
    "contractInfo": {},
    "token_transfers": [
        {
            "transaction_id": "6e857404b7b3b8fed973442e0e2f58c3179e04893deb7a341873fa4160d5e27f",
            "block_ts": 1670256540000,
            "from_address": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",
            "to_address": "TNLjmMrKwAxPXabtgdLGdF1DG17kQKHZg2",
            "block": 46556208,
            "contract_address": "THjYwnDDN6aYxrzKb88CSMTEYjBuHpoYxS",
            "token_id": "965650",
            "event_type": "Transfer",
            "confirmed": true,
            "contractRet": "SUCCESS",
            "finalResult": "SUCCESS",
            "revert": false,
            "tokenInfo": {
                "tokenId": "THjYwnDDN6aYxrzKb88CSMTEYjBuHpoYxS",
                "tokenAbbr": "DVKNFT",
                "tokenName": "Devikins NFT",
                "tokenDecimal": 0,
                "tokenCanShow": 1,
                "tokenType": "trc721",
                "tokenLogo": "https://static.tronscan.org/production/upload/logo/THjYwnDDN6aYxrzKb88CSMTEYjBuHpoYxS.png?t=1633678055355",
                "tokenLevel": "1",
                "issuerAddr": "TRQ2EpdqBTAQ6MjWecPh8gDDUwaPYaiXaa",
                "vip": false
            },
            "from_address_tag": "Black hole: Address(0) without private key, often used for token burn.",
            "to_address_tag": ""
        }
    ]
}

Get one TRC10/TRX transfer information

Returns the transfer list of a TRC10 token or TRX.

https://apilist.tronscanapi.com/api/asset/transfer?limit=2&start=0&name=&issueAddress=TF5Bn4cJCT6GVeUgyCN4rBhDg42KBrpAjg&start_timestamp=1680480000000&end_timestamp=1680566400000&address=&relatedAddress=&confirm=&filterTokenValue=0

Query Parameters

Parameter
Description

contract

TRC20/TRC721/TRC1155 contract address

showAll

Returned data type. 0: only whitelist. 1: all. 2: exclude blacklist

name

When querying TRX transfers, fill in 'trx'

issueAddress

TRC10 issuer address

start_timestamp

Start time

end_timestamp

End time

address

Query address

relatedAddress

Same as 'address' parameter

confirm

0: Return solidified transactions; 1: Return non-solidified transactions; Not passing any value will return all

filterTokenValue

Whether to hide small amount transactions. 1: hide. 0: do not hide

Sample response

{
    "total": 6,
    "rangeTotal": 6,
    "Data": [
        {
            "blockId": 49964543,
            "transactionHash": "16fc1528f314ed9d346f7a6087ae95d7cc484ab1d57af48c3e5e50679cd0c0b3",
            "timestamp": 1680506397000,
            "transferFromAddress": "TK3C7dJN9dh1nG8PzVJYJjCiunah99y1Pt",
            "transferToAddress": "TKXFJ1ucjo1eeNE12SU7Sw94qQGF9ogHwR",
            "amount": 429322766,
            "tokenName": "1002000",
            "finalResult": "SUCCESS",
            "contractRet": "SUCCESS",
            "confirmed": true,
            "tokenInfo": {
                "tokenId": "1002000",
                "tokenAbbr": "BTTOLD",
                "tokenName": "BitTorrent Old",
                "tokenDecimal": 6,
                "tokenCanShow": 1,
                "tokenType": "trc10",
                "tokenLogo": "https://static.tronscan.org/production/logo/1002000.png",
                "tokenLevel": "2",
                "vip": true
            },
            "fromAddressIsContract": false,
            "toAddressIsContract": false
        },
        {
            "blockId": 49964306,
            "transactionHash": "b79781695a314c030e4bdcbb088666b91c7661bc23142e7181d12955da88ddf4",
            "timestamp": 1680505686000,
            "transferFromAddress": "TMG43Y5LnnT8sfU98oXYcUSKsvXFuUMac8",
            "transferToAddress": "TCRnxaac1TbdGMy3RtArZeFQdEL3GWfj14",
            "amount": 4300000000,
            "tokenName": "1002000",
            "finalResult": "SUCCESS",
            "contractRet": "SUCCESS",
            "confirmed": true,
            "tokenInfo": {
                "tokenId": "1002000",
                "tokenAbbr": "BTTOLD",
                "tokenName": "BitTorrent Old",
                "tokenDecimal": 6,
                "tokenCanShow": 1,
                "tokenType": "trc10",
                "tokenLogo": "https://static.tronscan.org/production/logo/1002000.png",
                "tokenLevel": "2",
                "vip": true
            },
            "fromAddressIsContract": false,
            "toAddressIsContract": false
        }
    ]
}

Get inventory information of a TRC1155

Returns TRC1155 inventory information.

https://apilist.tronscanapi.com/api/trc1155/inventory?contract=TREYLQ3i56GTQnaQn68woKHtDkVTcFKHjN&tokenId=&limit=2&start=0&sort=-tokenId

Query Parameters

Parameter
Description

start

Start number. Default 0

limit

Number of items per page. Default 20

contract

TRC1155 contract address

tokenId

The ID of a token in TRC1155

sort

'-tokenId': Sort in descending order by tokenId. 'tokenId': Sort in ascending order by tokenId.

Sample response

{
    "total": 2,
    "rangeTotal": 2,
    "page_size": 2,
    "code": 200,
    "data": [
        {
            "token_id": "2",
            "holders_count": 1,
            "token_imageInnerUrl": "https://static.tronscan.org/production/upload/logo/98/988e5fe9cc0c7b50e795d3f7f87a2978.png",
            "token_name": "Mutant Ape #2",
            "latest_transfer_timestamp": 1657090707000,
            "token_description": "Number one Bored Ape Club bringing Mutant Apes on Tron Network",
            "token_image": "https://ipfs.io/ipfs/QmdsxYwtbDKmx6fz6CP5FLCH3hkkuZ3EDBFBTcHHRrsSRM",
            "token_url": ""
        },
        {
            "token_id": "1",
            "holders_count": 5,
            "token_imageInnerUrl": "https://static.tronscan.org/production/upload/logo/75/75d37b177b9a7c60d5a80f463ba624f2.png",
            "token_name": "Mutant Ape #1",
            "latest_transfer_timestamp": 1661310345000,
            "token_description": "Number one Bored Ape Club bringing Mutant Apes on Tron Network",
            "token_image": "https://ipfs.io/ipfs/QmVFPvu8aeJHXyNVxpfftVHaKjRsbtH6dXWscJ2TukM3xi",
            "token_url": ""
        }
    ]
}

Get the holding information of a certain tokenId in TRC1155.

Returns the holding information of a token in TRC1155.

https://apilist.tronscanapi.com/api/trc1155/token/inventory?contract=TREYLQ3i56GTQnaQn68woKHtDkVTcFKHjN&limit=2&start=0&tokenId=1

Query Parameters

Parameter
Description

contract

TRC1155 contract address

tokenId

The ID of a token in TRC1155

start

Start number. Default 0

limit

Number of items per page. Default 20

Sample response

{
    "total": 5,
    "code": 200,
    "data": [
        {
            "holder_count": "2",
            "token_id": "1",
            "token_imageInnerUrl": "https://static.tronscan.org/production/upload/logo/75/75d37b177b9a7c60d5a80f463ba624f2.png",
            "token_name": "Mutant Ape #1",
            "owner_address": "TLwiP6eaAvjmPcETN99qZMoPZ65EDK74BH",
            "token_description": "Number one Bored Ape Club bringing Mutant Apes on Tron Network",
            "token_image": "https://ipfs.io/ipfs/QmVFPvu8aeJHXyNVxpfftVHaKjRsbtH6dXWscJ2TukM3xi",
            "token_url": ""
        },
        {
            "holder_count": "5",
            "token_id": "1",
            "token_imageInnerUrl": "https://static.tronscan.org/production/upload/logo/75/75d37b177b9a7c60d5a80f463ba624f2.png",
            "token_name": "Mutant Ape #1",
            "owner_address": "TJezP5s9U1SN44qM1JyzdAyQ3dmZATcogF",
            "token_description": "Number one Bored Ape Club bringing Mutant Apes on Tron Network",
            "token_image": "https://ipfs.io/ipfs/QmVFPvu8aeJHXyNVxpfftVHaKjRsbtH6dXWscJ2TukM3xi",
            "token_url": ""
        }
    ],
    "rangeTotal": 5,
    "page_size": 2
}

Get the circulation of a TRC20 token

Returns the circulation of a TRC20 token

https://apilist.tronscanapi.com/api/token_trc20/totalSupply?address=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

Query Parameters

Parameter
Description

address

TRC20 contract address

Sample response

44125091014.551106

Get inventory information of a TRC721

Return the inverntory information of tokens in TRC721.

https://apilist.tronscanapi.com/api/trc721/token?contract=THjYwnDDN6aYxrzKb88CSMTEYjBuHpoYxS&tokenId=&limit=2&start=0&ownerAddress=&sort=-tokenId

Query Parameters

Parameter
Description

contract

TRC721 contract address

tokenId

The ID of a token in TRC721

start

Start number. Default 0

limit

Number of items per page. Default 20

ownerAddress

TRC721 token holder address

sort

'tokenId' is in ascending order. '-tokenId' is in descending order

Sample response

{
    "total": 10000,
    "rangeTotal": 856684,
    "page_size": 2,
    "code": 200,
    "data": [
        {
            "token_id": "965650",
            "owner_address": "TNLjmMrKwAxPXabtgdLGdF1DG17kQKHZg2",
            "owner_address_tag": "",
            "owner_address_tag_logo": "",
            "token_name": "965650",
            "token_description": "Devikin are the playable characters of the blockchain game Devikins.",
            "token_image": "https://img.devikins.com/9/965650.png",
            "token_url": "https://marketplace.devikins.com/devikin/965650",
            "token_imageInnerUrl": "https://static.tronscan.org/production/upload/logo/00/0078186f4893cb0b57c5799da8bec800.png",
            "latest_transfer_timestamp": 1670256540000
        },
        {
            "token_id": "965649",
            "owner_address": "TERfaJdmMPQEAsDjVcnwUUFxDgRAfqucaP",
            "owner_address_tag": "",
            "owner_address_tag_logo": "",
            "token_name": "965649",
            "token_description": "Devikin are the playable characters of the blockchain game Devikins.",
            "token_image": "https://img.devikins.com/9/965649.png",
            "token_url": "https://marketplace.devikins.com/devikin/965649",
            "token_imageInnerUrl": "https://static.tronscan.org/production/upload/logo/11/11748026721660209d0f007329ea09dd.png",
            "latest_transfer_timestamp": 1670254638000
        }
    ],
    "contractMap": {
        "TNLjmMrKwAxPXabtgdLGdF1DG17kQKHZg2": false,
        "TERfaJdmMPQEAsDjVcnwUUFxDgRAfqucaP": false
    }
}

Note : The maximum value for limit is 50.

Try this endpoint in your

Try this endpoint in your

Note : The value sum of start and limit must be less than or equal to 10000.

Try this endpoint in your

Note : The value sum of start and limit must be less than or equal to 10000.

Try this endpoint in your

Try this endpoint in your

Note : Only some tokens have price information.

Try this endpoint in your

Try this endpoint in your

Note : The value sum of start and limit must be less than or equal to 10000.

Try this endpoint in your

Note : The value sum of start and limit must be less than or equal to 10000.

Try this endpoint in your

Note : The value sum of start and limit must be less than or equal to 10000.

Try this endpoint in your

Note : The value sum of start and limit must be less than or equal to 10000.

Try this endpoint in your

Try this endpoint in your

Note : The value sum of start and limit must be less than or equal to 10000.

Try this endpoint in your

📝
📝
📝
📝
📝
📝
📝
📝
📝
📝
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser
🔗
browser