Get account transactions

Path Parameters

principalSTX Address & Smart Contract ID

Query Parameters

limit?Limit

Results per page

Default20

Rangevalue <= 50

offset?Offset

Result offset

Default0

height?integer

Filter for transactions only at this given block height

unanchored?boolean

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

Defaultfalse

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.

Response Body

GET request that returns account transactions

TypeScript Definitions

Use the response body type in TypeScript.

limitinteger

offsetinteger

totalinteger

resultsarray<TokenTransferTransaction & SmartContractTransaction & ContractCallTransaction & PoisonMicroblockTransaction & CoinbaseTransaction & TenureChangeTransaction>

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring

message?string

[key: string]any

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

fetch("https://api.hiro.so//extended/v1/address/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions?limit=20&offset=0&height=0&unanchored=true&until_block=string")

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//extended/v1/address/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions?limit=20&offset=0&height=0&unanchored=true&until_block=string"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

import requests

url = "https://api.hiro.so//extended/v1/address/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions?limit=20&offset=0&height=0&unanchored=true&until_block=string"

response = requests.request("GET", url)

print(response.text)

{
  "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,
      "vm_error": "string",
      "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"
      }
    }
  ]
}

{
  "error": "string",
  "message": "string"
}