Stake a Resource

Request example

{
  "source": {
    "type": "VAULT",
    "id": "vault_123"
  },
  "asset": "TRX",
  "blockChain": "TRON",
  "amount": "1000",
  "resourceType": "TRON_ENERGY",
  "category": "STAKE",
  "externalId": "stake-1001",
  "memo": "Stake TRX for energy"
}

# 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" },
    "asset": "TRX",
    "blockChain": "TRON",
    "amount": "1000",
    "resourceType": "TRON_ENERGY",
    "category": "STAKE",
    "externalId": "stake-1001",
    "memo": "Stake TRX for energy"
  }'

const tx = await apiClient.stakeResource({
  source: { type: "VAULT", id: "vault_123" },
  asset: "TRX",
  chain: "TRON",
  amount: "1000",
  resourceType: "TRON_ENERGY",
  externalId: "stake-1001",
  memo: "Stake TRX for energy",
});
console.log(tx.id, tx.status);

{
  "id": "transaction_stake_123",
  "orgId": "org_456",
  "vaultId": "vault_123",
  "status": "PENDING",
  "transactionType": "OUTGOING",
  "category": "STAKE",
  "subCategory": "STAKE",
  "createdAt": "2026-08-04T11:40:00Z",
  "updatedAt": "2026-08-04T11:40:00Z",
  "isDeleted": false,
  "externalId": "stake-1001",
  "memo": "Stake TRX for energy",
  "source": {
    "type": "VAULT",
    "id": "vault_123",
    "name": "Treasury Vault"
  },
  "blockChain": "TRON",
  "asset": "TRX",
  "amount": "1000"
}

POST /api/external/transactions/ Use staking 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 stakes the asset.

string

required

Asset symbol.

string

required

Blockchain identifier.

string

required

Decimal amount to stake.

string

One of TRON_ENERGY or TRON_BANDWIDTH.

string

required

Must be "STAKE".

string

Client reference.

string

Human-readable note.

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

Response

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

Request example

{
  "source": {
    "type": "VAULT",
    "id": "vault_123"
  },
  "asset": "TRX",
  "blockChain": "TRON",
  "amount": "1000",
  "resourceType": "TRON_ENERGY",
  "category": "STAKE",
  "externalId": "stake-1001",
  "memo": "Stake TRX for energy"
}

# 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" },
    "asset": "TRX",
    "blockChain": "TRON",
    "amount": "1000",
    "resourceType": "TRON_ENERGY",
    "category": "STAKE",
    "externalId": "stake-1001",
    "memo": "Stake TRX for energy"
  }'

const tx = await apiClient.stakeResource({
  source: { type: "VAULT", id: "vault_123" },
  asset: "TRX",
  chain: "TRON",
  amount: "1000",
  resourceType: "TRON_ENERGY",
  externalId: "stake-1001",
  memo: "Stake TRX for energy",
});
console.log(tx.id, tx.status);

{
  "id": "transaction_stake_123",
  "orgId": "org_456",
  "vaultId": "vault_123",
  "status": "PENDING",
  "transactionType": "OUTGOING",
  "category": "STAKE",
  "subCategory": "STAKE",
  "createdAt": "2026-08-04T11:40:00Z",
  "updatedAt": "2026-08-04T11:40:00Z",
  "isDeleted": false,
  "externalId": "stake-1001",
  "memo": "Stake TRX for energy",
  "source": {
    "type": "VAULT",
    "id": "vault_123",
    "name": "Treasury Vault"
  },
  "blockChain": "TRON",
  "asset": "TRX",
  "amount": "1000"
}

⌘I

Request example

{
  "source": {
    "type": "VAULT",
    "id": "vault_123"
  },
  "asset": "TRX",
  "blockChain": "TRON",
  "amount": "1000",
  "resourceType": "TRON_ENERGY",
  "category": "STAKE",
  "externalId": "stake-1001",
  "memo": "Stake TRX for energy"
}

# 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" },
    "asset": "TRX",
    "blockChain": "TRON",
    "amount": "1000",
    "resourceType": "TRON_ENERGY",
    "category": "STAKE",
    "externalId": "stake-1001",
    "memo": "Stake TRX for energy"
  }'

const tx = await apiClient.stakeResource({
  source: { type: "VAULT", id: "vault_123" },
  asset: "TRX",
  chain: "TRON",
  amount: "1000",
  resourceType: "TRON_ENERGY",
  externalId: "stake-1001",
  memo: "Stake TRX for energy",
});
console.log(tx.id, tx.status);

{
  "id": "transaction_stake_123",
  "orgId": "org_456",
  "vaultId": "vault_123",
  "status": "PENDING",
  "transactionType": "OUTGOING",
  "category": "STAKE",
  "subCategory": "STAKE",
  "createdAt": "2026-08-04T11:40:00Z",
  "updatedAt": "2026-08-04T11:40:00Z",
  "isDeleted": false,
  "externalId": "stake-1001",
  "memo": "Stake TRX for energy",
  "source": {
    "type": "VAULT",
    "id": "vault_123",
    "name": "Treasury Vault"
  },
  "blockChain": "TRON",
  "asset": "TRX",
  "amount": "1000"
}

API Basics

Accounts

Sub-Orgs

Transactions

Request body

Response

​Request body

​Response

Request body

Response