REST API›Wallet & Transact›Wallet

POST

Build bulk resource delegation transactions

Builds one delegation transaction per entry, collecting per-entry errors rather than aborting the batch on first failure.

Path Params

  • coin string required
    The coin ticker symbol (e.g. 'trx', 'ttrx')
  • walletId string required
    The wallet ID

Body Params

object

Build Resource Delegations Request Body

Request body for building bulk resource delegation transactions. Each entry delegates a resource (ENERGY or BANDWIDTH) from the wallet's root address to a receiver address.

  • delegations array of objects required
    delegations object
    • receiverAddress string required
      The address receiving the delegated resource
    • amount string required
      Amount of resource to delegate (in sun for TRX)
    • resource string required
      Resource type to delegate, e.g. 'ENERGY' or 'BANDWIDTH'
    • sequenceId string
      Client-generated idempotency key for the transaction request created for this delegation (TSS wallets only). When provided and another non-canceled latest transaction request on the same wallet already carries this sequenceId, creation fails with a DuplicateSequenceIdError instead of creating a duplicate. Omit for fire-and-forget builds.
  • preview boolean
    When true, build each delegation transaction without creating a transaction request. Response entries carry NO txRequestId in this mode — the build is never persisted, so there is no referenceable request. Defaults to false, which creates a transaction request per entry (TSS wallets). Non-TSS builds are pure either way.

Responses

200
OK

Response Body

object

  • transactions array of objects required
  • errors array of objects required
    errors object
    • receiverAddress string required
    • message string required
400
Bad Request

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id