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 account list
  • Get account detail information
  • Get account's token list
  • Get the voted list
  • Get a list of account resources
  • Get a list of stake 2.0 account resources
  • Get approval list
  • Get account authorization change records
  • Get list of daily analytics data for an account over time
  • Get an account to participate in the project
  • Get account wallet token overview
  • Find the address if exist on other chain
  1. API ENDPOINTS

Account

PreviousAPI KeysNextContract

Last updated 1 year ago

Get account list

Returns the list of accounts.

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

https://apilist.tronscanapi.com/api/account/list?sort=-balance&limit=20&start=0

Try this endpoint in your

Query Parameters

Parameter
Description

start

Start number. Default: 0

limit

Number of items per page. Default: 10

sort

Sort field. Default: -balance

Sample Response

{
    "account_number": 149682388,
    "last_24h_account_change": 201763,
    "total": 10000,
    "data": [
        {
            "address": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR",
            "addressTagLogo": "",
            "balance": 18243211943261359,
            "power": 0,
            "totalTransactionCount": 2341329,
            "latestOperationTime": 1680173745000,
            "updateTime": 1680173745000
        },
        {
            "address": "TNMcQVGPzqH9ZfMCSY4PNrukevtDgp24dK",
            "addressTagLogo": "",
            "balance": 8997572047566078,
            "power": 0,
            "totalTransactionCount": 183,
            "latestOperationTime": 1675712808000,
            "updateTime": 1675712808000
        }
    ],
    "contractMap": {
        "TNMcQVGPzqH9ZfMCSY4PNrukevtDgp24dK": true,
        "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR": true
    },
    "rangeTotal": 149682388,
    "contractInfo": {
        "TNMcQVGPzqH9ZfMCSY4PNrukevtDgp24dK": {
            "tag1": "USDD-TRXBURN",
            "tag1Url": "https://usdd.io",
            "name": "MultiSigTRXBurn",
            "vip": false
        },
        "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR": {
            "tag1": "WTRX Token",
            "tag1Url": "https://just.network/",
            "name": "WTRX",
            "vip": true
        }
    }
}

Get account detail information

Returns the detail information of an account.

https://apilist.tronscanapi.com/api/accountv2?address=TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7

Try this endpoint in your

Query Parameters

Parameter
Description

address

Account address

Sample Response

{
    "transactions_out": 2,
    "acquiredDelegateFrozenForBandWidth": 0,
    "rewardNum": 0,
    "greyTag": "",
    "ownerPermission": {
        "keys": [
            {
                "address": "TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7",
                "weight": 1
            }
        ],
        "threshold": 1,
        "permission_name": "owner"
    },
    "redTag": "",
    "publicTag": "",
    "withPriceTokens": [
        {
            "amount": "0.000000",
            "tokenPriceInTrx": 1,
            "tokenId": "_",
            "balance": "0",
            "tokenName": "trx",
            "tokenDecimal": 6,
            "tokenAbbr": "trx",
            "tokenCanShow": 1,
            "tokenType": "trc10",
            "vip": false,
            "tokenLogo": "https://static.tronscan.org/production/logo/trx.png"
        }
    ],
    "delegateFrozenForEnergy": 0,
    "balance": 0,
    "feedbackRisk": false,
    "voteTotal": 0,
    "totalFrozen": 0,
    "delegated": {},
    "transactions_in": 4,
    "latest_operation_time": 1670818821000,
    "totalTransactionCount": 8,
    "representative": {
        "lastWithDrawTime": 0,
        "allowance": 0,
        "enabled": false,
        "url": ""
    },
    "frozenForBandWidth": 0,
    "announcement": "",
    "reward": 1,
    "addressTagLogo": "",
    "allowExchange": [],
    "address": "TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7",
    "frozen_supply": [],
    "bandwidth": {
        "energyRemaining": 0,
        "totalEnergyLimit": 90000000000,
        "totalEnergyWeight": 5316153689,
        "netUsed": 0,
        "storageLimit": 0,
        "storagePercentage": 0,
        "assets": {
            "1002486": {
                "netPercentage": 0,
                "netLimit": 0,
                "netRemaining": 0,
                "netUsed": 0
            }
        },
        "netPercentage": 0,
        "storageUsed": 0,
        "storageRemaining": 0,
        "freeNetLimit": 1500,
        "energyUsed": 0,
        "freeNetRemaining": 1500,
        "netLimit": 0,
        "netRemaining": 0,
        "energyLimit": 0,
        "freeNetUsed": 0,
        "totalNetWeight": 39128278010,
        "freeNetPercentage": 0,
        "energyPercentage": 0,
        "totalNetLimit": 43200000000
    },
    "date_created": 1625827644000,
    "accountType": 0,
    "exchanges": [],
    "frozen": {
        "total": 0,
        "balances": []
    },
    "accountResource": {
        "frozen_balance_for_energy": {}
    },
    "transactions": 6,
    "blueTag": "",
    "witness": 0,
    "delegateFrozenForBandWidth": 0,
    "name": "myAccount",
    "frozenForEnergy": 0,
    "activated": true,
    "acquiredDelegateFrozenForEnergy": 0,
    "activePermissions": [
        {
            "operations": "7fff1fc0033e0300000000000000000000000000000000000000000000000000",
            "keys": [
                {
                    "address": "TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7",
                    "weight": 1
                }
            ],
            "threshold": 1,
            "id": 2,
            "type": "Active",
            "permission_name": "active"
        }
    ]
}

Get account's token list

Returns a list of tokens held by the account with a balance greater than 0.

https://apilist.tronscanapi.com/api/account/tokens?address=TSTVYwFDp7SBfZk7Hrz3tucwQVASyJdwC7&start=0&limit=20&hidden=0&show=0&sortType=0&sortBy=0&token=

Query Parameters

Parameter
Description

address

Account address

start

Start number. Default: 0

limit

Number of items per page. Default: 20

hidden

Whether to hide tokens with small balance. 0: hide (default) 1: show

show

Token type. 1: TRC20 2: TRC721 3: ALL (default) 4: TRC1155

sortBy

Sort field. 1: price 2: amount (default) 3: quantity

sortType

Sort order. 0: descending order (default) 1: ascending order

token

Specify token ID or token address

assetType

Asset type. 0: ALL 1: token only (default) 2: receipt token only

Sample Response

{
    "total": 3,
    "data": [
        {
            "amount": "0.000000",
            "quantity": "0.000000",
            "tokenId": "_",
            "tokenPriceInUsd": 0.066426241649404200,
            "tokenName": "trx",
            "tokenAbbr": "trx",
            "tokenCanShow": 1,
            "tokenLogo": "https://static.tronscan.org/production/logo/trx.png",
            "tokenPriceInTrx": 1,
            "amountInUsd": 0,
            "balance": "0",
            "tokenDecimal": 6,
            "tokenType": "trc10",
            "vip": false
        },
        {
            "quantity": 10000,
            "tokenId": "1002486",
            "tokenName": "BlockDance",
            "owner_address": "TZEZWXYQS44388xBoMhQdpL1HrBZFLfDpt",
            "tokenAbbr": "BDC",
            "tokenCanShow": 1,
            "transferCount": 44,
            "tokenLogo": "https://static.tronscan.org/production/upload/logo/1002486.png?t=1584951708472",
            "nrOfTokenHolders": 26,
            "balance": "10000000000",
            "tokenDecimal": 6,
            "tokenType": "trc10",
            "vip": false
        },
        {
            "tokenId": "TCmSR8UYWvsZkZmprGKaudTuWUZ62ycnnN",
            "balance": "1000000000000",
            "tokenName": "SSH",
            "tokenAbbr": "SSH",
            "tokenDecimal": 6,
            "tokenCanShow": 1,
            "tokenType": "trc20",
            "tokenLogo": "https://static.tronscan.org/production/upload/logo/TCmSR8UYWvsZkZmprGKaudTuWUZ62ycnnN.jpeg?t=1651809163740",
            "vip": false,
            "quantity": 1000000,
            "nrOfTokenHolders": 6,
            "transferCount": 6,
            "project": ""
        }
    ],
    "contractMap": {
        "TCmSR8UYWvsZkZmprGKaudTuWUZ62ycnnN": true,
        "_": false
    },
    "contractInfo": {
        "TCmSR8UYWvsZkZmprGKaudTuWUZ62ycnnN": {
            "tag1": "SSH Token",
            "tag1Url": "www.baidu.com",
            "name": "ADApp",
            "vip": false
        }
    }
}

Get the voted list

Returns the voter list of a certain SR or the voted list of a certain account involving all SRs.

https://apilist.tronscanapi.com/api/vote?sort=&limit=20&start=0&voter=TRzQrtxrEJbSbQNwAsgAHkBMxTX47yNmjo

Query Parameters

Parameter
Description

candidate

Account address to be used when querying the voter list of a SR

start

Start number. Default: 0

limit

Number of items per page. Default: 20

voter

Account address to be used when querying the voted list of a voter

sort

The sorting method is default to descending based on the number of votes

Sample Response

{
    "total":1,
    "totalVotes":949999000,
    "data":[
        {
            "timestamp":"2023-04-03T14:55:33.025+0800",
            "voterAddress":"TRzQrtxrEJbSbQNwAsgAHkBMxTX47yNmjo",
            "candidateAddress":"TC6qGw3d6h25gjcM64KLuZn1cznNi5NR6t",
            "votes":300000000,
            "candidateUrl":"cryptoinnovationfund",
            "candidateName":"Crypto Innovation Fund",
            "candidateTotalVotes":1677108262,
            "voterAvailableVotes":949999000
        }
    ]
}

Get a list of account resources

Returns the resource list of an account that has resources in Stake 1.0.

https://apilist.tronscanapi.com/api/account/resource?limit=1&start=0&address=TWSRE85rP7FydZKjHmmZgCYF5Dbw8AB91J&type=1&resourceType=0

Query Parameters

Parameter
Description

address

Account address

start

Start number. Default: 0

limit

Number of items per page. Default: 20

type

Stake type. 1-Freeze for yourself 2-Freeze for others 3-Freeze for yourself by others, other cases are handled by default

resourceType

Resource type. 0: return the data of Bandwidth and Energy 1: return only the data of Bandwidth 2: return only the data of Energy

Sample Response

{
    "total":1,
    "data":[
        {
            "hash":"0f62535aac5a4481ae2551b68615ad6f59b94cf7789409c5b0e9554012cf784c",
            "block":43780046,
            "timestamp":1661918766000,
            "ownerAddress":"TWSRE85rP7FydZKjHmmZgCYF5Dbw8AB91J",
            "receiverAddress":"TWSRE85rP7FydZKjHmmZgCYF5Dbw8AB91J",
            "resource":"ENERGY",
            "frozenBalance":10000000,
            "expireTime":1662177963000,
            "resourceValue":"172.254591"
        }
    ],
    "rangeTotal":1
}

Get a list of stake 2.0 account resources

Returns the resource list of an account that has resources in Stake 2.0.

https://apilist.tronscanapi.com/api/account/resourcev2?limit=1&start=0&address=TWSRE85rP7FydZKjHmmZgCYF5Dbw8AB91J&type=1&resourceType=0

Query Parameters

Parameter
Description

address

Account address

start

Start number. Default: 0

limit

Number of items per page. Default: 20

type

Stake type. 1-Freeze for yourself 2-Freeze for others 3-Freeze for yourself by others, other cases are handled by default. Default: 1

resourceType

Resource type. 0: return the data of Bandwidth and Energy 1: return only the data of Bandwidth 2: return only the data of Energy

Sample Response


Get approval list

Returns the approval list of the specified account.

https://apilist.tronscanapi.com/api/account/approve/list?address=TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm&limit=20&start=1&type=project

Query Parameters

Parameter
Description

address

Account address

limit

Number of items per page. Default: 20

start

Start number. Default: 0

type

Aggregation type. By project or token

transfer

Used when requesting mobile data, transfer=mobile

relatedId

Used when requesting mobile data, the parameter specifies the associated ID, which works together with the type parameter. When type=project, the field value indicates the specified project_id; when type=token, the field value indicates the specified token_id

Sample Response

{
    "total":1,
    "data":[

    ],
    "contractMap":{
        "TKcEU8ekq2ZoFzLSGFYCUY6aocJBX9X31b":true
    },
    "rangeTotal":1,
    "contractInfo":{
        "TKcEU8ekq2ZoFzLSGFYCUY6aocJBX9X31b":{
            "tag1":"SUN: StableSwap 3Pool (Old)",
            "tag1Url":"",
            "name":"StableSwap3Pool",
            "vip":false
        }
    }
}

Get account authorization change records

Returns account authorization change records.

https://apilist.tronscanapi.com/api/account/approve/change?limit=20&start=0&contract_address=TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4&type=approve&from_address=TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm&to_address=TKcEU8ekq2ZoFzLSGFYCUY6aocJBX9X31b

Query Parameters

Parameter
Description

contract_address

Contract address

start

Start number. Default: 0

limit

Number of items per page. Default: 20

type

Type must be set to approve

show

Token type. 1: TRC20 2: TRC721 3: ALL(default) 4: TRC1155

from_address

Originator address

to_address

Recipient address

Sample Response

{
    "total":1,
    "contractMap":{
        "TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm":false,
        "TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4":true,
        "TKcEU8ekq2ZoFzLSGFYCUY6aocJBX9X31b":true
    },
    "data":[
        {
            "date_created":1622129703000,
            "unlimited":true,
            "revert":false,
            "owner_address":"TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm",
            "to_address":"TKcEU8ekq2ZoFzLSGFYCUY6aocJBX9X31b",
            "type":"approve",
            "contract_address":"TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4",
            "confirmed":true,
            "tokenInfo":{
                "tokenId":"TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4",
                "tokenAbbr":"TUSD",
                "tokenName":"TrueUSD",
                "tokenDecimal":18,
                "tokenCanShow":1,
                "tokenType":"trc20",
                "tokenLogo":"https://static.tronscan.org/production/logo/TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4.png",
                "tokenLevel":"2",
                "issuerAddr":"TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm",
                "vip":true
            },
            "block":30558415,
            "contract_ret":"SUCCESS",
            "amount_str":"115792089237316195423570985008687907853269984665640564039457584007913129639935",
            "from_address":"TRX6Q82wMqWNbCCiLqejbZe43wk1h1zJHm",
            "hash":"292e134e8a641dea9c51c58eb492c6c5459e825e85967f8ab2290ee79e964304"
        }
    ],
    "contractInfo":{
        "TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4":{
            "tag1":"TUSD Token",
            "tag1Url":"https://tusd.io/",
            "name":"TrueUSD",
            "vip":true
        },
        "TKcEU8ekq2ZoFzLSGFYCUY6aocJBX9X31b":{
            "tag1":"SUN: StableSwap 3Pool (Old)",
            "tag1Url":"",
            "name":"StableSwap3Pool",
            "vip":false
        }
    },
    "rangeTotal":1
}

Get list of daily analytics data for an account over time

Returns a list of daily analytics data for an account within the specified period.

Remarks:

  • Balance (TRX balance, price of TRX on that day, calculated using USDT). Value: 0

  • Token transfers (number of transfers [trx, trc10, trc20] and number of tokens transferred [need to be de-duplicated]). Value: 1

  • Energy consumption ([transaction triggered by current account] consumes Energy from frozen TRX, consumes Energy from TRX burning, consumes Energy provided by contract deployers, total Energy consumed). Value: 2

  • Bandwidth consumption ([transaction triggered by current account] consumes Bandwidth from frozen TRX or free Bandwidth, consumes Bandwidth from burning TRX). Value: 3

  • Transactions (number of transactions initiated, and received by the current account). Value: 4

https://apilist.tronscanapi.com/api/account/analysis?address=TUD4YXYdj2t1gP5th3A7t97mx1AUmrrQRt&type=0&start_timestamp=1514764800000&end_timestamp=1680508422169

Query Parameters

Parameter
Description

address

Account address

start_timestamp

Start time, accurate to milliseconds

end_timestamp

End time, accurate to milliseconds

type

0: Balance 1: Transfer 2: Energy consumption 3: Bandwidth consumption 4: Transaction

See: Remarks for details

Sample Response

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

Get an account to participate in the project

Returns the project that an account has participated in.

https://apilist.tronscanapi.com/api/participate_project?address=TWSRE85rP7FydZKjHmmZgCYF5Dbw8AB91J

Query Parameters

Parameter
Description

address

Account address

justLendFilter

Filter JustLend DAO transactions of a certain type. 0 - all 1 - supply type 2 - borrow type

Sample Response

{
    "total":1,
    "projects":[
        {
            "project_name":"TRX Staking Governance",
            "logo":"https://static.tronscan.org/production/logo/trx.png",
            "url":"",
            "total_value":10,
            "total_value_in_usd":0.65,
            "data":[
                {
                    "sc_type":"Staking",
                    "type":"",
                    "currency":"_",
                    "currency_info":{
                        "tokenId":"_",
                        "tokenAbbr":"trx",
                        "tokenName":"trx",
                        "tokenDecimal":6,
                        "tokenCanShow":1,
                        "tokenType":"trc10",
                        "tokenLogo":"https://static.tronscan.org/production/logo/trx.png",
                        "tokenLevel":"2",
                        "vip":true
                    },
                    "balance":10,
                    "value":10,
                    "value_in_usd":0.65,
                    "value_detail":10,
                    "value_in_usd_detail":0.652073376549517
                }
            ],
            "total_value_detail":10,
            "total_value_in_usd_detail":0.652073376549517,
            "percent":1
        }
    ],
    "total_asset_in_trx":10,
    "total_asset_in_usd":0.652073376549517
}

Get account wallet token overview

Returns overview of tokens in the account wallet.

https://apilist.tronscanapi.com/api/account/token_asset_overview?address=TWSRE85rP7FydZKjHmmZgCYF5Dbw8AB91J

Query Parameters

Parameter
Description

address

Account address

Sample Response

{
    "totalAssetInTrx":155.002484,
    "data":[
        {
            "tokenId":"_",
            "tokenName":"trx",
            "tokenDecimal":6,
            "tokenAbbr":"trx",
            "tokenCanShow":1,
            "tokenType":"trc10",
            "tokenLogo":"https://static.tronscan.org/production/logo/trx.png",
            "vip":false,
            "balance":"155002484",
            "tokenPriceInTrx":1,
            "tokenPriceInUsd":0.06548146219054865,
            "assetInTrx":155.002484,
            "assetInUsd":10.149789295487123,
            "percent":1
        }
    ],
    "totalTokenCount":2,
    "totalAssetInUsd":10.149789295487123
}

Find the address if exist on other chain

https://apilist.tronscanapi.com/api/multiple/chain/query?address=TJAsZtFdFdkME5dAF12UMZzK9Vpqp4ri4Q

Query Parameters

Parameter
Description

address

Account address

Sample Response

{
    "isToken": false,
    "isContract": false,
    "tronLogo": "https://static.tronscan.org/production/upload/logo/new/chain/tron.svg",
    "tronAddress": "TJAsZtFdFdkME5dAF12UMZzK9Vpqp4ri4Q",
    "multipleChain": [
        {
            "exist": true,
            "chain": "BitTorrent Chain",
            "address": "0x59f5c66c3d9e2065b60bf4a8634cd57fd6a4acd0",
            "name": "bttc",
            "logo": "https://static.tronscan.org/production/upload/logo/new/chain/bttc.svg",
            "title": "BTTCSCAN",
            "url": "https://bttcscan.com/address/0x59f5c66c3d9e2065b60bf4a8634cd57fd6a4acd0"
        }
    ],
    "redTag": "",
    "publicTag": ""
}

Note : The maximum value for limit is 200.

Try this endpoint in your

Note : The maximum value for limit is 200.

Try this endpoint in your

Note : The maximum value for limit is 200.

Try this endpoint in your

Note : The maximum value for limit is 200.

Try this endpoint in your

Note : The maximum value for limit is 200.

Try this endpoint in your

Note : The maximum value for limit is 200.

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

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