TransactionsGet recent transactions

Get recent transactions

Retrieves all recently mined transactions.

GET
/extended/v1/tx

Get recent transactions

Retrieves all recently mined transactions

If using TypeScript, import typings for this response from our types package:

import type { TransactionResults } from '@stacks/stacks-blockchain-api-types';

Query Parameters

limitinteger

max number of transactions to fetch

Example: 100Default: 96Maximum: 200

offsetinteger

index of first transaction to fetch

Example: 42000

typearray<string>

Filter by transaction type

Example: "coinbase"

from_addressstring

Option to filter results by sender address

to_addressstring

Option to filter results by recipient address

sort_bystring

Option to sort results by block height, timestamp, or fee

Example: "burn_block_time"Default: "block_height"Value in: "block_height" | "burn_block_time" | "fee"

start_timeinteger

Filter by transactions after this timestamp (unix timestamp in seconds)

Example: 1704067200

end_timeinteger

Filter by transactions before this timestamp (unix timestamp in seconds)

Example: 1706745599

contract_idstring

Filter by contract call transactions involving this contract ID

Example: "SP000000000000000000002Q6VF78.pox-4"

function_namestring

Filter by contract call transactions involving this function name

Example: "delegate-stx"

nonceinteger

Filter by transactions with this nonce

Example: 123

orderstring

Option to sort results in ascending or descending order

Example: "desc"Default: "desc"Value in: "asc" | "desc"

unanchoredboolean

Include transaction data from unanchored (i.e. unconfirmed) microblocks

Example: trueDefault: false
Status codeDescription
200List of transactions
Terminal
$ 
curl -X GET "https://api.hiro.so/extended/v1/tx?limit=100&offset=42000&type=coinbase&from_address=string&to_address=string&sort_by=burn_block_time&start_time=1704067200&end_time=1706745599&contract_id=SP000000000000000000002Q6VF78.pox-4&function_name=delegate-stx&nonce=123&order=desc&unanchored=true"

GET request that returns transactions

{

  "limit": 200,

  "offset": 0,

  "total": 0,

  "results": [

    {

      "tx_id": "string",

      "nonce": 0,

      "fee_rate": "string",

      "sender_address": "string",

      "sponsor_nonce": 0,

      "sponsored": true,

      "sponsor_address": "string",

      "post_condition_mode": "allow",

      "post_conditions": [

        {

          "principal": {

            "type_id": "principal_origin"

          },

          "condition_code": "sent_equal_to",

          "amount": "string",

          "type": "stx"

        }

      ],

      "anchor_mode": "on_chain_only",

      "block_hash": "string",

      "block_height": 0,

      "block_time": 0,

      "block_time_iso": "string",

      "burn_block_height": 0,

      "burn_block_time": 0,

      "burn_block_time_iso": "string",

      "parent_burn_block_time": 0,

      "parent_burn_block_time_iso": "string",

      "canonical": true,

      "tx_index": 0,

      "tx_status": "success",

      "tx_result": {

        "hex": "string",

        "repr": "string"

      },

      "event_count": 0,

      "parent_block_hash": "string",

      "is_unanchored": true,

      "microblock_hash": "string",

      "microblock_sequence": 0,

      "microblock_canonical": true,

      "execution_cost_read_count": 0,

      "execution_cost_read_length": 0,

      "execution_cost_runtime": 0,

      "execution_cost_write_count": 0,

      "execution_cost_write_length": 0,

      "events": [

        {

          "event_index": 0,

          "event_type": "smart_contract_log",

          "tx_id": "string",

          "contract_log": {

            "contract_id": "string",

            "topic": "string",

            "value": {

              "hex": "string",

              "repr": "string"

            }

          }

        }

      ],

      "tx_type": "token_transfer",

      "token_transfer": {

        "recipient_address": "string",

        "amount": "string",

        "memo": "string"

      }

    }

  ]

}

Transactions

Get transaction