Public rippled Methods

Communicate directly with a rippled server using the following public API methods. Public methods are not necessarily meant for the general public, but they are used by any client attached to the server. Think of public methods as being for members or customers of the organization running the server.

Account Methods

An account in the XRP Ledger represents a holder of XRP and a sender of transactions. Use these methods to work with account info.

Ledger Methods

A ledger version contains a header, a transaction tree, and a state tree, which contain account settings, trust lines, balances, transactions, and other data. Use these methods to retrieve ledger info.

Transaction Methods

Transactions are the only thing that can modify the shared state of the XRP Ledger. All business on the XRP Ledger takes the form of transactions. Use these methods to work with transactions.

  • sign - Cryptographically sign a transaction.
  • sign_for - Contribute to a multi-signature.
  • submit - Send a transaction to the network.
  • submit_multisigned - Send a multi-signed transaction to the network.
  • transaction_entry - Retrieve info about a transaction from a particular ledger version.
  • tx - Retrieve info about a transaction from all the ledgers on hand.
  • tx_history - Retrieve info about all recent transactions.

Path and Order Book Methods

Paths define a way for payments to flow through intermediary steps on their way from sender to receiver. Paths enable cross-currency payments by connecting sender and receiver through order books. Use these methods to work with paths and other books.

  • book_offers - Get info about offers to exchange two currencies.
  • deposit_authorized - Look up whether one account is authorized to send payments directly to another.
  • path_find - Find a path for a payment between two accounts and receive updates.
  • ripple_path_find - Find a path for payment between two accounts, once.

Payment Channel Methods

Payment channels are a tool for facilitating repeated, unidirectional payments, or temporary credit between two parties. Use these methods to work with payment channels.

Subscription Methods

Use these methods to enable the server to push updates to your client when various events happen, so that you can know and react right away. WebSocket API only.

  • subscribe - Listen for updates about a particular subject.
  • unsubscribe - Stop listening for updates about a particular subject.

Server Info Methods

Use these methods to retrieve information about the current state of the rippled server.

  • fee - Get information about transaction cost.
  • server_info - Retrieve status of the server in human-readable format.
  • server_state - Retrieve status of the server in machine-readable format.
  • manifest - Retrieve the latest ephemeral public key information about a known validator.

Utility Methods

Use these methods to perform convenient tasks, such as ping and random number generation.

  • json - Use as a proxy to running other commands. Accepts the parameters for the command as a JSON value. Commandline only.
  • ping - Confirm connectivity with the server.
  • random - Generate a random number.

Deprecated Methods

The owner_info command is deprecated. Use account_objects instead.