# Account

## Get account list

```
https://api.botc.pro/api/account
```

{% tabs %}
{% tab title="Submit" %}
Return to account list

| Parameter    | Description     |
| ------------ | --------------- |
| address      | Account address |
| {% endtab %} |                 |

{% tab title="Parameters/results" %}
Query Parameters

```json
{
   "total": 15260, // Total number of accounts
   "data": [ // Account data list
     {
       "address": "TUG4nwPm4kEMQ5DJuNwfWYddSzhrdJntmA", // Account address
       "name": "", // Account name (empty here)
       "balance": 1651950590, // Account balance
       "power": 0, //Account power value (0 here)
       "tokenBalances": {}, // Token balances (empty object here)
       "dateCreated": 1706516345435, // Account creation date (timestamp)
       "dateUpdated": 1706516345435 // Account update date (timestamp)
     },
     // ...(other account information)
   ]
}
```

{% endtab %}
{% endtabs %}

## Get account information

```
https://api.botc.pro/api/account/
```

{% tabs %}
{% tab title="Submit" %}
Query Parameters

| Parameter    | Description     |
| ------------ | --------------- |
| address      | Account address |
| {% endtab %} |                 |

{% tab title="Parameters/results" %}

```json
{
   "representative": { // representative information
     "enabled": false, // Whether to enable representatives
     "lastWithDrawTime": 0, // Last extraction time
     "allowance": 0, // Number of authorizations
     "url": null //Represents the URL address, null means no setting
   },
   "name": "", // Name, here is an empty string
   "address": "TWLowShJYK8NdnsLo1FZ7R6seFqP3ChTTc", // User's address
   "bandwidth": { // Bandwidth usage
     "freeNetUsed": 0, // The amount of free network bandwidth used
     "freeNetLimit": 1500, // Free network bandwidth limit
     "freeNetRemaining": 1500, // The amount of free network bandwidth remaining available
     "freeNetPercentage": 0, // Free network bandwidth usage
     "netUsed": 0, // The amount of network bandwidth used
     "netLimit": 0, // Total network bandwidth limit
     "netRemaining": 0, // The amount of remaining available network bandwidth
     "netPercentage": 0, // Network bandwidth usage
     "assets": {} // Bandwidth-related asset information
   },
   "balances": [ // User's asset balance list
     {
       "name": "BOTC", // Asset name, here is BOTC, the default symbol is TRX
       "balance": 0 // Balance quantity
     }
   ],
   "balance": 500000,
   "tokenBalances": [
     {
       "name": "BOTC", // Token name, here is BOTC. The default symbol is TRX
       "balance": 0 // The balance amount of tokens
     }
   ],
   "frozen": { // Frozen asset information
     "total": 0, // The total amount frozen
     "balances": [] // List of frozen asset balances
   }
}
```

{% endtab %}
{% endtabs %}

## Get account token transaction records

```
https://api-console.botc.pro/api/transaction/botc20?address=
```

{% tabs %}
{% tab title="Submit" %}
Query parameters

| Parameter    | Description     |
| ------------ | --------------- |
| address      | Account address |
| {% endtab %} |                 |

{% tab title="Parameters/results" %}

```json
{
   "total": 3, // Total number of transactions
   "data": [
     {
       "id": 280, // Transaction ID
       "hash": "e42a5684e843c767cfb4c4964f09fb19015d811d19d9a186b7f98c9cc9afb4b0", // Transaction hash value
       "contractRet": "SUCCESS", // Contract execution result (success)
       "confirmed": 1, // Whether it has been confirmed (1 means confirmed, 0 means unconfirmed)
       "block": 621135, //Height of the block where it is located
       "timestamp": 1706951058000, // Transaction timestamp (millisecond level)
       "ownerAddress": "TF845sudduRYCuna4EkQwmdwNLsHZztUWk", // The address of the transaction initiator
       "toAddress": "TNbsC4VNiMhoxVvf2PtDKKzqBXshVMBQsb", // The address of the transaction recipient
       "contractType": 31, // Contract type
       "contractData": "{\"type\":\"TriggerSmartContract\"}", // Contract data
       "data": "", // additional data
       "fee": 357948, // Transaction fee
       "contract": "TVFdtotZP9BrakivQ6EveSRC2TvShUmT2w", // Contract address
       "function": "transfer", //The name of the function to be called
       "parameters": "a:3:{s:5:\"types\";a:2:{i:0;s:7:\"address\";i:1;s:7:\"uint256 \";}s:5:\"names\";a:2:{i:0;s:2:\"to\";i:1;s:5:\"value\";}s: 4:\"data\";a:2:{i:0;s:42:\"418a905cf92958385ac1118286af1e127f2f76e0e0\";i:1;s:1:\"0\";}}", // Function parameters, This means transferring 0 units to a certain address
       "value": "0",
       "name": "TetherUSD", //Full name of the token
       "symbol": "USDT", //Token symbol
       "decimals": 18 //Quantity precision
     },
     {
       "id": 281,
       "hash": "37d21f2444c661fe600935d479c3d7ae617f7f79049c676f4a914edbe1107ab6",
       "contractRet": "SUCCESS", // Contract execution result (success)
       "confirmed": 0, // Whether it has been confirmed (1 means confirmed, 0 means not confirmed)
       "block": 621137, //Height of the block where it is located
       "timestamp": 1706951064000, // Transaction timestamp (millisecond level)
       "ownerAddress": "TF845sudduRYCuna4EkQwmdwNLsHZztUWk", // The address of the transaction initiator
       "toAddress": "TNbsC4VNiMhoxVvf2PtDKKzqBXshVMBQsb", // The address of the transaction recipient
       "contractType": 31, // Contract type
       "contractData": "{\"type\":\"TriggerSmartContract\"}", // Contract data
       "data": "", //Additional data
       "fee": 0, //Transaction fee
       "contract": "TWmckoPHCMTgHtKyUAH3sUWHZYWRUERhQN", // Contract address
       "function": "transfer", //The name of the function to be called
       "parameters": "a:3:{s:5:\"types\";a:2:{i:0;s:7:\"address\";i:1;s:7:\"uint256 \";}s:5:\"names\";a:2:{i:0;s:2:\"to\";i:1;s:5:\"value\";}s: 4:\"data\";a:2:{i:0;s:42:\"418a905cf92958385ac1118286af1e127f2f76e0e0\";i:1;s:28:\"2500000000000000000000000000\";}}",
       "value": "2500000000000000000000000000", // quantity
       "name": "Mira", //Full name of the token
       "symbol": "MAL", //Token symbol
       "decimals": 18 //Quantity precision
     },
```

{% endtab %}
{% endtabs %}

## Get account BOTC transaction query

```
 https://api.botc.pro/api/transaction?address=
```

{% tabs %}
{% tab title="First Tab" %}
Query Parameters

| Parameter    | Description     |
| ------------ | --------------- |
| address      | Account address |
| {% endtab %} |                 |

{% tab title="Second Tab" %}

```json
{
   "total": 0,
   "data": [
     {
       "hash": "27c66611411934510d2163c2dfebd5121be6475789debe2868c95d25ec7045b7", // Transaction hash value
       "block": 621179, // block
       "timestamp": 1706951196000, // Transaction timestamp
       "confirmed": true, // Whether the transaction has been confirmed
       "ownerAddress": "TF845sudduRYCuna4EkQwmdwNLsHZztUWk", // The address where the transaction is initiated
       "toAddress": "TVXpx9P8pMKUcM5naoE12FFGMpWXcuNU7o", // The address to receive the transaction
       "contractData": { // Contract data
         "to": "TVXpx9P8pMKUcM5naoE12FFGMpWXcuNU7o", // Receiver address
         "from": "TF845sudduRYCuna4EkQwmdwNLsHZztUWk", // Sender address
         "amount": 1553796 // Transaction amount, quantity precision 6
       },
       "contractType": 1, // Contract type
       "data": "", // Additional transaction data (empty here)
       "fee": 1000010 // Transaction fee
     },
```

{% endtab %}
{% endtabs %}

## Get account BOTC transfer inquiry

```
https://api.botc.pro/api/transfer?address=
```

{% tabs %}
{% tab title="First Tab" %}
Query Parameters

| Parameter    | Description     |
| ------------ | --------------- |
| address      | Account address |
| {% endtab %} |                 |

{% tab title="Second Tab" %}

```json
{
   "total": 0,
   "data": [
     {
       "id": "5067b8f3-aac6-45b8-b43f-a9867b24aa56", // The unique identifier of the transaction
       "transactionHash": "0ac2ee07a6d55b8030de0088ce70d6ef1d4e9b5e2bafd65aee5406a5fc96f3dd", // Hash value of transaction
       "block": 590154, //The block where it is located
       "timestamp": 1706856219000, // Transaction timestamp
       "transferFromAddress": "TNymUv6XcEkzvzrAhQpPyMZi7pVrGsLpPJ", // Sender address
       "transferToAddress": "TF845sudduRYCuna4EkQwmdwNLsHZztUWk", // Receiver address
       "amount": 10000000000, // Amount of transaction, quantity precision 6
       "tokenName": "BOTC", // The token name of the transaction defaults to TRX
       "confirmed": true // Whether the transaction has been confirmed
     },
   ]
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://botccoin.gitbook.io/botccoin-developer-book/account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.