Skip to main content

submit

POST
Submits a signed transaction to the local node and the network.The result code in the response is preliminary; check the final outcome with tx after the transaction is included in a ledger version.

🚧 A submitted transaction cannot be cancelled!

Previewing the results with simulate before submitting is recommended.

Even when engine_result is tesSUCCESS, the final outcome can differ.

param[0]
parametersobjectrequired
tx_blobstringrequired
The signed transaction, hex-encoded.
fail_hardboolean
Whether to skip retrying or relaying to other nodes when local validation fails.
Responses
engine_resultstring
The preliminary result code of the transaction. (e.g.) tesSUCCESS
engine_result_codeinteger
The numeric value corresponding to the preliminary result code.
engine_result_messagestring
A human-readable explanation of the preliminary result.
tx_blobstring
The submitted transaction, hex-encoded.
tx_jsonobject
The submitted transaction data.
acceptedboolean
Whether the transaction was applied, queued, broadcast or kept.
account_sequence_availableinteger
The next sequence number available once pending transactions are taken into account.
account_sequence_nextinteger
The sequence number to use after the provisionally applied transactions.
appliedboolean
Whether the transaction was applied to the open ledger.
broadcastboolean
Whether the transaction was broadcast to peer servers.
keptboolean
Whether the transaction was kept for a later retry.
queuedboolean
Whether the transaction was queued for a future ledger version.
open_ledger_coststring
The cost of the open ledger before this transaction was processed, in drops.
validated_ledger_indexinteger
The index of the most recent validated ledger version at submission time.
codestringrequired
Code identifying the cause of the failed request.
messagestringrequired
Detailed message including the name and value of the invalid parameter.
{
  "code": "ERROR_CODE",
  "message": "Unauthorized"
}
cURL
curl -X POST 'https://xrpl-mainnet.nodit.io' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "method": "submit",
    "params": [
      {
        "tx_blob": "1200002280000000240000001B61400000000098968068400000000000000C7321ED",
        "fail_hard": false
      }
    ]
  }'