1 of 1

Submit a Transaction

This endpoint actually submits a transaction to the Stellar network. It only takes a single, required parameter: the signed transaction. Refer to the Transactions page for details on how to craft a proper one. If you submit a transaction that has already been included in a ledger, this endpoint will return the same response as would’ve been returned for the original transaction submission. This allows for safe resubmission of transactions in error scenarios, as highlighted in the error-handling guide.

This method will use 20 Compute Units.

Reference: Here

Submit a Transaction

This method will use 20 Compute Units.

Reference: Here

Submit a Transaction

POSThttps://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>/transactions

Query parameters

tx*string

The base64-encoded XDR of the transaction.

Response

Success

Body

_embeddedobject

recordsarray of object

memostring

memo_bytesstring

_linksobject

self*link (object)

href*string (link)

templatedboolean

account*link (object)

href*string (link)

templatedboolean

ledger*link (object)

href*string (link)

templatedboolean

operations*link (object)

href*string (link)

templatedboolean

effects*link (object)

href*string (link)

templatedboolean

precedes*link (object)

href*string (link)

templatedboolean

succeeds*link (object)

href*string (link)

templatedboolean

transaction*link (object)

href*string (link)

templatedboolean

id*id (string)

paging_token*string

successful*boolean

hash*string

ledger*integer (int32)

created_at*string

source_account*address (string)

Pattern: G[A-Z0-9]{55}

account_muxedstring

account_muxed_idstring

source_account_sequence*string

fee_account*address (string)

Pattern: G[A-Z0-9]{55}

fee_account_muxedaddress (string)

Pattern: G[A-Z0-9]{55}

fee_account_muxed_idstring

fee_charged*string

max_fee*string

operation_count*integer (int32)

envelope_xdr*string

result_xdr*string

result_meta_xdr*string

fee_meta_xdrstring

memo_type*string

signatures*signatures (array of string)

itemsstring

Pattern: G[A-Z0-9]{55}

valid_afterstring

valid_beforestring

preconditionsTransactionPreconditions (object)

timeboundsTransactionPreconditionsTimebounds (object)

min_timestring

max_timestring

ledgerboundsTransactionPreconditionsLedgerbounds (object)

min_ledgerstring

max_ledgerstring

min_account_sequencestring

min_account_sequence_agestring

min_account_sequence_ledger_gapinteger (uint32)

extra_signersarray of string

itemsstring

fee_bump_transactionFeeBumpTransaction (object)

hashhash (string)

signaturessignatures (array of string)

itemsstring

Pattern: G[A-Z0-9]{55}

inner_transactionInnerTransaction (object)

hashhash (string)

signaturessignatures (array of string)

itemsstring

Pattern: G[A-Z0-9]{55}

max_feestring

Request

const response = await fetch('https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>/transactions?tx=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

{
  "_embedded": {
    "records": [
      {
        "memo": "text",
        "memo_bytes": "text",
        "_links": {
          "self": {
            "href": "text",
            "templated": false
          },
          "account": {
            "href": "text",
            "templated": false
          },
          "ledger": {
            "href": "text",
            "templated": false
          },
          "operations": {
            "href": "text",
            "templated": false
          },
          "effects": {
            "href": "text",
            "templated": false
          },
          "precedes": {
            "href": "text",
            "templated": false
          },
          "succeeds": {
            "href": "text",
            "templated": false
          },
          "transaction": {
            "href": "text",
            "templated": false
          }
        },
        "id": "text",
        "paging_token": "text",
        "successful": false,
        "hash": "text",
        "created_at": "text",
        "source_account": "text",
        "account_muxed": "text",
        "account_muxed_id": "text",
        "source_account_sequence": "text",
        "fee_account": "text",
        "fee_account_muxed": "text",
        "fee_account_muxed_id": "text",
        "fee_charged": "text",
        "max_fee": "text",
        "envelope_xdr": "text",
        "result_xdr": "text",
        "result_meta_xdr": "text",
        "fee_meta_xdr": "text",
        "memo_type": "text",
        "signatures": [
          "text"
        ],
        "valid_after": "text",
        "valid_before": "text",
        "preconditions": {
          "timebounds": {
            "min_time": "text",
            "max_time": "text"
          },
          "ledgerbounds": {
            "min_ledger": "text",
            "max_ledger": "text"
          },
          "min_account_sequence": "text",
          "min_account_sequence_age": "text",
          "extra_signers": [
            "text"
          ]
        },
        "fee_bump_transaction": {
          "hash": "text",
          "signatures": [
            "text"
          ]
        },
        "inner_transaction": {
          "hash": "text",
          "signatures": [
            "text"
          ],
          "max_fee": "text"
        }
      }
    ]
  }
}

Submit a Transaction

POSThttps://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>/transactions

Query parameters

tx*string

The base64-encoded XDR of the transaction.

Response

Success

Body

_embeddedobject

recordsarray of object

memostring

memo_bytesstring

_linksobject

self*link (object)

href*string (link)

templatedboolean

account*link (object)

href*string (link)

templatedboolean

ledger*link (object)

href*string (link)

templatedboolean

operations*link (object)

href*string (link)

templatedboolean

effects*link (object)

href*string (link)

templatedboolean

precedes*link (object)

href*string (link)

templatedboolean

succeeds*link (object)

href*string (link)

templatedboolean

transaction*link (object)

href*string (link)

templatedboolean

id*id (string)

paging_token*string

successful*boolean

hash*string

ledger*integer (int32)

created_at*string

source_account*address (string)

Pattern: G[A-Z0-9]{55}

account_muxedstring

account_muxed_idstring

source_account_sequence*string

fee_account*address (string)

Pattern: G[A-Z0-9]{55}

fee_account_muxedaddress (string)

Pattern: G[A-Z0-9]{55}

fee_account_muxed_idstring

fee_charged*string

max_fee*string

operation_count*integer (int32)

envelope_xdr*string

result_xdr*string

result_meta_xdr*string

fee_meta_xdrstring

memo_type*string

signatures*signatures (array of string)

itemsstring

Pattern: G[A-Z0-9]{55}

valid_afterstring

valid_beforestring

preconditionsTransactionPreconditions (object)

timeboundsTransactionPreconditionsTimebounds (object)

min_timestring

max_timestring

ledgerboundsTransactionPreconditionsLedgerbounds (object)

min_ledgerstring

max_ledgerstring

min_account_sequencestring

min_account_sequence_agestring

min_account_sequence_ledger_gapinteger (uint32)

extra_signersarray of string

itemsstring

fee_bump_transactionFeeBumpTransaction (object)

hashhash (string)

signaturessignatures (array of string)

itemsstring

Pattern: G[A-Z0-9]{55}

inner_transactionInnerTransaction (object)

hashhash (string)

signaturessignatures (array of string)

itemsstring

Pattern: G[A-Z0-9]{55}

max_feestring

Request

const response = await fetch('https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>/transactions?tx=text', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

{
  "_embedded": {
    "records": [
      {
        "memo": "text",
        "memo_bytes": "text",
        "_links": {
          "self": {
            "href": "text",
            "templated": false
          },
          "account": {
            "href": "text",
            "templated": false
          },
          "ledger": {
            "href": "text",
            "templated": false
          },
          "operations": {
            "href": "text",
            "templated": false
          },
          "effects": {
            "href": "text",
            "templated": false
          },
          "precedes": {
            "href": "text",
            "templated": false
          },
          "succeeds": {
            "href": "text",
            "templated": false
          },
          "transaction": {
            "href": "text",
            "templated": false
          }
        },
        "id": "text",
        "paging_token": "text",
        "successful": false,
        "hash": "text",
        "created_at": "text",
        "source_account": "text",
        "account_muxed": "text",
        "account_muxed_id": "text",
        "source_account_sequence": "text",
        "fee_account": "text",
        "fee_account_muxed": "text",
        "fee_account_muxed_id": "text",
        "fee_charged": "text",
        "max_fee": "text",
        "envelope_xdr": "text",
        "result_xdr": "text",
        "result_meta_xdr": "text",
        "fee_meta_xdr": "text",
        "memo_type": "text",
        "signatures": [
          "text"
        ],
        "valid_after": "text",
        "valid_before": "text",
        "preconditions": {
          "timebounds": {
            "min_time": "text",
            "max_time": "text"
          },
          "ledgerbounds": {
            "min_ledger": "text",
            "max_ledger": "text"
          },
          "min_account_sequence": "text",
          "min_account_sequence_age": "text",
          "extra_signers": [
            "text"
          ]
        },
        "fee_bump_transaction": {
          "hash": "text",
          "signatures": [
            "text"
          ]
        },
        "inner_transaction": {
          "hash": "text",
          "signatures": [
            "text"
          ],
          "max_fee": "text"
        }
      }
    ]
  }
}