⚠️ Send TRX from one address to another (deprecated)

Code samples

POST /api/v1/trx/account/send

curl -X POST 'https://settla.net/api/v1/trx/account/send' \
  -H 'X-API-Key: $SETTLA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "private_key": "<64 hex characters>",
  "to_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "amount": 1.5
}'

DEPRECATED, shutdown 2026-12-01. The endpoint accepts the sender's private key in the request body; the service does not store or handle client keys.

Replacement: build the transaction with POST /api/v1/trx/transactions/create, sign it on your side and submit it with POST /api/v1/trx/transactions/broadcast.

Body parameter

{
  "private_key": "<64 hex characters>",
  "to_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "amount": 1.5
}

🛠️ Parameters

Name	In	Type	Required	Description
body	body	object	true	none
» private_key	body	string	true	Sender's private key.
» to_address	body	string	true	none
» amount	body	number	true	Amount in TRX, not SUN — `1.5` sends 1.5 TRX. Accepted as a number or a decimal string.

Example responses

200 Response

{
  "success": true,
  "tx_id": "e5c5e129f0cb41a6d29c18b060f9dbd6992025da1cc769485c06e3c373169b41",
  "from_address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
  "to_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "amount": 1500000,
  "amount_trx": 1.5
}

400 Response — missingFields

{
  "error": "private_key, to_address and amount are required."
}

400 Response — badKey

{
  "error": "Invalid private key format."
}

400 Response — badRecipient

{
  "error": "Invalid to_address."
}

400 Response — badAmount

{
  "error": "Invalid amount."
}

400 Response — Message relayed from java-tron

{
  "error": "Broadcast failed: Validate TransferContract error, balance is not sufficient."
}

500 Response

{
  "error": "Could not connect to TRX node."
}

🔁 Responses

Status	Meaning	Description	Schema
200	OK	The transaction was signed and accepted by the node. It is not confirmed yet — poll `GET /api/v1/trx/transactions/{hash}` for that.	Inline
400	Bad Request	Validation failed, or the node refused the transaction — an insufficient balance arrives here, not as a 5xx.	Inline
500	Internal Server Error	Could not connect to TRX node	Inline

🔄 Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	none
» tx_id	string	false	none	none
» from_address	string	false	none	Derived from the private key you sent.
» to_address	string	false	none	none
» amount	integer	false	none	Amount in SUN — the request value multiplied by 1 000 000.
» amount_trx	number	false	none	The request value, echoed back.

Status Code 400

Name	Type	Required	Restrictions	Description
» error	string	false	none	none
» details	object	false	none	Present only on a few validation errors.

Status Code 500

Name	Type	Required	Restrictions	Description
» error	string	false	none	none
» details	object	false	none	Present only on a few validation errors.