Skip to main content

account_tx RPC Method

Retrieves a list of transactions that involve a specific account in the XRP Ledger

Updated on
Jun 11, 2026

Parameters

object
object
REQUIRED

The account_tx request object.

account
string
REQUIRED

The XRP Ledger account for which to retrieve the transactions

binary
boolean

Specifies whether to return transaction data in binary format

forward
boolean

Specifies the direction of the transaction retrieval. If set to 'true', retrieves transactions from the oldest to the newest. If set to 'false', retrieves transactions from the newest to the oldest

ledger_index_max
integer

Specifies the maximum ledger index for the retrieval. Transactions with a ledger index higher than this value will not be included

ledger_index_min
integer

Specifies the minimum ledger index for the retrieval. Transactions with a ledger index lower than this value will not be included

limit
integer

Specifies the maximum number of transactions to retrieve

Returns

result
object

An object which contains the following fields:

limit
integer

The maximum number of transactions specified in the request

ledger_index_min
integer

The minimum ledger index specified in the request

ledger_index_max
integer

The maximum ledger index specified in the request

transactions
array

A list of transactions involving the specified account

account
string

The XRP Ledger account for which the transactions were retrieved

validated
boolean

Indicates whether the transactions are validated or not

status
string

The status of the request

marker
string | object

(Optional) The server-defined value indicating the response is paginated

warnings
array

(Optional) A list of warnings. Returned at the JSON-RPC response root on some servers and omitted from the result object

id
integer

The ID of the warning

message
string

The warning message

Request
Response
1
{
2
"result": {
3
"account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
4
"ledger_index_min": 32570,
5
"ledger_index_max": 102609804,
6
"transactions": [
7
{
8
"meta": {
9
"AffectedNodes": [
10
{
11
"ModifiedNode": {
12
"LedgerEntryType": "AccountRoot",
13
"LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574",
14
"PreviousTxnID": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
15
"PreviousTxnLgrSeq": 101974914
16
}
17
},
18
{
19
"ModifiedNode": {
20
"FinalFields": {
21
"Flags": 0,
22
"Owner": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
23
"RootIndex": "31ECB4AC7F3713FB1FD97E07F5F4589FF872D746AB1B8BA604BA40ED8F9F3CD2"
24
},
25
"LedgerEntryType": "DirectoryNode",
26
"LedgerIndex": "31ECB4AC7F3713FB1FD97E07F5F4589FF872D746AB1B8BA604BA40ED8F9F3CD2",
27
"PreviousTxnID": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
28
"PreviousTxnLgrSeq": 101974914
29
}
30
},
31
{
32
"ModifiedNode": {
33
"FinalFields": {
34
"Flags": 0,
35
"Owner": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
36
"RootIndex": "347C7476C61B99D4E7F6BBECDA911220042020C92A3E209282B69290BAE2F395"
37
},
38
"LedgerEntryType": "DirectoryNode",
39
"LedgerIndex": "347C7476C61B99D4E7F6BBECDA911220042020C92A3E209282B69290BAE2F395",
40
"PreviousTxnID": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
41
"PreviousTxnLgrSeq": 101974914
42
}
43
},
44
{
45
"ModifiedNode": {
46
"FinalFields": {
47
"Account": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
48
"Balance": "5199408",
49
"Flags": 0,
50
"OwnerCount": 7,
51
"Sequence": 98920206
52
},
53
"LedgerEntryType": "AccountRoot",
54
"LedgerIndex": "6221E36CC407593A1E74EC8BDCEF82BFF1C4275B92FC4D6877AA9013214133CA",
55
"PreviousFields": {
56
"Balance": "5199418",
57
"OwnerCount": 8,
58
"Sequence": 98920205
59
},
60
"PreviousTxnID": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
61
"PreviousTxnLgrSeq": 101974914
62
}
63
},
64
{
65
"DeletedNode": {
66
"FinalFields": {
67
"Balance": {
68
"currency": "USD",
69
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
70
"value": "0"
71
},
72
"Flags": 3145728,
73
"HighLimit": {
74
"currency": "USD",
75
"issuer": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
76
"value": "0"
77
},
78
"HighNode": "0",
79
"LowLimit": {
80
"currency": "USD",
81
"issuer": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
82
"value": "0"
83
},
84
"LowNode": "0",
85
"PreviousTxnID": "44DB86CB5AAC64416B00EC0BEE1B66293D81281B86C3351E7DB739BDA67ADE79",
86
"PreviousTxnLgrSeq": 101421310
87
},
88
"LedgerEntryType": "RippleState",
89
"LedgerIndex": "CE8F932A1CA2D2EDEAA1267BAEE88978BAA886034C389B76FB242860A82572A6",
90
"PreviousFields": {
91
"Flags": 1179648
92
}
93
}
94
}
95
],
96
"TransactionIndex": 9,
97
"TransactionResult": "tesSUCCESS"
98
},
99
"tx": {
100
"Account": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
101
"Fee": "10",
102
"Flags": 131072,
103
"LastLedgerSequence": 101974934,
104
"LimitAmount": {
105
"currency": "USD",
106
"issuer": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
107
"value": "0"
108
},
109
"Sequence": 98920205,
110
"SigningPubKey": "ED954DCBC5CB557C330BEAB71D36A18DEED0CAA5DE5A8FF8C9589A49D3253B50CF",
111
"TransactionType": "TrustSet",
112
"TxnSignature": "B6DCDEBB4CF253D6D868500D1AC80C611D5A2D833D9D6A72E7153641F47E0D731276980C5D5BC0887F106BE7012127BA8F05D489E71823B0C41E81FAE77C090B",
113
"hash": "E90074DD0D47BDA5F7E205BF5FA11B2D804498A5B10410F1EEC3A5E4592EE859",
114
"ctid": "C614038500090000",
115
"date": 823347021,
116
"ledger_index": 101974917,
117
"inLedger": 101974917
118
},
119
"validated": true
120
},
121
{
122
"meta": {
123
"AffectedNodes": [
124
{
125
"ModifiedNode": {
126
"LedgerEntryType": "AccountRoot",
127
"LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574",
128
"PreviousTxnID": "C58EB987B4AC3AE984ADF70DE375AD9B8A180569C30072DE57D6E17EFC69E7F0",
129
"PreviousTxnLgrSeq": 98918111
130
}
131
},
132
{
133
"ModifiedNode": {
134
"FinalFields": {
135
"Flags": 0,
136
"Owner": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
137
"RootIndex": "31ECB4AC7F3713FB1FD97E07F5F4589FF872D746AB1B8BA604BA40ED8F9F3CD2"
138
},
139
"LedgerEntryType": "DirectoryNode",
140
"LedgerIndex": "31ECB4AC7F3713FB1FD97E07F5F4589FF872D746AB1B8BA604BA40ED8F9F3CD2",
141
"PreviousTxnID": "B06372CF3B8AFDD77DB5334FD5BF26B2BA90E38BF31E850933EB1A81E876B892",
142
"PreviousTxnLgrSeq": 101974911
143
}
144
},
145
{
146
"ModifiedNode": {
147
"FinalFields": {
148
"Flags": 0,
149
"Owner": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
150
"RootIndex": "347C7476C61B99D4E7F6BBECDA911220042020C92A3E209282B69290BAE2F395"
151
},
152
"LedgerEntryType": "DirectoryNode",
153
"LedgerIndex": "347C7476C61B99D4E7F6BBECDA911220042020C92A3E209282B69290BAE2F395",
154
"PreviousTxnID": "C58EB987B4AC3AE984ADF70DE375AD9B8A180569C30072DE57D6E17EFC69E7F0",
155
"PreviousTxnLgrSeq": 98918111
156
}
157
},
158
{
159
"ModifiedNode": {
160
"FinalFields": {
161
"Account": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
162
"Balance": "5199418",
163
"Flags": 0,
164
"OwnerCount": 8,
165
"Sequence": 98920205
166
},
167
"LedgerEntryType": "AccountRoot",
168
"LedgerIndex": "6221E36CC407593A1E74EC8BDCEF82BFF1C4275B92FC4D6877AA9013214133CA",
169
"PreviousFields": {
170
"Balance": "5199428",
171
"OwnerCount": 9,
172
"Sequence": 98920204
173
},
174
"PreviousTxnID": "B06372CF3B8AFDD77DB5334FD5BF26B2BA90E38BF31E850933EB1A81E876B892",
175
"PreviousTxnLgrSeq": 101974911
176
}
177
},
178
{
179
"DeletedNode": {
180
"FinalFields": {
181
"Balance": {
182
"currency": "BTC",
183
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
184
"value": "0"
185
},
186
"Flags": 3145728,
187
"HighLimit": {
188
"currency": "BTC",
189
"issuer": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
190
"value": "0"
191
},
192
"HighNode": "0",
193
"LowLimit": {
194
"currency": "BTC",
195
"issuer": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
196
"value": "0"
197
},
198
"LowNode": "0",
199
"PreviousTxnID": "F5374239CC3A05121E7E1F1E8944F0B96FBCD27D008BA9A89E6D1AABD877D7ED",
200
"PreviousTxnLgrSeq": 101421307
201
},
202
"LedgerEntryType": "RippleState",
203
"LedgerIndex": "BCDE567C108FB674AA379BCDBEFF705899B38A39535A1EFA23E9906F96403A9F",
204
"PreviousFields": {
205
"Flags": 1179648
206
}
207
}
208
}
209
],
210
"TransactionIndex": 12,
211
"TransactionResult": "tesSUCCESS"
212
},
213
"tx": {
214
"Account": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
215
"Fee": "10",
216
"Flags": 131072,
217
"LastLedgerSequence": 101974932,
218
"LimitAmount": {
219
"currency": "BTC",
220
"issuer": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
221
"value": "0"
222
},
223
"Sequence": 98920204,
224
"SigningPubKey": "ED954DCBC5CB557C330BEAB71D36A18DEED0CAA5DE5A8FF8C9589A49D3253B50CF",
225
"TransactionType": "TrustSet",
226
"TxnSignature": "A94D005C1455AE4B0D4D0CC9BF47E400D58599A3E6FA3F0693FED345E78802CE98E18856171229BC60A7C087167BEFB5F9123B1FC2CB7AEDDCAC916DC6A0590C",
227
"hash": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
228
"ctid": "C6140382000C0000",
229
"date": 823347010,
230
"ledger_index": 101974914,
231
"inLedger": 101974914
232
},
233
"validated": true
234
}
235
],
236
"validated": true,
237
"marker": {
238
"ledger": 101974914,
239
"seq": 12
240
},
241
"limit": 2,
242
"status": "success"
243
},
244
"warnings": [
245
{
246
"id": 2001,
247
"message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
248
}
249
]
250
}
1
{
2
"result": {
3
"account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
4
"ledger_index_min": 32570,
5
"ledger_index_max": 102609804,
6
"transactions": [
7
{
8
"meta": {
9
"AffectedNodes": [
10
{
11
"ModifiedNode": {
12
"LedgerEntryType": "AccountRoot",
13
"LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574",
14
"PreviousTxnID": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
15
"PreviousTxnLgrSeq": 101974914
16
}
17
},
18
{
19
"ModifiedNode": {
20
"FinalFields": {
21
"Flags": 0,
22
"Owner": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
23
"RootIndex": "31ECB4AC7F3713FB1FD97E07F5F4589FF872D746AB1B8BA604BA40ED8F9F3CD2"
24
},
25
"LedgerEntryType": "DirectoryNode",
26
"LedgerIndex": "31ECB4AC7F3713FB1FD97E07F5F4589FF872D746AB1B8BA604BA40ED8F9F3CD2",
27
"PreviousTxnID": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
28
"PreviousTxnLgrSeq": 101974914
29
}
30
},
31
{
32
"ModifiedNode": {
33
"FinalFields": {
34
"Flags": 0,
35
"Owner": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
36
"RootIndex": "347C7476C61B99D4E7F6BBECDA911220042020C92A3E209282B69290BAE2F395"
37
},
38
"LedgerEntryType": "DirectoryNode",
39
"LedgerIndex": "347C7476C61B99D4E7F6BBECDA911220042020C92A3E209282B69290BAE2F395",
40
"PreviousTxnID": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
41
"PreviousTxnLgrSeq": 101974914
42
}
43
},
44
{
45
"ModifiedNode": {
46
"FinalFields": {
47
"Account": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
48
"Balance": "5199408",
49
"Flags": 0,
50
"OwnerCount": 7,
51
"Sequence": 98920206
52
},
53
"LedgerEntryType": "AccountRoot",
54
"LedgerIndex": "6221E36CC407593A1E74EC8BDCEF82BFF1C4275B92FC4D6877AA9013214133CA",
55
"PreviousFields": {
56
"Balance": "5199418",
57
"OwnerCount": 8,
58
"Sequence": 98920205
59
},
60
"PreviousTxnID": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
61
"PreviousTxnLgrSeq": 101974914
62
}
63
},
64
{
65
"DeletedNode": {
66
"FinalFields": {
67
"Balance": {
68
"currency": "USD",
69
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
70
"value": "0"
71
},
72
"Flags": 3145728,
73
"HighLimit": {
74
"currency": "USD",
75
"issuer": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
76
"value": "0"
77
},
78
"HighNode": "0",
79
"LowLimit": {
80
"currency": "USD",
81
"issuer": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
82
"value": "0"
83
},
84
"LowNode": "0",
85
"PreviousTxnID": "44DB86CB5AAC64416B00EC0BEE1B66293D81281B86C3351E7DB739BDA67ADE79",
86
"PreviousTxnLgrSeq": 101421310
87
},
88
"LedgerEntryType": "RippleState",
89
"LedgerIndex": "CE8F932A1CA2D2EDEAA1267BAEE88978BAA886034C389B76FB242860A82572A6",
90
"PreviousFields": {
91
"Flags": 1179648
92
}
93
}
94
}
95
],
96
"TransactionIndex": 9,
97
"TransactionResult": "tesSUCCESS"
98
},
99
"tx": {
100
"Account": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
101
"Fee": "10",
102
"Flags": 131072,
103
"LastLedgerSequence": 101974934,
104
"LimitAmount": {
105
"currency": "USD",
106
"issuer": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
107
"value": "0"
108
},
109
"Sequence": 98920205,
110
"SigningPubKey": "ED954DCBC5CB557C330BEAB71D36A18DEED0CAA5DE5A8FF8C9589A49D3253B50CF",
111
"TransactionType": "TrustSet",
112
"TxnSignature": "B6DCDEBB4CF253D6D868500D1AC80C611D5A2D833D9D6A72E7153641F47E0D731276980C5D5BC0887F106BE7012127BA8F05D489E71823B0C41E81FAE77C090B",
113
"hash": "E90074DD0D47BDA5F7E205BF5FA11B2D804498A5B10410F1EEC3A5E4592EE859",
114
"ctid": "C614038500090000",
115
"date": 823347021,
116
"ledger_index": 101974917,
117
"inLedger": 101974917
118
},
119
"validated": true
120
},
121
{
122
"meta": {
123
"AffectedNodes": [
124
{
125
"ModifiedNode": {
126
"LedgerEntryType": "AccountRoot",
127
"LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574",
128
"PreviousTxnID": "C58EB987B4AC3AE984ADF70DE375AD9B8A180569C30072DE57D6E17EFC69E7F0",
129
"PreviousTxnLgrSeq": 98918111
130
}
131
},
132
{
133
"ModifiedNode": {
134
"FinalFields": {
135
"Flags": 0,
136
"Owner": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
137
"RootIndex": "31ECB4AC7F3713FB1FD97E07F5F4589FF872D746AB1B8BA604BA40ED8F9F3CD2"
138
},
139
"LedgerEntryType": "DirectoryNode",
140
"LedgerIndex": "31ECB4AC7F3713FB1FD97E07F5F4589FF872D746AB1B8BA604BA40ED8F9F3CD2",
141
"PreviousTxnID": "B06372CF3B8AFDD77DB5334FD5BF26B2BA90E38BF31E850933EB1A81E876B892",
142
"PreviousTxnLgrSeq": 101974911
143
}
144
},
145
{
146
"ModifiedNode": {
147
"FinalFields": {
148
"Flags": 0,
149
"Owner": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
150
"RootIndex": "347C7476C61B99D4E7F6BBECDA911220042020C92A3E209282B69290BAE2F395"
151
},
152
"LedgerEntryType": "DirectoryNode",
153
"LedgerIndex": "347C7476C61B99D4E7F6BBECDA911220042020C92A3E209282B69290BAE2F395",
154
"PreviousTxnID": "C58EB987B4AC3AE984ADF70DE375AD9B8A180569C30072DE57D6E17EFC69E7F0",
155
"PreviousTxnLgrSeq": 98918111
156
}
157
},
158
{
159
"ModifiedNode": {
160
"FinalFields": {
161
"Account": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
162
"Balance": "5199418",
163
"Flags": 0,
164
"OwnerCount": 8,
165
"Sequence": 98920205
166
},
167
"LedgerEntryType": "AccountRoot",
168
"LedgerIndex": "6221E36CC407593A1E74EC8BDCEF82BFF1C4275B92FC4D6877AA9013214133CA",
169
"PreviousFields": {
170
"Balance": "5199428",
171
"OwnerCount": 9,
172
"Sequence": 98920204
173
},
174
"PreviousTxnID": "B06372CF3B8AFDD77DB5334FD5BF26B2BA90E38BF31E850933EB1A81E876B892",
175
"PreviousTxnLgrSeq": 101974911
176
}
177
},
178
{
179
"DeletedNode": {
180
"FinalFields": {
181
"Balance": {
182
"currency": "BTC",
183
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
184
"value": "0"
185
},
186
"Flags": 3145728,
187
"HighLimit": {
188
"currency": "BTC",
189
"issuer": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
190
"value": "0"
191
},
192
"HighNode": "0",
193
"LowLimit": {
194
"currency": "BTC",
195
"issuer": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
196
"value": "0"
197
},
198
"LowNode": "0",
199
"PreviousTxnID": "F5374239CC3A05121E7E1F1E8944F0B96FBCD27D008BA9A89E6D1AABD877D7ED",
200
"PreviousTxnLgrSeq": 101421307
201
},
202
"LedgerEntryType": "RippleState",
203
"LedgerIndex": "BCDE567C108FB674AA379BCDBEFF705899B38A39535A1EFA23E9906F96403A9F",
204
"PreviousFields": {
205
"Flags": 1179648
206
}
207
}
208
}
209
],
210
"TransactionIndex": 12,
211
"TransactionResult": "tesSUCCESS"
212
},
213
"tx": {
214
"Account": "r48QyLLbot7VCfw325LrXAUtP6CRfU3tb4",
215
"Fee": "10",
216
"Flags": 131072,
217
"LastLedgerSequence": 101974932,
218
"LimitAmount": {
219
"currency": "BTC",
220
"issuer": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
221
"value": "0"
222
},
223
"Sequence": 98920204,
224
"SigningPubKey": "ED954DCBC5CB557C330BEAB71D36A18DEED0CAA5DE5A8FF8C9589A49D3253B50CF",
225
"TransactionType": "TrustSet",
226
"TxnSignature": "A94D005C1455AE4B0D4D0CC9BF47E400D58599A3E6FA3F0693FED345E78802CE98E18856171229BC60A7C087167BEFB5F9123B1FC2CB7AEDDCAC916DC6A0590C",
227
"hash": "989E113E3627573FED734C77ABFF22FCA21A8EFC3E3B16ED8A23BC2C666F5CB8",
228
"ctid": "C6140382000C0000",
229
"date": 823347010,
230
"ledger_index": 101974914,
231
"inLedger": 101974914
232
},
233
"validated": true
234
}
235
],
236
"validated": true,
237
"marker": {
238
"ledger": 101974914,
239
"seq": 12
240
},
241
"limit": 2,
242
"status": "success"
243
},
244
"warnings": [
245
{
246
"id": 2001,
247
"message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
248
}
249
]
250
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free