Get recent transactions

Retrieves all recently mined transactions.

GET

Parameters

Query Parameters

offset
integer Result offset
limit
integer Results per page
type
array
unanchored
boolean Include data from unanchored (i.e. unconfirmed) microblocks
order
string
sort_by
string Option to sort results by block height, timestamp, or fee
from_address
string Option to filter results by sender address
to_address
string Option to filter results by recipient address
start_time
integer Filter by transactions after this timestamp (unix timestamp in seconds)
end_time
integer Filter by transactions before this timestamp (unix timestamp in seconds)
contract_id
string Option to filter results by contract ID
function_name
string Filter by contract call transactions involving this function name
nonce
integer Filter by transactions with this nonce
exclude_function_args
boolean Exclude function_args from contract call responses for smaller transaction sizes.
Status codeDescription
200List of transactions
4XXDefault Response
cURL
curl -L \

  "https://api.hiro.so/extended/v1/tx/?offset={offset}&limit={limit}&type={type}&unanchored=true&order={order}&sort_by={sort_by}&from_address={from_address}&to_address={to_address}&start_time=1704067200&end_time=1706745599&contract_id=SP000000000000000000002Q6VF78.pox-4&function_name=delegate-stx&nonce=123&exclude_function_args={exclude_function_args}" \

  -H 'Accept: application/json'
Response
{

  "limit": 20,

  "offset": 0,

  "total": 1,

  "results": [

    {

      "tx_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",

      "nonce": 1,

      "fee_rate": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",

      "sender_address": "SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP",

      "sponsor_nonce": 0,

      "sponsored": false,

      "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": "0x4839a8b01cfb39ffcc0d07d3db31e848d5adf5279d529ed5062300b9f353ff79",

      "block_height": 144000,

      "block_time": 144000,

      "block_time_iso": "string",

      "burn_block_time": 144000,

      "burn_block_height": 144000,

      "burn_block_time_iso": "string",

      "parent_burn_block_time": 144000,

      "parent_burn_block_time_iso": "string",

      "canonical": false,

      "tx_index": 0,

      "tx_status": "success",

      "tx_result": {

        "hex": "0x1234",

        "repr": "value representation"

      },

      "event_count": 0,

      "parent_block_hash": "0x4839a8b01cfb39ffcc0d07d3db31e848d5adf5279d529ed5062300b9f353ff79",

      "is_unanchored": false,

      "microblock_hash": "0x4839a8b01cfb39ffcc0d07d3db31e848d5adf5279d529ed5062300b9f353ff79",

      "microblock_sequence": 0,

      "microblock_canonical": false,

      "execution_cost_read_count": 1,

      "execution_cost_read_length": 0,

      "execution_cost_runtime": 0,

      "execution_cost_write_count": 1,

      "execution_cost_write_length": 0,

      "vm_error": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",

      "events": [

        {

          "event_index": 0,

          "event_type": "smart_contract_log",

          "tx_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",

          "contract_log": {

            "contract_id": "SP000000000000000000002Q6VF78.pox-3",

            "topic": "print",

            "value": {

              "hex": "0x1234",

              "repr": "value representation"

            }

          }

        }

      ],

      "tx_type": "token_transfer",

      "token_transfer": {

        "recipient_address": "string",

        "amount": "string",

        "memo": ""

      }

    }

  ]

}

How is this guide?