TransactionsGet address transactions

Get address transactions

Retrieves transactions sent or received by a STX address or smart contract ID.

GET

/extended/v2/addresses/{address}/transactions

Retrieves a paginated list of confirmed transactions sent or received by a STX address or smart contract ID, alongside the total amount of STX sent or received and the number of STX, FT and NFT transfers contained within each transaction.

Path parameters

address
Required
string

STX address or smart contract ID

Example: "SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0"

Query parameters

limitinteger

Number of transactions to fetch

Example: 20

offsetinteger

Index of first transaction to fetch

Example: 10
Status codeDescription
200Success
curl
curl -X GET "https://api.mainnet.hiro.so/extended/v2/addresses/SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0/transactions"

GET address 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,
        "block_time": 0,
        "block_time_iso": "string",
        "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",
      "events": {
        "stx": {
          "transfer": 0,
          "mint": 0,
          "burn": 0
        },
        "ft": {
          "transfer": 0,
          "mint": 0,
          "burn": 0
        },
        "nft": {
          "transfer": 0,
          "mint": 0,
          "burn": 0
        }
      }
    }
  ]
}

Get raw transaction

Get transactions by block