Actions

Get transaction details

Retrieve detailed information about a specific transaction including current status, hash, and execution details.

get/v1/transactions/{transactionId}

Request

Base URL: https://api.yield.xyz
URL: https://api.yield.xyz/v1/transactions/{transactionId}
Auth: API key in header x-api-key

Path parameters

transactionIdstring required

Example:21f5fd15-cf80-4b9a-804f-062c40dc3740

The unique identifier of the transaction

Response

Transaction details retrieved successfully

idstring required

Unique transaction identifier

titlestring required

Display title for the transaction

network'ethereum' | 'ethereum-goerli' | 'ethereum-holesky' | 'ethereum-sepolia' | 'ethereum-hoodi' | 'arbitrum' | 'base' | 'base-sepolia' | 'gnosis' | 'optimism' | 'polygon' | 'polygon-amoy' | 'starknet' | 'zksync' | 'linea' | 'unichain' | 'plume' | 'monad-testnet' | 'monad' | 'robinhood' | 'robinhood-testnet' | 'arc-testnet' | 'arc' | 'avalanche-c' | 'avalanche-c-atomic' | 'avalanche-p' | 'binance' | 'celo' | 'fantom' | 'harmony' | 'moonriver' | 'okc' | 'viction' | 'core' | 'sonic' | 'plasma' | 'katana' | 'hyperevm' | 'tempo' | 'pharos' | 'xlayer' | 'agoric' | 'akash' | 'axelar' | 'band-protocol' | 'bitsong' | 'canto' | 'chihuahua' | 'comdex' | 'coreum' | 'cosmos' | 'crescent' | 'cronos' | 'cudos' | 'desmos' | 'dydx' | 'evmos' | 'fetch-ai' | 'gravity-bridge' | 'injective' | 'irisnet' | 'juno' | 'kava' | 'ki-network' | 'mars-protocol' | 'nym' | 'okex-chain' | 'onomy' | 'osmosis' | 'persistence' | 'quicksilver' | 'regen' | 'secret' | 'sentinel' | 'sommelier' | 'stafi' | 'stargaze' | 'stride' | 'teritori' | 'tgrade' | 'umee' | 'sei' | 'mantra' | 'celestia' | 'saga' | 'zetachain' | 'dymension' | 'humansai' | 'neutron' | 'polkadot' | 'kusama' | 'westend' | 'bittensor' | 'aptos' | 'binancebeacon' | 'cardano' | 'near' | 'solana' | 'solana-devnet' | 'stellar' | 'stellar-testnet' | 'sui' | 'tezos' | 'tron' | 'ton' | 'ton-testnet' | 'hyperliquid' required

Network this transaction is for

status'NOT_FOUND' | 'CREATED' | 'BLOCKED' | 'WAITING_FOR_SIGNATURE' | 'SIGNED' | 'BROADCASTED' | 'PENDING' | 'CONFIRMED' | 'FAILED' | 'SKIPPED' required

Current status of the transaction

type'SWAP' | 'DEPOSIT' | 'APPROVAL' | 'STAKE' | 'SET_OPERATOR' | 'CLAIM_UNSTAKED' | 'CLAIM_REWARDS' | 'RESTAKE_REWARDS' | 'UNSTAKE' | 'SPLIT' | 'MERGE' | 'LOCK' | 'UNLOCK' | 'SUPPLY' | 'ADD_LIQUIDITY' | 'REMOVE_LIQUIDITY' | 'BRIDGE' | 'VOTE' | 'REVOKE' | 'RESTAKE' | 'REBOND' | 'WITHDRAW' | 'WITHDRAW_ALL' | 'CREATE_ACCOUNT' | 'REVEAL' | 'MIGRATE' | 'DELEGATE' | 'UNDELEGATE' | 'UTXO_P_TO_C_IMPORT' | 'UTXO_C_TO_P_IMPORT' | 'WRAP' | 'UNWRAP' | 'UNFREEZE_LEGACY' | 'UNFREEZE_LEGACY_BANDWIDTH' | 'UNFREEZE_LEGACY_ENERGY' | 'UNFREEZE_BANDWIDTH' | 'UNFREEZE_ENERGY' | 'FREEZE_BANDWIDTH' | 'FREEZE_ENERGY' | 'UNDELEGATE_BANDWIDTH' | 'UNDELEGATE_ENERGY' | 'P2P_NODE_REQUEST' | 'CREATE_EIGENPOD' | 'VERIFY_WITHDRAW_CREDENTIALS' | 'START_CHECKPOINT' | 'VERIFY_CHECKPOINT_PROOFS' | 'QUEUE_WITHDRAWALS' | 'COMPLETE_QUEUED_WITHDRAWALS' | 'LZ_DEPOSIT' | 'LZ_WITHDRAW' | 'LUGANODES_PROVISION' | 'LUGANODES_EXIT_REQUEST' | 'INFSTONES_PROVISION' | 'INFSTONES_EXIT_REQUEST' | 'INFSTONES_CLAIM_REQUEST' | 'BATCH' required

Type of transaction operation

hashstring nullable required

Transaction hash (available after broadcast)

createdAtstring date-time required

When the transaction was created

broadcastedAtstring date-time nullable required

When the transaction was broadcasted to the network

signedTransactionstring nullable required

Signed transaction data (ready for broadcast)

annotatedTransactionobject nullable

Human-readable breakdown of the transaction for display purposes

structuredTransactionobject nullable

Detailed transaction data for client-side validation or simulation

stepIndexnumber

Zero-based index of the step in the action flow

descriptionstring

User-friendly description of what this transaction does

errorstring nullable

Error message if the transaction failed

gasEstimatestring

Estimated gas cost for the transaction

explorerUrlstring nullable

Link to the blockchain explorer for this transaction

isMessageboolean

Whether this transaction is a message rather than a value transfer

Example response

{
  "id": "tx_123abc",
  "title": "Approve USDC",
  "network": "ethereum",
  "status": "PENDING",
  "type": "STAKE",
  "hash": "0x1234567890abcdef...",
  "annotatedTransaction": {
    "method": "stake",
    "inputs": {
      "amount": "1000000000000000000"
    }
  },
  "description": "Approve USDC for staking",
  "gasEstimate": "21000",
  "explorerUrl": "https://etherscan.io/tx/0x1234..."
}

Changes

No recorded changes to this operation across all 1 revision of this API.