ledger
Retrieve information about the public ledger.
Request Format
An example of the request format:
The request can contain the following parameters:
The ledger
field is deprecated and may be removed without further notice. The full
, accounts
, and type
fields (admin-only) are also deprecated; the Clio server does not implement these parameters.
Response Format
An example of a successful response:
The response follows the [standard format][], with a successful result containing information about the ledger, including the following fields:
The ledger.accountState
field (omitted unless requested with "full": true
or "accounts": true
) is deprecated.
The following deprecated fields have been removed: accepted
, hash
(use ledger_hash
instead), seqNum
(use ledger_index
instead), totalCoins
(use total_coins
instead).
Updated in: rippled 1.12.0
Each member of the queue_data
array represents one transaction in the queue. Some fields of this object may be omitted because they have not yet been calculated. The fields of this object are as follows:
If the request specified "owner_funds": true
and expanded transactions, the response has a field owner_funds
in the metaData
object of each [OfferCreate transaction][]. The purpose of this field is to make it easier to track the funding status of offers with each new validated ledger. This field is defined slightly differently than the version of this field in Order Book subscription streams:
Possible Errors
Any of the [universal error types][].
invalidParams
- One or more fields are specified incorrectly, or one or more required fields are missing.lgrNotFound
- The ledger specified by theledger_hash
orledger_index
does not exist, or it does exist but the server does not have it.noPermission
- If you specifiedfull
oraccounts
as true, but are not connected to the server as an admin (usually, admin requires connecting on localhost).
Last updated