Skip to main content
POST
Sponsor and broadcast external Tron transaction

Authorizations

X-API-Key
string
header
required

Headers

API-Version
enum<string>
default:v1

API version (defaults to the latest supported version if omitted).

Available options:
v1
Idempotency-Key
string
required

Unique key (1-255 printable ASCII chars) used to safely retry write operations. Same key + body returns the cached response; same key + different body returns 409.

Required string length: 1 - 255

Path Parameters

id
string<uuid>
required

Gas station ID

Body

application/json
amount
string
required

Transfer amount as a human-readable decimal in the asset's display unit.

Example:

"100"

asset
string
required

Symbol of the asset being transferred.

Example:

"USDT"

from_address
string
required

Sender address of the external transaction.

Example:

"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"

network
string
required

Network the transaction is on (e.g. mainnet).

Example:

"mainnet"

signed_tx
string
required

The client-signed raw transaction to broadcast.

Example:

"0a02..."

to_address
string
required

Recipient address of the external transaction.

Example:

"TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb"

fee_level
enum<string>

Desired fee level for the sponsorship: low, medium, or high.

Available options:
low,
medium,
high
Example:

"medium"

tx_hash
string

Expected transaction hash, for correlation.

Example:

"e1f2c3..."

Response

Success

broadcast_accepted
boolean

Whether the network accepted the broadcast.

Example:

true

gas_station_id
string

Identifier of the gas station that funded the fee.

Example:

"9b2e7a1c-3d4f-4a8b-9c0d-1e2f3a4b5c6d"

mode
string

Sponsorship mode that was applied.

object
string

Object type discriminator; always "sponsor_broadcast".

Example:

"sponsor_broadcast"

root_sponsor_tx_id
string

Identifier of the originating sponsorship transaction in a chained sponsorship.

sponsor_amount_sun
string

Sponsored amount in SUN (TRX base unit).

sponsor_amount_trx
string

Sponsored amount in TRX (display unit).

sponsor_tx_id
string

Identifier of the sponsorship (fee-funding) transaction.

status
string

Status of the sponsored broadcast.

Example:

"broadcasting"

tx_hash
string

Hash of the broadcast transaction.

Example:

"e1f2c3..."