# Trias explorer apitotal

## /api/all\_blocks&#x20;

***

Get block list data

### Request method&#x20;

GET

### Request address

```
https://www.tscscan.io/api/all_blocks_v1/?size=25&page=1&chain=default 
```

### Request Parameters

<table><thead><tr><th width="145" align="center">parameter</th><th width="235" align="center">description</th><th width="97" align="center">type</th><th width="105" align="center">default</th><th align="center">required</th></tr></thead><tbody><tr><td align="center">chain</td><td align="center">chain type(default/tm)</td><td align="center">string</td><td align="center">default</td><td align="center">no</td></tr><tr><td align="center">size</td><td align="center">request data size per page</td><td align="center">int</td><td align="center">50</td><td align="center">no</td></tr><tr><td align="center">page</td><td align="center">request pagination</td><td align="center">int</td><td align="center">1</td><td align="center">no</td></tr></tbody></table>

### Return Data Description&#x20;

**Trias return data**

<table><thead><tr><th width="153" align="center">field_name</th><th width="138" align="center">type</th><th>description</th></tr></thead><tbody><tr><td align="center">code</td><td align="center">int</td><td>status code, 200 for success</td></tr><tr><td align="center">total_size</td><td align="center">int</td><td>block total size</td></tr><tr><td align="center">page</td><td align="center">int</td><td>pagination</td></tr><tr><td align="center">total_page</td><td align="center">int</td><td>total pages</td></tr><tr><td align="center">return_data</td><td align="center">list dict</td><td>block data list</td></tr></tbody></table>

**Block data**&#x20;

<table><thead><tr><th width="187" align="center">field_name</th><th width="114" align="center">type</th><th>description</th></tr></thead><tbody><tr><td align="center">number</td><td align="center">int</td><td>block number</td></tr><tr><td align="center">size</td><td align="center">int</td><td>block size</td></tr><tr><td align="center">timestamp</td><td align="center">int</td><td>block timestamp</td></tr><tr><td align="center">hash</td><td align="center">string</td><td>block hash</td></tr><tr><td align="center">blockReward</td><td align="center">0</td><td>block award, field not used</td></tr><tr><td align="center">transactionsCount</td><td align="center">int</td><td>transactions count</td></tr><tr><td align="center">credit_max</td><td align="center">int</td><td>credit max</td></tr><tr><td align="center">time</td><td align="center">string</td><td>block time</td></tr><tr><td align="center">avgFee</td><td align="center">double</td><td>transaction avgFee (currently constant: 0.00332)</td></tr></tbody></table>

**Trias return data example**

```
{
    "code": 200,
    "total_size": 10000,
    "page": 1,
    "first_number": 0,
    "last_number": 0,
    "total_page": 400,
    "return_data": [
        {
        "hash": "0xe760278994abc32cfcf9421d13c2ed7d606d276fb35dff4e5663658f82397ffd",
            "miner": "0xDd38105Ee1915E04342568575869c94a1270805E",
            "number": 1607982,
            "transactionsCount": 0,
            "size": 850,
            "blockReward": "0 TSM",
            "timestamp": 1709206620,
            "credit_value": [
                {
                    "193bfba425e7d3451d8410f1f4fa4554812df713": 1124443
                },
                {
                    "279915786fb12e67f0f18b765ca6831d9a73a5e3": 1127407
                },
                {
                    "2ac30b3946da0fa0d94db97f680e0e1ebaaa3c86": 1126350
                },
                {
                    "3637f213c9dbd5e2d8c65a6410475aec410473d5": 1126503
                },
                {
                    "394fb9f059d2887a61abace3dccbbf32d91fa123": 1127840
                },
                {
                    "9a059e83defaef0b7dc650222dae7abc3dc0d0c7": 1126968
                },
                {
                    "dd38105ee1915e04342568575869c94a1270805e": 1125409
                },
                {
                    "ecb7bed0204d3b8d244e7a121d649ba654ede492": 1126141
                },
                {
                    "eef9becbf568559653fbce25d0b946cc2e30771c": 1128931
                }
            ],
            "gasLimit": 39843751,
            "gasUsed": 0,
            "time": 1709206620,
            "avgFee": 0.00332,
            "gas_used": "0(0.0000%)",
            "gas_Rate": 0.0,
            "blockcredit": 1125409
        },
        ...
}
```

## /api/block\_info&#x20;

***

Get block basic information

### Request method&#x20;

GET

### Request address

```
https://www.tscscan.io/api/block_info_v1/?block_hash=0xd0b8e8ae11ff0450373cf9b873c3c579d74a16c6c81abe161b644400aa8a86dc&chain=default 
```

### Request Parameters&#x20;

<table><thead><tr><th width="145" align="center">parameter</th><th width="235" align="center">description</th><th width="97" align="center">type</th><th width="105" align="center">default</th><th align="center">required</th></tr></thead><tbody><tr><td align="center">chain</td><td align="center">chain type(default/tm)</td><td align="center">string</td><td align="center">default</td><td align="center">no</td></tr><tr><td align="center">block_hash</td><td align="center">block hash</td><td align="center">string</td><td align="center">no</td><td align="center">yes</td></tr></tbody></table>

### Return Data Description&#x20;

**Trias return data**

<table><thead><tr><th width="187" align="center">field_name</th><th width="138" align="center">type</th><th>description</th></tr></thead><tbody><tr><td align="center">code</td><td align="center">int</td><td>status code, 200 for success</td></tr><tr><td align="center">return_data</td><td align="center">dict</td><td>block details</td></tr></tbody></table>

**Block details**

<table><thead><tr><th width="202" align="center">field_name</th><th width="134" align="center">type</th><th>description</th></tr></thead><tbody><tr><td align="center">number</td><td align="center">int</td><td>block number</td></tr><tr><td align="center">size</td><td align="center">int</td><td>block size</td></tr><tr><td align="center">timestamp</td><td align="center">int</td><td>block timestamp</td></tr><tr><td align="center">difficulty</td><td align="center">string</td><td>block diffcultly value,hexstring</td></tr><tr><td align="center">nonce</td><td align="center">string</td><td>block nonce</td></tr><tr><td align="center">parentHash</td><td align="center">string</td><td>parent block hash</td></tr><tr><td align="center">nextHash</td><td align="center">string</td><td>next block hash</td></tr><tr><td align="center">miner</td><td align="center">string</td><td>block miner</td></tr><tr><td align="center">gasLimit</td><td align="center">int</td><td>block gasLimit</td></tr><tr><td align="center">gas_used</td><td align="center">int</td><td>block gasUsed</td></tr><tr><td align="center">blockcredit</td><td align="center">list dict</td><td>block credit</td></tr><tr><td align="center">total_fee</td><td align="center">int</td><td>block transaction total fee</td></tr><tr><td align="center">is_computed</td><td align="center">bool</td><td>is computed total_fee</td></tr><tr><td align="center">blockReward</td><td align="center">0</td><td>block award, field not used</td></tr><tr><td align="center">transactionsCount</td><td align="center">int</td><td>transaction count</td></tr><tr><td align="center">time</td><td align="center">string</td><td>transaction time</td></tr><tr><td align="center">confirmations</td><td align="center">int</td><td>latest block confirmation, >0 means no =0 is the latest</td></tr></tbody></table>

### Return Data Example&#x20;

Trias return data example

```
{
    "code": 200,
    "return_data": {
        "number": 1605753,
        "transactionsCount": 5,
        "timestamp": 1709199893,
        "size": 1635,
        "difficulty": "0x2",
        "nonce": "0x0000000000000000 ",
        "parentHash": "0x21c8c812f3e9bc23e83dab6484980a32f120d33186e88e20d69ee65225ba14be",
        "miner": "0x193bfBA425e7D3451d8410f1f4fa4554812Df713",
        "gasLimit": 40000000,
        "gasUsed": 110004,
        "credit_value": [
            {
            "0x193bfba425e7d3451d8410f1f4fa4554812df713": 1122840
            },
            {
                "0x279915786fb12e67f0f18b765ca6831d9a73a5e3": 1125698
            },
            {
                "0x2ac30b3946da0fa0d94db97f680e0e1ebaaa3c86": 1124665
            },
            {
                "0x3637f213c9dbd5e2d8c65a6410475aec410473d5": 1124799
            },
            {
                "0x394fb9f059d2887a61abace3dccbbf32d91fa123": 1126159
            },
            {
                "0x9a059e83defaef0b7dc650222dae7abc3dc0d0c7": 1125277
            },
            {
                "0xdd38105ee1915e04342568575869c94a1270805e": 1123698
            },
            {
                "0xecb7bed0204d3b8d244e7a121d649ba654ede492": 1124446
            },
            {
                "0xeef9becbf568559653fbce25d0b946cc2e30771c": 1127216
            }
        ],
        "is_computed": false,
        "total_fee": 0,
        "blockReward": "0 TSM",
        "stateRoot": "0xa9cbaf2df64f51df630a9831c180501aa77af8ea1699f7fcbf34e85e8adcb974",
        "hash": "0xd0b8e8ae11ff0450373cf9b873c3c579d74a16c6c81abe161b644400aa8a86dc",
        "confirmed": true,
        "time": "2024-02-29 17:44:53",
        "confirmations": 1019,
        "nextHash": "0x3623204e47e74e30e7caad8f7b8855e08b49a7d35831764fd5a1cc6f602665c7",
        "gas_used": "110004(0.2750%)",
        "Timestamp": "Feb-29-2024 09:44:53 AM +UTC",
        "status": "Confirmed",
        "blockcredit": 1122840
    }
}
```

## /api/block\_transactions&#x20;

***

Get block details

### Request method&#x20;

GET

### Request address

```
https://www.tscscan.io/api/block_transactions_v1/?size=25&page=1&chain=default&block_hash=0xd0b8e8ae11ff0450373cf9b873c3c579d74a16c6c81abe161b644400aa8a86dc
```

### Request Parameters&#x20;

<table><thead><tr><th width="145" align="center">Parameter</th><th width="235" align="center">description</th><th width="97" align="center">type</th><th width="105" align="center">default</th><th align="center">required</th></tr></thead><tbody><tr><td align="center">chain</td><td align="center">chain type(default/tm)</td><td align="center">string</td><td align="center">default</td><td align="center">no</td></tr><tr><td align="center">block_hash</td><td align="center">block hash</td><td align="center">string</td><td align="center">no</td><td align="center">yes</td></tr><tr><td align="center">size</td><td align="center">request data size per page</td><td align="center">int</td><td align="center">50</td><td align="center">no</td></tr><tr><td align="center">page</td><td align="center">request pagination</td><td align="center">int</td><td align="center">1</td><td align="center">no</td></tr></tbody></table>

### Return Data Description&#x20;

**Trias return data**

<table><thead><tr><th width="153" align="center">field_name</th><th width="138" align="center">type</th><th>description</th></tr></thead><tbody><tr><td align="center">code</td><td align="center">int</td><td>status code, 200 for success</td></tr><tr><td align="center">total_size</td><td align="center">int</td><td>sum of block sizes</td></tr><tr><td align="center">page</td><td align="center">int</td><td>pagination</td></tr><tr><td align="center">total_page</td><td align="center">int</td><td>total pages</td></tr><tr><td align="center">return_data</td><td align="center">list dict</td><td>block data list</td></tr></tbody></table>

**Block transaction**&#x20;

<table><thead><tr><th width="189" align="center">field_name</th><th width="147" align="center">type</th><th align="center">description</th></tr></thead><tbody><tr><td align="center">id</td><td align="center">int</td><td align="center">Database primary key (not useful for business scenarios) </td></tr><tr><td align="center">blockHash</td><td align="center">string</td><td align="center">transaction blockHash</td></tr><tr><td align="center">source</td><td align="center">string</td><td align="center">transaction from address</td></tr><tr><td align="center">to</td><td align="center">string</td><td align="center">transaction to address</td></tr><tr><td align="center">gas</td><td align="center">int</td><td align="center">transaction gas</td></tr><tr><td align="center">gasPrice</td><td align="center">int</td><td align="center">transaction gas price</td></tr><tr><td align="center">nonce</td><td align="center">int</td><td align="center">transaction nonce</td></tr><tr><td align="center">hash</td><td align="center">string</td><td align="center">transaction hash</td></tr><tr><td align="center">transactionIndex</td><td align="center">int</td><td align="center">transaction block Index</td></tr><tr><td align="center">value</td><td align="center">int</td><td align="center">transaction value</td></tr><tr><td align="center">v</td><td align="center">int</td><td align="center">transaction signature v field value</td></tr><tr><td align="center">r</td><td align="center">string</td><td align="center">transaction signature r field value</td></tr><tr><td align="center">s</td><td align="center">string</td><td align="center">transaction signature s field value</td></tr><tr><td align="center">timestamp</td><td align="center">int</td><td align="center">transaction timesatmp</td></tr><tr><td align="center">tx_str</td><td align="center">string</td><td align="center">transaction input string</td></tr><tr><td align="center">type1</td><td align="center">int</td><td align="center">transaction type</td></tr><tr><td align="center">fee</td><td align="center">int</td><td align="center">transaction fee</td></tr></tbody></table>

### Return Data Example&#x20;

Trias return data example

```
{"code": 200, "total_size": 5, "page": 1, "total_page": 1, "contract_count": 0, "address_transactions": 5, "return_data": [{"hash": "0xd6dd3e54d02429d270ad30757e9e5d1e6a6ff04de4070f1ad564ef7b39077135", "to": "0x0000000000000000000000000000000000001000", "gasPrice": 0, "source": "0x193bfBA425e7D3451d8410f1f4fa4554812Df713", "value": "0.00010312875", "gas": 9223372036854775807, "fee": "0", "blockNumber": 1605753, "status": "succ", "contract_label": true, "timestamp": 1709199893, "tokenamount": "0", "method": "Common"}...]}
```

## api/all\_transactions/&#x20;

***

Get all block transaction data

### Request method&#x20;

GET

### Request address

```
https://www.tscscan.io/api/all_transactions_v1/ 
```

### Request Parameters&#x20;

<table><thead><tr><th width="145" align="center">parameter</th><th width="235" align="center">description</th><th width="97" align="center">type</th><th width="105" align="center">default</th><th align="center">required</th></tr></thead><tbody><tr><td align="center">chain</td><td align="center">chain type(default/tm)</td><td align="center">string</td><td align="center">default</td><td align="center">no</td></tr><tr><td align="center">size</td><td align="center">request data size per page</td><td align="center">int</td><td align="center">50</td><td align="center">no</td></tr><tr><td align="center">page</td><td align="center">request pagination</td><td align="center">int</td><td align="center">1</td><td align="center">no</td></tr></tbody></table>

### Return Data Description&#x20;

**Trias return data**

<table><thead><tr><th width="153" align="center">Ffeld_name</th><th width="138" align="center">type</th><th>description</th></tr></thead><tbody><tr><td align="center">code</td><td align="center">int</td><td>status code, 200 for success</td></tr><tr><td align="center">total_size</td><td align="center">int</td><td>block total sizes</td></tr><tr><td align="center">page</td><td align="center">int</td><td>pagination</td></tr><tr><td align="center">total_page</td><td align="center">int</td><td>total pages</td></tr><tr><td align="center">return_data</td><td align="center">list dict</td><td>block data list</td></tr></tbody></table>

**Block transaction**

<table><thead><tr><th width="157" align="center">field_name</th><th width="142" align="center">type</th><th>description</th></tr></thead><tbody><tr><td align="center">blockHash</td><td align="center">string</td><td>transaction block hash</td></tr><tr><td align="center">blockNumber</td><td align="center">int</td><td>transaction block number</td></tr><tr><td align="center">source</td><td align="center">string</td><td>transaction source</td></tr><tr><td align="center">to</td><td align="center">string</td><td>transaction to address</td></tr><tr><td align="center">hash</td><td align="center">string</td><td>transaction hash</td></tr><tr><td align="center">value</td><td align="center">string</td><td>transaction value</td></tr><tr><td align="center">time</td><td align="center">string</td><td>transaction time</td></tr><tr><td align="center">tx_str</td><td align="center">string</td><td>transaction input field</td></tr><tr><td align="center">type</td><td align="center">int</td><td>transaction type</td></tr></tbody></table>

### Return Data Example&#x20;

Trias return data example

```
{
    "code":200,
    "total_size":10000,
    "page":1,
    "total_page":200,
    "total_sum": 10000,
    "return_data": {
        {
            "hash":"0xa2273891a95472a205dd4ce57c26abc34cef5807eba1d13229e4162ddc2d6f08",
            "source":"0x38580efe497b22acc29783273e725a2a4f2aeea4",
            "to":"0x0000000000000000000000000000000000001001",
            "value":"0x0",
            "blockNumber":3948,
            "blockHash":"0xe20b6c9b229997b9b4f79ca7d25815ff7ab557930547b1e7843d4a2e747e2402",
            "tx_str":"0xc96be4cb0000000000000000000000000000000000000000000000000000000000000000",
            "type":0,
            "time":"2023-02-02 08:35:32"
        }        
    }
}
```

## api/transaction\_info/&#x20;

***

Get transaction details

### Request method&#x20;

GET

### Request address

```
https://www.tscscan.io/api/transaction_info_v1/?tx_hash=0x718d0964fc023746aa0e46f537bfd562c78f5dfcaf8d750ac76b71000971ba18&time=1709205297 
```

### Request Parameters&#x20;

<table><thead><tr><th width="136" align="center">parameters</th><th width="235" align="center">description</th><th width="94" align="center">type</th><th width="101" align="center">default</th><th align="center">Must</th></tr></thead><tbody><tr><td align="center">chain</td><td align="center">chain type(default/tm)</td><td align="center">string</td><td align="center">default</td><td align="center">no</td></tr><tr><td align="center">txhash</td><td align="center">transaction hash</td><td align="center">string</td><td align="center">no</td><td align="center">yes</td></tr></tbody></table>

### Return Data Description&#x20;

**Trias return data**

<table><thead><tr><th width="153" align="center">field_name</th><th width="138" align="center">type</th><th>description</th></tr></thead><tbody><tr><td align="center">code</td><td align="center">int</td><td>status code, 200 for success</td></tr><tr><td align="center">return_data</td><td align="center">dict</td><td>transaction details</td></tr></tbody></table>

**Transaction details**&#x20;

<table><thead><tr><th width="194" align="center">field_name</th><th width="147" align="center">type</th><th align="center">description</th></tr></thead><tbody><tr><td align="center">blockHash</td><td align="center">string</td><td align="center">transaction blockHash</td></tr><tr><td align="center">source</td><td align="center">string</td><td align="center">transaction from address</td></tr><tr><td align="center">to</td><td align="center">string</td><td align="center">transaction to address</td></tr><tr><td align="center">gas</td><td align="center">int</td><td align="center">transaction gas</td></tr><tr><td align="center">gasPrice</td><td align="center">int</td><td align="center">transaction gas price</td></tr><tr><td align="center">nonce</td><td align="center">int</td><td align="center">transaction nonce</td></tr><tr><td align="center">hash</td><td align="center">string</td><td align="center">transaction hash</td></tr><tr><td align="center">transactionIndex</td><td align="center">int</td><td align="center">transaction block Index</td></tr><tr><td align="center">value</td><td align="center">int</td><td align="center">transaction value</td></tr><tr><td align="center">v</td><td align="center">int</td><td align="center">transaction signature v field value</td></tr><tr><td align="center">r</td><td align="center">string</td><td align="center">transaction signature r field value</td></tr><tr><td align="center">s</td><td align="center">string</td><td align="center">transaction signature s field value</td></tr><tr><td align="center">gasUsed</td><td align="center">int</td><td align="center">gas used size</td></tr><tr><td align="center">timestamp</td><td align="center">int</td><td align="center">transaction timesatmp</td></tr><tr><td align="center">tx_str</td><td align="center">string</td><td align="center">transaction input string</td></tr><tr><td align="center">type1</td><td align="center">int</td><td align="center">transaction type</td></tr><tr><td align="center">fee</td><td align="center">int</td><td align="center">transaction fee</td></tr><tr><td align="center">gasLimit</td><td align="center">int</td><td align="center">transaction gas limit</td></tr><tr><td align="center">time</td><td align="center">string</td><td align="center">transaction time</td></tr><tr><td align="center">tokenamount</td><td align="center">string</td><td align="center">transfer token amount</td></tr><tr><td align="center">gasamount</td><td align="center">string</td><td align="center">transfer native token amount</td></tr><tr><td align="center">method</td><td align="center">string</td><td align="center">contract method</td></tr><tr><td align="center">tokenname</td><td align="center">string</td><td align="center">token name</td></tr><tr><td align="center">status</td><td align="center">string</td><td align="center">status</td></tr><tr><td align="center">transfer_list</td><td align="center">obj</td><td align="center">contract transfer list</td></tr><tr><td align="center">gas_rate</td><td align="center">string</td><td align="center">transaction gas rate</td></tr><tr><td align="center">to_address</td><td align="center">string</td><td align="center">token contrat address</td></tr></tbody></table>

### Return Data Example&#x20;

Trias return data example

```
{
    "code": 200,
    "return_data": {
        "id": 19909,
        "blockHash": "0x0e96a9b198f8e47604b804faa29ffa32afc678bfe2faff6d46b3cf72b67d34d5",
        "blockNumber": 1607541,
        "source": "0x947DD1558257a631049Fad9D686f427F86033c16",
        "toaddr": "0x1FfC121a47a70f24b4628815cE325908ff91e71A",
        "gas": 100000,
        "gasPrice": "0.000000001",
        "nonce": 2965671,
        "hash": "0x718d0964fc023746aa0e46f537bfd562c78f5dfcaf8d750ac76b71000971ba18",
        "transactionindex": 3,
        "value": "0",
        "r": "0xa681c07bfc6accdf9c1a8421fd1c4b2ce8ca2c6c27a8f7933e55376174e92652",
        "s": "0x4ef2991ad06a043bae1e4d47cc8c52a59273dc607871701d9dedb86e2db25b5c",
        "v": "0x43",
        "gasUsed": 36676,
        "timestamp": 1709205297,
        "tx_str": "0xa9059cbb0000000000000000000000008b13509f034335e042fc536d48bb466e04cc752a0000000000000000000000000000000000000000000000000000000c1b710800",
        "type1": 0,
        "fee": "0.0001",
        "recipients": [
            ""
        ],
        "recipient": "0x8b13509F034335E042Fc536d48Bb466E04Cc752a",
        "tokenamount": "52000000000",
        "gasamount": "0                                                                 ",
        "method": "Transfer",
        "tokenname": "TRIAS",
        "status": "succ",
        "offchaintype": "nuse",
        "to": "0x1FfC121a47a70f24b4628815cE325908ff91e71A",
        "gasPriceGwei": "1",
        "transfer_list": [
            {
                "from": "0x947DD1558257a631049Fad9D686f427F86033c16",
                "to": "0x8b13509F034335E042Fc536d48Bb466E04Cc752a",
                "tokenamount": "0.000000052",
                "tokenname": "TRIAS",
                "real_name": "Trias Token",
                "contractaddress": "0x1FfC121a47a70f24b4628815cE325908ff91e71A"
            }
        ],
        "contract_label": true,
        "gasLimit": 100000,
        "gas_rate": "100000 | 36676 (36.676 %)",
        "time": "Feb-29-2024 11:14:57 AM +UTC",
        "to_address": "0x1FfC121a47a70f24b4628815cE325908ff91e71A"
    }
}
```
