Contract

List of smart contract interfaces.

Get list of contracts

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

Returns a list of contracts.

https://apilist.tronscanapi.com/api/contracts?count=true&limit=20&confirm=0&start=0&verified-only=true&open-source-only=false&sort=-trxCount

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
search	Search by contract name, contract address
sort	Sort fields. -trxCount, -balance, -timestamp. Default: -trxCount
start	Start number. Default 0
limit	Number of items per page. Default 20
open-source-only	Whether to show only open source contracts.
verified-only	Whether to show only verified contracts

Response

Sample response

{
    "total":10000,
    "triggerTop7":[
        {
            "tag1":"USDT Token",
            "tag1Url":"https://tron.network/usdt",
            "contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "percentage":0.8975886192776561,
            "name":"TetherToken",
            "triggers":1970847
        }
    ],
    "data":[
        {
            "address":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "name":"TetherToken",
            "verify_status":2,
            "balance":846378273694,
            "trxCount":949991434,
            "date_created":1555400628000,
            "license":"0",
            "compile_version":"tron-0.4.25_Odyssey_v3.2.3",
            "compile_settings":"{\"optimizer\":0,\"constructor_params\":\"0000000000000000000000000000000000000000000000000000000000989680000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a546574686572205553440000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000045553445400000000000000000000000000000000000000000000000000000000\"}",
            "verify_time":1575472751000,
            "tag1":"USDT Token",
            "tag1Url":"https://tron.network/usdt",
            "vip":true,
            "trc20token":{
                "icon_url":"https://static.tronscan.org/production/logo/usdtlogo.png",
                "symbol":"USDT",
                "total_supply":"44125091014551106",
                "level":"2",
                "contract_address":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
                "issuer_addr":"THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
                "home_page":"https://tron.network/usdt",
                "token_desc":"USDT is the official stablecoin issued by Tether on the TRON network.",
                "holders_count":"22132393",
                "git_hub":"",
                "decimals":"6",
                "name":"Tether USD",
                "issue_time":"2019-04-16 20:41:20",
                "white_paper":"https://tether.to/wp-content/uploads/2016/06/TetherWhitePaper.pdf",
                "email":"",
                "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\":\"\"}]",
                "status":"1",
                "token_type":"trc20"
            }
        }
    ],
    "contractCount":2261713,
    "rangeTotal":33980,
    "contractCount24h":3431,
    "updateTime":1680516000000,
    "totalTrigger":2195713,
    "verifyContractCount":33980,
    "verifyContractCount24h":1,
    "status":{
        "code":0,
        "message":"SUCCESS"
    }
}

Get contract detail information

📝 Note : The maximum value for limit is 200.

Returns contract detail information.

https://apilist.tronscanapi.com/api/contract?contract=TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contract	Contract address

Response

Sample response

{
    "type":"null",
    "count":0,
    "status":{
        "code":0,
        "message":"SUCCESS"
    },
    "data":[
        {
            "address":"TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S",
            "balance":19957105809,
            "verify_status":2,
            "is_proxy":false,
            "proxy_implementation":"",
            "old_proxy_implementation":"",
            "balanceInUsd":0,
            "trxCount":757116,
            "date_created":1621864512000,
            "call_value":0,
            "call_token_value":0,
            "call_token_id":0,
            "call_token_info":{
                "tokenInfo":{
                    "tokenId":"_",
                    "tokenAbbr":"trx",
                    "tokenName":"trx",
                    "tokenDecimal":6,
                    "tokenCanShow":1,
                    "tokenType":"trc10",
                    "tokenLogo":"https://static.tronscan.org/production/logo/trx.png",
                    "tokenLevel":"2",
                    "vip":true
                }
            },
            "name":"SunToken",
            "description":"",
            "tag1":"SUN Token",
            "tag1Url":"https://sun.io/",
            "vip":true,
            "feedbackRisk":false,
            "announcement":"",
            "blueTag":"",
            "blueTagUrl":"",
            "greyTag":"",
            "redTag":"",
            "publicTag":"SUN Token",
            "creator":{
                "address":"TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm",
                "address_is_contract":false,
                "txHash":"1836ff59e1f9c46dd1682ede7824d08db922ba10162b7f69feefd76fd83c017f",
                "token_balance":0,
                "consume_user_resource_percent":0,
                "energy_remaining":0
            },
            "auditReportUrl":"",
            "auditDep":"",
            "auditDate":"",
            "methodMap":{
                "39509351":"increaseAllowance(address,uint256)",
                "23b872dd":"transferFrom(address,address,uint256)",
                "70a08231":"balanceOf(address)",
                "a9059cbb":"transfer(address,uint256)",
                "18160ddd":"totalSupply()",
                "95d89b41":"symbol()",
                "dd62ed3e":"allowance(address,address)",
                "095ea7b3":"approve(address,uint256)",
                "313ce567":"decimals()",
                "a457c2d7":"decreaseAllowance(address,uint256)",
                "06fdde03":"name()"
            },
            "energy_factor":0,
            "tokenInfo":{
                "tokenId":"TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S",
                "tokenAbbr":"SUN",
                "tokenName":"SUN",
                "tokenDecimal":18,
                "tokenCanShow":1,
                "tokenType":"trc20",
                "tokenLogo":"https://static.tronscan.org/production/logo/TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S.png",
                "tokenLevel":"2",
                "issuerAddr":"TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm",
                "vip":true
            },
            "balanceWithTokens":95414.58043381207,
            "balanceWithTokensInUsd":6266.799813970157
        }
    ]
}

Get event information of the contract

📝 Note : This is a post request, please use the post method to get the data.

Returns a list of event information for the contract.

https://apilist.tronscanapi.com/api/contracts/smart-contract-triggers-batch?fields=hash,method

Request

Query Parameters

Parameter	Description
contractAddress	Contract address
hashList	A list of transaction hashes
term	Query content, which supports the block number and event name
limit	Number of items per page. Default 20

Response

Sample response

{
    "event_list": [
        {
            "block_number": 49993470,
            "block_timestamp": 1680593202000,
            "caller_contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "event_index": 0,
            "event_name": "Transfer",
            "result_with_topic": {
                "index": [
                    {
                        "param": "from",
                        "value": "0x3402bee3959dc631ede6693cd96d79d951127d54"
                    },
                    {
                        "param": "to",
                        "value": "0xb7814f473cb0f00ebd2f6b4423904ff587571906"
                    }
                ],
                "topic": "ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "dataInArr": [
                    {
                        "param": "value",
                        "value": "0"
                    }
                ]
            },
            "result": {
                "0": "0x3402bee3959dc631ede6693cd96d79d951127d54",
                "1": "0xb7814f473cb0f00ebd2f6b4423904ff587571906",
                "2": "0",
                "from": "0x3402bee3959dc631ede6693cd96d79d951127d54",
                "to": "0xb7814f473cb0f00ebd2f6b4423904ff587571906",
                "value": "0"
            },
            "result_type": {
                "from": "address",
                "to": "address",
                "value": "uint256"
            },
            "event": "Transfer(address indexed from, address indexed to, uint256 value)",
            "transaction_id": "ef062a62284f5dd0de9c598c2ae8c17dc8179113d6f716cc37a5d72758e75b0d"
        }
    ],
    "list": [
        {
            "owner_address": "TAUNgCkc9JQckDUpNntJHFfKQcXDqFaFaF",
            "block": 49993470,
            "hash": "ef062a62284f5dd0de9c598c2ae8c17dc8179113d6f716cc37a5d72758e75b0d",
            "date_created": 1680593202000,
            "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "token_id": 0,
            "token_value": 0,
            "call_value": 0,
            "data": "23b872dd0000000000000000000000003402bee3959dc631ede6693cd96d79d951127d54000000000000000000000000b7814f473cb0f00ebd2f6b4423904ff5875719060000000000000000000000000000000000000000000000000000000000000000",
            "confirmed": false,
            "method": "transferFrom(address _from,address _to,uint256 _value)",
            "parameter": "{\"0\":\"TEiDRohciqCzb6dwD5ANvXmg4dPuHZsjxM\",\"1\":\"TShVZkvV25hu1iTxBVxGY67duQ46hV2i2t\",\"2\":\"0\",\"_from\":\"TEiDRohciqCzb6dwD5ANvXmg4dPuHZsjxM\",\"_value\":\"0\",\"_to\":\"TShVZkvV25hu1iTxBVxGY67duQ46hV2i2t\"}",
            "day": "2023-04-04"
        }
    ]
}

Get contract energy statistics

Returns Energy statistic data of a contract.

https://apilist.tronscanapi.com/api/onecontractenergystatistic?&address=TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	Contract address

Response

Sample response

{
    "total":1,
    "totalEnergy":10881764450,
    "data":[
        {
            "day":1621900800000,
            "total_energy":97804,
            "energy":75350,
            "contract_supplied":0,
            "trx":22454
        }
    ]
}

Get contract call statistics

Returns contract call statistics.

https://apilist.tronscanapi.com/api/contracts/top_call?contract_address=TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
contract_address	Contract address

Response

Sample response

{
    "recentCallTimes":8147,
    "timeLong":1680480000000,
    "contractMap":{
        "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G":false,
        "TQooBX9o8iSSprLWW96YShBogx7Uwisuim":false,
        "TM1zzNDZD2DPASbKcgdVoTYhfmYgtfwx9R":false,
        "TV6MuMXfmLbBqPZvBHdwFsDnQeVfnmiuSi":false,
        "TETh4cVmVGXLBkGuKRDWnoz96rqoAop2aZ":false,
        "TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR":false
    },
    "contractInfo":{

    },
    "topAddress":[
        {
            "address":"TV6MuMXfmLbBqPZvBHdwFsDnQeVfnmiuSi",
            "addressTag":"Binance-Hot",
            "count":628
        },
        {
            "address":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR",
            "addressTag":"Huobi",
            "count":605
        },
        {
            "address":"TETh4cVmVGXLBkGuKRDWnoz96rqoAop2aZ",
            "count":410
        },
        {
            "address":"TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
            "addressTag":"Binance-Hot",
            "count":384
        },
        {
            "address":"TQooBX9o8iSSprLWW96YShBogx7Uwisuim",
            "count":282
        },
        {
            "address":"TM1zzNDZD2DPASbKcgdVoTYhfmYgtfwx9R",
            "addressTag":"Okex",
            "count":234
        }
    ],
    "totalAddress":1429,
    "totalCallTimes":756112,
    "topMethods":[
        {
            "times":7164,
            "methodId":"a9059cbb"
        },
        {
            "times":866,
            "methodId":"095ea7b3"
        },
        {
            "times":116,
            "methodId":"23b872dd"
        },
        {
            "times":1,
            "methodId":"d73dd623"
        }
    ]
}

Get the number of unique addresses called per day for a contract over a certain period of time

Returns the number of unique addresses called per day for a contract over a certain period of time.

https://apilist.tronscanapi.com/api/onecontractcallerstatistic?address=TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S&start_timestamp=1621900800000&end_timestamp=1621987200000

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	Contract address
start_timestamp	Start time, accurate to seconds
end_timestamp	End time, accurate to seconds

Response

Sample response

{
    "total":2,
    "totalCallerAmount":143,
    "data":[
        {
            "day":1621900800000,
            "amount":2
        },
        {
            "day":1621987200000,
            "amount":141
        }
    ]
}

Get the list of the number of calls per day of the contract

Returns a list of the number of calls per day of the contract.

https://apilist.tronscanapi.com/api/onecontracttriggerstatistic?address=TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S&start_timestamp=1621900800000&end_timestamp=1621987200000

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	Contract address
start_timestamp	Start time, accurate to seconds
end_timestamp	End time, accurate to seconds

Response

Sample response

{
    "total":2,
    "totalAmount":166,
    "data":[
        {
            "day":1621900800000,
            "amount":6
        },
        {
            "day":1621987200000,
            "amount":160
        }
    ]
}

Get the list of daily analysis data for the contract over a period of time

Returns a list of daily analysis data for the contract over a period of time.

https://apilist.tronscanapi.com/api/contract/analysis?address=TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S&type=0&start_timestamp=1680430566127&end_timestamp=1680516966127

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	Contract address
type	Query data type: 0: balance (TRX balance, the price of TRX on that day, calculated using USDT) 1: token transfers (number of token [trc20] transfers and number of token transfers) 2: Energy consumption ([trigger current contract] consumes Energy from frozen TRX, consumes Energy from burning TRX, consumes Energy provided by contract deployers) 3: Bandwidth consumption ([trigger current contract] consumes free Bandwidth or Bandwidth from frozen TRX, consumes Bandwidth from burning TRX) 4: Contract calling (number of calls and number of calling accounts) 5: fees (Bandwidth and Energy consumed from burning TRX)
start_timestamp	Start time, accurate to seconds
end_timestamp	End time, accurate to seconds

Response

Sample response

{
    "size":1,
    "data":[
        {
            "day":"2023-04-02",
            "trx_amount":"19957.105809",
            "usdt_amount":"1303.445448",
            "price":0.06531234843567024
        }
    ]
}

Get the list of all callers of the contract and the statistics of the number of calls

Returns a list of all callers of the contract and the statistics of the number of calls.

https://apilist.tronscanapi.com/api/onecontractcallers?address=TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S&day=1680429735649&limit=2&start=0

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	Contract address
day	Query the number of days, from the current time in a backforward way. Default: yesterday
start	Start number. Default 0
limit	Number of items per page. Default 10

Response

Sample response

{
    "total": 93,
    "totalCallerAmount": 243,
    "data": [
        {
            "caller_address": "TZDSbKHtAF7UJPZmTgbx7EvFCpgKHX295g",
            "amount": 36
        },
        {
            "caller_address": "TV6MuMXfmLbBqPZvBHdwFsDnQeVfnmiuSi",
            "callerAddressTag": "Binance-Hot",
            "amount": 20
        }
    ],
    "contractMap": {
        "TZDSbKHtAF7UJPZmTgbx7EvFCpgKHX295g": false,
        "TV6MuMXfmLbBqPZvBHdwFsDnQeVfnmiuSi": false
    },
    "contractInfo": {}
}

Get the list of trigger transactions for a certain time period

📝 Note : The maximum value for limit is 200.

Returns a list of trigger transactions for a certain time period.

https://apilist.tronscanapi.com/api/contracts/trigger?limit=1&start=0&start_timestamp=1680430566127&end_timestamp=1680508302533

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
start	Start number. Default 0
limit	Number of items per page. Default 10
start_timestamp	Start time, accurate to milliseconds
end_timestamp	End time, accurate to milliseconds

Response

Sample response

{
    "total":10000,
    "data":[
        {
            "block":49965178,
            "callData":"23b872dd000000000000000000000041acd40aa681afe4fed382a8883f1300277c650c8f0000000000000000000000415da402a8d68655a5d93ef5e7f1204332665860d10000000000000000000000000000000000000000000000000000000000000000",
            "callValue":0,
            "confirmed":true,
            "contractAddress":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "contractType":"IntendedLeaveEmpty",
            "hash":"5d8b9023513dd8e13c0d3b282133661c05654a4808d731c678ea298d9eace5a7",
            "ownerAddress":"TGwaLG8wsB9UHytN5WKzdHn5KiMV8cCccC",
            "timestamp":1680508302000,
            "result":"IntendedLeaveEmpty",
            "token":""
        }
    ],
    "contractMap":{
        "TGwaLG8wsB9UHytN5WKzdHn5KiMV8cCccC":false,
        "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t":true
    },
    "rangeTotal":3059619,
    "contractInfo":{
        "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t":{
            "tag1":"USDT Token",
            "tag1Url":"https://tron.network/usdt",
            "name":"TetherToken",
            "vip":true
        }
    }
}