Skip to main content
POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
broadcasttransaction
wallet/broadcasttransaction
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
}'
{
  "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 you own node endpoint todayStart 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