TuringBitChain Docs

Appearance

TBC20 ​

Get FTs list by Address ​

This endpoint retrieves the list of FTs held for a given address.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/tokenlist/address/{address}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/tokenlist/address/143KgKGcse57nXBnXyJwtQrf2KP4KWto59'

Example Response

json
{
    "code": "200",
    "message": "OK",
    "data": {
        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
        "count": 2,
        "token_list": [
            {
                "contract_id": "b26155afc1acca8861d19037834a619098db5743f564fd64e32ffd338a76bfee",
                "decimal": 6,
                "balance": 1000000000000,
                "name": "test0814",
                "symbol": "test0814"
            },
            {
                "contract_id": "a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3",
                "decimal": 6,
                "balance": 82114359,
                "name": "SATOSHI",
                "symbol": "SATOSHI"
            }
        ]
    }
}

URL Parameters

ParameterDescription
addressAddress.

Get FT Balance by Address ​

This endpoint retrieves FT balance for a given address.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/tokenbalance/address/{address}/contract/{contract_id}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/tokenbalance/address/143KgKGcse57nXBnXyJwtQrf2KP4KWto59/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3'

Example Response

json
{
    "code": "200",
    "data": {
        "combine_script": "2158ccfe3dc673b74e67c1ffd77842fd8bc4361c00",
        "contract_id": "a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3",
        "decimal": 6,
        "balance": 82114359
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
addressAddress.
contract_idFT Contract ID.

Get FT History by Address ​

This endpoint retrieves FT transactions for a given address. The maximum number of History per request is 100.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/history/address/{address}/contract/{contract_id}/start/{start}/end/{end}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/history/address/143KgKGcse57nXBnXyJwtQrf2KP4KWto59/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3/start/0/end/10'

Example Response

json
{
    "code": "200",
    "data": {
        "decimal": 6,
        "history_count": 1,
        "history_list": [
            {
                "txid": "3d223e8c493df1c46f4bb4a1ce376c3ca5620a73c9199dfca346fa53e242df4a",
                "height": 907503,
                "vin": [
                    {
                        "address": "1M1DRkZdGb2hFDshpiX3MeuvbE2MDQqWxh",
                        "value": 82114359
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 82114359
                    }
                ],
                "fee": 264,
                "confirmations": 2518,
                "time": 1756715396
            }
        ]
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
addressAddress.
contract_idFT Contract ID.
startStarting position or offset (integer).
endEnding position or offset (integer).

Get All FT History by Address ​

This endpoint retrieves all FT transactions for a given address. The maximum number of History per request is 100.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/allhistory/address/{address}/start/{start}/end/{end}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/allhistory/address/143KgKGcse57nXBnXyJwtQrf2KP4KWto59/start/0/end/10'

Example Response

json
{
    "code": "200",
    "data": {
        "history_count": 38,
        "history_list": [
            {
                "txid": "3d223e8c493df1c46f4bb4a1ce376c3ca5620a73c9199dfca346fa53e242df4a",
                "height": 907503,
                "vin": [
                    {
                        "address": "1M1DRkZdGb2hFDshpiX3MeuvbE2MDQqWxh",
                        "value": 82114359
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 82114359
                    }
                ],
                "fee": 264,
                "confirmations": 2516,
                "time": 1756715396
            },
            {
                "txid": "e54dd7b479c338fceb22ec9182629c768f65b5bbc78c7a9aa5e10b59e22b6500",
                "height": 905168,
                "vin": [
                    {
                        "address": "1B1iuWp2sbKgUYtDK5H3KFs3Fs2sYCFacx",
                        "value": 8999000000
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 2000000
                    },
                    {
                        "address": "1B1iuWp2sbKgUYtDK5H3KFs3Fs2sYCFacx",
                        "value": 8997000000
                    }
                ],
                "fee": 395,
                "confirmations": 4851,
                "time": 1755238551
            },
            {
                "txid": "8b14fa2cbd7220ddc9fa0bc2641e1fef63e0965b98590c6e0e75a31f2108e942",
                "height": 880983,
                "vin": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999968000000
                    }
                ],
                "vout": [
                    {
                        "address": "1GyX4pfNGbmeoKNaUmdHEPEoWYejb1rprT",
                        "value": 13000000
                    },
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999955000000
                    }
                ],
                "fee": 477,
                "confirmations": 29036,
                "time": 1740714032
            },
            {
                "txid": "c731d8cdfbcda39f48065420c5fa9dc7204e8c7c4158ddb5cc225074789bb134",
                "height": 880979,
                "vin": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999980000000
                    }
                ],
                "vout": [
                    {
                        "address": "1GyX4pfNGbmeoKNaUmdHEPEoWYejb1rprT",
                        "value": 12000000
                    },
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999968000000
                    }
                ],
                "fee": 477,
                "confirmations": 29040,
                "time": 1740711690
            },
            {
                "txid": "bc4147ac56652c2b90e92cdd252363eae0c282f9a28bf58965512b483c530b64",
                "height": 880979,
                "vin": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999990000000
                    }
                ],
                "vout": [
                    {
                        "address": "1GyX4pfNGbmeoKNaUmdHEPEoWYejb1rprT",
                        "value": 10000000
                    },
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999980000000
                    }
                ],
                "fee": 469,
                "confirmations": 29040,
                "time": 1740711690
            },
            {
                "txid": "b5f40a50198508ecbd7b1d5f76769fb926eb07c2b205cdde021df6442d35e283",
                "height": 880977,
                "vin": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 1000000000000
                    }
                ],
                "vout": [
                    {
                        "address": "18cq3AMvs3U9Y6dwtLbtqDTsn2iVcBL9mv",
                        "value": 10000000
                    },
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999990000000
                    }
                ],
                "fee": 451,
                "confirmations": 29042,
                "time": 1740711139
            },
            {
                "txid": "d240deb558de3286818c1b678975004013d94bdd10307734ebccf02e144c13e1",
                "height": 880755,
                "vin": [
                    {
                        "address": "1Kisfz4US41gz2PRTfAQjdTA3w15PXjh3i",
                        "value": 997649707000
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 100000000000
                    },
                    {
                        "address": "1Kisfz4US41gz2PRTfAQjdTA3w15PXjh3i",
                        "value": 897649707000
                    }
                ],
                "fee": 495,
                "confirmations": 29264,
                "time": 1740568869
            },
            {
                "txid": "1db4d0b1d97babc1b3eb14418b7a7748ab83a57cd111849eced6122f2d6bfe20",
                "height": 880447,
                "vin": [
                    {
                        "address": "1Kisfz4US41gz2PRTfAQjdTA3w15PXjh3i",
                        "value": 95000000000
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 10012000000
                    },
                    {
                        "address": "1Kisfz4US41gz2PRTfAQjdTA3w15PXjh3i",
                        "value": 84988000000
                    }
                ],
                "fee": 468,
                "confirmations": 29572,
                "time": 1740392098
            }
        ]
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
addressAddress.
contract_idFT Contract ID.
startStarting position or offset (integer).
endEnding position or offset (integer).

Get FT UTXOs by Address ​

This endpoint retrieves a combined, ordered list of FT UTXOs for a given address.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/utxo/address/{address}/contract/{contract_id}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/utxo/address/143KgKGcse57nXBnXyJwtQrf2KP4KWto59/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3'

Example Request with Limit

shell
curl --location --request GET "https://api.turingbitchain.io/api/tbc/ft/utxo/address/143KgKGcse57nXBnXyJwtQrf2KP4KWto59/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3?limit=10"

Example Response

json
{
    "code": "200",
    "data": {
        "utxos": [
            {
                "txid": "3d223e8c493df1c46f4bb4a1ce376c3ca5620a73c9199dfca346fa53e242df4a",
                "index": 0,
                "ft_value": 82114359,
                "tbc_value": 500,
                "height": 907503,
                "decimal": 6
            }
        ]
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
addressAddress.
contract_idFT Contract ID.

Query Parameters

ParameterTypeDescription
limitintegerOptional. Limit the number of UTXOs returned.

Get FTs list by combine script ​

This endpoint retrieves the list of FTs held for a given combine script.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/tokenlist/combinescript/{combine_script}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/tokenlist/combinescript/2158ccfe3dc673b74e67c1ffd77842fd8bc4361c00'

Example Response

json
{
    "code": "200",
    "message": "OK",
    "data": {
        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
        "count": 2,
        "token_list": [
            {
                "contract_id": "b26155afc1acca8861d19037834a619098db5743f564fd64e32ffd338a76bfee",
                "decimal": 6,
                "balance": 1000000000000,
                "name": "test0814",
                "symbol": "test0814"
            },
            {
                "contract_id": "a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3",
                "decimal": 6,
                "balance": 82114359,
                "name": "SATOSHI",
                "symbol": "SATOSHI"
            }
        ]
    }
}

URL Parameters

ParameterDescription
combine_scriptAddress combine script

Get FT Balance by combine script ​

This endpoint retrieves FT balance for a given combine script.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/tokenbalance/combinescript/{combine_script}/contract/{contract_id}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/tokenbalance/combinescript/2158ccfe3dc673b74e67c1ffd77842fd8bc4361c00/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3'

Example Response

json
{
    "code": "200",
    "data": {
        "combine_script": "2158ccfe3dc673b74e67c1ffd77842fd8bc4361c00",
        "contract_id": "a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3",
        "decimal": 6,
        "balance": 82114359
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
combine_scriptAddress combine script
contract_idFT Contract ID.

Get FT History by combine script ​

This endpoint retrieves FT transactions for a given combine script. The maximum number of History per request is 100.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/history/combinescript/{combine_script}/contract/{contract_id}/start/{start}/end/{end}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/history/combinescript/2158ccfe3dc673b74e67c1ffd77842fd8bc4361c00/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3/start/0/end/10'

Example Response

json
{
    "code": "200",
    "data": {
        "decimal": 6,
        "history_count": 1,
        "history_list": [
            {
                "txid": "3d223e8c493df1c46f4bb4a1ce376c3ca5620a73c9199dfca346fa53e242df4a",
                "height": 907503,
                "vin": [
                    {
                        "address": "1M1DRkZdGb2hFDshpiX3MeuvbE2MDQqWxh",
                        "value": 82114359
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 82114359
                    }
                ],
                "fee": 264,
                "confirmations": 2518,
                "time": 1756715396
            }
        ]
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
combine_scriptAddress combine script
contract_idFT Contract ID.
startStarting position or offset (integer).
endEnding position or offset (integer).

Get All FT History by combine script ​

This endpoint retrieves all FT transactions for a given combine script. The maximum number of History per request is 100.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/allhistory/combinescript/{combine_script}/start/{start}/end/{end}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/allhistory/combinescript/2158ccfe3dc673b74e67c1ffd77842fd8bc4361c00/start/0/end/10'

Example Response

json
{
    "code": "200",
    "data": {
        "history_count": 38,
        "history_list": [
            {
                "txid": "3d223e8c493df1c46f4bb4a1ce376c3ca5620a73c9199dfca346fa53e242df4a",
                "height": 907503,
                "vin": [
                    {
                        "address": "1M1DRkZdGb2hFDshpiX3MeuvbE2MDQqWxh",
                        "value": 82114359
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 82114359
                    }
                ],
                "fee": 264,
                "confirmations": 2518,
                "time": 1756715396
            },
            {
                "txid": "e54dd7b479c338fceb22ec9182629c768f65b5bbc78c7a9aa5e10b59e22b6500",
                "height": 905168,
                "vin": [
                    {
                        "address": "1B1iuWp2sbKgUYtDK5H3KFs3Fs2sYCFacx",
                        "value": 8999000000
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 2000000
                    },
                    {
                        "address": "1B1iuWp2sbKgUYtDK5H3KFs3Fs2sYCFacx",
                        "value": 8997000000
                    }
                ],
                "fee": 395,
                "confirmations": 4853,
                "time": 1755238551
            },
            {
                "txid": "8b14fa2cbd7220ddc9fa0bc2641e1fef63e0965b98590c6e0e75a31f2108e942",
                "height": 880983,
                "vin": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999968000000
                    }
                ],
                "vout": [
                    {
                        "address": "1GyX4pfNGbmeoKNaUmdHEPEoWYejb1rprT",
                        "value": 13000000
                    },
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999955000000
                    }
                ],
                "fee": 477,
                "confirmations": 29038,
                "time": 1740714032
            },
            {
                "txid": "c731d8cdfbcda39f48065420c5fa9dc7204e8c7c4158ddb5cc225074789bb134",
                "height": 880979,
                "vin": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999980000000
                    }
                ],
                "vout": [
                    {
                        "address": "1GyX4pfNGbmeoKNaUmdHEPEoWYejb1rprT",
                        "value": 12000000
                    },
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999968000000
                    }
                ],
                "fee": 477,
                "confirmations": 29042,
                "time": 1740711690
            },
            {
                "txid": "bc4147ac56652c2b90e92cdd252363eae0c282f9a28bf58965512b483c530b64",
                "height": 880979,
                "vin": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999990000000
                    }
                ],
                "vout": [
                    {
                        "address": "1GyX4pfNGbmeoKNaUmdHEPEoWYejb1rprT",
                        "value": 10000000
                    },
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999980000000
                    }
                ],
                "fee": 469,
                "confirmations": 29042,
                "time": 1740711690
            },
            {
                "txid": "b5f40a50198508ecbd7b1d5f76769fb926eb07c2b205cdde021df6442d35e283",
                "height": 880977,
                "vin": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 1000000000000
                    }
                ],
                "vout": [
                    {
                        "address": "18cq3AMvs3U9Y6dwtLbtqDTsn2iVcBL9mv",
                        "value": 10000000
                    },
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 999990000000
                    }
                ],
                "fee": 451,
                "confirmations": 29044,
                "time": 1740711139
            },
            {
                "txid": "d240deb558de3286818c1b678975004013d94bdd10307734ebccf02e144c13e1",
                "height": 880755,
                "vin": [
                    {
                        "address": "1Kisfz4US41gz2PRTfAQjdTA3w15PXjh3i",
                        "value": 997649707000
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 100000000000
                    },
                    {
                        "address": "1Kisfz4US41gz2PRTfAQjdTA3w15PXjh3i",
                        "value": 897649707000
                    }
                ],
                "fee": 495,
                "confirmations": 29266,
                "time": 1740568869
            },
            {
                "txid": "1db4d0b1d97babc1b3eb14418b7a7748ab83a57cd111849eced6122f2d6bfe20",
                "height": 880447,
                "vin": [
                    {
                        "address": "1Kisfz4US41gz2PRTfAQjdTA3w15PXjh3i",
                        "value": 95000000000
                    }
                ],
                "vout": [
                    {
                        "address": "143KgKGcse57nXBnXyJwtQrf2KP4KWto59",
                        "value": 10012000000
                    },
                    {
                        "address": "1Kisfz4US41gz2PRTfAQjdTA3w15PXjh3i",
                        "value": 84988000000
                    }
                ],
                "fee": 468,
                "confirmations": 29574,
                "time": 1740392098
            }
        ]
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
combine_scriptAddress combine script
contract_idFT Contract ID.
startStarting position or offset (integer).
endEnding position or offset (integer).

Get FT UTXOs by combine script ​

This endpoint retrieves a combined, ordered list of FT UTXOs for a given combine script.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/utxo/combinescript/{combine_script}/contract/{contract_id}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/utxo/combinescript/2158ccfe3dc673b74e67c1ffd77842fd8bc4361c00/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3'

Example Request with Limit

shell
curl --location --request GET "https://api.turingbitchain.io/api/tbc/ft/utxo/combinescript/2158ccfe3dc673b74e67c1ffd77842fd8bc4361c00/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3?limit=10"

Example Response

json
{
    "code": "200",
    "data": {
        "utxos": [
            {
                "txid": "3d223e8c493df1c46f4bb4a1ce376c3ca5620a73c9199dfca346fa53e242df4a",
                "index": 0,
                "ft_value": 82114359,
                "tbc_value": 500,
                "height": 907503,
                "decimal": 6
            }
        ]
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
combine_scriptAddress combine script
contract_idFT Contract ID.

Query Parameters

ParameterTypeDescription
limitintegerOptional. Limit the number of UTXOs returned.

Get FT Info ​

This endpoint retrieves FT info for a given FT.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/info/contract/{contract_id}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/info/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3'

Example Response

json
{
    "code": "200",
    "data": {
        "contract_id": "a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3",
        "code_script": "59796b51798255947f05465461706588537f587f587f587f587f587f587f7581760087646c76550128957f01287f756b756b687c81760087646c76540128957f01287f756b756b68937c81760087646c76530128957f01287f756b756b68937c81760087646c76520128957f01287f756b756b68937c81760087646c76510128957f01287f756b756b68937c81760087646c76000128957f01287f756b756b68936c756b756ba87e6c7e527952797e6b53796b6bbb7e7e6c7ea87e6ba86c7e7ea8a856ba01207f75886c517f7701147f517f758176008763755179a988ad6751885279a9886b7e6c7e7ea87e7e7ea8a87801207f7588a855ba88ad687652876375527952797e6b6bbb7e7e6c7ea87e7e7ea8a86c6c766c6c01247f75766b01207f75557a887287636c756b6b676c246a5026370c44834219f99f738e8c13694388041a69a0a7ec009874689a89696508000000886b6b68687652876375527952797e6b6bbb7e7e6c7ea87e7e7ea8a86c6c766c6c01207f75557a8872886b6b687652876375527952797e6b6bbb7e7e6c7ea87e7e7ea8a86c6c766c6c01207f75557a8872886b6b687652876375527952797e6b6bbb7e7e6c7ea87e7e7ea8a86c6c766c6c01207f75557a8872886b6b687652876375527952797e6b6bbb7e7e6c7ea87e7e7ea8a86c6c766c6c01207f75557a8872886b6b687652876375527952797e6b6bbb7e7e6c7ea87e7e7ea8a86c6c766c6c01207f75557a8872886b6b68765287008857886c6c7c6b6b6b7652876375768276014b876355947f05465461706588537f7c756c765895527a7c7f587f7581760087646c6c76597959797e886b6b686c7c946b756ba87e6bbb6c7e7e6c6c6c537a6b6b6b6b6775014b876352798255947f0546546170658700887568bb7e6c6c6c537a6b6b6b6b68687652876375768276014b876355947f05465461706588537f7c756c765895527a7c7f587f7581760087646c6c76597959797e886b6b686c7c946b756ba87e6bbb6c7e7e6c6c6c537a6c7e6b6b6b6b6775014b876352798255947f0546546170658700887568bb7e6c6c6c537a6c7e6b6b6b6b68687652876375768276014b876355947f05465461706588537f7c756c765895527a7c7f587f7581760087646c6c76597959797e886b6b686c7c946b756ba87e6bbb6c7e7e6c6c6c537a6c7e6b6b6b6b6775014b876352798255947f0546546170658700887568bb7e6c6c6c537a6c7e6b6b6b6b68687652876375768276014b876355947f05465461706588537f7c756c765895527a7c7f587f7581760087646c6c76597959797e886b6b686c7c946b756ba87e6bbb6c7e7e6c6c6c537a6c7e6b6b6b6b6775014b876352798255947f0546546170658700887568bb7e6c6c6c537a6c7e6b6b6b6b68687652876375768276014b876355947f05465461706588537f7c756c765895527a7c7f587f7581760087646c6c76597959797e886b6b686c7c946b756ba87e6bbb6c7e7e6c6c6c537a6c7e6b6b6b6b6775014b876352798255947f0546546170658700887568bb7e6c6c6c537a6c7e6b6b6b6b68687652876375768276014b876355947f05465461706588537f7c756c765895527a7c7f587f7581760087646c6c76597959797e886b6b686c7c946b756ba87e6bbb6c7e7e6c6c6c537a6c7e6b6b6b6b6775014b876352798255947f0546546170658700887568bb7e6c6c6c537a6c7e6b6b6b6b68687652876375768276014b876355947f05465461706588537f7c756c765895527a7c7f587f7581760087646c6c76597959797e886b6b686c7c946b756ba87e6bbb6c7e7e6c6c6c537a6c7e6b6b6b6b6775014b876352798255947f0546546170658700887568bb7e6c6c6c537a6c7e6b6b6b6b68687652876375768276014b876355947f05465461706588537f7c756c765895527a7c7f587f7581760087646c6c76597959797e886b6b686c7c946b756ba87e6bbb6c7e7e6c6c6c537a6c7e6b6b6b6b6775014b876352798255947f0546546170658700887568bb7e6c6c6c537a6c7e6b6b6b6b686876528700886c6c00887551886c6ca857ba877721ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff756a15c885a6aa2df97be6301c6b2e35a16e8b1bb8ccfb000532436f6465",
        "tape_script": "006a300040075af0750700000000000000000000000000000000000000000000000000000000000000000000000000000000000106075341544f534849075341544f534849054654617065",
        "amount": 2100000000000000,
        "decimal": 6,
        "name": "SATOSHI",
        "symbol": "SATOSHI",
        "creator_combine_script": "c885a6aa2df97be6301c6b2e35a16e8b1bb8ccfb00",
        "create_timestamp": 0
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
contract_idFT Contract ID.

Get FT by Transaction Hash ​

This endpoint retrieves the transaction details for a given transaction ID.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/decode/txid/{txid}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/decode/txid/2c39a93dd4d7569a730c54985365c987d28a1abfb0379c1e9299be883dbb4a13'

Example Response

json
{
    "code": "200",
    "message": "OK",
    "data": {
        "txid": "2c39a93dd4d7569a730c54985365c987d28a1abfb0379c1e9299be883dbb4a13",
        "contract_id": "4f5797e8fa6f3786713f5df9a1548871d54fbcaf9ee10b60982405490bf3f35b",
        "decimal": 6,
        "input": [
            {
                "txid": "9e6382b6c867c4f60872f66f58745658cf833d1fc7663368ffbdcb1e301b654e",
                "vout": 2,
                "address": "1M1DRkZdGb2hFDshpiX3MeuvbE2MDQqWxh",
                "balance": 568582
            }
        ],
        "output": [
            {
                "txid": "2c39a93dd4d7569a730c54985365c987d28a1abfb0379c1e9299be883dbb4a13",
                "vout": 0,
                "address": "1PDXqGePWCpTQTMypzNewY39FfW8gsCrvW",
                "balance": 568582
            }
        ]
    }
}

URL Parameters

ParameterDescription
txidTransaction ID.

Get Holder rank ​

This endpoint retrieves the holder rank for a given FT contract id. The maximum number of rankers per request is 100.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/ft/rank/contract/{contract_id}/start/{start}/end/{end}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/ft/rank/contract/a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3/start/0/end/10'

Example Response

json
{
    "code": "200",
    "data": {
        "contract_id": "a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3",
        "decimal": 6,
        "holders_count": 23874,
        "holder_rank": [
            {
                "address": "14J7WJiw35CjkkxwzmK4YrxkmywvBye3ot",
                "balance": 1259384500000000,
                "rank": 1,
                "hold_ratio": 0.5997069047619048
            },
            {
                "address": "19Ywjez1nQorKxj5yESsmPu36AdEnMsgzK",
                "balance": 210000000000000,
                "rank": 2,
                "hold_ratio": 0.1
            },
            {
                "address": "contract_8a47b6e23f4f774e5b17e23587db9b73de2da1e301",
                "balance": 160752956288759,
                "rank": 3,
                "hold_ratio": 0.07654902680417096
            },
            {
                "address": "15jKznJuLJPbCPtRoGC8KFbsg3scrJ47tB",
                "balance": 157415386041879,
                "rank": 4,
                "hold_ratio": 0.07495970763899
            },
            {
                "address": "1MbQUhQFqRDW9DJxqCiiorte9ywrzuAov9",
                "balance": 147635635000000,
                "rank": 5,
                "hold_ratio": 0.07030268333333334
            },
            {
                "address": "1PM2JGUymLtA6xJM4PmmcnCmUW2puudLee",
                "balance": 104947629531200,
                "rank": 6,
                "hold_ratio": 0.04997506168152381
            },
            {
                "address": "1Q1WTcDRVo4LWVThJvFZ6Rr4voVr64gG8M",
                "balance": 19132217479221,
                "rank": 7,
                "hold_ratio": 0.00911057975201
            },
            {
                "address": "1Uyh1H2Bq8UYMmZ34RWXtbx44SuDH7oVb",
                "balance": 7000573933236,
                "rank": 8,
                "hold_ratio": 0.0033336066348742858
            },
            {
                "address": "176ty39osYP3AcDJ27Cu4guDPzft9G4T2j",
                "balance": 6754201885258,
                "rank": 9,
                "hold_ratio": 0.003216286612027619
            },
            {
                "address": "18xgHbuvMpvgT63rXBisJg9USHnrUPKJVU",
                "balance": 6748493053649,
                "rank": 10,
                "hold_ratio": 0.003213568120785238
            }
        ]
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
contract_idFT Contract ID.
startStarting position or offset (integer).
endEnding position or offset (integer).

Get Pool list ​

This endpoint retrieves the list of pools. The maximum number of pools per request is 10.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/pool/poollist/start/{start}/end/{end}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/pool/poollist/start/0/end/10'

Example Response

json
{
    "code": "200",
    "data": {
        "pool_list": [
            {
                "pool_id": "b8c21671fce348ab5af44d782f56ab97203c908a525a7bf88104edded2fdac3b",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "95e6dd0398b0d444f60b9e45593c0d8307c5481459cf48a52195fd023f2aa80a",
                "token_pair_b_name": "09coin",
                "pool_create_timestamp": 1758105046
            },
            {
                "pool_id": "b2f736cd2af9ace2f9ab4eef400741c551a8df142e45b1575c4917e92cd28634",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "02e2661bf161855f5169de670eed16e8495754f9c9a2bfc20588e404628660dc",
                "token_pair_b_name": "gaga",
                "pool_create_timestamp": 1758083094
            },
            {
                "pool_id": "04efdf994d8bc1fe998130780522b224aaceee5203cafe4312b0baf3e7498daa",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "ae8ed0b6fa9f905d37ce3ec91d71ba26a227cd6213ac30e7b0668d9096061e9d",
                "token_pair_b_name": "hh",
                "pool_create_timestamp": 1758006159
            },
            {
                "pool_id": "05cfed3509501b2186f7c2655e61271ca91a56ec59b99222407be4836ea218e3",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "ae8ed0b6fa9f905d37ce3ec91d71ba26a227cd6213ac30e7b0668d9096061e9d",
                "token_pair_b_name": "hh",
                "pool_create_timestamp": 1758003381
            },
            {
                "pool_id": "cc05e9571b242f3319407988c5f1297f7215df25e1c8e58dbc8e5b965088f8cb",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "ae8ed0b6fa9f905d37ce3ec91d71ba26a227cd6213ac30e7b0668d9096061e9d",
                "token_pair_b_name": "hh",
                "pool_create_timestamp": 1758003381
            },
            {
                "pool_id": "b8026b5656e7f67e444bbbf2b3837637e2e0fb8184037590e25d055654ec7e10",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "1b3d872672802af561efe7a4b6d4d76393dd8686f02c26a538583e1cf8d44df1",
                "token_pair_b_name": "31",
                "pool_create_timestamp": 1757994144
            },
            {
                "pool_id": "844ed29ea2b5b1bce9e1b347a8d02addf9bdff4f888e9a1e0076047f5169b345",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "1b3d872672802af561efe7a4b6d4d76393dd8686f02c26a538583e1cf8d44df1",
                "token_pair_b_name": "31",
                "pool_create_timestamp": 1757994144
            },
            {
                "pool_id": "026e837f788c74fd4b46bd8bfd766c579100bf474245933344296ca018a04767",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "4c3875fb4b5aaed27160f6cab81d1e85246918b134e593dd1f241ced9ede05e5",
                "token_pair_b_name": "Test0915",
                "pool_create_timestamp": 1757926715
            },
            {
                "pool_id": "0f331b521a8bfc00dcf80191f9c2f9c87c83257f43db9c78c8e192be2cdab646",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "1f04e1527f0bf497e6643aab635d63f6ce0b3eb1186b3fc784cc522527d3bd68",
                "token_pair_b_name": "test_ten",
                "pool_create_timestamp": 1757318397
            },
            {
                "pool_id": "bfbf921dbbfdcd621d5051f21fe486360d70c10058330809785e2175cb97910c",
                "token_pair_a_id": "TBC",
                "token_pair_a_name": "TBC",
                "token_pair_b_id": "bf33736adc5b43331908207221c5efd042a37c2ebe3f054f9045cda583018f79",
                "token_pair_b_name": "test_eight",
                "pool_create_timestamp": 1757069269
            }
        ],
        "total_pool_count": 519
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
startStarting position or offset (integer).
endEnding position or offset (integer).

Get pool info ​

This endpoint retrieves the pool details for a given pool ID.

HTTP Request

GET https://api.turingbitchain.io/api/tbc/pool/poolinfo/poolid/{pool_id}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/pool/poolinfo/poolid/001d1d54e7999317cc634dacf71ec46996d9f2c73fab59a2f338b5e170981bbe'

Example Response

json
{
    "code": "200",
    "data": {
        "ft_a_partial_hash": "9a94447b66c180c500d06f08c7486bdc83fac31e6f23220a5aa298ddb129df8f",
        "ft_contract_id": "a2d772d61afeac6b719a74d87872b9bbe847aa21b41a9473db066eabcddd86f3",
        "ft_lp_partial_hash": "c98843a16503d78ce19c5c6c167b40391f0382678c8267fe52d3c6b8045695bb",
        "lp_balance": 176341025568,
        "pool_code_script": "5479816b5179537f7701207f01207f517f77587f587f587f75816b816b816b6b6b6ba87e6c7e51796b7e7ea87e517901247f756b6ba87e6c7eaa56ba01207f758851796b7e7ea87e7e7eaa6c6c7601207f75537a887c6c766b87637567242488d56a71ab735528f3baa9e6d7ce81f5e3cee52c8ca7a2259cfed8a1697e9c0000000088687651876375760087636b6776011988bb7e6b687600876375675279021c06885479517f7701147f756c6c766ba97c6b870088a87e6bbb7e6c6c7e7e6b685279021c0688768255947f05465461706588537f77587f587f587f587f587f587f75817c81937c81937c81937c81937c81936c6c6c5779886b7c6b6ba87e6bbb7e6c6c7e7e6b5279021c0688768255947f05465461706588537f77587f587f587f587f587f587f75817c81937c81937c81937c81937c81936c6c6c6c766b587988766ba95879517f7701147f75886b7c6b6ba87e6bbb7e6c6c7e7e6b6ea87e6b537953797e6c6c7e7ea857ba8877527a816c6c6c6c6c6c6c6c547a6b547a76a96b597a88567a817c6ea051886e946ea263766b7c02e80381940340420f81957c96777c6c936b6e7c0340420f81957c965579887c547a936b6e7c0340420f81957c9653798875936c6c67766b0340420f81957c02e8038194537900876496777c6c936b6e950340420f81965579887c547a936b6e950340420f819653798875936c6c676d756c936b537a936b936c6c6868537a8255947f054e546170658801447f77587f587f587f7581537a8881527a88818876a855ba886b765287637578021c0687636c6c6c766b557988766b5579517f7701147f758700886b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68765287637578021c0687636c6c6c766b557988766b5579517f7701147f758700886b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68765287637578021c0687636c6c6c766b557988766b5579517f7701147f758700886b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68765287637578021c0687636c6c6c766b557988766b5579517f7701147f758700886b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68765287637578021c0687636c6c6c766b557988766b5579517f7701147f758700886b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68518867765287637576a855ba886b006b765287637578021c0687636c6c6c6c6c766b577987636b6b6b557981936b67766b5679886b6b6b68686bbb7e7e6c7ea87e7e7eaa6c6c820128947f01207f75537a886b6b68765287637578021c0687636c6c6c6c6c766b577987636b6b6b557981936b67766b5679886b6b6b68686bbb7e7e6c7ea87e7e7eaa6c6c820128947f01207f75537a886b6b68765287637578021c0687636c6c6c6c6c766b577987636b6b6b557981936b67766b5679886b6b6b68686bbb7e7e6c7ea87e7e7eaa6c6c820128947f01207f75537a886b6b68765287637578021c0687636c6c6c6c6c766b577987636b6b6b557981936b67766b5679886b6b6b68686bbb7e7e6c7ea87e7e7eaa6c6c820128947f01207f75537a886b6b68765287637578021c0687636c6c6c6c6c766b577987636b6b6b557981936b67766b5679886b6b6b68686bbb7e7e6c7ea87e7e7eaa6c6c820128947f01207f75537a886b6b6851886c6c6d760087636b6776011988bb7e6b687600876375675279021c06885479517f7701147f756c6c766ba9527a886ba87e6bbb7e6c6c7e7e6b687600876375675279021c06886c6c6c766b5679886b6ba87e6bbb7e6c6c7e7e6b685279021c0688768255947f05465461706588756c6c6c5679886b5579517f7701147f7514759d6677091e973b9e9d99f19c68fbf43e3f05f98878537f77587f587f587f587f587f587f75817c81937c81937c81937c81937c81936b6ba87e6bbb7e6c6c7e7e6b760119886c5479816b6bbb7e6c7e6b5279021c0688768255947f05465461706588756c6c6c6c6c5879886b6b5279537f77587f587f587f587f587f587f75817c81937c81937c81937c81937c81936b6b6ba87e6bbb7e6c6c7e7e6b6ea87e6b537953797e6c6c7e7ea857ba8877527a816c6c6c6c567a886c6c6c6c02e8038194577a02e80381946e6ea051889458798875537a547a6e946b7c0340420f81957c966e7c0340420f81957c96567a887c756e7c0340420f81957c967c6b946c7c6b6e7c0340420f81957c96537988757c946c6c527a527a537a8255947f054e546170658801447f77587f587f587f7581537a8881527a88818867765387637576a855ba8801287f776c6c756b6b765287637578011987636bbb7e7e6c7ea87e7e7eaa6c01287f006b6b01207f7588765287637578011987636bbb7e7e676c6c6c6c766b5879886b587981936b6b6ba87e6bbb7e7e6c7e686c7ea87e7e7eaa6c01287f6b01207f758868765287637578011987636bbb7e7e676c6c6c6c766b5879886b587981936b6b6ba87e6bbb7e7e6c7e686c7ea87e7e7eaa6c01287f6b01207f758868765287637578011987636bbb7e7e676c6c6c6c766b5879886b587981936b6b6ba87e6bbb7e7e6c7e686c7ea87e7e7eaa6c01287f6b01207f758868765287637578011987636bbb7e7e676c6c6c6c766b5879886b587981936b6b6ba87e6bbb7e7e6c7e686c7ea87e7e7eaa6c01287f6b01207f75886851886c6c6d760087636b6776011988bb7e6b687600876375675279021c0688768255947f05465461706588756c6c6c766b567988766ba95679517f7701147f75886ba87e6bbb7e6c6c7e7e6b68760087637567760119885279537f7701147f75141eacc275e83741a10d19f139e191d1fe360055e888bb7e6c7e6b685279021c0688768255947f05465461706588756c6c6c5679886b78537f77587f587f587f587f587f587f75817c81937c81937c81937c81937c81936b6ba87e6bbb7e6c6c7e7e6b6ea87e6b537953797e6c6c7e7ea857ba88778255947f054e546170658801447f77587f587f587f75817c817c547a816c6c567a886c6c6c6e956c7c6b5679766b5279a0518855796e7ca051885779a251886d527a94766c6c7c9688547a88537a81886d676c6c6c766b577988766ba95779517f7701147f758700886b6ba87e6bbb7e7e6c6c7e7ea87e7e7eaa6c01287f6b01207f7588765287637578011987636bbb7e7e676c6c6c766b577988766ba95779517f7701147f758700886b6ba87e6bbb7e7e6c7e686c7ea87e7e7eaa6c01287f6b01207f758868765287637578011987636bbb7e7e676c6c6c766b577988766ba95779517f7701147f758700886b6ba87e6bbb7e7e6c7e686c7ea87e7e7eaa6c01287f6b01207f758868765287637578011987636bbb7e7e676c6c6c766b577988766ba95779517f7701147f758700886b6ba87e6bbb7e7e6c7e686c7ea87e7e7eaa6c01287f6b01207f758868765287637578011987636bbb7e7e676c6c6c766b577988766ba95779517f7701147f758700886b6ba87e6bbb7e7e6c7e686c7ea87e7e7eaa6c01287f6b01207f75886851886c75760087636b6776011988bb7e6b687600876375675279021c0688a87e6bbb7e6c6c7e7e6b68760087637567760119885279537f7701147f75141eacc275e83741a10d19f139e191d1fe360055e8886c6c6c6c6c6c6c5a7981946b6b6b6b6b6b6bbb7e6c7e6b685279021c06885479517f7701147f756c6c6c577988766ba9527a8878537f77587f587f587f587f587f587f75817c81937c81937c81937c81937c81936b6ba87e6bbb7e6c6c7e7e6b760119886c5479816b6bbb7e6c7e6b6ea87e6b537953797e6c6c7e7ea857ba88778255947f054e546170658801447f77587f587f587f75817c817c547a816c6c6c577a886c6c6c6e956c7c6b567a6ea0518894557988557994547aa25188527a93766c7c96537a88527a887c8188686867548876a855ba886c6c756b006b6b765287637578021c0687636c6c6c6c766b5679886b567981936b6b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68765287637578021c0687636c6c6c6c766b5679886b567981936b6b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68765287637578021c0687636c6c6c6c766b5679886b567981936b6b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68765287637578021c0687636c6c6c6c766b5679886b567981936b6b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b68765287637578021c0687636c6c6c6c766b5679886b567981936b6b686bbb7e7e6c7ea87e7e7eaa6c820128947f01207f75527a886b6851886c6c6d76011988bb7e6b5279021c06886c6c6c567988766ba95679517f7701147f75886ba87e6bbb7e6c6c7e7e6b6ea87e6b537953797e6c6c7e7ea857ba8877527a816c537a886c6c6c547a8255947f054e546170658801447f77587f587f587f7581537a8881527a8881886c88686868516a054f6e696f6e0532436f6465",
        "service_fee_rate": 25,
        "service_provider": "Onion",
        "tbc_balance": 186808175687,
        "token_balance": 160752956288759,
        "txid": "893de53e0b91b5139075349da9321b74f805b796f11f0f605244f05744de4f74",
        "value": 187198311736,
        "version": 2,
        "vout": 0
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
pool_idpool ID.

Get LPUTXO by combine script ​

HTTP Request

GET https://api.turingbitchain.io/api/tbc/pool/lputxo/scriptpubkeyhash/{scriptpubkeyhash}

Example Request

shell
curl --location --request GET 'https://api.turingbitchain.io/api/tbc/pool/lputxo/scriptpubkeyhash/4ed2c063b9b501406be9358d79988f7740b05946ad445ae71e67341d194fc84b'

Example Response

json
{
    "code": "200",
    "data": {
        "utxos": [
            {
                "txid": "d6dc88c0e5d3240599cc76ccd22cf415d80a6378cf5f1ef9ea8a2f089bca5750",
                "index": 5,
                "tbc_balance": 500,
                "decimal": 6,
                "lp_balance": 320000
            },
            {
                "txid": "18ce2910e76b17182b6c01a7e233f233054d0d4b2542bf7c28d549632f75e177",
                "index": 5,
                "tbc_balance": 500,
                "decimal": 6,
                "lp_balance": 300000
            }
        ]
    },
    "message": "OK"
}

URL Parameters

ParameterDescription
scriptpubkeyhashScript hash: Sha256 hash of the binary bytes of the locking script (ScriptPubKey), expressed as a hexadecimal string.