wallet/broadcasttransaction | TRON

TRON API method that broadcasts a signed transaction to the TRON network. Reference for wallet/broadcasttransaction on TRON via Chainstack.

POST /95e61622bf6a8af293978377718e3b77/wallet/broadcasttransaction

wallet/broadcasttransaction

cURL

curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/broadcasttransaction \
  --header 'Content-Type: application/json' \
  --data '
{
  "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",
  "signature": [
    "deadbeefcafebabefacec0011234abcd0badf00d9999777755553333222211114321dcba0f0ff0f013579bdf2468ace0987654321a2b3c4d5e6f7a8b9c0deeff1b"
  ],
  "visible": false
}
'

200

{
  "result": true,
  "code": "<string>",
  "message": "<string>",
  "txid": "<string>"
}

TRON API method that broadcasts a signed transaction to the TRON network. This method submits a fully constructed and signed transaction for processing and inclusion in the blockchain.

Get your own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

The transaction object should contain:

• raw_data — the raw transaction data object containing:
  • contract — array of contract objects with transaction details
  • ref_block_bytes — reference block bytes
  • ref_block_hash — reference block hash
  • expiration — transaction expiration time in milliseconds
  • timestamp — transaction creation timestamp
• raw_data_hex — hexadecimal representation of the raw transaction data
• signature — array of transaction signatures (required for signed transactions)
• visible — optional boolean for address format

Response

• result — boolean indicating broadcast success
• code — error code if broadcast failed
• message — hexadecimal error message if broadcast failed
• txid — transaction ID if broadcast succeeded

Use case

The wallet/broadcasttransaction method is used for:

• Submitting signed transactions to the TRON network for processing.
• Broadcasting transfers, smart contract interactions, and other operations.
• Finalizing transactions after they have been created and signed offline.
• Implementing transaction submission in wallets and DApps.

curl example

Use a fully signed transaction object. The example below is syntactically valid and will return a JSON result from the node. If the signature does not match the raw_data, the node responds with SIGERROR. Replace the signature value with a real signature produced from the exact raw_data to get result: true.

Shell

curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/broadcasttransaction' \
  --header 'Content-Type: application/json' \
  --data '{
    "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",
    "signature": [
      "deadbeefcafebabefacec0011234abcd0badf00d9999777755553333222211114321dcba0f0ff0f013579bdf2468ace0987654321a2b3c4d5e6f7a8b9c0deeff1b"
    ],
    "visible": false
  }'

Example response with an invalid signature (connectivity and payload are correct, signature is not):

{
  "result": false,
  "code": "SIGERROR",
  "message": "..."
}

to get a successful result: true, create the transaction with wallet/createtransaction, sign the exact raw_data with your private key, then broadcast the signed transaction here. Keep your private key secure and never paste it in client-side code.

Body

application/json

raw_data · object · required

raw_data_hex · string · default: 0a025e4b220847c9dc89341b300d40f8fed3a2a72e5a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a1541608f8da72479edc7dd921e4c30bb7e7cddbe722e121541e9d79cc47518930bc322d9bf7cddd260a0260a8d18e8077093afd0a2a72e · required

signature · string[]

Array of hex-encoded signatures (65-byte secp256k1).

visible · boolean · default: false

Response

200 - application/json

Transaction broadcast result

result · boolean

code · string

message · string

txid · string