Transactions

Get Transactions Stream

Returns transactions which have been committed to the ledger. Check detailed documentation for brief explanation

POSThttps://xrd-gateway.nownodes.io/stream/transactions

Header parameters

Body

application/json

at_ledger_statenullable LedgerStateSelector (object)

Optional. This allows for a request to be made against a historic state. If a constraint is specified, the Gateway will resolve the request against the ledger state at that time. If not specified, requests will be made with respect to the top of the committed ledger.

from_ledger_statenullable LedgerStateSelector (object)

Optional. This allows for a request to be made against a historic state. If a constraint is specified, the Gateway will resolve the request against the ledger state at that time. If not specified, requests will be made with respect to the top of the committed ledger.

cursornullable string

This cursor allows forward pagination, by providing the cursor from the previous request.

limit_per_pagenullable integer

The page size requested.

kind_filterenum

Limit returned transactions by their kind. Defaults to user.

UserEpochChangeAll

manifest_accounts_withdrawn_from_filterarray of Address (string)

Allows specifying an array of account addresses. If specified, the response will contain only transactions with a manifest containing withdrawals from the given accounts.

manifest_accounts_deposited_into_filterarray of Address (string)

Similar to manifest_accounts_withdrawn_from_filter, but will return only transactions with a manifest containing deposits to the given accounts.

manifest_badges_presented_filterarray of Address (string)

Allows specifying array of badge resource addresses. If specified, the response will contain only transactions where the given badges were presented.

manifest_resources_filterarray of Address (string)

Allows specifying array of resource addresses. If specified, the response will contain only transactions containing the given resources in the manifest (regardless of their usage).

affected_global_entities_filterarray of Address (string)

Allows specifying an array of global addresses. If specified, the response will contain transactions that affected all of the given global entities. A global entity is marked as "affected" by a transaction if any of its state (or its descendents' state) was modified as a result of the transaction. For performance reasons consensus manager and transaction tracker are excluded from that filter.

events_filterarray of StreamTransactionsRequestEventFilterItem (object)

Filters the transaction stream to transactions which emitted at least one event matching each filter (each filter can be satisfied by a different event). Currently only deposit and withdrawal events emitted by an internal vault entity are tracked. For the purpose of filtering, the emitter address is replaced by the global ancestor of the emitter, for example, the top-level account / component which contains the vault which emitted the event.

accounts_with_manifest_owner_method_callsarray of Address (string)

Allows specifying an array of account addresses. If specified, the response will contain only transactions that, for all specified accounts, contain manifest method calls to that account which require the owner role. See the account docs for more information.

accounts_without_manifest_owner_method_callsarray of Address (string)

Allows specifying an array of account addresses. If specified, the response will contain only transactions that, for all specified accounts, do NOT contain manifest method calls to that account which require owner role. See the account docs for more information.

manifest_class_filterobject

Allows filtering to transactions which match the given manifest classification. If specified, the response will contain only transactions which have a class that matches the filter. If match_only_most_specific set to true, only transactions where the queried class is most specific will be returned. See the docs on manifest classification for more information.

event_global_emitters_filterarray of Address (string)

Allows specifying an array of global addresses. If specified, the response will contain transactions in which all entities emitted events. If an event was published by an internal entity, it is going to be indexed as it is a global ancestor. For performance reasons events published by consensus manager and native XRD resource are excluded from that filter.

orderenum

Configures the order of returned result set. Defaults to desc.

AscDesc

opt_insTransactionDetailsOptIns (object)

Response

2004XX

Transactions (paginated)

Body

application/json

ledger_state*LedgerState (object)

The ledger state against which the response was generated. Can be used to detect if the Network Gateway is returning up-to-date information.

total_countnullable integer (int64)

Total number of items in underlying collection, fragment of which is available in items collection.

next_cursornullable string

If specified, contains a cursor to query next page of the items collection.

items*array of CommittedTransactionInfo (object)

The page of user transactions.

Request

JavaScriptCurlPython

const response = await fetch('https://xrd-gateway.nownodes.io/stream/transactions', {
    method: 'POST',
    headers: {
      "api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "limit_per_page": 5
    }),
});
const data = await response.json();

Response

2004XX

{
  "ledger_state": {
    "network": "mainnet",
    "state_version": 0,
    "proposer_round_timestamp": "text",
    "epoch": 0,
    "round": 0
  },
  "total_count": 0,
  "next_cursor": "text",
  "items": [
    {
      "state_version": 0,
      "epoch": 0,
      "round": 0,
      "round_timestamp": "text",
      "transaction_status": "Unknown",
      "payload_hash": "text",
      "intent_hash": "text",
      "fee_paid": "text",
      "affected_global_entities": [
        "text"
      ],
      "confirmed_at": "2024-12-31T01:28:43.805Z",
      "error_message": "text",
      "raw_hex": "text",
      "receipt": {
        "status": "Unknown",
        "events": [
          {
            "name": "text",
            "data": {
              "kind": "Bool",
              "type_name": "text",
              "field_name": "text"
            }
          }
        ],
        "error_message": "text"
      },
      "manifest_instructions": "text",
      "manifest_classes": [
        "General"
      ],
      "balance_changes": {
        "fungible_fee_balance_changes": [
          {
            "type": "FeePayment",
            "entity_address": "text",
            "resource_address": "text",
            "balance_change": "text"
          }
        ],
        "fungible_balance_changes": [
          {
            "entity_address": "text",
            "resource_address": "text",
            "balance_change": "text"
          }
        ],
        "non_fungible_balance_changes": [
          {
            "entity_address": "text",
            "resource_address": "text",
            "added": [
              "text"
            ],
            "removed": [
              "text"
            ]
          }
        ]
      }
    }
  ]
}