RAradixdlt
Stream

Get Transactions Stream

Changed on

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

post/stream/transactions

Request

  • Base URL
    https://mainnet.radixdlt.com
  • URL
    https://mainnet.radixdlt.com/stream/transactions
  • Auth
    none declared

Request body

cursorstring nullable

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

limit_per_pageinteger nullable

The page size requested.

kind_filter'User' | 'EpochChange' | 'All'

Limit returned transactions by their kind. Defaults to user.

manifest_accounts_withdrawn_from_filterAddress[]

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_filterAddress[]

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

manifest_badges_presented_filterAddress[]

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

manifest_resources_filterAddress[]

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). We recommend that integrators use balance_change_resources_filter in most cases, as it also captures resource changes that are not specified in the manifest.

affected_global_entities_filterAddress[]

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.

accounts_with_manifest_owner_method_callsAddress[]

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_callsAddress[]

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.

event_global_emitters_filterAddress[]

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.

balance_change_resources_filterAddress[]

Allows filtering to transactions which included non-fee related balance changes for all provided resources. Defaults to []. We recommend that integrators use this instead of the manifest_resources_filter in most cases, as it also captures resource changes that are not specified in the manifest.

transaction_status_filter'Success' | 'Failure' | 'All'

Allows filtering by the transaction commit status (Success, Failure, All). Defaults to All.

order'Asc' | 'Desc'

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

Example request

{
  "limit_per_page": 5
}

Response

Transactions (paginated)

next_cursorstring nullable

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

Example response

{
  "ledger_state": {
    "network": "<network-name>"
  }
}

Changes

  • 428c7819d589Revision changes
    • info

      added the new optional request property /

    • info

      added the new optional request property //

    • info

      added the new optional request property /

    • info

      request property // deprecated

    • info

      added the optional property //// to the response with the status

    • info

      response property allOf[subschema #2]/items/items/receipt/events deprecated

  • 7147af27c92dRevision changes
    • warning

      removed the request property /

    • warning

      removed the request property //

    • warning

      removed the request property /

    • warning

      removed the optional property //// from the response with the status

    • info

      request property // reactivated

    • info

      response property allOf[subschema #2]/items/items/receipt/events reactivated