Txs

Last updated 9 months ago

GetTxsEvent fetches txs by event.

get

/cosmos/tx/v1beta1/txs

Query parameters

eventsstring[]

events is the list of transaction event type. Deprecated: post v0.47.x use query instead, which should contain a valid events query.

pagination.keystring byte

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring uint64

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring uint64

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalboolean

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverseboolean

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

order_byenum

ORDER_BY_UNSPECIFIED: ORDER_BY_UNSPECIFIED specifies an unknown sorting order. OrderBy defaults to ASC in this case.
ORDER_BY_ASC: ORDER_BY_ASC defines ascending order
ORDER_BY_DESC: ORDER_BY_DESC defines descending order

Options: ORDER_BY_UNSPECIFIED, ORDER_BY_ASC, ORDER_BY_DESC

pagestring uint64

page is the page number to query, starts at 1. If not provided, will default to first page.

limitstring uint64

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

querystring

query defines the transaction event query that is proxied to Tendermint's TxSearch RPC method. The query must be valid.

Since cosmos-sdk 0.50

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://fet.nownodes.io/cosmos/tx/v1beta1/txs'

200

default

{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "type_url": "text",
            "value": "text"
          }
        ],
        "memo": "text",
        "timeout_height": "text",
        "unordered": true,
        "extension_options": [
          {
            "type_url": "text",
            "value": "text"
          }
        ],
        "non_critical_extension_options": [
          {
            "type_url": "text",
            "value": "text"
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "type_url": "text",
              "value": "text"
            },
            "mode_info": "[Circular Reference]",
            "sequence": "text"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "text",
              "amount": "text"
            }
          ],
          "gas_limit": "text",
          "payer": "text",
          "granter": "text"
        },
        "tip": {
          "amount": [
            {
              "denom": "text",
              "amount": "text"
            }
          ],
          "tipper": "text"
        }
      },
      "signatures": [
        "text"
      ]
    }
  ],
  "tx_responses": [
    {
      "height": "text",
      "txhash": "text",
      "codespace": "text",
      "code": 1,
      "data": "text",
      "raw_log": "text",
      "logs": [
        {
          "msg_index": 1,
          "log": "text",
          "events": [
            {
              "type": "text",
              "attributes": [
                {
                  "key": "text",
                  "value": "text"
                }
              ]
            }
          ]
        }
      ],
      "info": "text",
      "gas_wanted": "text",
      "gas_used": "text",
      "tx": {
        "type_url": "text",
        "value": "text"
      },
      "timestamp": "text",
      "events": [
        {
          "type": "text",
          "attributes": [
            {
              "key": "text",
              "value": "text",
              "index": true
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "total": "text"
}

A successful response.

BroadcastTx broadcast transaction.

post

/cosmos/tx/v1beta1/txs

Body

tx_bytesstring byte

tx_bytes is the raw transaction.

modeenum

BroadcastMode specifies the broadcast mode for the TxService.Broadcast RPC method.

BROADCAST_MODE_UNSPECIFIED: zero-value for mode ordering
BROADCAST_MODE_BLOCK: Deprecated: use BROADCAST_MODE_SYNC instead, BROADCAST_MODE_BLOCK is not supported by the SDK from v0.47.x onwards.
BROADCAST_MODE_SYNC: BROADCAST_MODE_SYNC defines a tx broadcasting mode where the client waits for a CheckTx execution response only.
BROADCAST_MODE_ASYNC: BROADCAST_MODE_ASYNC defines a tx broadcasting mode where the client returns immediately.

Options: BROADCAST_MODE_UNSPECIFIED, BROADCAST_MODE_BLOCK, BROADCAST_MODE_SYNC, BROADCAST_MODE_ASYNC