AccountsGet account transactions

Get account transactions

Retrieves transactions for a specific account.

GET

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

NOTE: This endpoint has been deprecated and may be removed in future versions of the API.

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 using the @stacks/blockchain-api-client library for real-time updates.

Path parameters

principal
Required
string

Stacks address or a contract identifier

Example: "SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0"

Query parameters

limitinteger

Max number of account transactions to fetch

Example: 42000

offsetinteger

Index of first account transaction to fetch

Example: 42000

heightnumber

Filter for transactions only at this given block height

Example: 42000

unanchoredboolean

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

Example: trueDefault: false

until_blockstring

returned 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.

Example: 60000
Status codeDescription
200Success
Terminal
curl -X GET "https://api.mainnet.hiro.so/extended/v1/address/SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0/transactions"

GET request that returns account transactions

Example response
{
  "limit": 30,
  "offset": 0,
  "total": 0,
  "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",
      "tx_status": "pending",
      "receipt_time": 0,
      "receipt_time_iso": "string",
      "tx_type": "token_transfer",
      "token_transfer": {
        "recipient_address": "string",
        "amount": "string",
        "memo": "string"
      }
    }
  ]
}

Get inbound STX transfers

Get account transactions with transfers