Honeycluster Docs – Get account information

Account Methods

Get account information

wss://honeycluster.io

rpc method: account_info

Retrieves information about an account, its activity, and its XRP balance. This is one of the most commonly used methods.

Try it now

Response · account_info WS Response

{
  "result": {
    "account_data": {
      "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
      "Balance": "10234567890",
      "Flags": 0,
      "LedgerEntryType": "AccountRoot",
      "OwnerCount": 3,
      "PreviousTxnID": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
      "PreviousTxnLgrSeq": 89012340,
      "Sequence": 42
    },
    "ledger_index": 89012345,
    "validated": true
  },
  "status": "success",
  "type": "response",
  "id": 1
}

Request Message

account_info WS Request

application/json

Get account information

Field	Type	Description
`command` required	string	WebSocket command name
`id`	object	Client-supplied identifier to correlate requests with responses.
`account`	string	The account to retrieve info for.
`ledger_index`	object	A ledger index (sequence number) or shortcut string identifying which ledger to use.
`ledger_hash`	string	256-bit hex hash identifying a specific ledger version.
`queue`	boolean	If true, include information about queued transactions sent by this account.
`signer_lists`	boolean	If true, include the account's SignerList object(s) in the response.
`strict`	boolean	If true, only accept an account address in the proper base58 format.
`api_version`	object	API version for the response format. Version 2 is the default for rippled 2.0+.

Example

Json

{
  "command": "account_info",
  "id": 1,
  "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
  "ledger_index": "validated",
  "queue": true,
  "signer_lists": true
}

Response Message

account_info WS Response

application/json

WebSocket response for account_info

Field	Type	Description
`result`	object
`status`	enum<string>	Available `successerror`
`type`	string
`id`	stringnumber	Echo of the client-provided correlation ID

Example

Json

{
  "result": {
    "account_data": {
      "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
      "Balance": "10234567890",
      "Flags": 0,
      "LedgerEntryType": "AccountRoot",
      "OwnerCount": 3,
      "PreviousTxnID": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
      "PreviousTxnLgrSeq": 89012340,
      "Sequence": 42
    },
    "ledger_index": 89012345,
    "validated": true
  },
  "status": "success",
  "type": "response",
  "id": 1
}

Request

Payload · JSON

const ws = new WebSocket('wss://honeycluster.io');

ws.addEventListener('open', () => {
  const request = {
    "command": "account_info",
    "id": 1,
    "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
    "ledger_index": "validated",
    "queue": true,
    "signer_lists": true
  };
  ws.send(JSON.stringify(request));
});

ws.addEventListener('message', (event: MessageEvent<string>) => {
  const response: unknown = JSON.parse(event.data);
  console.log(response);
  ws.close();
});

Response · account_info WS Response

{
  "result": {
    "account_data": {
      "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
      "Balance": "10234567890",
      "Flags": 0,
      "LedgerEntryType": "AccountRoot",
      "OwnerCount": 3,
      "PreviousTxnID": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
      "PreviousTxnLgrSeq": 89012340,
      "Sequence": 42
    },
    "ledger_index": 89012345,
    "validated": true
  },
  "status": "success",
  "type": "response",
  "id": 1
}