blockchain

Get transactions

Get transactions by specified filter.

get/api/v3/transactions

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v3/transactions
  • Auth: one of:
    • API key in header X-Api-Key
    • API key in query parameter api_key

Query parameters

workchaininteger

Block workchain.

shardstring

Block shard id. Must be sent with workchain. Example: 8000000000000000.

seqnointeger

Block block seqno. Must be sent with workchain and shard.

mc_seqnointeger

Masterchain block seqno.

accountstring[]

List of account addresses to get transactions. Can be sent in hex, base64 or base64url form.

exclude_accountstring[]

Exclude transactions on specified account addresses.

hashstring

Transaction hash.

ltinteger

Transaction lt.

start_utimeinteger

Query transactions with generation UTC timestamp after given timestamp.

end_utimeinteger

Query transactions with generation UTC timestamp before given timestamp.

start_ltinteger

Query transactions with lt >= start_lt.

end_ltinteger

Query transactions with lt <= end_lt.

limitinteger

Limit number of queried rows. Use with offset to batch read.

offsetinteger

Skip first N rows. Use with limit to batch read.

sort'asc' | 'desc'

Sort transactions by lt.

Response

OK

address_bookAddressBook

Example response

{
  "transactions": [
    {
      "block_ref": {
        "shard": "0"
      },
      "description": {
        "action": {
          "tot_msg_size": {
            "bits": "0",
            "cells": "0"
          },
          "total_action_fees": "0",
          "total_fwd_fees": "0"
        },
        "bounce": {
          "fwd_fees": "0",
          "msg_fees": "0",
          "msg_size": {
            "bits": "0",
            "cells": "0"
          },
          "req_fwd_fees": "0"
        },
        "compute_ph": {
          "gas_credit": "0",
          "gas_fees": "0",
          "gas_limit": "0",
          "gas_used": "0"
        },
        "credit_ph": {
          "credit": "0",
          "due_fees_collected": "0"
        },
        "storage_ph": {
          "storage_fees_collected": "0",
          "storage_fees_due": "0"
        }
      },
      "in_msg": {
        "created_at": "0",
        "created_lt": "0",
        "fwd_fee": "0",
        "ihr_fee": "0",
        "import_fee": "0",
        "value": "0"
      },
      "lt": "0",
      "out_msgs": [
        {
          "created_at": "0",
          "created_lt": "0",
          "fwd_fee": "0",
          "ihr_fee": "0",
          "import_fee": "0",
          "value": "0"
        }
      ],
      "prev_trans_lt": "0",
      "total_fees": "0"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.