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 🔗

Query Parameters

Parameter

Description

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

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 🔗

Query Parameters

Parameter

Description

contract

Contract address

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

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

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 🔗

Query Parameters

Parameter

Description

address

Contract address

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 🔗

Query Parameters

Parameter

Description

contract_address

Contract address

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 🔗

Query Parameters

Parameter

Description

address

Contract address

start_timestamp

Start time, accurate to seconds

end_timestamp

End time, accurate to seconds

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 🔗

Query Parameters

Parameter

Description

address

Contract address

start_timestamp

Start time, accurate to seconds

end_timestamp

End time, accurate to seconds

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 🔗

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

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 🔗

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

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 🔗

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

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
        }
    }
}

PreviousAccount NextTransactions and Transfers

Last updated 1 year ago

hashtagGet list of contracts

hashtagGet contract detail information

hashtagGet event information of the contract

hashtagGet contract energy statistics

hashtagGet contract call statistics

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

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

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

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

hashtagGet the list of trigger transactions for a certain time period

Get list of contracts

Get contract detail information

Get event information of the contract

Get contract energy statistics

Get contract call statistics

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

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

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

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

Get the list of trigger transactions for a certain time period