Contract

List of smart contract interfaces.

Get list of contracts

The value sum of start and limit must be less than or equal to 10000. The maximum value for limit is 50.

Returns a list of contracts.


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

Request

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

Response


{
  "total": 10000,
  "triggerTop7": [
    {
      "tag1": "USDT Token",
      "tag1Url": "https://tron.network/usdt",
      "blueTagUrl": "tether.to",
      "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "percentage": 0.8975886192776561,
      "name": "TetherToken",
      "risk": false,
      "triggers": 1970847,
      "publicTagDesc": ""
    }
  ],
  "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\":\"...\"}",
      "verify_time": 1575472751000,
      "tag1": "USDT Token",
      "tag1Url": "https://tron.network/usdt",
      "risk": false,
      "publicTagDesc": "",
      "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\":\"Twitter\",\"link\":\"https://twitter.com/Tether_to\"}]",
        "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

Returns contract detail information.


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

Request

Parameter	Description
`contract`	Contract address

Response


{
  "type": "null",
  "count": 0,
  "status": {
    "code": 0,
    "message": "SUCCESS"
  },
  "data": [
    {
      "address": "TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S",
      "balance": 19957105809,
      "balanceInUsd": 0,
      "verify_status": 2,
      "is_proxy": false,
      "proxy_implementation": "",
      "old_proxy_implementation": "",
      "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
        }
      },
      "trxCount": 757116,
      "date_created": 1621864512000,
      "name": "SunToken",
      "description": "",
      "announcement": "",
      "license": "1",
      "tag1": "SUN Token",
      "tag1Url": "https://sun.io/",
      "vip": true,
      "feedbackRisk": false,
      "blueTag": "SUN",
      "blueTagUrl": "sun.io",
      "greyTag": "",
      "redTag": "",
      "publicTag": "SUN Token",
      "publicTagDesc": "",
      "activeDay": 1802,
      "creator": {
        "address": "TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm",
        "addressTag": "",
        "address_is_contract": false,
        "txHash": "1836ff59e1f9c46dd1682ede7824d08db922ba10162b7f69feefd76fd83c017f",
        "token_balance": 0,
        "consume_user_resource_percent": 0,
        "energy_remaining": 0,
        "energy_limit": 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()",
        "06fdde03": "name()"
      },
      "energy_factor": 0.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

This is a POST request. Please use the POST method to get the data.

Returns a list of event information for the contract.


POST https://apilist.tronscanapi.com/api/contracts/smart-contract-triggers-batch

Request

Parameter	Description
`contractAddress`	Contract address
`hashList`	A list of transaction hashes
`term`	Query content — supports block number and event name
`fields`	Comma-separated list of fields to return in `list[]`. Omit to return all fields. Example: `"hash,method"`

Example request body:


{
  "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}

Get contract energy statistics

Returns Energy statistic data of a contract.


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

Request

Parameter	Description
`address`	Contract address

Get contract call statistics

Returns contract call statistics.


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

Request

Parameter	Description
`contract_address`	Contract address

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.


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

Request

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

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.


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

Request

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

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.


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

Request

Parameter	Description
`address`	Contract address
`type`	Query data type (see below)
`start_timestamp`	Start time, accurate to seconds
`end_timestamp`	End time, accurate to seconds

type values:

Value	Description
`0`	Balance — TRX balance, the price of TRX on that day (calculated using USDT)
`1`	Token transfers — number of TRC20 token transfers and number of tokens transferred
`2`	Energy consumption — from frozen TRX, from burning TRX, provided by contract deployers
`3`	Bandwidth consumption — from free Bandwidth or frozen TRX, from burning TRX
`4`	Contract calling — number of calls and number of calling accounts
`5`	Fees — Bandwidth and Energy consumed from burning TRX

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.


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

Request

Parameter	Description
`address`	Contract address
`day`	Query the number of days, counted backwards from current time. Default: yesterday
`start`	Start number. Default: `0`
`limit`	Number of items per page. Default: `10`

Get the list of trigger transactions for a certain time period

The maximum value for limit is 50. The value sum of start and limit must be less than or equal to 10000.

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


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

Request

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