Get account transactions

GET

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

Get account transactions

Deprecated

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.

Path Parameters

`principal`
Required
string

Stacks address or a Contract identifier

Example: "SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0"

Query Parameters

`limit`integer

max number of account transactions to fetch

Example: 42000

`offset`integer

index of first account transaction to fetch

Example: 42000

`height`number

Filter for transactions only at this given block height

Example: 42000

`unanchored`boolean

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

Example: trueDefault: false

`until_block`string

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 code	Description
`200`	Success

Terminal

$ curl -X GET "https://api.hiro.so/extended/v1/address/SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0/transactions?limit=42000&offset=42000&height=42000&unanchored=true&until_block=60000"

GET request that returns account transactions

{
  "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 account transactions