Delegate a TRON Resource

Request example

{
  "source": {
    "type": "VAULT",
    "id": "vault_123"
  },
  "destination": {
    "type": "CONTACT",
    "id": "contact_456"
  },
  "asset": "TRX",
  "blockChain": "TRON",
  "amount": "500",
  "resourceType": "TRON_ENERGY",
  "category": "DELEGATE_RESOURCE",
  "externalId": "delegate-1001",
  "memo": "Delegate energy to operations"
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request POST \
  --url "https://api.primevault.com/api/external/transactions/" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Content-Type: application/json" \
  --data '{
    "source": { "type": "VAULT", "id": "vault_123" },
    "destination": { "type": "CONTACT", "id": "contact_456" },
    "asset": "TRX",
    "blockChain": "TRON",
    "amount": "500",
    "resourceType": "TRON_ENERGY",
    "category": "DELEGATE_RESOURCE",
    "externalId": "delegate-1001",
    "memo": "Delegate energy to operations"
  }'

const tx = await apiClient.delegateResource({
  source: { type: "VAULT", id: "vault_123" },
  destination: { type: "CONTACT", id: "contact_456" },
  asset: "TRX",
  chain: "TRON",
  amount: "500",
  resourceType: "TRON_ENERGY",
  externalId: "delegate-1001",
  memo: "Delegate energy to operations",
});
console.log(tx.id, tx.status);

{
  "id": "transaction_delegate_123",
  "orgId": "org_456",
  "vaultId": "vault_123",
  "status": "PENDING",
  "transactionType": "OUTGOING",
  "category": "DELEGATE_RESOURCE",
  "subCategory": "DELEGATE_RESOURCE",
  "createdAt": "2026-08-04T11:50:00Z",
  "updatedAt": "2026-08-04T11:50:00Z",
  "isDeleted": false,
  "externalId": "delegate-1001",
  "memo": "Delegate energy to operations",
  "source": {
    "type": "VAULT",
    "id": "vault_123",
    "name": "Treasury Vault"
  },
  "destination": {
    "type": "CONTACT",
    "id": "contact_456",
    "name": "Operations Wallet"
  },
  "blockChain": "TRON",
  "asset": "TRX",
  "amount": "500"
}

POST /api/external/transactions/ Use resource delegation for chain-level protocol actions. These transactions can have chain-specific data requirements and may require approval before broadcast.

Request body

TransferPartyData

required

Vault that delegates the resource.

TransferPartyData

required

Party that receives the delegated resource.

string

required

Asset symbol.

string

required

Blockchain identifier.

string

required

Decimal amount to delegate.

string

required

One of TRON_ENERGY or TRON_BANDWIDTH.

string

required

Must be "DELEGATE_RESOURCE".

string

Client reference.

string

Human-readable note.

The SDK accepts chain and serializes it as blockChain. It injects category: "DELEGATE_RESOURCE".

Response

Returns a Transaction. Its status is the lifecycle source of truth.

Approve the transaction

New transactions return status: "PENDING" and wait for approval. Get the approval message for the transaction id, sign it with your API user’s key, then submit the approval. See Approvals. With the SDK, call approveChangeRequest({ entityId: transaction.id, action: "approve" }) after this call.

Request example

{
  "source": {
    "type": "VAULT",
    "id": "vault_123"
  },
  "destination": {
    "type": "CONTACT",
    "id": "contact_456"
  },
  "asset": "TRX",
  "blockChain": "TRON",
  "amount": "500",
  "resourceType": "TRON_ENERGY",
  "category": "DELEGATE_RESOURCE",
  "externalId": "delegate-1001",
  "memo": "Delegate energy to operations"
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request POST \
  --url "https://api.primevault.com/api/external/transactions/" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Content-Type: application/json" \
  --data '{
    "source": { "type": "VAULT", "id": "vault_123" },
    "destination": { "type": "CONTACT", "id": "contact_456" },
    "asset": "TRX",
    "blockChain": "TRON",
    "amount": "500",
    "resourceType": "TRON_ENERGY",
    "category": "DELEGATE_RESOURCE",
    "externalId": "delegate-1001",
    "memo": "Delegate energy to operations"
  }'

const tx = await apiClient.delegateResource({
  source: { type: "VAULT", id: "vault_123" },
  destination: { type: "CONTACT", id: "contact_456" },
  asset: "TRX",
  chain: "TRON",
  amount: "500",
  resourceType: "TRON_ENERGY",
  externalId: "delegate-1001",
  memo: "Delegate energy to operations",
});
console.log(tx.id, tx.status);

{
  "id": "transaction_delegate_123",
  "orgId": "org_456",
  "vaultId": "vault_123",
  "status": "PENDING",
  "transactionType": "OUTGOING",
  "category": "DELEGATE_RESOURCE",
  "subCategory": "DELEGATE_RESOURCE",
  "createdAt": "2026-08-04T11:50:00Z",
  "updatedAt": "2026-08-04T11:50:00Z",
  "isDeleted": false,
  "externalId": "delegate-1001",
  "memo": "Delegate energy to operations",
  "source": {
    "type": "VAULT",
    "id": "vault_123",
    "name": "Treasury Vault"
  },
  "destination": {
    "type": "CONTACT",
    "id": "contact_456",
    "name": "Operations Wallet"
  },
  "blockChain": "TRON",
  "asset": "TRX",
  "amount": "500"
}

⌘I

Request example

{
  "source": {
    "type": "VAULT",
    "id": "vault_123"
  },
  "destination": {
    "type": "CONTACT",
    "id": "contact_456"
  },
  "asset": "TRX",
  "blockChain": "TRON",
  "amount": "500",
  "resourceType": "TRON_ENERGY",
  "category": "DELEGATE_RESOURCE",
  "externalId": "delegate-1001",
  "memo": "Delegate energy to operations"
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request POST \
  --url "https://api.primevault.com/api/external/transactions/" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Content-Type: application/json" \
  --data '{
    "source": { "type": "VAULT", "id": "vault_123" },
    "destination": { "type": "CONTACT", "id": "contact_456" },
    "asset": "TRX",
    "blockChain": "TRON",
    "amount": "500",
    "resourceType": "TRON_ENERGY",
    "category": "DELEGATE_RESOURCE",
    "externalId": "delegate-1001",
    "memo": "Delegate energy to operations"
  }'

const tx = await apiClient.delegateResource({
  source: { type: "VAULT", id: "vault_123" },
  destination: { type: "CONTACT", id: "contact_456" },
  asset: "TRX",
  chain: "TRON",
  amount: "500",
  resourceType: "TRON_ENERGY",
  externalId: "delegate-1001",
  memo: "Delegate energy to operations",
});
console.log(tx.id, tx.status);

{
  "id": "transaction_delegate_123",
  "orgId": "org_456",
  "vaultId": "vault_123",
  "status": "PENDING",
  "transactionType": "OUTGOING",
  "category": "DELEGATE_RESOURCE",
  "subCategory": "DELEGATE_RESOURCE",
  "createdAt": "2026-08-04T11:50:00Z",
  "updatedAt": "2026-08-04T11:50:00Z",
  "isDeleted": false,
  "externalId": "delegate-1001",
  "memo": "Delegate energy to operations",
  "source": {
    "type": "VAULT",
    "id": "vault_123",
    "name": "Treasury Vault"
  },
  "destination": {
    "type": "CONTACT",
    "id": "contact_456",
    "name": "Operations Wallet"
  },
  "blockChain": "TRON",
  "asset": "TRX",
  "amount": "500"
}

API Basics

Approvals

Accounts

Sub-Orgs

Transactions

Request body

Response

Approve the transaction

​Request body

​Response

​Approve the transaction

Request body

Response

Approve the transaction