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

NOTE: This endpoint has been deprecated and may be removed in future versions of the API.

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
Terminal
curl -X GET \
  "https://api.mainnet.hiro.so/extended/v1/address/SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0/transactions_with_transfers"

GET request that returns account transactions

Example response
{
  "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,
        "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