Send a Tron transaction

To send a transaction, make a POST request to

https://api.privy.io/v1/wallets/<wallet_id>/rpc

All addresses in raw_data.contract must be 41-prefixed hex — use TronWeb.address.toHex() to convert from base58check.

TRX transfer

$ curl --request POST https://api.privy.io/v1/wallets/<wallet_id>/rpc \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H "privy-authorization-signature: <authorization-signature>" \
-H 'Content-Type: application/json' \
-d '{
  "method": "tron_sendTransaction",
  "caip2": "tron:mainnet",
  "params": {
    "raw_data": {
      "contract": [
        {
          "type": "TransferContract",
          "owner_address": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c",
          "to_address": "41e552f6487585c2b58bc2c9bb4492bc1f17132cd0",
          "amount": 1000000
        }
      ]
    }
  }
}'

TRC-20 transfer

$ curl --request POST https://api.privy.io/v1/wallets/<wallet_id>/rpc \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H "privy-authorization-signature: <authorization-signature>" \
-H 'Content-Type: application/json' \
-d '{
  "method": "tron_sendTransaction",
  "caip2": "tron:mainnet",
  "params": {
    "raw_data": {
      "contract": [
        {
          "type": "TriggerSmartContract",
          "owner_address": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c",
          "contract_address": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c",
          "data": "a9059cbb000000000000000041e552f6487585c2b58bc2c9bb4492bc1f17132cd000000000000000000000000000000000000000000000000000000000000f4240",
          "call_value": 0
        }
      ],
      "fee_limit": 100000000
    }
  }
}'

A successful response looks like:

{
  "method": "tron_sendTransaction",
  "data": {
    "hash": "8a3f2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1",
    "caip2": "tron:mainnet",
    "transaction_id": "8a3f2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1"
  }
}

Parameters

string

required

Must be "tron_sendTransaction".

string

Tron CAIP-2 chain. Defaults to tron:mainnet. Use tron:nile for the Nile testnet.

array

required

Array of exactly one contract — either TransferContract (native TRX) or TriggerSmartContract (TRC-20 / smart contract call). All addresses must be 41-prefixed hex.

number

Maximum energy fee in sun. Required for TriggerSmartContract. 100_000_000 (100 TRX) is a safe default for standard TRC-20 transfers.

string

4 hex-character block reference. Optional — Privy fetches fresh values if omitted.

string

16 hex-character block reference hash. Optional — Privy fetches fresh values if omitted.

number

Expiration timestamp in Unix milliseconds. Optional — Privy sets now + 60s if omitted.

string

Optional idempotency key (max 64 characters). Re-submitting the same reference_id returns the cached response.

Returns

string

Tron transaction ID — SHA-256 of the raw transaction bytes, lowercase hex, no 0x prefix.

string

The CAIP-2 chain the transaction was broadcast on.

string

Privy internal transaction ID.

Check out the API reference for more details.

Signatures and transactions

Wallet actions

Signing and RPC

Intents

Transactions

Send a Tron transaction

TRX transfer

TRC-20 transfer

Parameters

Returns

​TRX transfer

​TRC-20 transfer

​Parameters

​Returns

TRX transfer

TRC-20 transfer

Parameters

Returns