Skip to main content
POST
/
v1
/
transactions
/
{transactionId}
/
submit
Submit transaction
curl --request POST \
  --url https://api.yield.xyz/v1/transactions/{transactionId}/submit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "signedTransaction": "0aba010aa0010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512790a2a696e6a316a61366664646e6e33727272677137646d6a757a6b71363279376d68346675346b6e656d37791231696e6a76616c6f7065723167346436646d766e706737773779756779366b706c6e6470376a70666d66336b7274736368701a180a03696e6a121131303030303030303030303030303030301215766961205374616b654b6974204349442d31303039129e010a7e0a740a2d2f696e6a6563746976652e63727970746f2e763162657461312e657468736563703235366b312e5075624b657912430a41042aec99dce37ea3d8f11b44da62bce0e885f0ba5b309382954babec76eb138cb0bb84f4f24b9f63143f2ce66923b2dd3ee55475e680a7b992b9cbc17941f6486312040a0208011802121c0a160a03696e6a120f31383732303030303030303030303010d0b4471a0b696e6a6563746976652d312092c35b"
}
'
{
  "id": "tx_123abc",
  "title": "Approve USDC",
  "network": "ethereum",
  "status": "PENDING",
  "type": "STAKE",
  "hash": "0x1234567890abcdef...",
  "createdAt": "2023-11-07T05:31:56Z",
  "broadcastedAt": "2023-11-07T05:31:56Z",
  "signedTransaction": "<string>",
  "unsignedTransaction": "0x02f87082012a022f2f83018000947a250d5630b4cf539739df2c5dacb4c659f2488d880de0b6b3a764000080c080a0ef0de6c7b46fc75dd6cb86dccc3cfd731c2bdf6f3d736557240c3646c6fe01a6a07cd60b58dfe01847249dfdd7950ba0d045dded5bbe410b07a015a0ed34e5e00d",
  "annotatedTransaction": {
    "method": "stake",
    "inputs": {
      "amount": "1000000000000000000"
    }
  },
  "structuredTransaction": {},
  "stepIndex": 0,
  "description": "Approve USDC for staking",
  "error": "<string>",
  "gasEstimate": "21000",
  "explorerUrl": "https://etherscan.io/tx/0x1234...",
  "isMessage": false
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
transactionId
string
required

The unique identifier of the transaction

Body

application/json
​
signedTransaction
string
required

Encoded signed transaction to submit to the blockchain

Example:

"0aba010aa0010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512790a2a696e6a316a61366664646e6e33727272677137646d6a757a6b71363279376d68346675346b6e656d37791231696e6a76616c6f7065723167346436646d766e706737773779756779366b706c6e6470376a70666d66336b7274736368701a180a03696e6a121131303030303030303030303030303030301215766961205374616b654b6974204349442d31303039129e010a7e0a740a2d2f696e6a6563746976652e63727970746f2e763162657461312e657468736563703235366b312e5075624b657912430a41042aec99dce37ea3d8f11b44da62bce0e885f0ba5b309382954babec76eb138cb0bb84f4f24b9f63143f2ce66923b2dd3ee55475e680a7b992b9cbc17941f6486312040a0208011802121c0a160a03696e6a120f31383732303030303030303030303010d0b4471a0b696e6a6563746976652d312092c35b"

Response

Transaction successfully submitted

​
id
string
required

Unique transaction identifier

Example:

"tx_123abc"

​
title
string
required

Display title for the transaction

Example:

"Approve USDC"

​
network
enum<string>
required

Network this transaction is for

Available options:
ethereum,
ethereum-goerli,
ethereum-holesky,
ethereum-sepolia,
ethereum-hoodi,
arbitrum,
base,
base-sepolia,
gnosis,
optimism,
polygon,
polygon-amoy,
starknet,
zksync,
linea,
unichain,
monad-testnet,
avalanche-c,
avalanche-c-atomic,
avalanche-p,
binance,
celo,
fantom,
harmony,
moonriver,
okc,
viction,
core,
sonic,
katana,
hyperevm,
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,
binancebeacon,
cardano,
near,
solana,
solana-devnet,
stellar,
stellar-testnet,
sui,
tezos,
tron,
ton,
ton-testnet
Example:

"ethereum"

​
status
enum<string>
required

Current status of the transaction

Available options:
NOT_FOUND,
CREATED,
BLOCKED,
WAITING_FOR_SIGNATURE,
SIGNED,
BROADCASTED,
PENDING,
CONFIRMED,
FAILED,
SKIPPED
Example:

"PENDING"

​
type
enum<string>
required

Type of transaction operation

Available options:
SWAP,
DEPOSIT,
APPROVAL,
STAKE,
CLAIM_UNSTAKED,
CLAIM_REWARDS,
RESTAKE_REWARDS,
UNSTAKE,
SPLIT,
MERGE,
LOCK,
UNLOCK,
SUPPLY,
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,
LUGANODES_PROVISION,
LUGANODES_EXIT_REQUEST,
INFSTONES_PROVISION,
INFSTONES_EXIT_REQUEST,
INFSTONES_CLAIM_REQUEST
Example:

"STAKE"

​
hash
string | null
required

Transaction hash (available after broadcast)

Example:

"0x1234567890abcdef..."

​
createdAt
string<date-time>
required

When the transaction was created

​
broadcastedAt
string<date-time> | null
required

When the transaction was broadcasted to the network

​
signedTransaction
string | null
required

Signed transaction data (ready for broadcast)

​
unsignedTransaction
required

The unsigned transaction data to be signed by the wallet

Example:

"0x02f87082012a022f2f83018000947a250d5630b4cf539739df2c5dacb4c659f2488d880de0b6b3a764000080c080a0ef0de6c7b46fc75dd6cb86dccc3cfd731c2bdf6f3d736557240c3646c6fe01a6a07cd60b58dfe01847249dfdd7950ba0d045dded5bbe410b07a015a0ed34e5e00d"

​
annotatedTransaction
object

Human-readable breakdown of the transaction for display purposes

Example:
{
  "method": "stake",
  "inputs": { "amount": "1000000000000000000" }
}
​
structuredTransaction
object

Detailed transaction data for client-side validation or simulation

​
stepIndex
number

Zero-based index of the step in the action flow

Example:

0

​
description
string

User-friendly description of what this transaction does

Example:

"Approve USDC for staking"

​
error
string | null

Error message if the transaction failed

​
gasEstimate
string

Estimated gas cost for the transaction

Example:

"21000"

​
explorerUrl
string | null

Link to the blockchain explorer for this transaction

Example:

"https://etherscan.io/tx/0x1234..."

​
isMessage
boolean

Whether this transaction is a message rather than a value transfer

Example:

false