Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save akirattii/bfa5500f90d328fa2840c9d1a93c32e2 to your computer and use it in GitHub Desktop.
Save akirattii/bfa5500f90d328fa2840c9d1a93c32e2 to your computer and use it in GitHub Desktop.
Ripple: Understand rippled `book_offers` request & response

Ripple: Understand rippled book_offers request & response

Request example (on TestNet)

{
  "id": 4,
  "command": "book_offers",
  "taker": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
  "taker_gets": {
    "currency": "XRP"
  },
  "taker_pays": {
    "currency": "USD",
    "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
  },
  "limit": 10
}

Above means that the order taker (r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59) buys XRP/USD.
In other words, the order taker (r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59) sells USD for XRP.

Response

{
  "id": 4,
  "result": {
    "ledger_current_index": 11796819,
    "offers": [
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4B03F28CB71571C7",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000003",
        "PreviousTxnID": "EDB35BA037305CAB8D2F97DE0820F8BEB1BB220ECE8E3F890A59A94A2653E61A",
        "PreviousTxnLgrSeq": 11393589,
        "Sequence": 442,
        "TakerGets": "9000000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "B1D154AE65E3673674E54EB900A2E7625D7EF822DC99E0E743189BDBA6A736F3",
        "owner_funds": "13038994526",
        "quality": "0.0000000001111111111111111"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C0FCA32DC55C71C",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000002",
        "PreviousTxnID": "6A179A02C091E918D86D20741D7192542F4B8EA17DFE98FBF23EB1B889F8B50E",
        "PreviousTxnLgrSeq": 11303320,
        "Sequence": 367,
        "TakerGets": "450000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "2"
        },
        "index": "35089EAC31EA16350CA6D711AB578400D6ED68BC0F500DC6906E1DCBD19B03FE",
        "quality": "0.000000004444444444444444"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C11C37937E08000",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000002",
        "PreviousTxnID": "5C881057295F9D2B9720E0C74C88EF6AC15F75C186420913410BBBCC9AE18694",
        "PreviousTxnLgrSeq": 11303158,
        "Sequence": 366,
        "TakerGets": "200000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "3C38DC5F284A6E3BAAD9DC474451F047A3E3697B680D64484F20B99D95BBACD6",
        "quality": "0.000000005"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C1CE2440FEE14D0",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000001",
        "PreviousTxnID": "AC5026BE9334804B7881466124C75AA15BC5EBCADA9D9CA1A16A8BAF7B9D00E6",
        "PreviousTxnLgrSeq": 10813363,
        "Sequence": 231,
        "TakerGets": "123000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "D765960AC7238F5E202C7A605FC3E5A076431910F715A1ECCB17295B9483A652",
        "quality": "0.000000008130081300813008"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C22D49D5E80FAFB",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000002",
        "PreviousTxnID": "9540FC1F1DEF9AE348150ECE45C987C617C0520A6CA77A48261C6079F1A18ECE",
        "PreviousTxnLgrSeq": 11215118,
        "Sequence": 334,
        "TakerGets": "102000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "11D9AA0676877AD54CD68836A613B42461F85FA8B98B3CE29005C89B29D6259E",
        "quality": "0.000000009803921568627451"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C232CE5E5C6B16D",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000002",
        "PreviousTxnID": "9A4A299A444E4F388827CB2E4FE7CA0AC97228DBC8CA8F9E7F34BEF40C8DDC17",
        "PreviousTxnLgrSeq": 11215097,
        "Sequence": 332,
        "TakerGets": "101000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "6AC231A11AB8FCB2CA997D0A3E5AA84A2B5568BAB7A76E845606C0E04D559B61",
        "quality": "0.000000009900990099009901"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4D038D7EA4C68000",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000001",
        "PreviousTxnID": "0FFCB68C22E8EF3661B0DE26790B87E3FB99577115C6B61CF2175333A2881695",
        "PreviousTxnLgrSeq": 10813179,
        "Sequence": 227,
        "TakerGets": "100000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "CC03D9AEC7EB3EDFBC754650F17E59FFAF438A1699B0FB8F9F1F4CD3194CDAC2",
        "quality": "0.00000001"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4D038D7EA4C68000",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000001",
        "PreviousTxnID": "D7769082713CE36ECF9CDCEB37A1368D9C662F19D953D828DF8214F1FA82C76A",
        "PreviousTxnLgrSeq": 10813302,
        "Sequence": 230,
        "TakerGets": "100000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "9C74D8964456C8D1FC580D96F10142293947DC4C900274D8861CBEFAC26F8DDC",
        "quality": "0.00000001"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4D0675A07168E8BA",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000002",
        "PreviousTxnID": "413FF9986A05936B46B8376A8A7BA324CB6421840E50A63F14B28D87C7871635",
        "PreviousTxnLgrSeq": 11303150,
        "Sequence": 365,
        "TakerGets": "55000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "10DE519CC1A8CEB8C953A186AD8CC93BB24E6F251E363FE772A33A692F8C3A80",
        "quality": "0.00000001818181818181818"
      },
      {
        "Account": "rpWQ3d3X8iXMARHxWM6gEH364BjmCCKNbj",
        "BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4D1D9B1F5D20D555",
        "BookNode": "0000000000000000",
        "Flags": 0,
        "LedgerEntryType": "Offer",
        "OwnerNode": "0000000000000001",
        "PreviousTxnID": "CA4BDCDDCC42194F831F1608CB9CEE1B07AA804C6BDA3A8536C563D498826390",
        "PreviousTxnLgrSeq": 10813472,
        "Sequence": 233,
        "TakerGets": "12000000",
        "TakerPays": {
          "currency": "USD",
          "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
          "value": "1"
        },
        "index": "F6CF114C92C80A11ACB9B4E3FE19D6645AAFBBD8CFF3F4D7D8D328049F298086",
        "quality": "0.00000008333333333333333"
      }
    ],
    "validated": false
  },
  "status": "success",
  "type": "response"
}

OK, now look at the below part of above book_offers response:

...
"TakerGets": "100000000",
"TakerPays": {
  "currency": "USD",
  "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
  "value": "1"
},
"index": "9C74D8964456C8D1FC580D96F10142293947DC4C900274D8861CBEFAC26F8DDC",
"quality": "0.00000001"
...

This part means that Taker gets (buys) 100000000 XRP/USD at rate: 0.00000001.
In other words, Taker gets (buys) 100000000 XRP at price: 0.00000001 USD per XRP.

NOTE: The USD's issued by rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment