Get account transactions with transfers
Retrieves transactions for a specific account including STX transfers for each transaction.
GET
/extended/v1/address/{principal}/transactions_with_transfers
Get account transactions including STX transfers for each transaction.
Retrieve all transactions for an account or contract identifier including STX transfers for each transaction.
Path Parameters
principalRequiredstring
Stacks address or a Contract identifier
Example:"SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0"Query Parameters
limitinteger
max number of account transactions to fetch
Example:20offsetinteger
index of first account transaction to fetch
Example:10heightnumber
Filter for transactions only at this given block height
Example:66119unanchoredboolean
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.
Example:60000| Status code | Description |
|---|---|
| Success |
Terminal
$curl -X GET "https://api.hiro.so/extended/v1/address/SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0/transactions_with_transfers?limit=20&offset=10&height=66119&unanchored=true&until_block=60000"
GET request that returns account transactions
{"limit": 30,"offset": 0,"total": 0,"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_height": 0,"burn_block_time": 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,"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","stx_transfers": [{"amount": "string","sender": "string","recipient": "string"}],"ft_transfers": [{"asset_identifier": "string","amount": "string","sender": "string","recipient": "string"}],"nft_transfers": [{"asset_identifier": "string","value": {"hex": "string","repr": "string"},"sender": "string","recipient": "string"}]}]}