Get address transactions

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

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

Path Parameters

addressSTX Address & Smart Contract ID

Query Parameters

limit?Limit

Results per page

Default20
Rangevalue <= 50
offset?Offset

Result offset

Default0

Response Body

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

limitinteger
offsetinteger
totalinteger
resultsarray<AddressTransaction>

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/v2/addresses/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions?limit=20&offset=0"
fetch("https://api.hiro.so//extended/v2/addresses/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions?limit=20&offset=0")
package main

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

func main() {
  url := "https://api.hiro.so//extended/v2/addresses/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions?limit=20&offset=0"

  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/v2/addresses/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions?limit=20&offset=0"

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

print(response.text)
{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "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_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"
        }
      },
      "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
        }
      }
    }
  ]
}
{
  "error": "string",
  "message": "string"
}