ledger_entry

[Source]

The ledger_entry method returns a single ledger object from the XAG Ledger in its raw format. See ledger format for information on the different types of objects you can retrieve.

Note: There is no commandline version of this method. You can use the json method to access this method from the commandline instead.

Request Format

An example of the request format:

{
  "id": 3,
  "command": "ledger_entry",
  "type": "account_root",
  "account_root": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
  "ledger_index": "validated"
}

{
    "method": "ledger_entry",
    "params": [
        {
            "account_root": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
            "ledger_index": "validated",
            "type": "account_root"
        }
    ]
}

Try it!

This method can retrieve several different types of data. You can select which type of item to retrieve by passing the appropriate parameters. Specifically, you should provide exactly one of the following fields:

1. index - Retrieve any type of ledger object by its unique ID
2. account_root - Retrieve an AccountRoot object. This is roughly equivalent to the account_info method.
3. directory - Retrieve a DirectoryNode, which contains a list of other ledger objects.
4. offer - Retrieve an Offer object, which defines an offer to exchange currency.
5. ripple_state - Retrieve a RippleState object, which tracks a (non-XAG ) currency balance between two accounts.
6. deposit_preauth - Retrieve a DepositPreauth object, which tracks preauthorization for payments to accounts requiring Deposit Authorization.

If you specify more than one of the above items, the server retrieves only one of them; it is undefined which it chooses.

The full list of parameters recognized by this method is as follows:

Field	Type	Description
index	String	(Optional) Specify the object ID of a single object to retrieve from the ledger.
account_root	String - Address	(Optional) Specify an AccountRoot object to retrieve.
check	String	(Optional) Specify the object ID of a Check object to retrieve.
deposit_preauth	Object or String	(Optional) Specify a DepositPreauth object to retrieve. If a string, must be the object ID of the DepositPreauth object, as hexadecimal. If an object, requires owner and authorized sub-fields.
deposit_preauth.owner	String - Address	(Required if deposit_preauth is specified as an object) The account that provided the preauthorization.
deposit_preauth.authorized	String - Address	(Required if deposit_preauth is specified as an object) The account that received the preauthorization.
directory	Object or String	(Optional) Specify a DirectoryNode to retrieve. If a string, must be the object ID of the directory, as hexadecimal. If an object, requires either dir_root or owner as a sub-field, plus optionally a sub_index sub-field.
directory.sub_index	Unsigned Integer	(Optional) If provided, jumps to a later "page" of the DirectoryNode.
directory.dir_root	String	(Required if directory is specified as an object and directory.owner is not provided) Unique index identifying the directory to retrieve, as a hex string.
directory.owner	String	(Required if directory is specified as an object and directory.dir_root is not provided) Unique address of the account associated with this directory.
offer	Object or String	(Optional) Specify an Offer object to retrieve. If a string, interpret as the unique index to the Offer. If an object, requires the sub-fields account and seq to uniquely identify the offer.
offer.account	String - Address	(Required if offer is specified) The account that placed the offer.
offer.seq	Unsigned Integer	(Required if offer is specified) The sequence number of the transaction that created the Offer object.
ripple_state	Object	(Optional) Object specifying the RippleState (trust line) object to retrieve. The accounts and currency sub-fields are required to uniquely specify the RippleState entry to retrieve.
ripple_state.accounts	Array	(Required if ripple_state is specified) 2-length array of account Addresses, defining the two accounts linked by this RippleState object.
ripple_state.currency	String	(Required if ripple_state is specified) Currency Code of the RippleState object to retrieve.
binary	Boolean	(Optional) If true, return the requested ledger object's contents as a hex string. Otherwise, return data in JSON format. The default is false.
ledger_hash	String	(Optional) A 20-byte hex string for the ledger version to use. (See Specifying Ledgers)
ledger_index	String or Unsigned Integer	(Optional) The ledger index of the ledger to use, or a shortcut string to choose a ledger automatically. (See Specifying Ledgers)

The generator and ledger parameters are deprecated and may be removed without further notice.

Response Format

An example of a successful response:

    "id": 3,
    "result": {
        "index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05",
        "ledger_index": 6889347,
        "node": {
            "Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
            "Balance": "27389517749",
            "Flags": 0,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 18,
            "PreviousTxnID": "B6B410172C0B65575D89E464AF5B99937CC568822929ABF87DA75CBD11911932",
            "PreviousTxnLgrSeq": 6592159,
            "Sequence": 1400,
            "index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
        }
    },
    "status": "success",
    "type": "response"
}

200 OK
{
    "result": {
        "index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05",
        "ledger_index": 8696234,
        "node": {
            "Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
            "Balance": "13176802787",
            "Flags": 0,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 17,
            "PreviousTxnID": "E5D0235A236F7CD162C1AB87A0325056AE61CFC63D92D1494AB5D826AAD0CDCA",
            "PreviousTxnLgrSeq": 8554742,
            "Sequence": 1406,
            "index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
        },
        "status": "success",
        "validated": true
    }
}

The response follows the standard format, with a successful result containing the following fields:

Possible Errors

• Any of the universal error types.
• deprecatedFeature - The request specified a removed field, such as generator.
• entryNotFound - The requested ledger object does not exist in the ledger.
• invalidParams - One or more fields are specified incorrectly, or one or more required fields are missing.
• lgrNotFound - The ledger specified by the ledger_hash or ledger_index does not exist, or it does exist but the server does not have it.
• malformedAddress - The request improperly specified an Address field.
• malformedCurrency - The request improperly specified a Currency Code field.
• malformedRequest - The request provided an invalid combination of fields, or provided the wrong type for one or more fields.
• unknownOption - The fields provided in the request did not match any of the expected request formats.