Get address transactions

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

GET

Parameters

Path Parameters

address
REQUIRED
string

Query Parameters

limit
integer Results per page
offset
integer Result offset
exclude_function_args
boolean Exclude function_args from contract call responses for smaller transaction sizes.
Status codeDescription
200Default Response
4XXDefault Response
cURL
curl -L \

  "https://api.hiro.so/extended/v2/addresses/{address}/transactions?limit={limit}&offset={offset}&exclude_function_args={exclude_function_args}" \

  -H 'Accept: application/json'
Response
{

  "limit": 20,

  "offset": 0,

  "total": 1,

  "results": [

    {

      "tx": {

        "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": ""

        }

      },

      "stx_sent": "SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP",

      "stx_received": "SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP",

      "events": {

        "stx": {

          "transfer": 0,

          "mint": 0,

          "burn": 0

        },

        "ft": {

          "transfer": 0,

          "mint": 0,

          "burn": 0

        },

        "nft": {

          "transfer": 0,

          "mint": 0,

          "burn": 0

        }

      }

    }

  ]

}

How is this guide?