AccountsGet account transactions with transfers

Get account transactions with transfers

Retrieves transactions for a specific account including STX transfers for each transaction.

GET
/extended/v1/address/{principal}/transactions_with_transfers

Get account transactions including STX transfers for each transaction.

Retrieve all transactions for an account or contract identifier including STX transfers for each transaction.

Path Parameters

principal
Required
string

Stacks address or a Contract identifier

Example: "SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0"

Query Parameters

limitinteger

max number of account transactions to fetch

Example: 20

offsetinteger

index of first account transaction to fetch

Example: 10

heightnumber

Filter for transactions only at this given block height

Example: 66119

unanchoredboolean

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

Example: trueDefault: false

until_blockstring

returned data representing the state up until that point in time, rather than the current block.

Example: 60000
Status codeDescription
200Success
/extended/v1/address/{principal}/transactions_with_transfers

curl -X GET "https://api.hiro.so/extended/v1/address/SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0/transactions_with_transfers?limit=20&offset=10&height=66119&unanchored=true&until_block=60000"

GET request that returns account transactions

{
  "limit": 30,
  "offset": 0,
  "total": 0,
  "results": [
    {
      "tx": {
        "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"
        }
      },
      "stx_sent": "string",
      "stx_received": "string",
      "stx_transfers": [
        {
          "amount": "string",
          "sender": "string",
          "recipient": "string"
        }
      ],
      "ft_transfers": [
        {
          "asset_identifier": "string",
          "amount": "string",
          "sender": "string",
          "recipient": "string"
        }
      ],
      "nft_transfers": [
        {
          "asset_identifier": "string",
          "value": {
            "hex": "string",
            "repr": "string"
          },
          "sender": "string",
          "recipient": "string"
        }
      ]
    }
  ]
}

Get account transactions

Get account transaction with transfers