Skip to main content

/extended/v3/principals/{principal}/transactions REST API Endpoint

Returns a list of confirmed transactions sent or received by a Stacks principal, including the transaction summary, the involvement of the principal in the transaction, and the balances affected by the transaction.

Updated on
Aug 18, 2026

Path Parameters

principal
string
REQUIRED

Stacks account or contract principal.

Query Parameters

limit
integer

Number of results per page

cursor
string

(Optional) Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index

Returns

total
integer

Total number of matching records.

limit
integer

Number of results per page

cursor
object

Cursor metadata for this page of results.

next
string | null

Cursor for the next page, or null when there is no next page.

previous
string | null

Cursor for the previous page, or null when there is no previous page.

current
string

Cursor identifying the current page.

results
array

Items returned for the current page.

transaction
object

Transaction associated with the record.

Token transfer transaction summary

tx_id
string

Transaction ID

sender
object

Transaction sender details.

address
string

Address of the transaction initiator

nonce
integer

Nonce of the transaction initiator

sponsor
object | null

Fee sponsor details, or null when the transaction is not sponsored.

address
string

Address of the transaction initiator

nonce
integer

Nonce of the transaction initiator

fee_rate
string

Transaction fee as Integer string (64-bit unsigned integer).

block
object

Stacks block containing the transaction.

height
integer

Height of the block this transactions was associated with

hash
string

Hash of the blocked this transactions was associated with

index_hash
string

Hash of the index block this transactions was associated with

time
number

Unix timestamp (in seconds) indicating when this block was mined.

time_iso
string

Block timestamp in ISO 8601 UTC format.

tx_index
integer

Index of the transaction, indicating the order. Starts at 0 and increases with each transaction

bitcoin_block
object

Bitcoin block that anchors the Stacks block.

height
integer

Height of the anchor burn block.

time
number

Unix timestamp (in seconds) indicating when this block was mined.

time_iso
string

Block timestamp in ISO 8601 UTC format.

status
string

Status of the transaction

event_count
integer

Number of events emitted by the transaction.

type
string

Discriminator identifying the record or transaction variant.

token_transfer
object

Token-transfer transaction details.

recipient
string

Principal that receives the transferred asset.

amount
string

Transfer amount as Integer string (64-bit unsigned integer)

memo
object

Token-transfer memo in encoded and readable forms.

hex
string

Hex-encoded Clarity value.

repr
string

Human-readable Clarity value representation.

tx_id
string

Transaction ID

sender
object

Transaction sender details.

address
string

Address of the transaction initiator

nonce
integer

Nonce of the transaction initiator

sponsor
object | null

Fee sponsor details, or null when the transaction is not sponsored.

address
string

Address of the transaction initiator

nonce
integer

Nonce of the transaction initiator

fee_rate
string

Transaction fee as Integer string (64-bit unsigned integer).

block
object

Stacks block containing the transaction.

height
integer

Height of the block this transactions was associated with

hash
string

Hash of the blocked this transactions was associated with

index_hash
string

Hash of the index block this transactions was associated with

time
number

Unix timestamp (in seconds) indicating when this block was mined.

time_iso
string

Block timestamp in ISO 8601 UTC format.

tx_index
integer

Index of the transaction, indicating the order. Starts at 0 and increases with each transaction

bitcoin_block
object

Bitcoin block that anchors the Stacks block.

height
integer

Height of the anchor burn block.

time
number

Unix timestamp (in seconds) indicating when this block was mined.

time_iso
string

Block timestamp in ISO 8601 UTC format.

status
string

Status of the transaction

event_count
integer

Number of events emitted by the transaction.

type
string

Discriminator identifying the record or transaction variant.

contract_call
object

Contract-call transaction details.

contract_id
string

Contract identifier formatted as <principaladdress>.<contract_name>

function_name
string

Name of the Clarity function to be invoked

involvement
string

How the principal is involved in the transaction.

balance_changes
object

Balance changes produced by the transaction.

stx
object

STX balance change details.

sent
string

Total sent from the given address, including the tx fee, in micro-STX as an integer string.

received
string

Total received by the given address in micro-STX as an integer string.

net
string

Net change in the principal's STX balance in micro-STX as an integer string.

affected_balances
object

Balances affected by the transaction.

stx
boolean

Whether the principal's STX balance was affected by the transaction

ft
boolean

Whether the principal's FT balance was affected by the transaction

nft
boolean

Whether the principal's NFT balance was affected by the transaction

Request
Response
1
{
2
"total": 119879,
3
"limit": 1,
4
"cursor": {
5
"next": "9107518:2147483647:2",
6
"previous": null,
7
"current": "9107524:2147483647:1"
8
},
9
"results": [
10
{
11
"transaction": {
12
"tx_id": "0x26edd8410c9a0e9430284c4533ca827d41ce77e7fb32f4dee3bcfabd65e95066",
13
"sender": {
14
"address": "SP1QCRAKXQ8TESKJ95ABBBZZHQBX9NX1TAQ085HEC",
15
"nonce": 11
16
},
17
"sponsor": null,
18
"fee_rate": "300",
19
"block": {
20
"height": 9107524,
21
"hash": "0x27327e977d6a4ca730a8ef10997368cc688a10c562ae34523d95293551e6c644",
22
"index_hash": "0xde5796996a35704430539d3825b0db9d6f10e21e7d4bdaf500f60d14ed55dddc",
23
"time": 1790949942,
24
"time_iso": "2026-10-02T14:05:42.000Z",
25
"tx_index": 1
26
},
27
"bitcoin_block": {
28
"height": 969600,
29
"time": 1790949209,
30
"time_iso": "2026-10-02T13:53:29.000Z"
31
},
32
"status": "success",
33
"event_count": 1,
34
"type": "token_transfer",
35
"token_transfer": {
36
"recipient": "SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4",
37
"amount": "100",
38
"memo": {
39
"hex": "0x00000000000000000000000000000000000000000000000000000000000000000000",
40
"repr": ""
41
}
42
}
43
},
44
"involvement": "affected",
45
"balance_changes": {
46
"stx": {
47
"sent": "0",
48
"received": "100",
49
"net": "100"
50
}
51
},
52
"affected_balances": {
53
"stx": true,
54
"ft": false,
55
"nft": false
56
}
57
}
58
]
59
}
1
{
2
"total": 119879,
3
"limit": 1,
4
"cursor": {
5
"next": "9107518:2147483647:2",
6
"previous": null,
7
"current": "9107524:2147483647:1"
8
},
9
"results": [
10
{
11
"transaction": {
12
"tx_id": "0x26edd8410c9a0e9430284c4533ca827d41ce77e7fb32f4dee3bcfabd65e95066",
13
"sender": {
14
"address": "SP1QCRAKXQ8TESKJ95ABBBZZHQBX9NX1TAQ085HEC",
15
"nonce": 11
16
},
17
"sponsor": null,
18
"fee_rate": "300",
19
"block": {
20
"height": 9107524,
21
"hash": "0x27327e977d6a4ca730a8ef10997368cc688a10c562ae34523d95293551e6c644",
22
"index_hash": "0xde5796996a35704430539d3825b0db9d6f10e21e7d4bdaf500f60d14ed55dddc",
23
"time": 1790949942,
24
"time_iso": "2026-10-02T14:05:42.000Z",
25
"tx_index": 1
26
},
27
"bitcoin_block": {
28
"height": 969600,
29
"time": 1790949209,
30
"time_iso": "2026-10-02T13:53:29.000Z"
31
},
32
"status": "success",
33
"event_count": 1,
34
"type": "token_transfer",
35
"token_transfer": {
36
"recipient": "SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4",
37
"amount": "100",
38
"memo": {
39
"hex": "0x00000000000000000000000000000000000000000000000000000000000000000000",
40
"repr": ""
41
}
42
}
43
},
44
"involvement": "affected",
45
"balance_changes": {
46
"stx": {
47
"sent": "0",
48
"received": "100",
49
"net": "100"
50
}
51
},
52
"affected_balances": {
53
"stx": true,
54
"ft": false,
55
"nft": false
56
}
57
}
58
]
59
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free