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

Account

PreviousAPI KeysNextContract

Last updated 1 year ago

CtrlK
  • 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

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 browser 🔗

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 browser 🔗

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=

Try this endpoint in your browser 🔗

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

Try this endpoint in your browser 🔗

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

Try this endpoint in your browser 🔗

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=TWSRE85rP7FydZKjHmmZgCYF5Dbw8AB91J&type=1&resourceType=0

Try this endpoint in your browser 🔗

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

📝 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

Try this endpoint in your browser 🔗

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

Try this endpoint in your browser 🔗

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

Try this endpoint in your browser 🔗

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

Try this endpoint in your browser 🔗

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

Try this endpoint in your browser 🔗

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

Try this endpoint in your browser 🔗

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