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.

Query Parameters

limitLimit

Results per page

Default: 20Minimum: 0Maximum: 50

offsetOffset

Result offset

Default: 0Minimum: 0

heightinteger

Filter for transactions only at this given block height

unanchoredboolean

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

Default: false

until_blockstring

Block hash or block height. Return 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.

Path Parameters

principal
Required
Any properties in STX Address, Smart Contract ID

Status codeDescription
200Default Response
4XXDefault Response
/extended/v1/address/{principal}/transactions_with_transfers

curl -X GET "https://api.hiro.so/extended/v1/address/SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP/transactions_with_transfers?limit=20&offset=0&height=0&unanchored=false&until_block=string"

{
"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,
"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": [
{
"amount": "string",
"asset_identifier": "string",
"sender": "string",
"recipient": "string"
}
],
"nft_transfers": [
{
"value": {
"hex": "string",
"repr": "string"
},
"asset_identifier": "string",
"sender": "string",
"recipient": "string"
}
]
}
]
}