Skip to main content
Broadcast one or more fully signed transactions to MultiversX validators via the P2P gossipsub network. The Relayer forwards transactions without modifying or co-signing them.

Endpoint

wss://relayer.xoxno.com/ws

Body

action
string
required
Must be "broadcast".
requestId
string
Echoed back in the response for client-side correlation. Use a unique value per request to match responses across concurrent operations.
tx
object
required
A single signed transaction object.

Response

action
string
"broadcast"
requestId
string
Echoed from the request.
status
string
"completed" when all transactions succeed, "partial" when some fail, "failed" when all fail.
hashes
string[]
Transaction hashes for successfully broadcast transactions.
failed
object[]
Failures, each with index and reason.
{
  "action": "broadcast",
  "requestId": "tx-001",
  "tx": {
    "nonce": 42,
    "value": "1000000000000000000",
    "receiver": "erd1qyu5wthldzr8wx5c9ucg8kjagg0jfs53s8nr3zpz3hypefsdd8ssycr6th",
    "sender": "erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx",
    "gasPrice": 1000000000,
    "gasLimit": 50000,
    "chainID": "1",
    "version": 2,
    "signature": "a1b2c3d4..."
  }
}
{
  "action": "broadcast",
  "requestId": "tx-001",
  "status": "completed",
  "hashes": [
    "d5e8c9a1b3f7..."
  ],
  "failed": []
}
{
  "action": "broadcast",
  "requestId": "tx-001",
  "status": "partial",
  "hashes": ["d5e8c9a1b3f7..."],
  "failed": [
    { "index": 1, "reason": "invalid signature" }
  ]
}