Parameters
The book_offers request object.
The account that is taking the offers
The details of the asset the taker wants to acquire. It contains the following properties:
The currency code of the asset
The details of the asset the taker is willing to give in exchange. It contains the following properties:
The currency code of the asset
The issuer of the asset
The maximum number of offers to retrieve
Returns
An object which contains the following fields:
The hash of the ledger containing the offers
The index of the ledger containing the offers
A list of offers with the following properties:
(Optional) The amount of the currency that the offering side has available for trading
(Optional) The maximum amount of currency that the taker can get provided the funding status
(Optional) The maximum amount of currency that the taker would pay provided the funding status
The exchange rate, as the ratio 'taker_pays' divided by 'taker_gets'
The account that placed the offer
The order book directory index
The order book node index
The flags on the offer
The ledger entry type
The owner directory node index
The hash of the previous transaction
The ledger index of the previous transaction
The sequence number of the offer
The amount the taker receives
The amount the taker pays
The ledger entry index of the offer
(Optional) It indicates whether the result has been validated
The status of the request
(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
The ID of the warning
The warning message
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}