Get account transactions

GET

/extended/v1/address/{principal}/transactions

Get account transactions

NOTE: This endpoint is deprecated in favor of Get address transactions.

Retrieves a list of all Transactions for a given Address or Contract Identifier. More information on Transaction types can be found here.

If you need to actively monitor new transactions for an address or contract id, we highly recommend subscribing to WebSockets or Socket.io for real-time updates.

Query Parameters

`limit`Limit

Results per page

Default: 20Minimum: 0Maximum: 50

`offset`Offset

Result offset

Default: 0Minimum: 0

`height`integer

Filter for transactions only at this given block height

`unanchored`boolean

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

Default: false

`until_block`string

Block hash or block height. Return data representing the state up until that point in time, rather than the current block. Note - Use either of the query parameters but not both at a time.

Path Parameters

`principal`
Required
Any properties in STX Address, Smart Contract ID

Status code	Description
`200`	GET request that returns account transactions
`4XX`	Default Response

curl -X GET "https://api.hiro.so/extended/v1/address/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions?limit=20&offset=0&height=0&unanchored=false&until_block=string"

GET request that returns account transactions

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "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_height": 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"
      }
    }
  ]
}

Get account transactions