Account

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

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

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

📝 Note : The maximum value for limit is 200.

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

📝 Note : The maximum value for limit is 200.

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

📝 Note : The maximum value for limit is 200.

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

📝 Note : The maximum value for limit is 200.

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=TAcJ8gRyo16rpk9qzefMUi3FL7WDjBTMrg&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

{
	"total": 1,
	"data": [{
		"receiverAddress": "TAcJ8gRyo16rpk9qzefMUi3FL7WDjBTMrg",
		"expireTime": 1749683322000,
		"balance": 464000000,
		"resource": 0,
		"receiverAddressTag": "",
		"lockBalance": 0,
		"lockResourceValue": 0.0,
		"ownerAddress": "TAeGoVhpmGqmsQZpNbuH3tjGAhTxfwh5xg",
		"resourceValue": 732.66,
		"operationTime": 1749424125000
	}],
	"contractMap": {
		"TAeGoVhpmGqmsQZpNbuH3tjGAhTxfwh5xg": false,
		"TAcJ8gRyo16rpk9qzefMUi3FL7WDjBTMrg": true
	},
	"test": "test",
	"rangeTotal": 1,
	"contractInfo": {
		"TAcJ8gRyo16rpk9qzefMUi3FL7WDjBTMrg": {
			"isToken": false,
			"tag1": "",
			"tag1Url": "",
			"name": "CreatedByContract",
			"risk": false,
			"publicTagDesc": "",
			"vip": false,
			"publicTag": ""
		}
	},
	"normalAddressInfo": {
		"TAeGoVhpmGqmsQZpNbuH3tjGAhTxfwh5xg": {
			"risk": false
		},
		"TAcJ8gRyo16rpk9qzefMUi3FL7WDjBTMrg": {
			"risk": false
		}
	}
}

Get approval list

📝 Note : The maximum value for limit is 200.

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

📝 Note : The maximum value for limit is 200.

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

PreviousAPI Keys NextContract

Last updated 5 months ago

hashtagGet account list

hashtagGet account detail information

hashtagGet account's token list

hashtagGet the voted list

hashtagGet a list of account resources

hashtagGet a list of stake 2.0 account resources

hashtagGet approval list

hashtagGet account authorization change records

hashtagGet list of daily analytics data for an account over time

hashtagGet an account to participate in the project

hashtagGet account wallet token overview

hashtagFind the address if exist on other chain

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