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 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
  1. API ENDPOINTS

Contract

List of smart contract interfaces.

PreviousAccountNextTransactions and Transfers

Last updated 1 year ago

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Try this endpoint in your

Try this endpoint in your

Try this endpoint in your

Try this endpoint in your

Try this endpoint in your

Try this endpoint in your

Note : The maximum value for limit is 200.

Try this endpoint in your

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