Skip to main content
POST
/
v1
/
transactions
/
submit
Submit Transaction
curl --request POST \
  --url https://api.example.com/v1/transactions/submit \
  --header 'Content-Type: application/json' \
  --data '
{
  "txId": "<string>",
  "signedTxHex": "<string>",
  "signatures": [
    {}
  ]
}
'
{
  "txId": "<string>",
  "txHash": "<string>",
  "status": 123
}

​
Submit Transaction

Broadcast a signed transaction to the blockchain network. Returns the transaction hash upon successful submission.

​
Request

​
txId
string
required
Transaction ID from build step
​
signedTxHex
string
Signed transaction in hex format (if not using signatures array)
​
signatures
array
Array of signatures (alternative to signedTxHex)

​
Response

​
txId
string
Internal transaction identifier
​
txHash
string
Blockchain transaction hash
​
status
integer
Transaction status (1 = Submitted)

​
Example

curl -X POST https://api.axonvault.io/v1/transactions/submit \
  -H "X-Access-Key: ak_live_abc123" \
  -H "X-Signature: 5d41402abc4b2a76b9719d911017c592" \
  -H "X-Timestamp: 2024-01-15T10:30:00Z" \
  -H "Content-Type: application/json" \
  -d '{
    "txId": "tx_abc123",
    "signedTxHex": "0xf86c0a8502540be400825208..."
  }'

​
Response Example

{
  "txId": "tx_abc123",
  "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "status": 1
}

​
Transaction Status

StatusDescription
0Pending (not yet submitted)
1Submitted (awaiting confirmation)
2Confirmed
3Failed

​
Errors

Error TypeStatusDescription
invalid_request400Missing txId or signature
not_found404Transaction not found
already_submitted409Transaction already submitted
broadcast_failed502Failed to broadcast to network

​
Webhook Notifications

After submission, you’ll receive webhook notifications for status changes: 
{
  "event": "transaction.confirmed",
  "data": {
    "txId": "tx_abc123",
    "txHash": "0x1234...",
    "status": 2,
    "blockNumber": 12345678,
    "confirmations": 12
  }
}

Configure Webhooks

Set up transaction notifications