📝 Create an unsigned transaction

Code samples

POST /api/v1/trx/transactions/create

curl -X POST 'https://settla.net/api/v1/trx/transactions/create' \
  -H 'X-API-Key: $SETTLA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "owner_address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
  "to_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "amount": 1000,
  "visible": true
}'

Builds an unsigned TRX transfer. Nothing is signed, nothing is sent, and no key ever reaches the platform — this is the first half of the recommended flow:

1. POST /api/v1/trx/transactions/create — get the unsigned transaction; 2. sign txID with your own key, on your own side; 3. POST /api/v1/trx/transactions/broadcast — submit the signed object. The body is forwarded verbatim to the node's /wallet/createtransaction and the node's answer is returned verbatim, so any field java-tron accepts works here. Pass visible: true to use base58 (T…) addresses; without it the node expects hex (41…). amount is in SUN — 1 TRX = 1 000 000 SUN. This endpoint builds plain TRX transfers only; a TRC20 transfer needs /wallet/triggersmartcontract, which is not exposed here. Before signing, recompute txID yourself — it is the SHA-256 of the bytes of raw_data_hex, not of its hex text — and refuse to sign if it differs from what the node returned. This is what protects you from a tampered transaction body. The transaction expires at expiration (about a minute after creation) and must be broadcast before then.

Body parameter

{
  "owner_address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
  "to_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "amount": 1000,
  "visible": true
}

🛠️ Parameters

Example responses

200 Response

{
  "txID": "e5c5e129f0cb41a6d29c18b060f9dbd6992025da1cc769485c06e3c373169b41",
  "raw_data": {
    "ref_block_bytes": "88f0",
    "ref_block_hash": "ef8831affaead8f8",
    "expiration": 1788333366000,
    "contract": [
      {
        "type": "TransferContract",
        "parameter": {
          "type_url": "type.googleapis.com/protocol.TransferContract",
          "value": {
            "owner_address": "TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
            "to_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
            "amount": 1000
          }
        }
      }
    ],
    "timestamp": 1788333307556
  },
  "raw_data_hex": "0a0288f02208ef8831affaead8f840f0b5e68786345a66080112620a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412310a154182dd6b9966724ae2fdc79b416c7588da67ff1b3512154184716914c0fdf7110a44030d04d0c4923504d9cc18e80770a4ede2878634",
  "visible": true
}

500 Response

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

🔁 Responses

🔄 Response Schema

Status Code 200

Status Code 500