Parameters

object

object

REQUIRED

The account_lines request object.

account

string

The XRP Ledger account for which trust line information is to be retrieved

Returns

result

object

The method returns a JSON object with the following properties:

account

string

The XRP Ledger account

ledger_hash

string

The hash of the ledger containing the trust line information

ledger_index

integer

The index of the ledger containing the trust line information

limit

integer

The maximum number of trust lines returned

lines

array

A list of trust lines associated with the account

account

string

The account associated with the trust line

balance

string

The balance held against the trust line

currency

string

The trusted currency

limit

string

The maximum amount of the given currency that this account is willing to owe the peer account

limit_peer

string

The maximum amount of currency that the counterparty account is willing to owe the perspective account

quality_in

integer

The rate at which the account values incoming balances on this trust line, as a ratio of this value per 1 billion units, with 0 treated as a 1:1 ratio

quality_out

integer

The ratio at which the account values outgoing balances on this trust line, measured in units per 1 billion units

validated

boolean

Indicates if the information is from a validated ledger

status

string

The status of the request

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

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "account_lines",
6
  "params": [
7
    {
8
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
9
    }
10
  ],
11
  "id": 1
12
}'

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "account_lines",
6
  "params": [
7
    {
8
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
9
    }
10
  ],
11
  "id": 1
12
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'account_lines',
4
    params: [{"account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'account_lines',
4
    params: [{"account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "account_lines",
9
  "params": [
10
    {
11
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
12
    }
13
  ],
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "account_lines",
9
  "params": [
10
    {
11
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
12
    }
13
  ],
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "account_lines",
11
  params: [{"account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "account_lines",
11
  params: [{"account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "result": {
3
    "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
4
    "ledger_hash": "FE51E76B5948B60B847B5A1ECFF57C1EAF0FACDE7E408D5A1BEB1648F0D80E96",
5
    "ledger_index": 102609803,
6
    "validated": true,
7
    "limit": 200,
8
    "lines": [
9
      {
10
        "account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
11
        "balance": "0",
12
        "currency": "ASP",
13
        "limit": "0",
14
        "limit_peer": "10",
15
        "quality_in": 0,
16
        "quality_out": 0
17
      },
18
      {
19
        "account": "rE6R3DWF9fBD7CyiQciePF9SqK58Ubp8o2",
20
        "balance": "0",
21
        "currency": "JOE",
22
        "limit": "0",
23
        "limit_peer": "100",
24
        "quality_in": 0,
25
        "quality_out": 0,
26
        "no_ripple_peer": true
27
      },
28
      {
29
        "account": "rEhDDUUNxpXgEHVJtC2cjXAgyx5VCFxdMF",
30
        "balance": "0",
31
        "currency": "USD",
32
        "limit": "0",
33
        "limit_peer": "1",
34
        "quality_in": 0,
35
        "quality_out": 0
36
      },
37
      {
38
        "account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
39
        "balance": "5",
40
        "currency": "USD",
41
        "limit": "5",
42
        "limit_peer": "0",
43
        "quality_in": 0,
44
        "quality_out": 0,
45
        "no_ripple": true
46
      },
47
      {
48
        "account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
49
        "balance": "0.793598266778297",
50
        "currency": "EUR",
51
        "limit": "1",
52
        "limit_peer": "0",
53
        "quality_in": 0,
54
        "quality_out": 0,
55
        "no_ripple": true
56
      },
57
      {
58
        "account": "rnuF96W4SZoCJmbHYBFoJZpR8eCaxNvekK",
59
        "balance": "0",
60
        "currency": "CNY",
61
        "limit": "3",
62
        "limit_peer": "0",
63
        "quality_in": 0,
64
        "quality_out": 0,
65
        "no_ripple": true
66
      },
67
      {
68
        "account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
69
        "balance": "1.336889190631542",
70
        "currency": "DYM",
71
        "limit": "3",
72
        "limit_peer": "0",
73
        "quality_in": 0,
74
        "quality_out": 0
75
      },
76
      {
77
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
78
        "balance": "0",
79
        "currency": "BTC",
80
        "limit": "3",
81
        "limit_peer": "0",
82
        "quality_in": 0,
83
        "quality_out": 0
84
      },
85
      {
86
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
87
        "balance": "11.68225001668339",
88
        "currency": "USD",
89
        "limit": "5000",
90
        "limit_peer": "0",
91
        "quality_in": 0,
92
        "quality_out": 0
93
      },
94
      {
95
        "account": "rE6R3DWF9fBD7CyiQciePF9SqK58Ubp8o2",
96
        "balance": "0",
97
        "currency": "USD",
98
        "limit": "0",
99
        "limit_peer": "100",
100
        "quality_in": 0,
101
        "quality_out": 0,
102
        "no_ripple_peer": true
103
      },
104
      {
105
        "account": "rpgKWEmNqSDAGFhy5WDnsyPqfQxbWxKeVd",
106
        "balance": "-0.00111",
107
        "currency": "BTC",
108
        "limit": "0",
109
        "limit_peer": "10",
110
        "quality_in": 0,
111
        "quality_out": 0
112
      },
113
      {
114
        "account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
115
        "balance": "0",
116
        "currency": "XAU",
117
        "limit": "0",
118
        "limit_peer": "0",
119
        "quality_in": 0,
120
        "quality_out": 0,
121
        "no_ripple": true,
122
        "no_ripple_peer": true
123
      },
124
      {
125
        "account": "rs9M85karFkCRjvc6KMWn8Coigm9cbcgcx",
126
        "balance": "0",
127
        "currency": "015841551A748AD2C1F76FF6ECB0CCCD00000000",
128
        "limit": "10.01037626125837",
129
        "limit_peer": "0",
130
        "quality_in": 0,
131
        "quality_out": 0,
132
        "no_ripple": true
133
      },
134
      {
135
        "account": "rBJ3YjwXi2MGbg7GVLuTXUWQ8DjL7tDXh4",
136
        "balance": "-0.0008744482690504699",
137
        "currency": "BTC",
138
        "limit": "0",
139
        "limit_peer": "10",
140
        "quality_in": 0,
141
        "quality_out": 0
142
      },
143
      {
144
        "account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
145
        "balance": "0",
146
        "currency": "USD",
147
        "limit": "1",
148
        "limit_peer": "0",
149
        "quality_in": 0,
150
        "quality_out": 0
151
      },
152
      {
153
        "account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
154
        "balance": "0",
155
        "currency": "AUX",
156
        "limit": "0",
157
        "limit_peer": "0",
158
        "quality_in": 0,
159
        "quality_out": 0,
160
        "no_ripple": true,
161
        "no_ripple_peer": true
162
      },
163
      {
164
        "account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
165
        "balance": "9.07619790068559",
166
        "currency": "CNY",
167
        "limit": "100",
168
        "limit_peer": "0",
169
        "quality_in": 0,
170
        "quality_out": 0,
171
        "no_ripple": true
172
      },
173
      {
174
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
175
        "balance": "7.292695098901099",
176
        "currency": "JPY",
177
        "limit": "0",
178
        "limit_peer": "0",
179
        "quality_in": 0,
180
        "quality_out": 0,
181
        "no_ripple": true
182
      },
183
      {
184
        "account": "rfF3PNkwkq1DygW2wum2HK3RGfgkJjdPVD",
185
        "balance": "35",
186
        "currency": "USD",
187
        "limit": "500",
188
        "limit_peer": "0",
189
        "quality_in": 0,
190
        "quality_out": 0,
191
        "no_ripple": true
192
      },
193
      {
194
        "account": "r9vbV3EHvXWjSkeQ6CAcYVPGeq7TuiXY2X",
195
        "balance": "0.0004557360418801623",
196
        "currency": "USD",
197
        "limit": "1",
198
        "limit_peer": "0",
199
        "quality_in": 0,
200
        "quality_out": 0,
201
        "no_ripple": true
202
      },
203
      {
204
        "account": "rHpXfibHgSb64n8kK9QWDpdbfqSpYbM9a4",
205
        "balance": "481.992867407479",
206
        "currency": "MXN",
207
        "limit": "1000",
208
        "limit_peer": "0",
209
        "quality_in": 0,
210
        "quality_out": 0
211
      },
212
      {
213
        "account": "rnZPod3VTvqBQQTgNMrisnRSkjzoBvs14H",
214
        "balance": "0",
215
        "currency": "5553445400000000000000000000000000000000",
216
        "limit": "0",
217
        "limit_peer": "1000",
218
        "quality_in": 0,
219
        "quality_out": 0,
220
        "no_ripple": true
221
      },
222
      {
223
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
224
        "balance": "0.3488146605801446",
225
        "currency": "CHF",
226
        "limit": "0",
227
        "limit_peer": "0",
228
        "quality_in": 0,
229
        "quality_out": 0
230
      },
231
      {
232
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
233
        "balance": "12.41688780720394",
234
        "currency": "EUR",
235
        "limit": "100",
236
        "limit_peer": "0",
237
        "quality_in": 0,
238
        "quality_out": 0,
239
        "no_ripple": true
240
      },
241
      {
242
        "account": "rwUVoVMSURqNyvocPCcvLu3ygJzZyw8qwp",
243
        "balance": "-5",
244
        "currency": "JOE",
245
        "limit": "0",
246
        "limit_peer": "50",
247
        "quality_in": 0,
248
        "quality_out": 0,
249
        "no_ripple_peer": true
250
      }
251
    ],
252
    "status": "success"
253
  },
254
  "warnings": [
255
    {
256
      "id": 2001,
257
      "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"
258
    }
259
  ]
260
}

1
{
2
  "result": {
3
    "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
4
    "ledger_hash": "FE51E76B5948B60B847B5A1ECFF57C1EAF0FACDE7E408D5A1BEB1648F0D80E96",
5
    "ledger_index": 102609803,
6
    "validated": true,
7
    "limit": 200,
8
    "lines": [
9
      {
10
        "account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
11
        "balance": "0",
12
        "currency": "ASP",
13
        "limit": "0",
14
        "limit_peer": "10",
15
        "quality_in": 0,
16
        "quality_out": 0
17
      },
18
      {
19
        "account": "rE6R3DWF9fBD7CyiQciePF9SqK58Ubp8o2",
20
        "balance": "0",
21
        "currency": "JOE",
22
        "limit": "0",
23
        "limit_peer": "100",
24
        "quality_in": 0,
25
        "quality_out": 0,
26
        "no_ripple_peer": true
27
      },
28
      {
29
        "account": "rEhDDUUNxpXgEHVJtC2cjXAgyx5VCFxdMF",
30
        "balance": "0",
31
        "currency": "USD",
32
        "limit": "0",
33
        "limit_peer": "1",
34
        "quality_in": 0,
35
        "quality_out": 0
36
      },
37
      {
38
        "account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
39
        "balance": "5",
40
        "currency": "USD",
41
        "limit": "5",
42
        "limit_peer": "0",
43
        "quality_in": 0,
44
        "quality_out": 0,
45
        "no_ripple": true
46
      },
47
      {
48
        "account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
49
        "balance": "0.793598266778297",
50
        "currency": "EUR",
51
        "limit": "1",
52
        "limit_peer": "0",
53
        "quality_in": 0,
54
        "quality_out": 0,
55
        "no_ripple": true
56
      },
57
      {
58
        "account": "rnuF96W4SZoCJmbHYBFoJZpR8eCaxNvekK",
59
        "balance": "0",
60
        "currency": "CNY",
61
        "limit": "3",
62
        "limit_peer": "0",
63
        "quality_in": 0,
64
        "quality_out": 0,
65
        "no_ripple": true
66
      },
67
      {
68
        "account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
69
        "balance": "1.336889190631542",
70
        "currency": "DYM",
71
        "limit": "3",
72
        "limit_peer": "0",
73
        "quality_in": 0,
74
        "quality_out": 0
75
      },
76
      {
77
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
78
        "balance": "0",
79
        "currency": "BTC",
80
        "limit": "3",
81
        "limit_peer": "0",
82
        "quality_in": 0,
83
        "quality_out": 0
84
      },
85
      {
86
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
87
        "balance": "11.68225001668339",
88
        "currency": "USD",
89
        "limit": "5000",
90
        "limit_peer": "0",
91
        "quality_in": 0,
92
        "quality_out": 0
93
      },
94
      {
95
        "account": "rE6R3DWF9fBD7CyiQciePF9SqK58Ubp8o2",
96
        "balance": "0",
97
        "currency": "USD",
98
        "limit": "0",
99
        "limit_peer": "100",
100
        "quality_in": 0,
101
        "quality_out": 0,
102
        "no_ripple_peer": true
103
      },
104
      {
105
        "account": "rpgKWEmNqSDAGFhy5WDnsyPqfQxbWxKeVd",
106
        "balance": "-0.00111",
107
        "currency": "BTC",
108
        "limit": "0",
109
        "limit_peer": "10",
110
        "quality_in": 0,
111
        "quality_out": 0
112
      },
113
      {
114
        "account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
115
        "balance": "0",
116
        "currency": "XAU",
117
        "limit": "0",
118
        "limit_peer": "0",
119
        "quality_in": 0,
120
        "quality_out": 0,
121
        "no_ripple": true,
122
        "no_ripple_peer": true
123
      },
124
      {
125
        "account": "rs9M85karFkCRjvc6KMWn8Coigm9cbcgcx",
126
        "balance": "0",
127
        "currency": "015841551A748AD2C1F76FF6ECB0CCCD00000000",
128
        "limit": "10.01037626125837",
129
        "limit_peer": "0",
130
        "quality_in": 0,
131
        "quality_out": 0,
132
        "no_ripple": true
133
      },
134
      {
135
        "account": "rBJ3YjwXi2MGbg7GVLuTXUWQ8DjL7tDXh4",
136
        "balance": "-0.0008744482690504699",
137
        "currency": "BTC",
138
        "limit": "0",
139
        "limit_peer": "10",
140
        "quality_in": 0,
141
        "quality_out": 0
142
      },
143
      {
144
        "account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
145
        "balance": "0",
146
        "currency": "USD",
147
        "limit": "1",
148
        "limit_peer": "0",
149
        "quality_in": 0,
150
        "quality_out": 0
151
      },
152
      {
153
        "account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
154
        "balance": "0",
155
        "currency": "AUX",
156
        "limit": "0",
157
        "limit_peer": "0",
158
        "quality_in": 0,
159
        "quality_out": 0,
160
        "no_ripple": true,
161
        "no_ripple_peer": true
162
      },
163
      {
164
        "account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
165
        "balance": "9.07619790068559",
166
        "currency": "CNY",
167
        "limit": "100",
168
        "limit_peer": "0",
169
        "quality_in": 0,
170
        "quality_out": 0,
171
        "no_ripple": true
172
      },
173
      {
174
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
175
        "balance": "7.292695098901099",
176
        "currency": "JPY",
177
        "limit": "0",
178
        "limit_peer": "0",
179
        "quality_in": 0,
180
        "quality_out": 0,
181
        "no_ripple": true
182
      },
183
      {
184
        "account": "rfF3PNkwkq1DygW2wum2HK3RGfgkJjdPVD",
185
        "balance": "35",
186
        "currency": "USD",
187
        "limit": "500",
188
        "limit_peer": "0",
189
        "quality_in": 0,
190
        "quality_out": 0,
191
        "no_ripple": true
192
      },
193
      {
194
        "account": "r9vbV3EHvXWjSkeQ6CAcYVPGeq7TuiXY2X",
195
        "balance": "0.0004557360418801623",
196
        "currency": "USD",
197
        "limit": "1",
198
        "limit_peer": "0",
199
        "quality_in": 0,
200
        "quality_out": 0,
201
        "no_ripple": true
202
      },
203
      {
204
        "account": "rHpXfibHgSb64n8kK9QWDpdbfqSpYbM9a4",
205
        "balance": "481.992867407479",
206
        "currency": "MXN",
207
        "limit": "1000",
208
        "limit_peer": "0",
209
        "quality_in": 0,
210
        "quality_out": 0
211
      },
212
      {
213
        "account": "rnZPod3VTvqBQQTgNMrisnRSkjzoBvs14H",
214
        "balance": "0",
215
        "currency": "5553445400000000000000000000000000000000",
216
        "limit": "0",
217
        "limit_peer": "1000",
218
        "quality_in": 0,
219
        "quality_out": 0,
220
        "no_ripple": true
221
      },
222
      {
223
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
224
        "balance": "0.3488146605801446",
225
        "currency": "CHF",
226
        "limit": "0",
227
        "limit_peer": "0",
228
        "quality_in": 0,
229
        "quality_out": 0
230
      },
231
      {
232
        "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
233
        "balance": "12.41688780720394",
234
        "currency": "EUR",
235
        "limit": "100",
236
        "limit_peer": "0",
237
        "quality_in": 0,
238
        "quality_out": 0,
239
        "no_ripple": true
240
      },
241
      {
242
        "account": "rwUVoVMSURqNyvocPCcvLu3ygJzZyw8qwp",
243
        "balance": "-5",
244
        "currency": "JOE",
245
        "limit": "0",
246
        "limit_peer": "50",
247
        "quality_in": 0,
248
        "quality_out": 0,
249
        "no_ripple_peer": true
250
      }
251
    ],
252
    "status": "success"
253
  },
254
  "warnings": [
255
    {
256
      "id": 2001,
257
      "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"
258
    }
259
  ]
260
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free