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);

Response example

{
  "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"
}

interface Transaction {
  id: string;
  orgId: string;
  vaultId: string;
  status: TransactionStatus | string;
  transactionType: TransactionType | string;
  category: TransactionCategory | string;
  subCategory: TransactionSubCategory | string;
  createdAt: string;
  updatedAt: string;
  isDeleted: boolean;
  amount: string;

  txHash?: string;
  error?: string;
  externalId?: string;
  createdById?: string;
  fees?: Fees;
  memo?: string;
  txnSignature?: string;
  txnSignatureData?: Record<string, unknown>;
  output?: TransactionOutput;
  amountInUSD?: string;
  nonce?: number;
  dAppId?: string;
  source?: TransferPartyData;
  destination?: TransferPartyData;
  quoteResponse?: QuoteResponseItem;
  depositInstructions?: DepositInstructions;
  operations?: TransactionOperation[];
  balanceChanges?: TransactionOperationBalanceChanges | null;
  blockChain?: string;
  asset?: string;

  /** Deprecated: use destination.address. */
  toAddress?: string;
  /** Deprecated: use destination.name. */
  toAddressName?: string;
  /** Deprecated: use destination.id. */
  toVaultId?: string;
  /** Deprecated: use source.address. */
  sourceAddress?: string;
}

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 the new Transaction. Its status is the lifecycle source of truth.

string

Transaction ID. Use it with Retrieve Transaction to track status.

string

Organization that owns the transaction.

string

Vault the transaction runs from.

string

Lifecycle status. Track it until COMPLETED, FAILED, or DECLINED. See TransactionStatus.

string

See TransactionType.

string

For example TRANSFER or CONTRACT_CALL. See TransactionCategory.

string

See TransactionSubCategory.

string

Creation timestamp (ISO 8601).

string

Last update timestamp (ISO 8601).

boolean

Whether the transaction is deleted.

string

Your own reference, if you set one.

string

Memo you attached, if any.

TransferPartyData

Where the funds come from. Which fields are present depends on type. See TransferPartyData.

Show Properties

string

VAULT, BANK_ACCOUNT, CONTACT, EXTERNAL_ADDRESS, or EXTERNAL_BANK_ACCOUNT.

string

ID of the vault, bank account, or contact.

string

Display name.

string

Wallet address, for crypto parties.

string

Blockchain, for crypto parties.

string

Payment rail, for bank parties, such as ACH.

string

Chain the transaction runs on.

string

Asset moved.

string

Amount as a decimal string.

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"
  },
  "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);

Response example

{
  "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"
}

interface Transaction {
  id: string;
  orgId: string;
  vaultId: string;
  status: TransactionStatus | string;
  transactionType: TransactionType | string;
  category: TransactionCategory | string;
  subCategory: TransactionSubCategory | string;
  createdAt: string;
  updatedAt: string;
  isDeleted: boolean;
  amount: string;

  txHash?: string;
  error?: string;
  externalId?: string;
  createdById?: string;
  fees?: Fees;
  memo?: string;
  txnSignature?: string;
  txnSignatureData?: Record<string, unknown>;
  output?: TransactionOutput;
  amountInUSD?: string;
  nonce?: number;
  dAppId?: string;
  source?: TransferPartyData;
  destination?: TransferPartyData;
  quoteResponse?: QuoteResponseItem;
  depositInstructions?: DepositInstructions;
  operations?: TransactionOperation[];
  balanceChanges?: TransactionOperationBalanceChanges | null;
  blockChain?: string;
  asset?: string;

  /** Deprecated: use destination.address. */
  toAddress?: string;
  /** Deprecated: use destination.name. */
  toAddressName?: string;
  /** Deprecated: use destination.id. */
  toVaultId?: string;
  /** Deprecated: use source.address. */
  sourceAddress?: string;
}

⌘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);

Response example

{
  "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"
}

interface Transaction {
  id: string;
  orgId: string;
  vaultId: string;
  status: TransactionStatus | string;
  transactionType: TransactionType | string;
  category: TransactionCategory | string;
  subCategory: TransactionSubCategory | string;
  createdAt: string;
  updatedAt: string;
  isDeleted: boolean;
  amount: string;

  txHash?: string;
  error?: string;
  externalId?: string;
  createdById?: string;
  fees?: Fees;
  memo?: string;
  txnSignature?: string;
  txnSignatureData?: Record<string, unknown>;
  output?: TransactionOutput;
  amountInUSD?: string;
  nonce?: number;
  dAppId?: string;
  source?: TransferPartyData;
  destination?: TransferPartyData;
  quoteResponse?: QuoteResponseItem;
  depositInstructions?: DepositInstructions;
  operations?: TransactionOperation[];
  balanceChanges?: TransactionOperationBalanceChanges | null;
  blockChain?: string;
  asset?: string;

  /** Deprecated: use destination.address. */
  toAddress?: string;
  /** Deprecated: use destination.name. */
  toAddressName?: string;
  /** Deprecated: use destination.id. */
  toVaultId?: string;
  /** Deprecated: use source.address. */
  sourceAddress?: string;
}

API Basics

Approvals

Vaults

Blockchain Contacts

Bank Accounts

Assets and Chains

Sub-Orgs

Transactions

Request body

Response

Approve the transaction

​Request body

​Response

​Approve the transaction

Request body

Response

Approve the transaction