Skip to main content

book_offers RPC Method

Retrieves a list of offers in a specified order book on the XRP Ledger

Updated on
Jun 11, 2026

Parameters

object
object
REQUIRED

The book_offers request object.

taker
string

The account that is taking the offers

taker_gets
object
REQUIRED

The details of the asset the taker wants to acquire. It contains the following properties:

currency
string

The currency code of the asset

taker_pays
object
REQUIRED

The details of the asset the taker is willing to give in exchange. It contains the following properties:

currency
string

The currency code of the asset

issuer
string

The issuer of the asset

limit
integer

The maximum number of offers to retrieve

Returns

result
object

An object which contains the following fields:

ledger_hash
string

The hash of the ledger containing the offers

ledger_index
integer

The index of the ledger containing the offers

offers
array

A list of offers with the following properties:

owner_funds
string | integer

(Optional) The amount of the currency that the offering side has available for trading

taker_gets_funded
string | integer | object

(Optional) The maximum amount of currency that the taker can get provided the funding status

taker_pays_funded
string | integer | object

(Optional) The maximum amount of currency that the taker would pay provided the funding status

quality
string

The exchange rate, as the ratio 'taker_pays' divided by 'taker_gets'

Account
string

The account that placed the offer

BookDirectory
string

The order book directory index

BookNode
string

The order book node index

Flags
integer

The flags on the offer

LedgerEntryType
string

The ledger entry type

OwnerNode
string

The owner directory node index

PreviousTxnID
string

The hash of the previous transaction

PreviousTxnLgrSeq
integer

The ledger index of the previous transaction

Sequence
integer

The sequence number of the offer

TakerGets
string | object

The amount the taker receives

TakerPays
string | object

The amount the taker pays

index
string

The ledger entry index of the offer

validated
boolean

(Optional) It indicates whether the result has been validated

status
string

The status of the request

warnings
array

(Optional) An array of warning objects, each containing the following fields. 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
"ledger_hash": "7735091DF9F32511F41AD963A8BDE4AF24B27D3AA3946903A31E3CFF2B948217",
4
"ledger_index": 102609804,
5
"offers": [
6
{
7
"Account": "rsPrWzpYp5jj278vHVgp1tMvbKdHAZGFbi",
8
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04F8383682906C",
9
"BookNode": "0",
10
"Flags": 0,
11
"LedgerEntryType": "Offer",
12
"OwnerNode": "0",
13
"PreviousTxnID": "AD64BCFCEBDD521418F228FF1799B6E99A909E972C30FAE42CD15641874CF2E2",
14
"PreviousTxnLgrSeq": 102609513,
15
"Sequence": 9686350,
16
"TakerGets": "24921326",
17
"TakerPays": {
18
"currency": "USD",
19
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
20
"value": "34.86045479840703"
21
},
22
"index": "7175F381B8E2005C23DBF143940A1D20A29FC88772790646D06E4CF286283327",
23
"owner_funds": "1357947312",
24
"quality": "0.000001398820223225964"
25
},
26
{
27
"Account": "ra8jRjyCR7MTzDr2jeQBYSAwpT1aqYrTF4",
28
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04F8393121929F",
29
"BookNode": "0",
30
"Flags": 196608,
31
"LedgerEntryType": "Offer",
32
"OwnerNode": "12",
33
"PreviousTxnID": "0F2DD1CC77B89378E8726D2234E1ABADA2A4ACAAE642FC7C89C248B74D05B509",
34
"PreviousTxnLgrSeq": 102609758,
35
"Sequence": 98128172,
36
"TakerGets": "7148860",
37
"TakerPays": {
38
"currency": "USD",
39
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
40
"value": "10"
41
},
42
"index": "FA5E665C5A99F1B5D964C6EBC8035B44633C90ED2A973EDE25FBB6673638E41E",
43
"owner_funds": "120087159",
44
"quality": "0.000001398824427950751"
45
},
46
{
47
"Account": "rP4gybHF3astaSuih16DMpL16aFa6DjYkX",
48
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FB4C85356D40",
49
"BookNode": "0",
50
"Flags": 0,
51
"LedgerEntryType": "Offer",
52
"OwnerNode": "0",
53
"PreviousTxnID": "C0A83AEC11C89A524572E496A1F6D87DDAED4164655CABB80161DCE5D44CDF68",
54
"PreviousTxnLgrSeq": 102609797,
55
"Sequence": 1848423,
56
"TakerGets": "50000000",
57
"TakerPays": {
58
"currency": "USD",
59
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
60
"value": "70.11029889000001"
61
},
62
"index": "09E04F62431576E1295A44F064DE64EFB9DBA12B7B0EC8D3598E3D72B089A864",
63
"owner_funds": "1476717986",
64
"quality": "0.0000014022059778"
65
},
66
{
67
"Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
68
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FB90FA4C2800",
69
"BookNode": "0",
70
"Flags": 0,
71
"LedgerEntryType": "Offer",
72
"OwnerNode": "1",
73
"PreviousTxnID": "A1B2E490641769129FF12A2434132C759353006A85F8AD463B1BC1C151208CB4",
74
"PreviousTxnLgrSeq": 102609804,
75
"Sequence": 231811290,
76
"TakerGets": "196397000000",
77
"TakerPays": {
78
"currency": "USD",
79
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
80
"value": "275446.7925"
81
},
82
"index": "FF7E48A0092C0CA07ABEE7AFA7DDD07252BFB3F552366F494DE9BDA37BC86965",
83
"owner_funds": "196492741742",
84
"quality": "0.0000014025"
85
},
86
{
87
"Account": "r3rhWeE31Jt5sWmi4QiGLMZnY3ENgqw96W",
88
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FBF6FFDC7FA4",
89
"BookNode": "0",
90
"Flags": 0,
91
"LedgerEntryType": "Offer",
92
"OwnerNode": "181cc",
93
"PreviousTxnID": "824EDF057FB94BB9F25A880065EE432BCB41892A9A64B645000196C3A1BCB890",
94
"PreviousTxnLgrSeq": 102609791,
95
"Sequence": 157535619,
96
"TakerGets": "89388226525",
97
"TakerPays": {
98
"currency": "USD",
99
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
100
"value": "125406.1558352954"
101
},
102
"index": "7816BD0C78E8959E7B60C12335E477E14D40571511AC7F4D2C4FA46DA1F1694D",
103
"owner_funds": "174479944880",
104
"quality": "0.000001402938180009892"
105
},
106
{
107
"Account": "r3rhWeE31Jt5sWmi4QiGLMZnY3ENgqw96W",
108
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FBF6FFDC897A",
109
"BookNode": "0",
110
"Flags": 0,
111
"LedgerEntryType": "Offer",
112
"OwnerNode": "181cc",
113
"PreviousTxnID": "85B38A5024C15AA2C4B4EFB3520CA18DE100B621F41EB3FC3113607C7B1EA697",
114
"PreviousTxnLgrSeq": 102609791,
115
"Sequence": 157535618,
116
"TakerGets": "63522654453",
117
"TakerPays": {
118
"currency": "USD",
119
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
120
"value": "89118.35722784902"
121
},
122
"index": "D6300EDDE5F69BAC38FEBAC8100390F203AD6D1DC82CF214E73B90E6711C60F8",
123
"quality": "0.00000140293818001241"
124
},
125
{
126
"Account": "rNmp1eKUcH6fhENA286G6FEe1AEvpzDb9B",
127
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FCBFA855F000",
128
"BookNode": "0",
129
"Flags": 131072,
130
"LedgerEntryType": "Offer",
131
"OwnerNode": "3",
132
"PreviousTxnID": "0FA7F94E8B74E7722CD23133ECBBD32C7A3C0EE6563347F0CC2E419557EB79A8",
133
"PreviousTxnLgrSeq": 102601119,
134
"Sequence": 102053657,
135
"TakerGets": "3588602",
136
"TakerPays": {
137
"currency": "USD",
138
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
139
"value": "5.0376794876"
140
},
141
"index": "6BC49163BCA7D44DD688732B7FF8778FFA19C3433889EB3E09E7C21DBDBC3B7A",
142
"owner_funds": "162050446",
143
"quality": "0.0000014038"
144
},
145
{
146
"Account": "rhqs2GjSFoFUv97ANNwdgtegFApSCKwG13",
147
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F0504B528950600",
148
"BookNode": "0",
149
"Expiration": 825793729,
150
"Flags": 0,
151
"LedgerEntryType": "Offer",
152
"OwnerNode": "0",
153
"PreviousTxnID": "5697F97C2872E17D6F8630FFA9F8FAD8BB16EEE48BB37377A3B92FD27A39B3A6",
154
"PreviousTxnLgrSeq": 102602407,
155
"Sequence": 95000883,
156
"TakerGets": "29000000",
157
"TakerPays": {
158
"currency": "USD",
159
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
160
"value": "40.963979"
161
},
162
"index": "476858BA4ACA76223414959EA4F58FCC2A8F7C5F97C09ED97797710AD8DB6888",
163
"owner_funds": "344736457",
164
"quality": "0.000001412551"
165
},
166
{
167
"Account": "rNmp1eKUcH6fhENA286G6FEe1AEvpzDb9B",
168
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F050A92AEEFB000",
169
"BookNode": "0",
170
"Flags": 131072,
171
"LedgerEntryType": "Offer",
172
"OwnerNode": "3",
173
"PreviousTxnID": "E9EF4EA942ED3AA771828E6064E73669FD32F01BB3D9C9438FBB94C2029B185D",
174
"PreviousTxnLgrSeq": 102568581,
175
"Sequence": 102053622,
176
"TakerGets": "1416430",
177
"TakerPays": {
178
"currency": "USD",
179
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
180
"value": "2.00991417"
181
},
182
"index": "3699F9D1BA02737473C162710A78CE539C682B69727A655561A4126DB09EA863",
183
"quality": "0.000001419"
184
},
185
{
186
"Account": "rNmp1eKUcH6fhENA286G6FEe1AEvpzDb9B",
187
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F050D7BBDCCB000",
188
"BookNode": "0",
189
"Flags": 131072,
190
"LedgerEntryType": "Offer",
191
"OwnerNode": "3",
192
"PreviousTxnID": "F42F7E984BEB195F2EC92FCCFE7D4F8F85BE7BDF8E296BA971BB5FA0456A0060",
193
"PreviousTxnLgrSeq": 102571465,
194
"Sequence": 102053626,
195
"TakerGets": "3618468",
196
"TakerPays": {
197
"currency": "USD",
198
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
199
"value": "5.1461851896"
200
},
201
"index": "9EA224CF7C0B59AA2B362232E346AF99F2F9E628E1CE70CFAFCD0035C0452F5E",
202
"quality": "0.0000014222"
203
}
204
],
205
"status": "success"
206
},
207
"warnings": [
208
{
209
"id": 2001,
210
"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"
211
}
212
]
213
}
1
{
2
"result": {
3
"ledger_hash": "7735091DF9F32511F41AD963A8BDE4AF24B27D3AA3946903A31E3CFF2B948217",
4
"ledger_index": 102609804,
5
"offers": [
6
{
7
"Account": "rsPrWzpYp5jj278vHVgp1tMvbKdHAZGFbi",
8
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04F8383682906C",
9
"BookNode": "0",
10
"Flags": 0,
11
"LedgerEntryType": "Offer",
12
"OwnerNode": "0",
13
"PreviousTxnID": "AD64BCFCEBDD521418F228FF1799B6E99A909E972C30FAE42CD15641874CF2E2",
14
"PreviousTxnLgrSeq": 102609513,
15
"Sequence": 9686350,
16
"TakerGets": "24921326",
17
"TakerPays": {
18
"currency": "USD",
19
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
20
"value": "34.86045479840703"
21
},
22
"index": "7175F381B8E2005C23DBF143940A1D20A29FC88772790646D06E4CF286283327",
23
"owner_funds": "1357947312",
24
"quality": "0.000001398820223225964"
25
},
26
{
27
"Account": "ra8jRjyCR7MTzDr2jeQBYSAwpT1aqYrTF4",
28
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04F8393121929F",
29
"BookNode": "0",
30
"Flags": 196608,
31
"LedgerEntryType": "Offer",
32
"OwnerNode": "12",
33
"PreviousTxnID": "0F2DD1CC77B89378E8726D2234E1ABADA2A4ACAAE642FC7C89C248B74D05B509",
34
"PreviousTxnLgrSeq": 102609758,
35
"Sequence": 98128172,
36
"TakerGets": "7148860",
37
"TakerPays": {
38
"currency": "USD",
39
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
40
"value": "10"
41
},
42
"index": "FA5E665C5A99F1B5D964C6EBC8035B44633C90ED2A973EDE25FBB6673638E41E",
43
"owner_funds": "120087159",
44
"quality": "0.000001398824427950751"
45
},
46
{
47
"Account": "rP4gybHF3astaSuih16DMpL16aFa6DjYkX",
48
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FB4C85356D40",
49
"BookNode": "0",
50
"Flags": 0,
51
"LedgerEntryType": "Offer",
52
"OwnerNode": "0",
53
"PreviousTxnID": "C0A83AEC11C89A524572E496A1F6D87DDAED4164655CABB80161DCE5D44CDF68",
54
"PreviousTxnLgrSeq": 102609797,
55
"Sequence": 1848423,
56
"TakerGets": "50000000",
57
"TakerPays": {
58
"currency": "USD",
59
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
60
"value": "70.11029889000001"
61
},
62
"index": "09E04F62431576E1295A44F064DE64EFB9DBA12B7B0EC8D3598E3D72B089A864",
63
"owner_funds": "1476717986",
64
"quality": "0.0000014022059778"
65
},
66
{
67
"Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
68
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FB90FA4C2800",
69
"BookNode": "0",
70
"Flags": 0,
71
"LedgerEntryType": "Offer",
72
"OwnerNode": "1",
73
"PreviousTxnID": "A1B2E490641769129FF12A2434132C759353006A85F8AD463B1BC1C151208CB4",
74
"PreviousTxnLgrSeq": 102609804,
75
"Sequence": 231811290,
76
"TakerGets": "196397000000",
77
"TakerPays": {
78
"currency": "USD",
79
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
80
"value": "275446.7925"
81
},
82
"index": "FF7E48A0092C0CA07ABEE7AFA7DDD07252BFB3F552366F494DE9BDA37BC86965",
83
"owner_funds": "196492741742",
84
"quality": "0.0000014025"
85
},
86
{
87
"Account": "r3rhWeE31Jt5sWmi4QiGLMZnY3ENgqw96W",
88
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FBF6FFDC7FA4",
89
"BookNode": "0",
90
"Flags": 0,
91
"LedgerEntryType": "Offer",
92
"OwnerNode": "181cc",
93
"PreviousTxnID": "824EDF057FB94BB9F25A880065EE432BCB41892A9A64B645000196C3A1BCB890",
94
"PreviousTxnLgrSeq": 102609791,
95
"Sequence": 157535619,
96
"TakerGets": "89388226525",
97
"TakerPays": {
98
"currency": "USD",
99
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
100
"value": "125406.1558352954"
101
},
102
"index": "7816BD0C78E8959E7B60C12335E477E14D40571511AC7F4D2C4FA46DA1F1694D",
103
"owner_funds": "174479944880",
104
"quality": "0.000001402938180009892"
105
},
106
{
107
"Account": "r3rhWeE31Jt5sWmi4QiGLMZnY3ENgqw96W",
108
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FBF6FFDC897A",
109
"BookNode": "0",
110
"Flags": 0,
111
"LedgerEntryType": "Offer",
112
"OwnerNode": "181cc",
113
"PreviousTxnID": "85B38A5024C15AA2C4B4EFB3520CA18DE100B621F41EB3FC3113607C7B1EA697",
114
"PreviousTxnLgrSeq": 102609791,
115
"Sequence": 157535618,
116
"TakerGets": "63522654453",
117
"TakerPays": {
118
"currency": "USD",
119
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
120
"value": "89118.35722784902"
121
},
122
"index": "D6300EDDE5F69BAC38FEBAC8100390F203AD6D1DC82CF214E73B90E6711C60F8",
123
"quality": "0.00000140293818001241"
124
},
125
{
126
"Account": "rNmp1eKUcH6fhENA286G6FEe1AEvpzDb9B",
127
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F04FCBFA855F000",
128
"BookNode": "0",
129
"Flags": 131072,
130
"LedgerEntryType": "Offer",
131
"OwnerNode": "3",
132
"PreviousTxnID": "0FA7F94E8B74E7722CD23133ECBBD32C7A3C0EE6563347F0CC2E419557EB79A8",
133
"PreviousTxnLgrSeq": 102601119,
134
"Sequence": 102053657,
135
"TakerGets": "3588602",
136
"TakerPays": {
137
"currency": "USD",
138
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
139
"value": "5.0376794876"
140
},
141
"index": "6BC49163BCA7D44DD688732B7FF8778FFA19C3433889EB3E09E7C21DBDBC3B7A",
142
"owner_funds": "162050446",
143
"quality": "0.0000014038"
144
},
145
{
146
"Account": "rhqs2GjSFoFUv97ANNwdgtegFApSCKwG13",
147
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F0504B528950600",
148
"BookNode": "0",
149
"Expiration": 825793729,
150
"Flags": 0,
151
"LedgerEntryType": "Offer",
152
"OwnerNode": "0",
153
"PreviousTxnID": "5697F97C2872E17D6F8630FFA9F8FAD8BB16EEE48BB37377A3B92FD27A39B3A6",
154
"PreviousTxnLgrSeq": 102602407,
155
"Sequence": 95000883,
156
"TakerGets": "29000000",
157
"TakerPays": {
158
"currency": "USD",
159
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
160
"value": "40.963979"
161
},
162
"index": "476858BA4ACA76223414959EA4F58FCC2A8F7C5F97C09ED97797710AD8DB6888",
163
"owner_funds": "344736457",
164
"quality": "0.000001412551"
165
},
166
{
167
"Account": "rNmp1eKUcH6fhENA286G6FEe1AEvpzDb9B",
168
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F050A92AEEFB000",
169
"BookNode": "0",
170
"Flags": 131072,
171
"LedgerEntryType": "Offer",
172
"OwnerNode": "3",
173
"PreviousTxnID": "E9EF4EA942ED3AA771828E6064E73669FD32F01BB3D9C9438FBB94C2029B185D",
174
"PreviousTxnLgrSeq": 102568581,
175
"Sequence": 102053622,
176
"TakerGets": "1416430",
177
"TakerPays": {
178
"currency": "USD",
179
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
180
"value": "2.00991417"
181
},
182
"index": "3699F9D1BA02737473C162710A78CE539C682B69727A655561A4126DB09EA863",
183
"quality": "0.000001419"
184
},
185
{
186
"Account": "rNmp1eKUcH6fhENA286G6FEe1AEvpzDb9B",
187
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4F050D7BBDCCB000",
188
"BookNode": "0",
189
"Flags": 131072,
190
"LedgerEntryType": "Offer",
191
"OwnerNode": "3",
192
"PreviousTxnID": "F42F7E984BEB195F2EC92FCCFE7D4F8F85BE7BDF8E296BA971BB5FA0456A0060",
193
"PreviousTxnLgrSeq": 102571465,
194
"Sequence": 102053626,
195
"TakerGets": "3618468",
196
"TakerPays": {
197
"currency": "USD",
198
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
199
"value": "5.1461851896"
200
},
201
"index": "9EA224CF7C0B59AA2B362232E346AF99F2F9E628E1CE70CFAFCD0035C0452F5E",
202
"quality": "0.0000014222"
203
}
204
],
205
"status": "success"
206
},
207
"warnings": [
208
{
209
"id": 2001,
210
"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"
211
}
212
]
213
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free