Sign in
Actions

Submit transaction hash

Submit the transaction hash after broadcasting a transaction to the blockchain. This updates the transaction status and enables tracking.

put/v1/transactions/{transactionId}/submit-hash

Request

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

Path parameters

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

The unique identifier of the transaction

Request body

hashstring required

Transaction hash from the blockchain

Example request

{
  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}

Response

Transaction successfully updated with hash

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.