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