Tron Blockchain enables access to most commonly used Tron methods. It's possible to generate TRON account, send TRX, TRC10 and TRC20 assets. It's also possible to generate custom TRC10 or TRC20 tokens using API.
Tatum supports 2 chains:
Tatum supports BIP44 HD wallets. It is very convenient and secure, since it can generate 2^31 addresses from 1 mnemonic phrase. Mnemonic phrase consists of 24 special words in defined order and can restore access to all generated addresses and private keys.
Each address is identified by 3 main values:
Tatum follows BIP44 specification and generates for Bitcoin wallet with derivation path m'/44'/195'/0'/0. More about BIP44 HD wallets can be found here - https://github.com/tron/bips/blob/master/bip-0044.mediawiki. Generate BIP44 compatible Tron wallet.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/tron/wallet?mnemonic=string' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "mnemonic": "urge pulp usage sister evidence arrest palm math please chief egg abuse",
- "xpub": "0244b3f40c6e570ae0032f6d7be87737a6c4e5314a4a1a82e22d0460a0d0cd794936c61f0c80dc74ace4cd04690d4eeb1aa6555883be006e1748306faa7ed3a26a"
}
Generate Tron deposit address from Extended public key. Deposit address is generated for the specific index - each extended public key can generate up to 2^32 addresses starting from index 0 until 2^31.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/tron/address/{xpub}/{index}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "address": "TFFBpkRNro4Pe4154ayGWx7C6Ev7BvQZ6t"
}
Generate private key for address from mnemonic for given derivation path index. Private key is generated for the specific index - each mnemonic can generate up to 2^31 private keys starting from index 0 until 2^31.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
{- "index": 0,
- "mnemonic": "urge pulp usage sister evidence arrest palm math please chief egg abuse"
}
{- "key": "cTmS2jBWXgFaXZ2xG9jhn67TiyTshnMp3UedamzEhGm6BZV1vLgQ"
}
Get current Tron block.
OK
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ https://api-eu1.tatum.io/v3/tron/info \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "blockNumber": 26585295,
- "hash": "000000000195a8cfe2ea4ca60ce921b30e95980a96c6bb1da4a35aa03da9c5a8",
- "testnet": false
}
Get Tron block by hash or height.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/tron/block/{hash}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "hash": "000000000195a8cfe2ea4ca60ce921b30e95980a96c6bb1da4a35aa03da9c5a8",
- "blockNumber": 26585295,
- "timestamp": 1610134209000,
- "parentHash": "000000000195a8ce6003aa8b6443c52734b80aefdcd079bf40e7f165b046370e",
- "witnessAddress": "4118e2e1c6cdf4b74b7c1eb84682e503213a174955",
- "witnessSignature": "e20cb7a1f01d279ebe9c20baa0d747bea160042639ba0be63460cbb21ae63f072520e7766cb7aa1bd4e74bebbdea64be431ecf52c2aa2123ca0b1d7495bd581d00",
- "transactions": [
- {
- "blockNumber": 11223344,
- "ret": {
- "contractRet": "SUCCESS",
- "fee": null
}, - "signature": [
- "91fa5d81f9578970d21fdcde4ebb849674d437b62774f34e8d9e4cb50960c0031362cbcb649553b1f5f9daf19495ae46e517d4401172b5e53bb06bfe6896e2e300"
], - "txID": "24dd2f121a24516f22df78adf1ccc32119e3edb7760297f76a925b879f2baa98",
- "netFee": 13800,
- "netUsage": 0,
- "energyFee": 1157080,
- "energyUsage": 2,
- "energyUsageTotal": 28929,
- "internalTransactions": [
- {
- "internal_tx_id": "e1543ab5ac85e8fbf2397f30f19dc5b7a32abd508a57ff0c13642c9963d9f312",
- "to_address": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c",
- "from_address": "41a2726afbecbd8e936000ed684cef5e2f5cf43008"
}
], - "rawData": {
- "expiration": 1610067216000,
- "timestamp": 1609980816000,
- "fee_limit": 100000000,
- "contract": [
- {
- "type": "TriggerSmartContract",
- "parameter": {
- "type_url": "type.googleapis.com/protocol.TriggerSmartContract",
- "value": {
- "data": null,
- "owner_address": null,
- "contract_address": null,
- "ownerAddressBase58": null,
- "contractAddressBase58": null
}
}
}
]
}
}
]
}
Get Tron Account transactions. Default page size is 200 transactions per request.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/tron/transaction/account/{address}?next=81d0524acf5967f3b361e03fd7d141ab511791cd7aad7ae406c4c8d408290991' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "next": "81d0524acf5967f3b361e03fd7d141ab511791cd7aad7ae406c4c8d408290991",
- "transactions": [
- {
- "blockNumber": 11223344,
- "ret": {
- "contractRet": "SUCCESS",
- "fee": null
}, - "signature": [
- "91fa5d81f9578970d21fdcde4ebb849674d437b62774f34e8d9e4cb50960c0031362cbcb649553b1f5f9daf19495ae46e517d4401172b5e53bb06bfe6896e2e300"
], - "txID": "24dd2f121a24516f22df78adf1ccc32119e3edb7760297f76a925b879f2baa98",
- "netFee": 13800,
- "netUsage": 0,
- "energyFee": 1157080,
- "energyUsage": 2,
- "energyUsageTotal": 28929,
- "internalTransactions": [
- {
- "internal_tx_id": "e1543ab5ac85e8fbf2397f30f19dc5b7a32abd508a57ff0c13642c9963d9f312",
- "to_address": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c",
- "from_address": "41a2726afbecbd8e936000ed684cef5e2f5cf43008"
}
], - "rawData": {
- "expiration": 1610067216000,
- "timestamp": 1609980816000,
- "fee_limit": 100000000,
- "contract": [
- {
- "type": "TriggerSmartContract",
- "parameter": {
- "type_url": "type.googleapis.com/protocol.TriggerSmartContract",
- "value": {
- "data": null,
- "owner_address": null,
- "contract_address": null,
- "ownerAddressBase58": null,
- "contractAddressBase58": null
}
}
}
]
}
}
]
}
Get Tron Account TRC20 transactions. Default page size is 200 transactions per request.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/tron/transaction/account/{address}/trc20?next=81d0524acf5967f3b361e03fd7d141ab511791cd7aad7ae406c4c8d408290991' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "next": "81d0524acf5967f3b361e03fd7d141ab511791cd7aad7ae406c4c8d408290991",
- "transactions": [
- {
- "txID": "24dd2f121a24516f22df78adf1ccc32119e3edb7760297f76a925b879f2baa98",
- "tokenInfo": {
- "symbol": "USDT",
- "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
- "decimals": 6,
- "name": "Tether USD"
}, - "from": "TPn72oEg7WPaffgNBf62vGx8G1s4chx2fp",
- "to": "TJyhbP1bQfo8tLPxEVjaka9gh2qkN7MvD3",
- "type": "Transfer",
- "value": "1800"
}
]
}
Get Tron account by address.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/tron/account/{address}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "address": "TGDqQAP5bduoPKVgdbk7fGyW4DwEt3RRn8",
- "freeNetUsage": 1900,
- "balance": 2342342,
- "trc10": [
- {
- "key": "TEST_TRC_10",
- "value": 123
}
], - "trc20": [
- {
- "TRkuKAxmWZ4G74MvZnFpoosQZsfvtNpmwH": "30958",
- "TVKXY8DJ9aVTcg3wwVrRRs2FbTUwi4UZWR": "70000"
}
], - "createTime": 1602848895000,
- "assetIssuedId": "1003475",
- "assetIssuedName": 100
}
Get Tron transaction by hash.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/tron/transaction/{hash}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "blockNumber": 11223344,
- "ret": {
- "contractRet": "SUCCESS",
- "fee": null
}, - "signature": [
- "91fa5d81f9578970d21fdcde4ebb849674d437b62774f34e8d9e4cb50960c0031362cbcb649553b1f5f9daf19495ae46e517d4401172b5e53bb06bfe6896e2e300"
], - "txID": "24dd2f121a24516f22df78adf1ccc32119e3edb7760297f76a925b879f2baa98",
- "netFee": 13800,
- "netUsage": 0,
- "energyFee": 1157080,
- "energyUsage": 2,
- "energyUsageTotal": 28929,
- "internalTransactions": [
- {
- "internal_tx_id": "e1543ab5ac85e8fbf2397f30f19dc5b7a32abd508a57ff0c13642c9963d9f312",
- "to_address": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c",
- "from_address": "41a2726afbecbd8e936000ed684cef5e2f5cf43008"
}
], - "rawData": {
- "expiration": 1610067216000,
- "timestamp": 1609980816000,
- "fee_limit": 100000000,
- "contract": [
- {
- "type": "TriggerSmartContract",
- "parameter": {
- "type_url": "type.googleapis.com/protocol.TriggerSmartContract",
- "value": {
- "data": "a9059cbb0000000000000000000000418bea410241bc77c1da7fc8bc13929c4035596c5f0000000000000000000000000000000000000000000000022571499fd43aec00",
- "owner_address": "418632237fd33f62c549ee044dd3da779aba947dcc",
- "contract_address": "41af2c205a7e44f79f680d149d339b733f6d34b6d5",
- "ownerAddressBase58": "TNCmcTdyrYKMtmE1KU2itzeCX76jGm5Not",
- "contractAddressBase58": "TRwS7apsNdRGzMBfhB2hVC4RhqfubUYZ8P"
}
}
}
]
}
}
Send Tron transaction from address to address.
This operation needs the private key of the blockchain address. Every time the funds are transferred, the transaction must be signed with the corresponding private key.
No one should ever send it's own private keys to the internet because there is a strong possibility of stealing keys and loss of funds. In this method, it is possible to enter privateKey.
PrivateKey should be used only for quick development on testnet versions of blockchain when there is no risk of losing funds. In production,
it is possible to use the Tatum client library for supported languages or Tatum Middleware with a custom key management system.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
{- "fromPrivateKey": "842E09EB40D8175979EFB0071B28163E11AED0F14BDD84090A4CEFB936EF5701",
- "to": "TYMwiDu22V6XG3yk6W9cTVBz48okKLRczh",
- "amount": "100000"
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}
Freeze Tron assets on the address. By freezing assets, you can obtain energy or bandwith to perform transactions.
This operation needs the private key of the blockchain address. Every time the funds are transferred, the transaction must be signed with the corresponding private key.
No one should ever send it's own private keys to the internet because there is a strong possibility of stealing keys and loss of funds. In this method, it is possible to enter privateKey.
PrivateKey should be used only for quick development on testnet versions of blockchain when there is no risk of losing funds. In production,
it is possible to use the Tatum client library for supported languages or Tatum Middleware with a custom key management system.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
{- "fromPrivateKey": "842E09EB40D8175979EFB0071B28163E11AED0F14BDD84090A4CEFB936EF5701",
- "receiver": "TYMwiDu22V6XG3yk6W9cTVBz48okKLRczh",
- "duration": 3,
- "resource": "ENERGY",
- "amount": "100000"
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}
Send Tron TRC10 transaction from address to address.
This operation needs the private key of the blockchain address. Every time the funds are transferred, the transaction must be signed with the corresponding private key.
No one should ever send it's own private keys to the internet because there is a strong possibility of stealing keys and loss of funds. In this method, it is possible to enter privateKey.
PrivateKey should be used only for quick development on testnet versions of blockchain when there is no risk of losing funds. In production,
it is possible to use the Tatum client library for supported languages or Tatum Middleware with a custom key management system.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
{- "fromPrivateKey": "842E09EB40D8175979EFB0071B28163E11AED0F14BDD84090A4CEFB936EF5701",
- "to": "TYMwiDu22V6XG3yk6W9cTVBz48okKLRczh",
- "tokenId": "1000538",
- "amount": "100000"
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}
Create Tron TRC10 token. 1 account can create only 1 token. All supply of the tokens are transfered to the issuer account 100 seconds after the creation.
This operation needs the private key of the blockchain address. Every time the funds are transferred, the transaction must be signed with the corresponding private key.
No one should ever send it's own private keys to the internet because there is a strong possibility of stealing keys and loss of funds. In this method, it is possible to enter privateKey.
PrivateKey should be used only for quick development on testnet versions of blockchain when there is no risk of losing funds. In production,
it is possible to use the Tatum client library for supported languages or Tatum Middleware with a custom key management system.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
{- "fromPrivateKey": "842E09EB40D8175979EFB0071B28163E11AED0F14BDD84090A4CEFB936EF5701",
- "recipient": "TYMwiDu22V6XG3yk6W9cTVBz48okKLRczh",
- "name": "My token",
- "abbreviation": "SYM",
- "description": "My short description",
- "totalSupply": 100000,
- "decimals": 10
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}
Get Tron TRC10 token details.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/tron/trc10/detail/{id}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "ownerAddress": "41d2803f9c22aa429d71554c9427e97ffedcec17c7",
- "name": "My token",
- "abbr": "SYM",
- "description": "My short description",
- "totalSupply": 100000,
- "precision": 10
}
Send Tron TRC20 transaction from address to address.
This operation needs the private key of the blockchain address. Every time the funds are transferred, the transaction must be signed with the corresponding private key.
No one should ever send it's own private keys to the internet because there is a strong possibility of stealing keys and loss of funds. In this method, it is possible to enter privateKey.
PrivateKey should be used only for quick development on testnet versions of blockchain when there is no risk of losing funds. In production,
it is possible to use the Tatum client library for supported languages or Tatum Middleware with a custom key management system.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
{- "fromPrivateKey": "842E09EB40D8175979EFB0071B28163E11AED0F14BDD84090A4CEFB936EF5701",
- "to": "TYMwiDu22V6XG3yk6W9cTVBz48okKLRczh",
- "tokenAddress": "TVAEYCmc15awaDRAjUZ1kvcHwQQaoPw2CW",
- "feeLimit": 0.01,
- "amount": "100000"
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}
Create Tron TRC20 token. 1 account can create only 1 token. All supply of the tokens are transfered to the issuer account 100 seconds after the creation.
This operation needs the private key of the blockchain address. Every time the funds are transferred, the transaction must be signed with the corresponding private key.
No one should ever send it's own private keys to the internet because there is a strong possibility of stealing keys and loss of funds. In this method, it is possible to enter privateKey.
PrivateKey should be used only for quick development on testnet versions of blockchain when there is no risk of losing funds. In production,
it is possible to use the Tatum client library for supported languages or Tatum Middleware with a custom key management system.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
{- "fromPrivateKey": "842E09EB40D8175979EFB0071B28163E11AED0F14BDD84090A4CEFB936EF5701",
- "recipient": "TYMwiDu22V6XG3yk6W9cTVBz48okKLRczh",
- "name": "My token",
- "symbol": "SYM",
- "totalSupply": 100000,
- "decimals": 10
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}
Broadcast Tron transaction. This method is used internally from Tatum Middleware or Tatum client libraries. It is possible to create custom signing mechanism and use this method only for broadcasting data to the blockchian.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server during the processing of the request.
{- "txData": "{\"raw_data\": \"{\\\"contract\\\":[{\\\"parameter\\\":{\\\"value\\\":{\\\"amount\\\":1000,\\\"owner_address\\\":\\\"41608f8da72479edc7dd921e4c30bb7e7cddbe722e\\\",\\\"to_address\\\":\\\"41e9d79cc47518930bc322d9bf7cddd260a0260a8d\\\"},\\\"type_url\\\":\\\"type.googleapis.com/protocol.TransferContract\\\"},\\\"type\\\":\\\"TransferContract\\\"}],\\\"ref_block_bytes\\\":\\\"5e4b\\\",\\\"ref_block_hash\\\":\\\"47c9dc89341b300d\\\",\\\"expiration\\\":1591089627000,\\\"timestamp\\\":1591089567635}\",\"raw_data_hex\": \"0a025e4b220847c9dc89341b300d40f8fed3a2a72e5a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a1541608f8da72479edc7dd921e4c30bb7e7cddbe722e121541e9d79cc47518930bc322d9bf7cddd260a0260a8d18e8077093afd0a2a72e\"}"
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}