Get account transactions
Retrieves transactions for a specific account.
Get account transactions
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
principalRequiredstring
Stacks address or a Contract identifier
Example:"SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0"Query Parameters
limitinteger
max number of account transactions to fetch
Example:42000offsetinteger
index of first account transaction to fetch
Example:42000heightnumber
Filter for transactions only at this given block height
Example:42000unanchoredboolean
Include transaction data from unanchored (i.e. unconfirmed) microblocks
Example:trueDefault: falseuntil_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 code | Description |
|---|---|
200 | Success |
$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"}}]}