ARCHIVE/xrpl-dev-portal
1
0
Fork 0
mirror of https://github.com/XRPLF/xrpl-dev-portal.git synced 2025-11-05 04:15:50 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
8fe388de6fab69f9299b014025c28030e87fde08
xrpl-dev-portal/rippled-apis.html

7270 lines
356 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width">
<title>Ripple Developer Portal: rippled APIs</title>
<!-- favicon -->
<link rel="icon" href="favicon.ico" type="image/x-icon">
<link rel="shortcut icon" href="favicon.ico" type="image/x-icon">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
<!-- Flatdoc -->
<script src="https://dev.ripple.com/vendor/flatdoc/v/0.8.0/legacy.js"></script>
<script src="https://dev.ripple.com/vendor/flatdoc/v/0.8.0/flatdoc.js"></script>
<!-- Bootstrap -->
<link href="css/bootstrap.min.css" rel="stylesheet">
<script src="js/bootstrap.min.js"></script>
<!-- Flatdoc theme -->
<link href="vendor/flatdoc/v/0.8.0/theme-white/style.css" rel="stylesheet">
<script src="vendor/flatdoc/v/0.8.0/theme-white/script.js"></script>
<!-- Custom Stylesheets -->
<link href="https://fonts.googleapis.com/css?family=Montserrat" rel="stylesheet" type="text/css">
<link href="https://fonts.googleapis.com/css?family=Open+Sans:600italic,400,700,300" rel="stylesheet" type="text/css">
<link href="css/main.css" rel="stylesheet">
<link href="css/custom.css" rel="stylesheet">
<link rel="shortcut icon" href="favicon.ico?v=2" type="image/x-icon">
<link rel="icon" href="favicon.ico?v=2" type="image/x-icon">
<!-- start Mixpanel -->
<script type="text/javascript">(function(e,b){if(!b.__SV){var a,f,i,g;window.mixpanel=b;a=e.createElement("script");a.type="text/javascript";a.async=!0;a.src=("https:"===e.location.protocol?"https:":"http:")+'//cdn.mxpnl.com/libs/mixpanel-2.2.min.js';f=e.getElementsByTagName("script")[0];f.parentNode.insertBefore(a,f);b._i=[];b.init=function(a,e,d){function f(b,h){var a=h.split(".");2==a.length&&(b=b[a[0]],h=a[1]);b[h]=function(){b.push([h].concat(Array.prototype.slice.call(arguments,0)))}}var c=b;"undefined"!==
typeof d?c=b[d]=[]:d="mixpanel";c.people=c.people||[];c.toString=function(b){var a="mixpanel";"mixpanel"!==d&&(a+="."+d);b||(a+=" (stub)");return a};c.people.toString=function(){return c.toString(1)+".people (stub)"};i="disable track track_pageview track_links track_forms register register_once alias unregister identify name_tag set_config people.set people.set_once people.increment people.append people.track_charge people.clear_charges people.delete_user".split(" ");for(g=0;g<i.length;g++)f(c,i[g]);
b._i.push([a,e,d])};b.__SV=1.2}})(document,window.mixpanel||[]);
mixpanel.init("132d42885e094171f34467fc54da6fab");
</script>
<script>if (window.location.host == "dev.ripple.com") { mixpanel.track("rippled-apis"); }</script>
<!-- end Mixpanel -->
<!-- start google analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-49188512-1', 'ripple.com');
ga('send', 'pageview');
</script>
<!-- end google analytics -->
<!-- syntax selection js -->
<script src="js/multicodetab.js"></script>
<!-- Code to load Flatdoc; commented out on compiled page
<script>
$(".flatdoc-content").empty();
$(".content-root .menubar .menu").empty();
Flatdoc.run({
fetcher: Flatdoc.file('websocket_api.md')
});
$(document).on('flatdoc:ready', $().multicode_tabs);
</script>
<!-- end flatdoc load -->
<!-- Alternate multicode tabs for compiled page: -->
<script>
$(document).ready(function() {
$(".multicode").minitabs()
make_code_expandable();
});
</script>
<!--end alt code for compiled page -->
<link type="text/css" rel="stylesheet" href="css/mod.css">
<script src="js/expandcode.js"></script>
<script src="js/fixsidebarscroll.js"></script>
</head>
<body role="flatdoc" class="no-literate">
<div class="navbar navbar-inverse navbar-fixed-top" role="navigation">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="https://dev.ripple.com/"><img class="small_logo" src="assets/img/ripple_logo_small.png"></a>
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="active"><a href="/">Resources</a></li>
<li><a href="https://www.bountysource.com/teams/ripple/bounties">Bounties</a></li>
<li><a href="https://ripplelabs.atlassian.net/">Bug Tracking</a></li>
<li><a href="https://ripple.com/dev/blog/">Dev Blog</a></li>
<li><a href="https://ripple.com/forum/viewforum.php?f=2&amp;sid=c016bc6b934120b7117c0e136e74de98">Forums</a></li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">API Tool <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="ripple-api-tool.html">WebSocket Tool</a></li>
<li><a href="rest-api-tool.html">REST Tool</a></li>
</ul>
</li>
</ul>
<div class="right">
<!-- GitHub buttons -->
<iframe width="110" height="20" frameborder="0" src="https://dev.ripple.com/vendor/ghbtn.html?user=ripple&amp;repo=ripple-dev-portal&amp;type=watch&amp;count=true" allowtransparency="true" scrolling="0"></iframe>
</div>
</div><!--/.nav-collapse -->
</div>
</div>
<div class="content-root">
<div class="menubar">
<div class="menu section" role="flatdoc-menu">
<ul><li class="level-0" id="root-item"><ul id="root-list" class="level-1"><li class="level-1" id="websocket-and-json-rpc-apis-item"><a class="level-1" href="#websocket-and-json-rpc-apis" id="websocket-and-json-rpc-apis-link">WebSocket and JSON-RPC APIs</a><ul id="websocket-and-json-rpc-apis-list" class="level-2"><li class="level-2" id="changes-to-the-apis-item"><a class="level-2" href="#changes-to-the-apis" id="changes-to-the-apis-link">Changes to the APIs</a></li><li class="level-2" id="connecting-to-rippled-item"><a class="level-2" href="#connecting-to-rippled" id="connecting-to-rippled-link">Connecting to rippled</a><ul id="connecting-to-rippled-list" class="level-3"><li class="level-3" id="reasons-to-run-your-own-rippled-item"><a class="level-3" href="#reasons-to-run-your-own-rippled" id="reasons-to-run-your-own-rippled-link">Reasons to Run Your Own rippled</a></li><li class="level-3" id="websocket-api-item"><a class="level-3" href="#websocket-api" id="websocket-api-link">WebSocket API</a></li><li class="level-3" id="json-rpc-item"><a class="level-3" href="#json-rpc" id="json-rpc-link">JSON-RPC</a></li><li class="level-3" id="commandline-item"><a class="level-3" href="#commandline" id="commandline-link">Commandline</a></li></ul></li><li class="level-2" id="request-formatting-item"><a class="level-2" href="#request-formatting" id="request-formatting-link">Request Formatting</a></li><li class="level-2" id="response-formatting-item"><a class="level-2" href="#response-formatting" id="response-formatting-link">Response Formatting</a></li><li class="level-2" id="error-responses-item"><a class="level-2" href="#error-responses" id="error-responses-link">Error Responses</a><ul id="error-responses-list" class="level-3"><li class="level-3" id="caution-on-errors-item"><a class="level-3" href="#caution-on-errors" id="caution-on-errors-link">Caution on Errors</a></li></ul></li><li class="level-2" id="formatting-conventions-item"><a class="level-2" href="#formatting-conventions" id="formatting-conventions-link">Formatting Conventions</a><ul id="formatting-conventions-list" class="level-3"><li class="level-3" id="unique-identifiers-item"><a class="level-3" href="#unique-identifiers" id="unique-identifiers-link">Unique Identifiers</a></li><li class="level-3" id="specifying-a-ledger-instance-item"><a class="level-3" href="#specifying-a-ledger-instance" id="specifying-a-ledger-instance-link">Specifying a Ledger Instance</a></li><li class="level-3" id="specifying-currency-amounts-item"><a class="level-3" href="#specifying-currency-amounts" id="specifying-currency-amounts-link">Specifying Currency Amounts</a></li><li class="level-3" id="specifying-time-item"><a class="level-3" href="#specifying-time" id="specifying-time-link">Specifying Time</a></li><li class="level-3" id="possible-server-states-item"><a class="level-3" href="#possible-server-states" id="possible-server-states-link">Possible Server States</a></li></ul></li><li class="level-2" id="modifying-the-ledger-item"><a class="level-2" href="#modifying-the-ledger" id="modifying-the-ledger-link">Modifying the Ledger</a></li></ul></li><li class="level-1" id="api-methods-item"><a class="level-1" href="#api-methods" id="api-methods-link">API Methods</a><ul id="api-methods-list" class="level-2"><li class="level-2" id="list-of-public-commands-item"><a class="level-2" href="#list-of-public-commands" id="list-of-public-commands-link">List of Public Commands</a></li><li class="level-2" id="admin-commands-item"><a class="level-2" href="#admin-commands" id="admin-commands-link">Admin Commands</a></li><li class="level-2" id="commandline-access-item"><a class="level-2" href="#commandline-access" id="commandline-access-link">Commandline Access</a></li></ul></li><li class="level-1" id="managing-accounts-item"><a class="level-1" href="#managing-accounts" id="managing-accounts-link">Managing Accounts</a><ul id="managing-accounts-list" class="level-2"><li class="level-2" id="account-info-item"><a class="level-2" href="#account-info" id="account-info-link">account_info</a></li><li class="level-2" id="account-lines-item"><a class="level-2" href="#account-lines" id="account-lines-link">account_lines</a></li><li class="level-2" id="account-offers-item"><a class="level-2" href="#account-offers" id="account-offers-link">account_offers</a></li><li class="level-2" id="account-tx-item"><a class="level-2" href="#account-tx" id="account-tx-link">account_tx</a></li><li class="level-2" id="wallet-propose-item"><a class="level-2" href="#wallet-propose" id="wallet-propose-link">wallet_propose</a></li></ul></li><li class="level-1" id="managing-ledgers-item"><a class="level-1" href="#managing-ledgers" id="managing-ledgers-link">Managing Ledgers</a><ul id="managing-ledgers-list" class="level-2"><li class="level-2" id="ledger-item"><a class="level-2" href="#ledger" id="ledger-link">ledger</a></li><li class="level-2" id="ledger-closed-item"><a class="level-2" href="#ledger-closed" id="ledger-closed-link">ledger_closed</a></li><li class="level-2" id="ledger-current-item"><a class="level-2" href="#ledger-current" id="ledger-current-link">ledger_current</a></li><li class="level-2" id="ledger-data-item"><a class="level-2" href="#ledger-data" id="ledger-data-link">ledger_data</a></li><li class="level-2" id="ledger-entry-item"><a class="level-2" href="#ledger-entry" id="ledger-entry-link">ledger_entry</a></li></ul></li><li class="level-1" id="managing-transactions-item"><a class="level-1" href="#managing-transactions" id="managing-transactions-link">Managing Transactions</a><ul id="managing-transactions-list" class="level-2"><li class="level-2" id="tx-item"><a class="level-2" href="#tx" id="tx-link">tx</a></li><li class="level-2" id="transaction-entry-item"><a class="level-2" href="#transaction-entry" id="transaction-entry-link">transaction_entry</a></li><li class="level-2" id="tx-history-item"><a class="level-2 active" href="#tx-history" id="tx-history-link">tx_history</a></li><li class="level-2" id="path-find-item"><a class="level-2" href="#path-find" id="path-find-link">path_find</a><ul id="path-find-list" class="level-3"><li class="level-3" id="path-find-create-item"><a class="level-3" href="#path-find-create" id="path-find-create-link">path_find create</a></li><li class="level-3" id="path-find-close-item"><a class="level-3" href="#path-find-close" id="path-find-close-link">path_find close</a></li><li class="level-3" id="path-find-status-item"><a class="level-3" href="#path-find-status" id="path-find-status-link">path_find status</a></li></ul></li><li class="level-2" id="ripple-path-find-item"><a class="level-2" href="#ripple-path-find" id="ripple-path-find-link">ripple_path_find</a></li><li class="level-2" id="sign-item"><a class="level-2" href="#sign" id="sign-link">sign</a></li><li class="level-2" id="submit-item"><a class="level-2" href="#submit" id="submit-link">submit</a><ul id="submit-list" class="level-3"><li class="level-3" id="submit-only-mode-item"><a class="level-3" href="#submit-only-mode" id="submit-only-mode-link">Submit-Only Mode</a></li><li class="level-3" id="sign-and-submit-mode-item"><a class="level-3" href="#sign-and-submit-mode" id="sign-and-submit-mode-link">Sign-and-Submit Mode</a></li></ul></li><li class="level-2" id="book-offers-item"><a class="level-2" href="#book-offers" id="book-offers-link">book_offers</a></li></ul></li><li class="level-1" id="subscriptions-item"><a class="level-1" href="#subscriptions" id="subscriptions-link">Subscriptions</a><ul id="subscriptions-list" class="level-2"><li class="level-2" id="subscribe-item"><a class="level-2" href="#subscribe" id="subscribe-link">subscribe</a><ul id="subscribe-list" class="level-3"><li class="level-3" id="subscription-stream-messages-item"><a class="level-3" href="#subscription-stream-messages" id="subscription-stream-messages-link">Subscription Stream Messages</a></li></ul></li><li class="level-2" id="unsubscribe-item"><a class="level-2" href="#unsubscribe" id="unsubscribe-link">unsubscribe</a></li></ul></li><li class="level-1" id="server-information-item"><a class="level-1" href="#server-information" id="server-information-link">Server Information</a><ul id="server-information-list" class="level-2"><li class="level-2" id="server-info-item"><a class="level-2" href="#server-info" id="server-info-link">server_info</a></li><li class="level-2" id="server-state-item"><a class="level-2" href="#server-state" id="server-state-link">server_state</a></li></ul></li><li class="level-1" id="convenience-functions-item"><a class="level-1" href="#convenience-functions" id="convenience-functions-link">Convenience Functions</a><ul id="convenience-functions-list" class="level-2"><li class="level-2" id="ping-item"><a class="level-2" href="#ping" id="ping-link">ping</a></li><li class="level-2" id="random-item"><a class="level-2" href="#random" id="random-link">random</a></li><li class="level-2" id="json-item"><a class="level-2" href="#json" id="json-link">json</a></li></ul></li></ul></li></ul>
</div>
</div>
<div role="flatdoc-content" class="content">
<h1 id="websocket-and-json-rpc-apis">WebSocket and JSON-RPC APIs</h1><p>If you want to communicate directly with the <code title="Double-click to expand/collapse">rippled</code> server, you have three fairly similar options for how to do that. All of these APIs use the same list of commands, with almost entirely the same parameters in each command. Whereas the <a href="ripple-rest.html">Ripple-REST API</a> provides a simplified interface on top of the WebSocket API for easier integration, these APIs provide the full power of Ripple but require slightly more complexity:</p><ul>
<li>The WebSocket API uses the <a href="http://www.html5rocks.com/en/tutorials/websockets/basics/">WebSocket protocol</a>, available in most browsers and Javascript implementations, to achieve persistent two-way communication. There is not a 1:1 correlation between requests and responses. Some requests prompt the server to send multiple messages back asynchronously; other times, responses may arrive in a different order than the requests that prompted them. </li>
<li>The JSON-RPC API relies on simple request-response communication via HTTP. For commands that prompt multiple responses, you can provide a callback URL.</li>
<li>The <code title="Double-click to expand/collapse">rippled</code> program can also be used as a quick commandline client to make JSON-RPC requests to a running <code title="Double-click to expand/collapse">rippled</code> server. This is only intended for administrative purposes, and is not a supported API.</li>
</ul><p>In general, we recommend using WebSocket, because WebSocket’s push paradigm has less latency and less network overhead. JSON-RPC must open and close an HTTP connection for each individual message. WebSocket is also more reliable; you can worry less about missing messages and establishing multiple connections. However, all three have valid use cases and will continue to be supported for the foreseeable future.</p><h2 id="changes-to-the-apis">Changes to the APIs</h2><p>The WebSocket and JSON-RPC APIs are still in development, and are subject to change. If you want to be notified of upcoming changes and future versions of <code title="Double-click to expand/collapse">rippled</code>, subscribe to the Ripple Server mailing list:</p><p><a href="https://groups.google.com/forum/#!forum/ripple-server">https://groups.google.com/forum/#!forum/ripple-server</a></p><h2 id="connecting-to-rippled">Connecting to rippled</h2><p>Before you can run any commands against a <code title="Double-click to expand/collapse">rippled</code> server, you must know which server you are connecting to. Most servers are configured not to accept requests directly from the outside network. </p><p>Alternatively, you can run your own local copy of <a href="https://ripple.com/wiki/Rippled"><code title="Double-click to expand/collapse">rippled</code></a>. This is required if you want to access any of the <a href="#List-of-Admin-Commands">Admin Commands</a>. In this case, you should use whatever IP and port you configured the server to bind. (For example, <code title="Double-click to expand/collapse">127.0.0.1:54321</code>)</p><h3 id="reasons-to-run-your-own-rippled">Reasons to Run Your Own rippled</h3><p>There are lots of reasons you might want to run your own <code title="Double-click to expand/collapse">rippled</code> server, but most of them can be summarized as: you can trust your own server, you have control over its workload, and you’re not at the mercy of others to decide when and how you can access it.</p><p>It is important that you can trust the <code title="Double-click to expand/collapse">rippled</code> you use, so you can be certain that the software you are running will behave in the manner specified in its source code. Of course, you must also practice good network security to protect your server from malicious hackers. If you connect to a malicious server, there are myriad ways that it can take advantage of you or cause you to lose money. For example:</p><ul>
<li>A malicious server could report that you were paid when no such payment was made</li>
<li>It could selectively show or hide payment paths and currency exchange offers to guarantee its own profit while not providing you the best deal</li>
<li>If you sent it your account’s secret, it could make arbitrary transactions on your behalf, and even transfer or destroy all the money in your account’s balances.</li>
</ul><p>Additionally, running your own server gives you admin control over it, which allows you to run important admin-only and load-intensive commands. If you use a shared server, you have to worry about other users of the same server competing with you for the server’s computing power. Many of the commands in the WebSocket API can put a lot of strain on the server, so <code title="Double-click to expand/collapse">rippled</code> has the option to scale back its responses when it needs to. If you share a server with others, you may not always get the best results possible.</p><h3 id="websocket-api">WebSocket API</h3><p>If you are just looking to try out some methods on the Ripple network, you can skip writing your own WebSocket code and go straight to using the API at the <a href="ripple-api-tool.html">Ripple WebSocket API Tool</a>. Later on, when you want to connect to your own <code title="Double-click to expand/collapse">rippled</code> server, you can build your own client in Javascript to run in a browser (See <a href="http://www.websocket.org/echo.html">this example</a> ) or possibly <a href="https://github.com/einaros/ws">Node.js</a>.</p><p>Currently Ripple Labs maintains a set of public WebSocket servers at:</p><table>
<thead>
<tr>
<th>Domain</th>
<th>Port</th>
</tr>
</thead>
<tbody>
<tr>
<td>s1.ripple.com</td>
<td>443</td>
</tr>
</tbody>
</table><p>These public servers are not for sustained or business use, and they may become unavailable at any time. For regular use, you should run your own <code title="Double-click to expand/collapse">rippled</code> server or contract someone you trust to do so.</p><h3 id="json-rpc">JSON-RPC</h3><p>You can use any HTTP client (like <a href="https://addons.mozilla.org/en-US/firefox/addon/poster/">Poster for Firefox</a> or <a href="https://chrome.google.com/webstore/detail/postman-rest-client/fdmmgilgnpjigdojojpjoooidkmcomcm?hl=en">Postman for Chrome</a>) to make JSON-RPC calls a <code title="Double-click to expand/collapse">rippled</code> server. </p><p>Currently, Ripple Labs maintains a set of public JSON-RPC servers at:</p><table>
<thead>
<tr>
<th>Domain</th>
<th>Port</th>
</tr>
</thead>
<tbody>
<tr>
<td>s1.ripple.com</td>
<td>51234</td>
</tr>
</tbody>
</table><p>These public servers are not for sustained or business use, and they may become unavailable at any time. For regular use, you should run your own <code title="Double-click to expand/collapse">rippled</code> server or contract someone you trust to do so.</p><p>If you are running your own <code title="Double-click to expand/collapse">rippled</code> server, make sure that you have enabled the JSON-RPC interface in your <a href="https://ripple.com/wiki/Rippled.cfg">rippled.cfg</a> file, since JSON-RPC is disabled by default. The relevant section is something like this example:</p><pre><code title="Double-click to expand/collapse"># [rpc_ip]:
# IP address or domain to bind to allow insecure RPC connections.
# Defaults to not allow RPC connections.
#
# [rpc_port]:
# Port to bind to if allowing insecure RPC connections.
[rpc_ip]
127.0.0.1
[rpc_port]
8088</code></pre><h3 id="commandline">Commandline</h3><p>The commandline interface connects to the same service as the JSON-RPC one, so the public servers and server configuration are the same. By default, <code title="Double-click to expand/collapse">rippled</code> connects to the local instance; however, you can specify the server to connect to in the configuration file or with the <code title="Double-click to expand/collapse">--rpc-ip</code> commandline argument. For example:</p><pre><code title="Double-click to expand/collapse">rippled --rpc_ip=s1.ripple.com:51234 server_info</code></pre><h2 id="request-formatting">Request Formatting</h2><p>Both the WebSocket API and the JSON-RPC API use <a href="http://www.w3schools.com/json/">JSON</a> for requests and responses. The methods and parameters available on both APIs are generally the same, but the exact formatting is slightly different between the two. The commandline interface supports the same commands, with the parameters in the commandline as well.</p><ul>
<li>A WebSocket request puts the command name in the <code title="Double-click to expand/collapse">"command"</code> field alongside the command’s parameters at the top level of the JSON object, with an optional <code title="Double-click to expand/collapse">"id"</code> field that will be returned with the response, so you can identify responses that come back out of order. </li>
<li>A JSON-RPC request puts the command in the <code title="Double-click to expand/collapse">"method"</code> field, with parameters in a separate object, as the first member of a <code title="Double-click to expand/collapse">"params"</code> array. There is no <code title="Double-click to expand/collapse">"id"</code> field, since all responses are direct replies to the requests.</li>
<li>The commandline puts the command after any normal (dash-prefaced) commandline options, followed by a limited set of parameters, separated by spaces. </li>
</ul><h4>Example Request</h4><div id="code-0" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-0-0">WebSocket</a></li><li><a href="#code-0-1">JSON-RPC</a></li><li><a href="#code-0-2">Commandline</a></li></ul>
<div id="code-0-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"command": "account_info",
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"strict": true,
"ledger_index": "validated"
}</code></pre></div>
<div style="display: none;" id="code-0-1"><pre><code title="Double-click to expand/collapse">POST http://s1.ripple.com:51234/
{
"method": "account_info",
"params": [
{
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"strict": true,
"ledger_index": "validated"
}
]
}</code></pre></div>
<div style="display: none;" id="code-0-2"><pre><code title="Double-click to expand/collapse">rippled -- account_info r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 validated true</code></pre></div>
</div><h2 id="response-formatting">Response Formatting</h2><h4>Example Successful Response</h4><div id="code-1" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-1-0">WebSocket</a></li><li><a href="#code-1-1">JSON-RPC</a></li><li><a href="#code-1-2">Commandline</a></li></ul>
<div id="code-1-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"status": "success",
"type": "response",
"result": {
"account_data": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Balance": "27389517749",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 18,
"PreviousTxnID": "B6B410172C0B65575D89E464AF5B99937CC568822929ABF87DA75CBD11911932",
"PreviousTxnLgrSeq": 6592159,
"Sequence": 1400,
"index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
},
"ledger_index": 6760970
}
}</code></pre></div>
<div style="display: none;" id="code-1-1"><pre><code title="Double-click to expand/collapse">HTTP Status: 200 OK
{
"result": {
"account_data": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Balance": "27389517749",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 18,
"PreviousTxnID": "B6B410172C0B65575D89E464AF5B99937CC568822929ABF87DA75CBD11911932",
"PreviousTxnLgrSeq": 6592159,
"Sequence": 1400,
"index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
},
"ledger_index": 6761012,
"status": "success"
}
}</code></pre></div>
<div style="display: none;" id="code-1-2"><pre><code title="Double-click to expand/collapse">{
"result": {
"account_data": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Balance": "27389517749",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 18,
"PreviousTxnID": "B6B410172C0B65575D89E464AF5B99937CC568822929ABF87DA75CBD11911932",
"PreviousTxnLgrSeq": 6592159,
"Sequence": 1400,
"index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
},
"ledger_index": 6761012,
"status": "success"
}
}</code></pre></div>
</div><p>The fields of a successful response include:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code title="Double-click to expand/collapse">id</code></td>
<td>(Varies)</td>
<td>(WebSocket only) ID provided in the request that prompted this response</td>
</tr>
<tr>
<td><code title="Double-click to expand/collapse">status</code> (WebSocket) <br\> <code title="Double-click to expand/collapse">result.status</code> (JSON-RPC and Commandline)</br\></td>
<td>String</td>
<td><code title="Double-click to expand/collapse">"success"</code> if the request successfully completed. In the WebSocket API responses, this is included at the top level; in JSON-RPC and Commandline responses, this is included as a sub-field of the <code title="Double-click to expand/collapse">"result"</code> object.</td>
</tr>
<tr>
<td><code title="Double-click to expand/collapse">type</code></td>
<td>String</td>
<td>(WebSocket only) Typically <code title="Double-click to expand/collapse">"response"</code>, which indicates a successful response to a command. Asynchronous notifications use a different value such as <code title="Double-click to expand/collapse">"ledgerClosed"</code> or <code title="Double-click to expand/collapse">"transaction"</code>.</td>
</tr>
<tr>
<td><code title="Double-click to expand/collapse">result</code></td>
<td>Object</td>
<td>The result of the query; contents vary depending on the command.</td>
</tr>
</tbody>
</table><h4>Commandline</h4><p>The response format for commandline methods is identical to JSON-RPC responses, because they use the same interface.</p><h2 id="error-responses">Error Responses</h2><p>It is impossible to enumerate all the possible ways an error can occur. Some may occur in the transport layer (for example, loss of network connectivity), in which case the results will vary depending on what client and transport you are using. However, if the <code title="Double-click to expand/collapse">rippled</code> server successfully receives your request, it will try to respond in a standardized error format.</p><p>Some example errors:</p><div id="code-2" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-2-0">WebSocket</a></li><li><a href="#code-2-1">JSON-RPC</a></li><li><a href="#code-2-2">Commandline</a></li></ul>
<div id="code-2-0"><pre><code title="Double-click to expand/collapse">{
"id": 3,
"status": "error",
"type": "response",
"error": "ledgerIndexMalformed",
"request": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"command": "account_info",
"id": 3,
"ledger_index": "-",
"strict": true
}
}</code></pre></div>
<div style="display: none;" id="code-2-1"><pre><code title="Double-click to expand/collapse">HTTP Status: 200 OK
{
"result": {
"error": "ledgerIndexMalformed",
"request": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"command": "account_info",
"ledger_index": "-",
"strict": true
},
"status": "error"
}
}</code></pre></div>
<div style="display: none;" id="code-2-2"><pre><code title="Double-click to expand/collapse">{
"result": {
"error": "ledgerIndexMalformed",
"request": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"command": "account_info",
"ledger_index": "-",
"strict": true
},
"status": "error"
}
}</code></pre></div>
</div><h4>WebSocket API Error Response Format</h4><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>(Varies)</td>
<td>ID provided in the Web Socket request that prompted this response</td>
</tr>
<tr>
<td>status</td>
<td>String</td>
<td><code title="Double-click to expand/collapse">"error"</code> if the request caused an error</td>
</tr>
<tr>
<td>type</td>
<td>String</td>
<td>Typically <code title="Double-click to expand/collapse">"response"</code>, which indicates a successful response to a command.</td>
</tr>
<tr>
<td>error</td>
<td>String</td>
<td>A unique code for the type of error that occurred</td>
</tr>
<tr>
<td>request</td>
<td>Object</td>
<td>A copy of the request that prompted this error, in JSON format. <em>Caution:</em> If the request contained any account secrets, they are copied here!</td>
</tr>
</tbody>
</table><h4>JSON-RPC API Error Response Format</h4><p>Some JSON-RPC requests will respond with an error code on the HTTP layer. In these cases, the response is a plain-text explanation in the response body. For example, if you forgot to specify the command in the <code title="Double-click to expand/collapse">method</code> parameter, the response is like this:</p><pre><code title="Double-click to expand/collapse">HTTP Status: 400 Bad Request
Null method</code></pre><p>For other errors that returned with HTTP status code 200 OK, the responses are formatted in JSON, with the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>result</td>
<td>Object</td>
<td>Object containing the response to the query</td>
</tr>
<tr>
<td>result.error</td>
<td>String</td>
<td>A unique code for the type of error that occurred</td>
</tr>
<tr>
<td>result.status</td>
<td>String</td>
<td><code title="Double-click to expand/collapse">"error"</code> if the request caused an error</td>
</tr>
<tr>
<td>result.request</td>
<td>Object</td>
<td>A copy of the request that prompted this error, in JSON format. <em>Caution:</em> If the request contained any account secrets, they are copied here! <em>Note:</em> The request is re-formatted in WebSocket format, regardless of the request made. This may be changed in the future: See <a href="https://ripplelabs.atlassian.net/browse/RIPD-279">RIPD-279</a>.</td>
</tr>
</tbody>
</table><h3 id="caution-on-errors">Caution on Errors</h3><p>When your request results in an error, the entire request is copied back as part of the response, so that you can try to debug the error. However, this also includes any secrets that were passed as part of the request. When sharing error messages, be very careful not to accidentally expose important account secrets to others.</p><h2 id="formatting-conventions">Formatting Conventions</h2><p>The WebSocket and JSON-RPC APIs generally take the same arguments, although they’re provided in a different way (See <a href="#request-formatting">Request Formatting</a> for details). Many similar parameters appear throughout the APIs, and there are conventions for how to specify these parameters.</p><p>All field names are case-sensitive. In responses, fields that are taken directly from Ledger Node or Transaction objects start with upper-case letters. Other fields, including ones that are dynamically generated for a response, are lower case.</p><h3 id="unique-identifiers">Unique Identifiers</h3><p>Different types of objects are uniquely identified in different ways:</p><p><em>Accounts</em> are identified by their <em>address</em>, a <a href="https://wiki.ripple.com/Encodings">base-58-encoded</a> string, for example <code title="Double-click to expand/collapse">"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"</code>. Addresses always start with “r”. You can also provide an un-encoded hex representation instead.</p><p><em>Transactions</em> are identified by their <em>hash</em>, which is a <a href="http://en.wikipedia.org/wiki/Sha512">SHA-512</a> hash of the transaction’s binary format. Transaction hashes are represented as hex strings.</p><p>Each instance of the Ripple <em>Ledger</em> has a sequence number and a hash value. See <a href="#specifying-a-ledger-instance">Specifying a Ledger Instance</a> for details.</p><h3 id="specifying-a-ledger-instance">Specifying a Ledger Instance</h3><p>Many API methods require you to specify an instance of the ledger, with the data retrieved being considered accurate and up-to-date as of that particular version of the shared ledger. The commands that accept a ledger version all work the same way. There are three ways you can specify which ledger you want to use:</p><ol>
<li>Specify a ledger by its Sequence Number in the <code title="Double-click to expand/collapse">ledger_index</code> parameter. Each closed ledger has an identifying sequence number that is 1 higher than the previously-validated ledger. (The Genesis Ledger has sequence number 0)</li>
<li>Specify a ledger by its hash value in the <code title="Double-click to expand/collapse">ledger_hash</code> parameter. </li>
<li>Specify a ledger by one of the following shortcuts, in the <code title="Double-click to expand/collapse">ledger_index</code> parameter:<ul>
<li><code title="Double-click to expand/collapse">validated</code> for the most recent ledger that has been validated by the whole network</li>
<li><code title="Double-click to expand/collapse">closed</code> for the most recent ledger that has been closed for modifications and proposed for validation by the node</li>
<li><code title="Double-click to expand/collapse">current</code> for the node’s current working version of the ledger.</li>
</ul>
</li>
</ol><p>There is also a deprecated <code title="Double-click to expand/collapse">ledger</code> parameter which accepts any of the above three formats. <em>Do not</em> use this parameter; it may be removed without further notice.</p><p>If you do not specify a ledger, the <code title="Double-click to expand/collapse">current</code> (in-progress) ledger will be chosen by default. If you provide more than one field specifying ledgers, the deprecated <code title="Double-click to expand/collapse">ledger</code> field will be used first if it exists, falling back to <code title="Double-click to expand/collapse">ledger_hash</code>. The <code title="Double-click to expand/collapse">ledger_index</code> field is ignored unless neither of the other two are present. <em>Note:</em> Do not rely on this default behavior; it is subject to change. Instead, you should always specify a ledger version in each call.</p><p>The sequence number indicates the order of the ledgers; the hash value identifies the exact contents of the ledger. Two ledgers with the same hash are always identical. For closed ledgers, hash values and sequence numbers are equally valid and correlate 1:1. However, this is not true for in-progress ledgers:</p><ul>
<li>Two different rippled servers may have different contents for a current ledger with the same sequence number, due to transactions not being fully propagated throughout the network.</li>
<li>A current ledger’s contents change over time, which would cause its hash to change, even though its sequence number stays the same. Therefore, the hash of a ledger is not calculated until it is closed.</li>
</ul><h3 id="specifying-currency-amounts">Specifying Currency Amounts</h3><p>Some API methods require you to specify an amount of currency. Depending on whether you are dealing in the network’s native XRP currency or other currency units (sometimes referred to as IOUs), the style for specifying it is very different.</p><h4>XRP</h4><p>Amounts of XRP are represented as strings. (JSON integers are limited to 32 bits, so integer overflows are possible.) XRP is formally specified in “drops”, which are equivalent to 0.000001 (one 1-millionth) of an XRP each. Thus, to represent 1.0 XRP in a JSON document, you would write <code title="Double-click to expand/collapse">"1000000"</code>.</p><p>Unit tests are permitted to submit values of XRP (not drops) with a decimal point - for example, “1.23” meaning 1.23 XRP. All other cases should always specify XRP in drops, with no decimal point: e.g. “1230000” meaning 1.23 XRP.</p><h4>Non-XRP</h4><p>If you are specifying non-XRP currency (including fiat dollars, precious metals, cryptocurrencies, or other custom currency) you must specify it with a currency specification object. This is a JSON object with three fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>currency</td>
<td>String</td>
<td>Three-letter <a href="http://www.xe.com/iso4217.php">ISO 4217 Currency Code</a> string (“XRP” is invalid). Alternatively, an unsigned 160-bit hex value according to the <a href="https://wiki.ripple.com/Currency_format">Currency format</a>.</td>
</tr>
<tr>
<td>value</td>
<td>String</td>
<td>Quoted decimal representation of the amount of currency</td>
</tr>
<tr>
<td>issuer</td>
<td>String</td>
<td>Unique account address of the entity issuing the currency. In other words, the person or business where the currency can be redeemed.</td>
</tr>
</tbody>
</table><p>For example, to represent $153.75 US dollars issued by account <code title="Double-click to expand/collapse">r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59</code>, you would specify:</p><pre><code title="Double-click to expand/collapse" class="lang-js">{
<span class="string">"currency"</span>: <span class="string">"USD"</span>,
<span class="string">"value"</span>: <span class="string">"<span class="number"><span class="number">153</span>.<span class="number">75</span></span>"</span>,
<span class="string">"issuer"</span>: <span class="string">"r<span class="number">9</span>cZA<span class="number">1</span>mLK<span class="number">5</span>R<span class="number">5</span>Am<span class="number">25</span>ArfXFmqgNwjZgnfk<span class="number">59</span>"</span>
}</code></pre><p>Unit tests are permitted to submit amounts of non-XRP currencies as a slash-separated string in the format <code title="Double-click to expand/collapse">"amount/currency/issuer"</code>. All other cases should use the JSON object format above.</p><h4>Specifying Currencies Without Amounts</h4><p>If you are specifying a non-XRP currency without an amount (typically for defining an order book of currency exchange offers) you should specify it as above, but omit the <code title="Double-click to expand/collapse">value</code> field.</p><p>If you are specifying XRP without an amount — also typically for defining an order book — you should specify it as a JSON object with <em>only</em> a <code title="Double-click to expand/collapse">currency</code> field. Never include an <code title="Double-click to expand/collapse">issuer</code> field for XRP.</p><p>Finally, if you are specifying a non-currency for a payment or path definition, and the recipient account of the payment trusts multiple gateways that issue the same currency, you can indicate that the payment should be made in any combination of issuers that the recipient accepts. To do this, specify the recipient account’s address as the <code title="Double-click to expand/collapse">issuer</code> value in the JSON object.</p><h3 id="specifying-time">Specifying Time</h3><p>The <code title="Double-click to expand/collapse">rippled</code> server and its APIs represent time as an unsigned integer. This number measures the number of seconds since the “Ripple Epoch” of January 1, 2000 (00:00 UTC). This is similar to the way the <a href="http://en.wikipedia.org/wiki/Unix_time">Unix epoch</a> works, except the Ripple Epoch is 946684800 seconds after the Unix Epoch.</p><p>Don’t convert Ripple Epoch times to UNIX Epoch times in 32-bit variables: this could lead to integer overflows.</p><h3 id="possible-server-states">Possible Server States</h3><p>Depending on how the <code title="Double-click to expand/collapse">rippled</code> server is configured, how long it has been running, and other factors, a server may be participating in the global Ripple Network to different degrees. This is represented as the <code title="Double-click to expand/collapse">server_state</code> field in the responses to the <a href="#server-info"><code title="Double-click to expand/collapse">server_info</code></a> and <a href="#server-state"><code title="Double-click to expand/collapse">server_state</code></a> commands. The possible responses follow a range of ascending interaction, with each subsequent value superseding the previous one. Their definitions are as follows (in order of increasing priority):</p><table>
<thead>
<tr>
<th>Value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>disconnected</td>
<td>The server is not connected to the Ripple Network whatsoever. It may be running in offline mode, or it may not be able to access the network for whatever reason.</td>
</tr>
<tr>
<td>connected</td>
<td>The server believes it is connected to the network.</td>
</tr>
<tr>
<td>syncing</td>
<td>The server is currently behind on ledger versions. (It is normal for a server to spend a few minutes catching up after you start it.)</td>
</tr>
<tr>
<td>tracking</td>
<td>The server is in agreement with the network</td>
</tr>
<tr>
<td>full</td>
<td>The server is fully caught-up with the network and could participate in validation, but is not doing so (possibly because it has not been configured as a validator).</td>
</tr>
<tr>
<td>validating</td>
<td>The server is currently participating in validation of the ledger</td>
</tr>
<tr>
<td>proposing</td>
<td>The server is participating in validation of the ledger and currently proposing its own version.</td>
</tr>
</tbody>
</table><p><em>Note:</em> The distinction between <code title="Double-click to expand/collapse">full</code>, <code title="Double-click to expand/collapse">validating</code>, and <code title="Double-click to expand/collapse">proposing</code> is based on synchronization with the rest of the global network, and it is normal for a server to fluctuate between these states as a course of general operation.</p><h2 id="modifying-the-ledger">Modifying the Ledger</h2><p>All changes to Ripple’s global shared ledger happen as the result of transactions. Consequently, this means that there is <em>only one</em> public API method that causes a change in the state of the Ripple Network at all: the <a href="#submit"><em>submit</em></a> command. Most of the other methods represent different ways to view the data represented in the Ripple Network, and the remaining ones just generate data for your convenience. (The <a href="#wallet-propose">wallet_propose</a>, <a href="#path-find">path_find</a>, and <a href="#random">random</a> commands fall into this category.)</p><p>For more information on the various transactions you can submit, consult the <a href="transactions.html">Transaction Format</a>.</p><h1 id="api-methods">API Methods</h1><p>API methods for the Websocket and JSON-RPC APIs are defined by command names, and are divided into Public Commands and Admin Commands. Public Commands are not necessarily meant for the general public, but they are used by any client attached to the server. (Think of Public Commands as being for members or customers of the organization running the server, while the Admin Commands are for the personnel in charge of keeping the server operational.) Public Commands include the general operations for Ripple use, including checking the state of the ledger, finding a path to connecting users, and submitting a transaction, among others. Admin Commands, on the other hand, are meant only for the operators of the server, and include commands for managing the state of the server, the nodes it uses for validation, and other administrative features.</p><p>This page deals with all the Public Commands available. </p><h2 id="list-of-public-commands">List of Public Commands</h2><ul>
<li><a href="#account-info"><code title="Double-click to expand/collapse">account_info</code> - Get basic data about an account</a></li>
<li><a href="#account-lines"><code title="Double-click to expand/collapse">account_lines</code> - Get info about an account’s trust lines</a></li>
<li><a href="#account-offers"><code title="Double-click to expand/collapse">account_offers</code> - Get info about an account’s currency exchange offers</a></li>
<li><a href="#account-tx"><code title="Double-click to expand/collapse">account_tx</code> - Get info about an account’s transactions</a></li>
<li><a href="#book-offers"><code title="Double-click to expand/collapse">book_offers</code> - Get info about offers to exchange two currencies</a></li>
<li><a href="#ledger"><code title="Double-click to expand/collapse">ledger</code> - Get info about a ledger version</a></li>
<li><a href="#ledger-closed"><code title="Double-click to expand/collapse">ledger_closed</code> - Get the latest closed ledger version</a></li>
<li><a href="#ledger-current"><code title="Double-click to expand/collapse">ledger_current</code> - Get the current working ledger version</a></li>
<li><a href="#ledger-data"><code title="Double-click to expand/collapse">ledger_data</code> - Get the raw contents of a ledger version</a></li>
<li><a href="#ledger-entry"><code title="Double-click to expand/collapse">ledger_entry</code> - Get one element from a ledger version</a></li>
<li><a href="#path-find"><code title="Double-click to expand/collapse">path_find</code> - Find a path for a payment between two accounts and receive updates</a></li>
<li><a href="#ping"><code title="Double-click to expand/collapse">ping</code> - Confirm connectivity with the server</a></li>
<li><a href="#random"><code title="Double-click to expand/collapse">random</code> - Generate a random number</a></li>
<li><a href="#ripple-path-find"><code title="Double-click to expand/collapse">ripple_path_find</code> - Find a path for payment between two accounts, once</a></li>
<li><a href="#server-info"><code title="Double-click to expand/collapse">server_info</code> - Retrieve status of the server in human-readable format</a></li>
<li><a href="#server-state"><code title="Double-click to expand/collapse">server_state</code> - Retrieve status of the server in machine-readable format</a></li>
<li><a href="#sign"><code title="Double-click to expand/collapse">sign</code> - Cryptographically sign a transaction</a></li>
<li><a href="#submit"><code title="Double-click to expand/collapse">submit</code> - Send a transaction to the network</a></li>
<li><a href="#subscribe"><code title="Double-click to expand/collapse">subscribe</code> - Listen for updates about a particular subject</a></li>
<li><a href="#transaction-entry"><code title="Double-click to expand/collapse">transaction_entry</code> - Retrieve info about a transaction from a particular ledger version</a></li>
<li><a href="#tx"><code title="Double-click to expand/collapse">tx</code> - Retrieve info about a transaction from all the ledgers on hand</a></li>
<li><a class="active" href="#tx-history"><code title="Double-click to expand/collapse">tx_history</code> - Retrieve info about all recent transactions</a></li>
<li><a href="#unsubscribe"><code title="Double-click to expand/collapse">unsubscribe</code> - Stop listening for updates about a particular subject</a></li>
</ul><p>The <code title="Double-click to expand/collapse">wallet_accounts</code> command is deprecated and may be removed without further notice.</p><h2 id="admin-commands">Admin Commands</h2><p>Additionally, this page contains an explanation of the following important admin-only command:</p><ul>
<li><a href="#wallet-propose"><code title="Double-click to expand/collapse">wallet_propose</code> - Generate keys for a new account</a></li>
</ul><p>For information about other Admin Commands, consult <a href="https://ripple.com/wiki/JSON_Messages">the old wiki documentation</a>.</p><h2 id="commandline-access">Commandline Access</h2><p>The <code title="Double-click to expand/collapse">rippled</code> application, in addition to acting as a server, can be run (as a separate instance) to act as a JSON-RPC client. In this mode, it has syntax for triggering most API methods with a single line from the command prompt, as described in each method. However, some methods don’t have a commandline shortcut, so it also provides the following catch-all method for performing commands:</p><ul>
<li><a href="#json"><code title="Double-click to expand/collapse">json</code> - Pass JSON through the commandline</a></li>
</ul><h1 id="managing-accounts">Managing Accounts</h1><p>Accounts are the core unit of authentication in the Ripple Network. Each account can hold balances in multiple currencies, and all transactions must be signed by an account’s secret key. In order for an account to exist in a validated ledger version, it must hold a minimum reserve amount of XRP. (The <a href="https://ripple.com/wiki/Reserves">reserve for an account</a> increases with the amount of data it is responsible for in the shared ledger.) It is expected that accounts will correspond loosely to individual users. </p><h2 id="account-info">account_info</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/AccountInfo.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">account_info</code> command retrieves information about an account, its activity, and its XRP balance. All information retrieved is relative to a particular version of the ledger. </p><h4>Request Format</h4><p>An example of an account_info request:</p><div id="code-3" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-3-0">WebSocket</a></li><li><a href="#code-3-1">JSON-RPC</a></li><li><a href="#code-3-2">Commandline</a></li></ul>
<div id="code-3-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"command": "account_info",
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"strict": true,
"ledger_index": "validated"
}</code></pre></div>
<div style="display: none;" id="code-3-1"><pre><code title="Double-click to expand/collapse">{
"method": "account_info",
"params": [
{
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"strict": true,
"ledger_index": "validated"
}
]
}</code></pre></div>
<div style="display: none;" id="code-3-2"><pre><code title="Double-click to expand/collapse">#Syntax: account_info account [ledger_index|ledger_hash] [strict]
rippled -- account_info r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 true</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#account_info">Try it!</a></p><p>The request contains the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account</td>
<td>String</td>
<td>A unique identifier for the account, most commonly the account’s address.</td>
</tr>
<tr>
<td>strict</td>
<td>Boolean</td>
<td>(Optional, defaults to False) If set to True, then the <code title="Double-click to expand/collapse">account</code> field will only accept a public key or account address.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) A 20-byte hex string for the ledger version to use. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String or Unsigned Integer</td>
<td>(Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
</tbody>
</table><p>The following fields are deprecated and should not be provided: <code title="Double-click to expand/collapse">ident</code>, <code title="Double-click to expand/collapse">account_index</code>, <code title="Double-click to expand/collapse">ledger</code>.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-4" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-4-0">WebSocket</a></li></ul>
<div id="code-4-0"><pre><code title="Double-click to expand/collapse">{
"id": 5,
"status": "success",
"type": "response",
"result": {
"account_data": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Balance": "27389517749",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 18,
"PreviousTxnID": "2F804E1A00DBCBDAFBDB7D001409F79FE196785EB68FBA463E5924002BE4DEE9",
"PreviousTxnLgrSeq": 6405716,
"Sequence": 1400,
"index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
},
"ledger_current_index": 6507948
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with the result containing the requested account, its data, and a ledger to which it applies, as the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account_data</td>
<td>Object</td>
<td>Information about the requested account</td>
</tr>
<tr>
<td>account_data.Account</td>
<td>String</td>
<td>Address of the requested account</td>
</tr>
<tr>
<td>account_data.Balance</td>
<td>String</td>
<td>XRP balance in “drops” represented as a string</td>
</tr>
<tr>
<td>account_data.Flags</td>
<td>32-bit unsigned integer</td>
<td>Integer with different bits representing the status of several <a href="transactions.html#accountset-flags">account flags</a></td>
</tr>
<tr>
<td>account_data.LedgerEntryType</td>
<td>String</td>
<td>“AccountRoot” is the type of ledger entry that holds an account’s data</td>
</tr>
<tr>
<td>account_data.OwnerCount</td>
<td>Integer</td>
<td>Number of other ledger entries (specifically, trust lines and offers) attributed to this account. This is used to calculate the total reserve required to use the account.</td>
</tr>
<tr>
<td>account_data.PreviousTxnID</td>
<td>String</td>
<td>Hash value representing the most recent transaction that affected this account</td>
</tr>
<tr>
<td>account_data.Sequence</td>
<td>Integer</td>
<td>The sequence number of the next valid transaction for this account. (Each account starts with Sequence = 1 and increases each time a transaction is made.)</td>
</tr>
<tr>
<td>account_data.index</td>
<td>String</td>
<td>A unique index for the AccountRoot node that represents this account in the ledger.</td>
</tr>
<tr>
<td>ledger_current_index</td>
<td>Integer</td>
<td>(Omitted if <code title="Double-click to expand/collapse">ledger_index</code> is provided instead) The sequence number of the most-current ledger, which was used when retrieving this information. The information does not contain any changes from ledgers newer than this one.</td>
</tr>
<tr>
<td>ledger_index</td>
<td>Integer</td>
<td>(Omitted if <code title="Double-click to expand/collapse">ledger_current_index</code> is provided instead) The sequence number of the ledger used when retrieving this information. The information does not contain any changes from ledgers newer than this one.</td>
</tr>
<tr>
<td>validated</td>
<td>Boolean</td>
<td>True if this data is from a validated ledger version; if omitted or set to false, this data is not final. (<a href="https://ripplelabs.atlassian.net/browse/RIPD-275">New in version 0.26</a>)</td>
</tr>
</tbody>
</table><h2 id="account-lines">account_lines</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/AccountLines.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">account_lines</code> method returns information about the account’s lines of trust, including balances in all non-XRP currencies and assets. All information retrieved is relative to a particular version of the ledger.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-5" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-5-0">WebSocket</a></li><li><a href="#code-5-1">JSON-RPC</a></li></ul>
<div id="code-5-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"command": "account_lines",
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger": "current"
}</code></pre></div>
<div style="display: none;" id="code-5-1"><pre><code title="Double-click to expand/collapse">{
"method": "account_lines",
"params": [
{
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger": "current"
}
]
}</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#account_lines">Try it!</a></p><p>The request accepts the following paramters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account</td>
<td>String</td>
<td>A unique identifier for the account, most commonly the account’s address as a base-58 string.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) A 20-byte hex string for the ledger version to use. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String or Unsigned Integer</td>
<td>(Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>peer</td>
<td>String</td>
<td>(Optional) A unique ID for a second account. If provided, show only lines of trust connecting the two accounts.</td>
</tr>
<tr>
<td>limit</td>
<td>Integer</td>
<td>(<a href="https://ripplelabs.atlassian.net/browse/RIPD-343">Upcoming</a>, Optional, default varies) Limit the number of transactions to retrieve. The server is not required to honor this value.</td>
</tr>
<tr>
<td>marker</td>
<td>(Not Specified)</td>
<td>(<a href="https://ripplelabs.atlassian.net/browse/RIPD-343">Upcoming</a>) Server-provided value to specify where to resume retrieving data from.</td>
</tr>
</tbody>
</table><p>The following parameters are deprecated and may be removed without further notice: <code title="Double-click to expand/collapse">ledger</code> and <code title="Double-click to expand/collapse">peer_index</code>.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-6" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-6-0">WebSocket</a></li><li><a href="#code-6-1">JSON-RPC</a></li></ul>
<div id="code-6-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"status": "success",
"type": "response",
"result": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"lines": [
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "ASP",
"limit": "0",
"limit_peer": "10",
"quality_in": 0,
"quality_out": 0
},
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "XAU",
"limit": "0",
"limit_peer": "0",
"no_ripple": true,
"no_ripple_peer": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"balance": "3.497605752725159",
"currency": "USD",
"limit": "5",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
}
]
}
}</code></pre></div>
<div style="display: none;" id="code-6-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"lines": [
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "ASP",
"limit": "0",
"limit_peer": "10",
"quality_in": 0,
"quality_out": 0
},
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "XAU",
"limit": "0",
"limit_peer": "0",
"no_ripple": true,
"no_ripple_peer": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"balance": "5",
"currency": "USD",
"limit": "5",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rHpXfibHgSb64n8kK9QWDpdbfqSpYbM9a4",
"balance": "481.992867407479",
"currency": "MXN",
"limit": "1000",
"limit_peer": "0",
"quality_in": 0,
"quality_out": 0
},
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"balance": "0.793598266778297",
"currency": "EUR",
"limit": "1",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rnuF96W4SZoCJmbHYBFoJZpR8eCaxNvekK",
"balance": "0",
"currency": "CNY",
"limit": "3",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
"balance": "1.326889190631542",
"currency": "DYM",
"limit": "3",
"limit_peer": "0",
"quality_in": 0,
"quality_out": 0
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"balance": "0.3488146605801446",
"currency": "CHF",
"limit": "0",
"limit_peer": "0",
"quality_in": 0,
"quality_out": 0
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"balance": "0",
"currency": "BTC",
"limit": "3",
"limit_peer": "0",
"quality_in": 0,
"quality_out": 0
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"balance": "10.06051402019741",
"currency": "USD",
"limit": "5000",
"limit_peer": "0",
"quality_in": 0,
"quality_out": 0
},
{
"account": "rpgKWEmNqSDAGFhy5WDnsyPqfQxbWxKeVd",
"balance": "-0.00111",
"currency": "BTC",
"limit": "0",
"limit_peer": "10",
"quality_in": 0,
"quality_out": 0
},
{
"account": "rBJ3YjwXi2MGbg7GVLuTXUWQ8DjL7tDXh4",
"balance": "-0.0008744482690504699",
"currency": "BTC",
"limit": "0",
"limit_peer": "10",
"quality_in": 0,
"quality_out": 0
},
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"balance": "0.982191732527743",
"currency": "USD",
"limit": "1",
"limit_peer": "0",
"quality_in": 0,
"quality_out": 0
},
{
"account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
"balance": "9.07619790068559",
"currency": "CNY",
"limit": "100",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"balance": "7.292695098901099",
"currency": "JPY",
"limit": "0",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "r3vi7mWxru9rJCxETCyA1CHvzL96eZWx5z",
"balance": "0",
"currency": "AUX",
"limit": "0",
"limit_peer": "0",
"no_ripple": true,
"no_ripple_peer": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "r9vbV3EHvXWjSkeQ6CAcYVPGeq7TuiXY2X",
"balance": "0",
"currency": "USD",
"limit": "1",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"balance": "12.41688780720394",
"currency": "EUR",
"limit": "100",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rfF3PNkwkq1DygW2wum2HK3RGfgkJjdPVD",
"balance": "35",
"currency": "USD",
"limit": "500",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rwUVoVMSURqNyvocPCcvLu3ygJzZyw8qwp",
"balance": "-5",
"currency": "JOE",
"limit": "0",
"limit_peer": "50",
"no_ripple_peer": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rE6R3DWF9fBD7CyiQciePF9SqK58Ubp8o2",
"balance": "0",
"currency": "USD",
"limit": "0",
"limit_peer": "100",
"no_ripple_peer": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rE6R3DWF9fBD7CyiQciePF9SqK58Ubp8o2",
"balance": "0",
"currency": "JOE",
"limit": "0",
"limit_peer": "100",
"no_ripple_peer": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rs9M85karFkCRjvc6KMWn8Coigm9cbcgcx",
"balance": "0",
"currency": "015841551A748AD2C1F76FF6ECB0CCCD00000000",
"limit": "10.01037626125837",
"limit_peer": "0",
"no_ripple": true,
"quality_in": 0,
"quality_out": 0
},
{
"account": "rEhDDUUNxpXgEHVJtC2cjXAgyx5VCFxdMF",
"balance": "0",
"currency": "USD",
"limit": "0",
"limit_peer": "1",
"quality_in": 0,
"quality_out": 0
}
],
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the address of the account and an array of trust-line objects. Specifically, the result object contains the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account</td>
<td>String</td>
<td>Unique address of the account this request corresponds to</td>
</tr>
<tr>
<td>lines</td>
<td>Array</td>
<td>Array of trust-line objects, as described below.</td>
</tr>
<tr>
<td>marker</td>
<td>(Not Specified)</td>
<td>(<a href="https://ripplelabs.atlassian.net/browse/RIPD-343">Upcoming</a>) Server-defined value. Pass this to the next call in order to resume where this call left off.</td>
</tr>
</tbody>
</table><p>Each trust-line object has some combination of the following fields, although not necessarily all of them:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account</td>
<td>String</td>
<td>The unique address of the account this line applies to.</td>
</tr>
<tr>
<td>balance</td>
<td>String</td>
<td>Representation of the numeric balance currently held against this line. A positive balance means that the account holds value; a negative balance means that the account owes value.</td>
</tr>
<tr>
<td>currency</td>
<td>String</td>
<td>The currency this line applies to</td>
</tr>
<tr>
<td>limit</td>
<td>String</td>
<td>The maximum amount of the given currency that the account is willing to owe the peer account</td>
</tr>
<tr>
<td>limit_peer</td>
<td>String</td>
<td>The maximum amount of currency that the peer account is willing to owe the account</td>
</tr>
<tr>
<td>no_ripple</td>
<td>Boolean</td>
<td>Whether or not the account has the <a href="https://ripple.com/wiki/No_Ripple">NoRipple flag</a> set for this line</td>
</tr>
<tr>
<td>no_ripple_peer</td>
<td>Boolean</td>
<td>Whether or not the peer account has the <a href="https://ripple.com/wiki/No_Ripple">NoRipple flag</a> set for the other direction of this trust line</td>
</tr>
<tr>
<td>quality_in</td>
<td>Unsigned Integer</td>
<td>Ratio for incoming <a href="https://ripple.com/wiki/Transit_Fees">transit fees</a> represented in billionths. (For example, a value of 500 million represents a 0.5:1 ratio.) As a special case, 0 is treated as a 1:1 ratio.</td>
</tr>
<tr>
<td>quality_out</td>
<td>Unsigned Integer</td>
<td>Ratio for outgoing <a href="https://ripple.com/wiki/Transit_Fees">transit fees</a> represented in billionths. (For example, a value of 500 million represents a 0.5:1 ratio.) As a special case, 0 is treated as a 1:1 ratio.</td>
</tr>
</tbody>
</table><h2 id="account-offers">account_offers</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/AccountOffers.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">account_offers</code> method retrieves a list of offers made by a given account that are outstanding as of a particular ledger version.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-7" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-7-0">WebSocket</a></li><li><a href="#code-7-1">JSON-RPC</a></li><li><a href="#code-7-2">Commandline</a></li></ul>
<div id="code-7-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"command": "account_offers",
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger_index": "current"
}</code></pre></div>
<div style="display: none;" id="code-7-1"><pre><code title="Double-click to expand/collapse">{
"method": "account_offers",
"params": [
{
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger_index": "current"
}
]
}</code></pre></div>
<div style="display: none;" id="code-7-2"><pre><code title="Double-click to expand/collapse">#Syntax: account_offers account [ledger_index]
rippled -- account_offers r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 current</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#account_offers">Try it!</a></p><p>A request can include the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account</td>
<td>String</td>
<td>A unique identifier for the account, most commonly the account’s address as a base-58 string.</td>
</tr>
<tr>
<td>ledger</td>
<td>Unsigned integer, or String</td>
<td>(Deprecated, Optional) A unique identifier for the ledger version to use, such as a ledger sequence number, a hash, or a shortcut such as “validated”.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) A 20-byte hex string identifying the ledger version to use.</td>
</tr>
<tr>
<td>ledger_index</td>
<td>(Optional) Unsigned integer, or String</td>
<td>(Optional, defaults to <code title="Double-click to expand/collapse">current</code>) The sequence number of the ledger to use, or “current”, “closed”, or “validated” to select a ledger dynamically. (See Ledger Indexes.)</td>
</tr>
<tr>
<td>limit</td>
<td>Integer</td>
<td>(<a href="https://ripplelabs.atlassian.net/browse/RIPD-344">Upcoming</a>, Optional, default varies) Limit the number of transactions to retrieve. The server is not required to honor this value.</td>
</tr>
<tr>
<td>marker</td>
<td>(Not Specified)</td>
<td>(<a href="https://ripplelabs.atlassian.net/browse/RIPD-344">Upcoming</a>) Server-provided value to specify where to resume retrieving data from.</td>
</tr>
</tbody>
</table><p>The following parameter is deprecated and may be removed without further notice: <code title="Double-click to expand/collapse">ledger</code>.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-8" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-8-0">WebSocket</a></li><li><a href="#code-8-1">JSON-RPC</a></li></ul>
<div id="code-8-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"status": "success",
"type": "response",
"result": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"offers": [
{
"flags": 0,
"seq": 1399,
"taker_gets": "16666666",
"taker_pays": {
"currency": "XAU",
"issuer": "rs9M85karFkCRjvc6KMWn8Coigm9cbcgcx",
"value": "0.0001"
}
}
]
}
}</code></pre></div>
Response:
<div style="display: none;" id="code-8-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"offers": [],
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account</td>
<td>String</td>
<td>Unique address identifying the account that made the offers</td>
</tr>
<tr>
<td>offers</td>
<td>Array</td>
<td>Array of objects, where each object represents an offer made by this account that is outstanding as of the requested ledger version.</td>
</tr>
<tr>
<td>marker</td>
<td>(Not Specified)</td>
<td>(<a href="https://ripplelabs.atlassian.net/browse/RIPD-344">Upcoming</a>) Server-defined value. Pass this to the next call in order to resume where this call left off.</td>
</tr>
</tbody>
</table><p>Each offer object contains the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>flags</td>
<td>Unsigned integer</td>
<td>Options set for this offer entry as bit-flags.</td>
</tr>
<tr>
<td>seq</td>
<td>Unsigned integer</td>
<td>Sequence number of the transaction that created this entry. (Transaction sequence numbers are relative to accounts.)</td>
</tr>
<tr>
<td>taker_gets</td>
<td>String or Object</td>
<td>The amount the account accepting the offer receives, as a String representing an amount in XRP, or a currency specification object. (See <a href="#specifying-currency-amounts">Specifying Currency Amounts</a>)</td>
</tr>
<tr>
<td>taker_pays</td>
<td>String or Object</td>
<td>The amount the account accepting the offer provides, as a String representing an amount in XRP, or a currency specification object. (See <a href="#specifying-currency-amounts">Specifying Currency Amounts</a>)</td>
</tr>
</tbody>
</table><h2 id="account-tx">account_tx</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/AccountTx.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">account_tx</code> method retrieves a list of transactions that involved the specified account.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-9" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-9-0">WebSocket</a></li><li><a href="#code-9-1">JSON-RPC</a></li><li><a href="#code-9-2">Commandline</a></li></ul>
<div id="code-9-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"command": "account_tx",
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger_index_min": -1,
"ledger_index_max": -1,
"binary": false,
"count": false,
"descending": false,
"offset": 1,
"limit": 2,
"forward": false
}</code></pre></div>
<div style="display: none;" id="code-9-1"><pre><code title="Double-click to expand/collapse">{
"method": "account_tx",
"params": [
{
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"binary": false,
"count": false,
"descending": false,
"forward": false,
"ledger_index_max": -1,
"ledger_index_min": -1,
"limit": 2,
"offset": 1
}
]
}</code></pre></div>
<div style="display: none;" id="code-9-2"><pre><code title="Double-click to expand/collapse">#Syntax account_tx account [ledger_index_min [ledger_index_max [limit]]] [binary] [count] [forward]
rippled -- account_tx r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 -1 -1 2 false false false</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#account_tx">Try it!</a></p><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account</td>
<td>String</td>
<td>A unique identifier for the account, most commonly the account’s address.</td>
</tr>
<tr>
<td>ledger_index_min</td>
<td>Integer</td>
<td>Use to specify the earliest ledger to include transactions from. A value of <code title="Double-click to expand/collapse">-1</code> instructs the server to use the earliest ledger available.</td>
</tr>
<tr>
<td>ledger_index_max</td>
<td>Integer</td>
<td>Use to specify the most recent ledger to include transactions from. A value of <code title="Double-click to expand/collapse">-1</code> instructs the server to use the most recent one available.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) Use instead of ledger_index_min and ledger_index_max to look for transactions from a single ledger only. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String or Unsigned Integer</td>
<td>(Optional) Use instead of ledger_index_min and ledger_index_max to look for transactions from a single ledger only. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>binary</td>
<td>Boolean</td>
<td>(Optional, defaults to False) If set to True, return transactions as hex strings instead of JSON.</td>
</tr>
<tr>
<td>forward</td>
<td>boolean</td>
<td>(Optional, defaults to False) If set to True, return values indexed with the oldest ledger first. Otherwise, the results are indexed with the newest ledger first. (Each page of results may not be internally ordered, but the pages are overall ordered.)</td>
</tr>
<tr>
<td>limit</td>
<td>Integer</td>
<td>(Optional, default varies) Limit the number of transactions to retrieve. The server is not required to honor this value.</td>
</tr>
<tr>
<td>marker</td>
<td>(Not Specified)</td>
<td>Server-provided value to specify where to resume retrieving data from.</td>
</tr>
</tbody>
</table><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/AccountTxSwitch.cpp" title="Source">[Source]<br></a>
There is also a deprecated legacy variation of the <code title="Double-click to expand/collapse">account_tx</code> method. For that reason, we recommend <em>not using any of the following fields</em>: <code title="Double-click to expand/collapse">offset</code>, <code title="Double-click to expand/collapse">count</code>, <code title="Double-click to expand/collapse">descending</code>, <code title="Double-click to expand/collapse">ledger_max</code>, <code title="Double-click to expand/collapse">ledger_min</code>.</p><h5>Iterating over queried data</h5><p>If you want to retrieve an amount of data that is higher than the server’s maximum <code title="Double-click to expand/collapse">limit</code> value, or you want to break up your request into multiple smaller requests, you can use the <code title="Double-click to expand/collapse">marker</code> field to pick up in the same place you left off. For each subsequent request, pass the <code title="Double-click to expand/collapse">marker</code> value from the previous request to instruct rippled to resume from the point where you left off.</p><p>However, in the time between requests, things may change so that <code title="Double-click to expand/collapse">"ledger_index_min": -1</code> and <code title="Double-click to expand/collapse">"ledger_index_max": -1</code> may refer to different ledger versions than they did before. To make sure you iterate over the same exact data set, take the <code title="Double-click to expand/collapse">ledger_index_min</code> and <code title="Double-click to expand/collapse">ledger_index_max</code> values provided in the first response, and use those values for all subsequent requests. </p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-10" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-10-0">WebSocket</a></li><li><a href="#code-10-1">JSON-RPC</a></li></ul>
<div id="code-10-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"status": "success",
"type": "response",
"result": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger_index_max": 6542489,
"ledger_index_min": 32570,
"limit": 2,
"offset": 1,
"transactions": [
{
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Balance": "9999999980",
"Flags": 0,
"OwnerCount": 2,
"Sequence": 3
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05",
"PreviousFields": {
"Balance": "9999999990",
"OwnerCount": 1,
"Sequence": 2
},
"PreviousTxnID": "389720F6FD8A144F171708F9ECB334D704CBCFEFBCDA152D931AC34FB5F9E32B",
"PreviousTxnLgrSeq": 95405
}
},
{
"CreatedNode": {
"LedgerEntryType": "RippleState",
"LedgerIndex": "718C6D58DD3BBAAAEBFE48B8FBE3C32C9F6F2EBC395233BA95D0057078EE07DB",
"NewFields": {
"Balance": {
"currency": "USD",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "0"
},
"Flags": 131072,
"HighLimit": {
"currency": "USD",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "100"
},
"LowLimit": {
"currency": "USD",
"issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"value": "0"
}
}
}
},
{
"ModifiedNode": {
"FinalFields": {
"Flags": 0,
"Owner": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"RootIndex": "77F65EFF930ED7E93C6CC839C421E394D6B1B6A47CEA8A140D63EC9C712F46F5"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "77F65EFF930ED7E93C6CC839C421E394D6B1B6A47CEA8A140D63EC9C712F46F5"
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"Balance": "78991384535796",
"Flags": 0,
"OwnerCount": 3,
"Sequence": 188
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "B33FDD5CF3445E1A7F2BE9B06336BEBD73A5E3EE885D3EF93F7E3E2992E46F1A",
"PreviousTxnID": "E9E1988A0F061679E5D14DE77DB0163CE0BBDC00F29E396FFD1DA0366E7D8904",
"PreviousTxnLgrSeq": 195455
}
},
{
"ModifiedNode": {
"FinalFields": {
"ExchangeRate": "4E11C37937E08000",
"Flags": 0,
"RootIndex": "F60ADF645E78B69857D2E4AEC8B7742FEABC8431BD8611D099B428C3E816DF93",
"TakerGetsCurrency": "0000000000000000000000000000000000000000",
"TakerGetsIssuer": "0000000000000000000000000000000000000000",
"TakerPaysCurrency": "0000000000000000000000004254430000000000",
"TakerPaysIssuer": "5E7B112523F68D2F5E879DB4EAC51C6698A69304"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "F60ADF645E78B69857D2E4AEC8B7742FEABC8431BD8611D099B428C3E816DF93"
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Fee": "10",
"Flags": 0,
"LimitAmount": {
"currency": "USD",
"issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"value": "100"
},
"Sequence": 2,
"SigningPubKey": "02BC8C02199949B15C005B997E7C8594574E9B02BA2D0628902E0532989976CF9D",
"TransactionType": "TrustSet",
"TxnSignature": "304402200EF81EC32E0DFA9BE376B20AFCA11765ED9FEA04CA8B77C7178DAA699F7F5AFF02202DA484DBD66521AC317D84F7717EC4614E2F5DB743E313E8B48440499CC0DBA4",
"date": 413620090,
"hash": "002AA492496A1543DBD3680BF8CF21B6D6A078CE4A01D2C1A4B63778033792CE",
"inLedger": 195480,
"ledger_index": 195480
},
"validated": true
},
{
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Balance": "9999999970",
"Flags": 0,
"OwnerCount": 3,
"Sequence": 4
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05",
"PreviousFields": {
"Balance": "9999999980",
"OwnerCount": 2,
"Sequence": 3
},
"PreviousTxnID": "002AA492496A1543DBD3680BF8CF21B6D6A078CE4A01D2C1A4B63778033792CE",
"PreviousTxnLgrSeq": 195480
}
},
{
"ModifiedNode": {
"FinalFields": {
"Flags": 0,
"Owner": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"RootIndex": "A39F044D860C5B5846AA7E0FAAD44DC8897F0A62B2F628AA073B21B3EC146010"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "A39F044D860C5B5846AA7E0FAAD44DC8897F0A62B2F628AA073B21B3EC146010"
}
},
{
"ModifiedNode": {
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06",
"PreviousTxnID": "0222B59280D165D40C464EA75AAD08A4D152C46A38C0625DEECF6EE87FC5B9E1",
"PreviousTxnLgrSeq": 343555
}
},
{
"CreatedNode": {
"LedgerEntryType": "RippleState",
"LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959",
"NewFields": {
"Balance": {
"currency": "USD",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "0"
},
"Flags": 131072,
"HighLimit": {
"currency": "USD",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "100"
},
"LowLimit": {
"currency": "USD",
"issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"value": "0"
}
}
}
},
{
"ModifiedNode": {
"FinalFields": {
"ExchangeRate": "4E11C37937E08000",
"Flags": 0,
"RootIndex": "F60ADF645E78B69857D2E4AEC8B7742FEABC8431BD8611D099B428C3E816DF93",
"TakerGetsCurrency": "0000000000000000000000000000000000000000",
"TakerGetsIssuer": "0000000000000000000000000000000000000000",
"TakerPaysCurrency": "0000000000000000000000004254430000000000",
"TakerPaysIssuer": "5E7B112523F68D2F5E879DB4EAC51C6698A69304"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "F60ADF645E78B69857D2E4AEC8B7742FEABC8431BD8611D099B428C3E816DF93"
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Fee": "10",
"Flags": 0,
"LimitAmount": {
"currency": "USD",
"issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"value": "100"
},
"Sequence": 3,
"SigningPubKey": "02BC8C02199949B15C005B997E7C8594574E9B02BA2D0628902E0532989976CF9D",
"TransactionType": "TrustSet",
"TxnSignature": "3044022058A89552068D1A274EE72BA71363E33E54E6608BC28A84DEC6EE530FC2B5C979022029F4D1EA1237A1F717C5F5EC526E6CFB6DF54C30BADD25EDDE7D2FDBC8F17E34",
"date": 416347560,
"hash": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8",
"inLedger": 343570,
"ledger_index": 343570
},
"validated": true
}
],
"validated": true
}
}</code></pre></div>
<div style="display: none;" id="code-10-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger_index_max": 8696227,
"ledger_index_min": 32570,
"limit": 2,
"offset": 1,
"status": "success",
"transactions": [
{
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Balance": "9999999980",
"Flags": 0,
"OwnerCount": 2,
"Sequence": 3
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05",
"PreviousFields": {
"Balance": "9999999990",
"OwnerCount": 1,
"Sequence": 2
},
"PreviousTxnID": "389720F6FD8A144F171708F9ECB334D704CBCFEFBCDA152D931AC34FB5F9E32B",
"PreviousTxnLgrSeq": 95405
}
},
{
"CreatedNode": {
"LedgerEntryType": "RippleState",
"LedgerIndex": "718C6D58DD3BBAAAEBFE48B8FBE3C32C9F6F2EBC395233BA95D0057078EE07DB",
"NewFields": {
"Balance": {
"currency": "USD",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "0"
},
"Flags": 131072,
"HighLimit": {
"currency": "USD",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "100"
},
"LowLimit": {
"currency": "USD",
"issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"value": "0"
}
}
}
},
{
"ModifiedNode": {
"FinalFields": {
"Flags": 0,
"Owner": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"RootIndex": "77F65EFF930ED7E93C6CC839C421E394D6B1B6A47CEA8A140D63EC9C712F46F5"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "77F65EFF930ED7E93C6CC839C421E394D6B1B6A47CEA8A140D63EC9C712F46F5"
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"Balance": "78991384535796",
"Flags": 0,
"OwnerCount": 3,
"Sequence": 188
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "B33FDD5CF3445E1A7F2BE9B06336BEBD73A5E3EE885D3EF93F7E3E2992E46F1A",
"PreviousTxnID": "E9E1988A0F061679E5D14DE77DB0163CE0BBDC00F29E396FFD1DA0366E7D8904",
"PreviousTxnLgrSeq": 195455
}
},
{
"ModifiedNode": {
"FinalFields": {
"ExchangeRate": "4E11C37937E08000",
"Flags": 0,
"RootIndex": "F60ADF645E78B69857D2E4AEC8B7742FEABC8431BD8611D099B428C3E816DF93",
"TakerGetsCurrency": "0000000000000000000000000000000000000000",
"TakerGetsIssuer": "0000000000000000000000000000000000000000",
"TakerPaysCurrency": "0000000000000000000000004254430000000000",
"TakerPaysIssuer": "5E7B112523F68D2F5E879DB4EAC51C6698A69304"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "F60ADF645E78B69857D2E4AEC8B7742FEABC8431BD8611D099B428C3E816DF93"
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Fee": "10",
"Flags": 0,
"LimitAmount": {
"currency": "USD",
"issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"value": "100"
},
"Sequence": 2,
"SigningPubKey": "02BC8C02199949B15C005B997E7C8594574E9B02BA2D0628902E0532989976CF9D",
"TransactionType": "TrustSet",
"TxnSignature": "304402200EF81EC32E0DFA9BE376B20AFCA11765ED9FEA04CA8B77C7178DAA699F7F5AFF02202DA484DBD66521AC317D84F7717EC4614E2F5DB743E313E8B48440499CC0DBA4",
"date": 413620090,
"hash": "002AA492496A1543DBD3680BF8CF21B6D6A078CE4A01D2C1A4B63778033792CE",
"inLedger": 195480,
"ledger_index": 195480
},
"validated": true
},
{
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Balance": "9999999970",
"Flags": 0,
"OwnerCount": 3,
"Sequence": 4
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05",
"PreviousFields": {
"Balance": "9999999980",
"OwnerCount": 2,
"Sequence": 3
},
"PreviousTxnID": "002AA492496A1543DBD3680BF8CF21B6D6A078CE4A01D2C1A4B63778033792CE",
"PreviousTxnLgrSeq": 195480
}
},
{
"ModifiedNode": {
"FinalFields": {
"Flags": 0,
"Owner": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"RootIndex": "A39F044D860C5B5846AA7E0FAAD44DC8897F0A62B2F628AA073B21B3EC146010"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "A39F044D860C5B5846AA7E0FAAD44DC8897F0A62B2F628AA073B21B3EC146010"
}
},
{
"ModifiedNode": {
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06",
"PreviousTxnID": "0222B59280D165D40C464EA75AAD08A4D152C46A38C0625DEECF6EE87FC5B9E1",
"PreviousTxnLgrSeq": 343555
}
},
{
"CreatedNode": {
"LedgerEntryType": "RippleState",
"LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959",
"NewFields": {
"Balance": {
"currency": "USD",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "0"
},
"Flags": 131072,
"HighLimit": {
"currency": "USD",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "100"
},
"LowLimit": {
"currency": "USD",
"issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"value": "0"
}
}
}
},
{
"ModifiedNode": {
"FinalFields": {
"ExchangeRate": "4E11C37937E08000",
"Flags": 0,
"RootIndex": "F60ADF645E78B69857D2E4AEC8B7742FEABC8431BD8611D099B428C3E816DF93",
"TakerGetsCurrency": "0000000000000000000000000000000000000000",
"TakerGetsIssuer": "0000000000000000000000000000000000000000",
"TakerPaysCurrency": "0000000000000000000000004254430000000000",
"TakerPaysIssuer": "5E7B112523F68D2F5E879DB4EAC51C6698A69304"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "F60ADF645E78B69857D2E4AEC8B7742FEABC8431BD8611D099B428C3E816DF93"
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Fee": "10",
"Flags": 0,
"LimitAmount": {
"currency": "USD",
"issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"value": "100"
},
"Sequence": 3,
"SigningPubKey": "02BC8C02199949B15C005B997E7C8594574E9B02BA2D0628902E0532989976CF9D",
"TransactionType": "TrustSet",
"TxnSignature": "3044022058A89552068D1A274EE72BA71363E33E54E6608BC28A84DEC6EE530FC2B5C979022029F4D1EA1237A1F717C5F5EC526E6CFB6DF54C30BADD25EDDE7D2FDBC8F17E34",
"date": 416347560,
"hash": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8",
"inLedger": 343570,
"ledger_index": 343570
},
"validated": true
}
],
"validated": true
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account</td>
<td>String</td>
<td>Unique address identifying the related account</td>
</tr>
<tr>
<td>ledger_index_min</td>
<td>Integer</td>
<td>The sequence number of the earliest ledger actually searched for transactions.</td>
</tr>
<tr>
<td>ledger_index_max</td>
<td>Integer</td>
<td>The sequence number of the most recent ledger actually searched for transactions.</td>
</tr>
<tr>
<td>limit</td>
<td>Integer</td>
<td>The <code title="Double-click to expand/collapse">limit</code> value used in the request. (This may differ from the actual limit value enforced by the server.)</td>
</tr>
<tr>
<td>marker</td>
<td>(Not Specified)</td>
<td>Server-defined value. Pass this to the next call in order to resume where this call left off.</td>
</tr>
<tr>
<td>offset</td>
<td>Integer</td>
<td>The <code title="Double-click to expand/collapse">offset</code> value used in the request.</td>
</tr>
<tr>
<td>transactions</td>
<td>Array</td>
<td>Array of transactions matching the request’s criteria, as explained below.</td>
</tr>
<tr>
<td>validated</td>
<td>Boolean</td>
<td>If included and set to <code title="Double-click to expand/collapse">true</code>, the information in this request comes from a validated ledger version. Otherwise, the information is subject to change.</td>
</tr>
</tbody>
</table><p><em>Note:</em> The server may respond with different values of <code title="Double-click to expand/collapse">ledger_index_min</code> and <code title="Double-click to expand/collapse">ledger_index_max</code> than you provided in the request, for example if it did not have the versions you specified on hand. If you are iterating over data, you should check these fields with every call to make sure you don’t miss anything if the values change over time.</p><p>Each transaction object includes the following fields, depending on whether it was requested in JSON or hex string (<code title="Double-click to expand/collapse">"binary":true</code>) format.</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>ledger_index</td>
<td>Integer</td>
<td>The sequence number of the ledger version that included this transaction.</td>
</tr>
<tr>
<td>meta</td>
<td>Object (JSON) or String (Binary)</td>
<td>If <code title="Double-click to expand/collapse">binary</code> is True, then this is a hex string of the transaction metadata. Otherwise, the transaction metadata is included in JSON format.</td>
</tr>
<tr>
<td>tx</td>
<td>Object</td>
<td>(JSON mode only) JSON object defining the transaction</td>
</tr>
<tr>
<td>tx_blob</td>
<td>String</td>
<td>(Binary mode only) Unique hashed String representing the transaction.</td>
</tr>
<tr>
<td>validated</td>
<td>Boolean</td>
<td>Whether or not the transaction is included in a validated ledger. Any transaction not yet in a validated ledger is subject to change.</td>
</tr>
</tbody>
</table><h2 id="wallet-propose">wallet_propose</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/WalletPropose.cpp" title="Source">[Source]<br></a></p><p>Use the <code title="Double-click to expand/collapse">wallet_propose</code> method to generate the keys needed for a new account. The account created this way will only become officially included in the Ripple network when it receives a transaction that provides enough XRP to meet the account reserve. (The <code title="Double-click to expand/collapse">wallet_propose</code> command does not affect the global network. Technically, it is not strictly necessary for creating a new account: you could generate keys some other way, but that is not recommended.)</p><p><em>The <code title="Double-click to expand/collapse">wallet_propose</code> request is an admin command that cannot be run by unpriviledged users!</em> (Since admin commands are not transmitted over the outside network this command is protected against people sniffing the network for account secrets.)</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-11" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-11-0">WebSocket</a></li><li><a href="#code-11-1">JSON-RPC</a></li><li><a href="#code-11-2">Commandline</a></li></ul>
<div id="code-11-0"><pre><code title="Double-click to expand/collapse">{
"command": "wallet_propose",
"passphrase": "test"
}</code></pre></div>
<div style="display: none;" id="code-11-1"><pre><code title="Double-click to expand/collapse">{
"method": "wallet_propose",
"params": [
{
"passphrase": "test"
}
]
}</code></pre></div>
<div style="display: none;" id="code-11-2"><pre><code title="Double-click to expand/collapse">#Syntax: wallet_propose [passphrase]
rippled -- wallet_propose test</code></pre></div>
</div><p>The request can contain the following parameter:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>passphrase</td>
<td>String</td>
<td>(Optional) Specify a passphrase, for testing purposes. If omitted, the server will use a random number to generate the master key. Outside of testing purposes, keys should always be randomly generated. Some values, which resemble Ripple addresses and some other formats, are prohibited.</td>
</tr>
</tbody>
</table><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-12" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-12-0">WebSocket</a></li></ul>
<div id="code-12-0"><pre><code title="Double-click to expand/collapse">{
"result" : {
"account_id" : "rp2YHP5k3bSd6LRFT4phDjVMLXQjH4hiaG",
"master_key" : "AHOY CLAD JUDD NOON MINI CHAD CUBA JAN KANT AMID DEL LETS",
"master_seed" : "ssyXjRurNo75TjXjubby65cD96ak8",
"master_seed_hex" : "5BDD10A694F2E36CCAC0CBE28CE2AC49",
"public_key" : "aBPXjfsA7fY2LLPxRuZ7Sj2ADzoSEGDW4Atd5MgxdHz5FQvGPbqU",
"public_key_hex" : "02CF23BCB1252D153713954AF374F44F82C255170ECAEDB059783128F53288F34F",
"status" : "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing various important information about the new account, including the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>master_seed</td>
<td>String</td>
<td>The <a href="https://ripple.com/wiki/Master_Key">master seed</a> from which all other information about this account is derived, in Ripple’s base-58 encoded string format.</td>
</tr>
<tr>
<td>master_seed_hex</td>
<td>String</td>
<td>The master seed, in hex format.</td>
</tr>
<tr>
<td>master_key</td>
<td>String</td>
<td>The master seed, in <a href="http://tools.ietf.org/html/rfc1751">RFC 1751</a> format.</td>
</tr>
<tr>
<td>account_id</td>
<td>String</td>
<td>The public address of the account.</td>
</tr>
<tr>
<td>public_key</td>
<td>String</td>
<td>The public key of the account, in encoded string format.</td>
</tr>
<tr>
<td>public_key_hex</td>
<td>String</td>
<td>The public key of the account, in hex format.</td>
</tr>
</tbody>
</table><p>The key generated by this method can also be used as a regular key for an account if you use the <a href="transactions.html#setregularkey">SetRegularKey transaction type</a> to do so.</p><h1 id="managing-ledgers">Managing Ledgers</h1><p>The globally-shared ledger is the core of the Ripple Network. Each <code title="Double-click to expand/collapse">rippled</code> server keeps a current version of the ledger, which contains all the accounts, transactions, offers, and other data in the network in an optimized tree format. As transactions and offers are proposed, each server incorporates them into its current copy of the ledger, closes it periodically, and (if configured) participates in the process of advancing the globally-validated version. After concensus is reached in the network, that ledger version is validated and becomes permanently immutable. Any transactions that were not included in one ledger become candidates to be included in the next validated version.</p><h2 id="ledger">ledger</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/Ledger.cpp" title="Source">[Source]<br></a></p><p>Retrieve information about the public ledger.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-13" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-13-0">WebSocket</a></li><li><a href="#code-13-1">JSON-RPC</a></li><li><a href="#code-13-2">Commandline</a></li></ul>
<div id="code-13-0"><pre><code title="Double-click to expand/collapse">{
"command": "ledger",
"full": false,
"accounts": false,
"transactions": false,
"expand": false,
"ledger_index": "current"
}</code></pre></div>
<div style="display: none;" id="code-13-1"><pre><code title="Double-click to expand/collapse">{
"method": "ledger",
"params": [
{
"accounts": false,
"expand": false,
"full": false,
"ledger_index": "current",
"transactions": false
}
]
}</code></pre></div>
<div style="display: none;" id="code-13-2"><pre><code title="Double-click to expand/collapse">#Syntax: ledger ledger_index|ledger_hash [full]
rippled -- ledger current false</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#ledger">Try it!</a></p><p>The request can contain the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>accounts</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, return information on accounts in the ledger. <em>Admin required.</em> If enabled, this method returns a large amount of data, which may cause the request to fail due to a timeout, depending on the server load and capabilities.</td>
</tr>
<tr>
<td>transactions</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, return information on transactions in the specified ledger version.</td>
</tr>
<tr>
<td>full</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, return full information on the entire ledger. (Equivalent to enabling <code title="Double-click to expand/collapse">transactions</code>, <code title="Double-click to expand/collapse">accounts</code>, and <code title="Double-click to expand/collapse">expand</code> <em>Admin required</em></td>
</tr>
<tr>
<td>expand</td>
<td>Boolean</td>
<td>(Optional, defaults to false) Provide full JSON-formatted information for transaction/account information instead of just hashes</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) A 20-byte hex string for the ledger version to use. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String or Unsigned Integer</td>
<td>(Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
</tbody>
</table><p>The <code title="Double-click to expand/collapse">ledger</code> field is deprecated and may be removed without further notice.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-14" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-14-0">WebSocket</a></li><li><a href="#code-14-1">JSON-RPC</a></li></ul>
<div id="code-14-0"><pre><code title="Double-click to expand/collapse">{
"id": 14,
"status": "success",
"type": "response",
"result": {
"ledger": {
"accepted": true,
"account_hash": "03AC618315876C2B1F50EBB570C84BB11AB7FFE571CFE173E898326C8281C623",
"close_time": 453452750,
"close_time_human": "2014-May-15 07:05:50",
"close_time_resolution": 10,
"closed": true,
"hash": "957034715D2A4065820E3EC1413FCE23AB4A6496C150A355C691B1F9A985416C",
"ledger_hash": "957034715D2A4065820E3EC1413FCE23AB4A6496C150A355C691B1F9A985416C",
"ledger_index": "6636643",
"parent_hash": "22128FF378D06A0040B9C67D38EBBB2C175CB7ACDDA1F8772266338E97D90BAF",
"seqNum": "6636643",
"totalCoins": "99999990220863890",
"total_coins": "99999990220863890",
"transaction_hash": "D5B2F85496B00841A9FE16BFB91CBA4DA1C3D337CAD9F4EE13A0D7D8F198D02C"
}
}
}</code></pre></div>
<div style="display: none;" id="code-14-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"ledger": {
"closed": false,
"ledger_index": "8696231",
"parent_hash": "A9008337AA9441B8961D9F97183B8BFB3EECFAA7D2FA65545B4CB552AEA65909",
"seqNum": "8696231"
},
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing information about the ledger, including the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>accepted</td>
<td>Boolean</td>
<td>This designation is for internal protocol use, and should not be used. It does <em>not</em> mean the same as <code title="Double-click to expand/collapse">validated</code></td>
</tr>
<tr>
<td>account_hash</td>
<td>String</td>
<td>Hash of all account state information in this ledger, as hex</td>
</tr>
<tr>
<td>close_time</td>
<td>Integer</td>
<td>The time this ledger was closed, in seconds since the <a href="#specifying-time">Ripple Epoch</a></td>
</tr>
<tr>
<td>close_time_human</td>
<td>String</td>
<td>The time this ledger was closed, in human-readable format</td>
</tr>
<tr>
<td>close_time_resolution</td>
<td>Integer</td>
<td>Approximate number of seconds between closing one ledger version and closing the next one</td>
</tr>
<tr>
<td>closed</td>
<td>Boolean</td>
<td>Whether or not this ledger has been closed</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>Unique identifying hash of the entire ledger.</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String</td>
<td>Ledger sequence number as a quoted integer</td>
</tr>
<tr>
<td>parent_hash</td>
<td>String</td>
<td>Unique identifying hash of the ledger that came immediately before this one.</td>
</tr>
<tr>
<td>total_coins</td>
<td>String</td>
<td>Total number of XRP drops in the network, as a quoted integer. (This decreases as transaction fees cause XRP to be destroyed.)</td>
</tr>
<tr>
<td>transaction_hash</td>
<td>String</td>
<td>Hash of the transaction information included in this ledger, as hex</td>
</tr>
<tr>
<td>validated</td>
<td>Boolean</td>
<td>(<a href="https://ripplelabs.atlassian.net/browse/RIPD-569">Upcoming</a>) If included and set to <code title="Double-click to expand/collapse">true</code>, the information in this request describes a validated ledger version. Otherwise, the information is subject to change.</td>
</tr>
</tbody>
</table><p>The following fields are deprecated and may be removed without further notice: <code title="Double-click to expand/collapse">hash</code>, <code title="Double-click to expand/collapse">seqNum</code>, <code title="Double-click to expand/collapse">totalCoins</code>.</p><h2 id="ledger-closed">ledger_closed</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/LedgerClosed.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">ledger_closed</code> method returns the unique identifiers of the most recently closed ledger. (This ledger is not necessarily validated and immutable yet.)</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-15" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-15-0">WebSocket</a></li><li><a href="#code-15-1">JSON-RPC</a></li><li><a href="#code-15-2">Commandline</a></li></ul>
<div id="code-15-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"command": "ledger_closed"
}</code></pre></div>
<div style="display: none;" id="code-15-1"><pre><code title="Double-click to expand/collapse">{
"method": "ledger_closed",
"params": [
{}
]
}</code></pre></div>
<div style="display: none;" id="code-15-2"><pre><code title="Double-click to expand/collapse">#Syntax: ledger_closed
rippled -- ledger_closed</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#ledger_closed">Try it!</a></p><p>This method accepts no parameters.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-16" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-16-0">WebSocket</a></li><li><a href="#code-16-1">JSON-RPC</a></li></ul>
<div id="code-16-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"status": "success",
"type": "response",
"result": {
"ledger_hash": "17ACB57A0F73B5160713E81FE72B2AC9F6064541004E272BD09F257D57C30C02",
"ledger_index": 6643099
}
}</code></pre></div>
<div style="display: none;" id="code-16-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"ledger_hash": "8B5A0C5F6B198254A6E411AF55C29EE40AA86251D2E78DD0BB17647047FA9C24",
"ledger_index": 8696231,
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>20-byte hex string with a unique hash of the ledger</td>
</tr>
<tr>
<td>ledger_index</td>
<td>Unsigned Integer</td>
<td>Sequence number of this ledger</td>
</tr>
</tbody>
</table><h2 id="ledger-current">ledger_current</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/LedgerCurrent.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">ledger_current</code> method returns the unique identifiers of the current in-progress ledger. This command is mostly useful for testing, because the ledger returned is still in flux.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-17" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-17-0">WebSocket</a></li><li><a href="#code-17-1">JSON-RPC</a></li><li><a href="#code-17-2">Commandline</a></li></ul>
<div id="code-17-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"command": "ledger_current"
}</code></pre></div>
<div style="display: none;" id="code-17-1"><pre><code title="Double-click to expand/collapse">{
"method": "ledger_current",
"params": [
{}
]
}</code></pre></div>
<div style="display: none;" id="code-17-2"><pre><code title="Double-click to expand/collapse">#Syntax: ledger_current
rippled -- ledger_current</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#ledger_current">Try it!</a></p><p>The request contains no parameters.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-18" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-18-0">WebSocket</a></li><li><a href="#code-18-1">JSON-RPC</a></li></ul>
<div id="code-18-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"status": "success",
"type": "response",
"result": {
"ledger_current_index": 6643240
}
}</code></pre></div>
<div style="display: none;" id="code-18-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"ledger_current_index": 8696233,
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following field:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>ledger_current_index</td>
<td>Unsigned Integer</td>
<td>Sequence number of this ledger</td>
</tr>
</tbody>
</table><p>A <code title="Double-click to expand/collapse">ledger_hash</code> field is not provided, because the hash of the current ledger is constantly changing along with its contents.</p><h2 id="ledger-data">ledger_data</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/LedgerData.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">ledger_data</code> method retrieves contents of the specified ledger. You can iterate through several calls in order to retrieve the entire contents of a single ledger version.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-19" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-19-0">WebSocket</a></li><li><a href="#code-19-1">JSON-RPC</a></li></ul>
<div id="code-19-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"ledger_hash": "842B57C1CC0613299A686D3E9F310EC0422C84D3911E5056389AA7E5808A93C8",
"command": "ledger_data",
"limit": 5,
"binary": true
}</code></pre></div>
<div style="display: none;" id="code-19-1"><pre><code title="Double-click to expand/collapse">{
"method": "ledger_data",
"params": [
{
"binary": true,
"ledger_hash": "842B57C1CC0613299A686D3E9F310EC0422C84D3911E5056389AA7E5808A93C8",
"limit": 5
}
]
}</code></pre></div>
</div><p><em>Note:</em> There is no commandline syntax for <code title="Double-click to expand/collapse">ledger_data</code>.</p><p>A request can include the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>(Arbitrary)</td>
<td>(WebSocket only) Any identifier to separate this request from others in case the responses are delayed or out of order.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) A 20-byte hex string for the ledger version to use. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String or Unsigned Integer</td>
<td>(Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>binary</td>
<td>Boolean</td>
<td>(Optional, defaults to False) If set to true, return data nodes as hashed hex strings instead of JSON.</td>
</tr>
<tr>
<td>limit</td>
<td>Integer</td>
<td>(Optional, default varies) Limit the number of nodes to retrieve. The server is not required to honor this value.</td>
</tr>
<tr>
<td>marker</td>
<td>(Not Specified)</td>
<td>Server-provided value to specify where to resume retrieving data from.</td>
</tr>
</tbody>
</table><p>The <code title="Double-click to expand/collapse">ledger</code> field is deprecated and may be removed without further notice.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-20" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-20-0">WebSocket (binary:true)</a></li><li><a href="#code-20-1">WebSocket (binary:false)</a></li><li><a href="#code-20-2">JSON-RPC (binary:true)</a></li></ul>
<div id="code-20-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"result": {
"ledger_hash": "842B57C1CC0613299A686D3E9F310EC0422C84D3911E5056389AA7E5808A93C8",
"ledger_index": "6885842",
"marker": "0002A590029B53BE7857EFF9985F770EC792CE483720EB5E963C4D6A607D43DF",
"state": [
{
"data": "11006122000000002400000001250062FEA42D0000000055C204A65CF2542946289A3358C67D991B5E135FABFA89F271DBA7A150C08CA0466240000000354540208114C909F42250CFE8F12A7A1A0DFBD3CBD20F32CD79",
"index": "00001A2969BE1FC85F1D7A55282FA2E6D95C71D2E4B9C0FDD3D9994F3C00FF8F"
},
{
"data": "11006F22000000002400000003250035788533000000000000000034000000000000000055555B93628BF3EC318892BB7C7CDCB6732FF53D12B6EEC4FAF60DD1AEE1C6101F501071633D7DE1B6AEB32F87F1A73258B13FC8CC32942D53A66D4F038D7EA4C6800064D4838D7EA4C68000000000000000000000000000425443000000000035DD7DF146893456296BF4061FBE68735D28F3286540000000000F42408114A4B8F5F7B644AEDC3447F9459C132EEB016A133B",
"index": "000037C6659BB98F8D09F2F4CFEB27DE8EFEAFE54DD9E1C13AECDF5794B0C0F5"
},
{
"data": "11006F2200020000240000000A250067395C33000000000000000034000000000000000055A160BC41A45B6BB118DF23D77E4FF23C723431B917F50DCB41319ECC2821F34C5010DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C1AA535D3D0C00064D554C88B43EFA00000000000000000000000000055534400000000000A20B3C85F482532A9578DBB3950B85CA06594D165400000B59B9F780081148366FB9ACD2A0FD822E31112D2EB6F98C317C2C1",
"index": "0000A8791F78CC9B39200E12A9BDAACCF40A72A512FA815525CFC9BA772990F7"
},
{
"data": "1100612200000000240000000125003E742F2D0000000055286498B513710CFEB2D723A554C7557983D1952DF4DEE342C40DCB43067C9A21624000000306DC42008114225BAB89C4A4B94624BB069D6DB3C819F934991C",
"index": "0000B717320558E2DE1A3B9FDB24E9A695BF05D1A44E4A4683212BB1DD0FBA23"
},
{
"data": "110072220002000025000B65783700000000000000003800000000000000005587591A63051645F37B85D1FBA55EE69B1C96BFF16904F5C99F03FB93D42D03756280000000000000000000000000000000000000004254430000000000000000000000000000000000000000000000000166800000000000000000000000000000000000000042544300000000000A20B3C85F482532A9578DBB3950B85CA06594D167D4C38D7EA4C680000000000000000000000000004254430000000000C795FDF8A637BCAAEDAD1C434033506236C82A2D",
"index": "000103996A3BAD918657F86E12A67D693E8FC8A814DA4B958A244B5F14D93E58"
}
]
},
"status": "success",
"type": "response"
}</code></pre></div>
<div style="display: none;" id="code-20-1"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"result": {
"ledger_hash": "842B57C1CC0613299A686D3E9F310EC0422C84D3911E5056389AA7E5808A93C8",
"ledger_index": "6885842",
"marker": "0002A590029B53BE7857EFF9985F770EC792CE483720EB5E963C4D6A607D43DF",
"state": [
{
"Account": "rKKzk9ghA2iuy3imqMXUHJqdRPMtNDGf4c",
"Balance": "893730848",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 0,
"PreviousTxnID": "C204A65CF2542946289A3358C67D991B5E135FABFA89F271DBA7A150C08CA046",
"PreviousTxnLgrSeq": 6487716,
"Sequence": 1,
"index": "00001A2969BE1FC85F1D7A55282FA2E6D95C71D2E4B9C0FDD3D9994F3C00FF8F"
},
{
"Account": "rGryPmNWFognBgMtr9k4quqPbbEcCrhNmD",
"BookDirectory": "71633D7DE1B6AEB32F87F1A73258B13FC8CC32942D53A66D4F038D7EA4C68000",
"BookNode": "0000000000000000",
"Flags": 0,
"LedgerEntryType": "Offer",
"OwnerNode": "0000000000000000",
"PreviousTxnID": "555B93628BF3EC318892BB7C7CDCB6732FF53D12B6EEC4FAF60DD1AEE1C6101F",
"PreviousTxnLgrSeq": 3504261,
"Sequence": 3,
"TakerGets": "1000000",
"TakerPays": {
"currency": "BTC",
"issuer": "rnuF96W4SZoCJmbHYBFoJZpR8eCaxNvekK",
"value": "1"
},
"index": "000037C6659BB98F8D09F2F4CFEB27DE8EFEAFE54DD9E1C13AECDF5794B0C0F5"
},
{
"Account": "rUy8tW38MW9ma7kSjRgB2GHtTkQAFRyrN8",
"BookDirectory": "DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C1AA535D3D0C000",
"BookNode": "0000000000000000",
"Flags": 131072,
"LedgerEntryType": "Offer",
"OwnerNode": "0000000000000000",
"PreviousTxnID": "A160BC41A45B6BB118DF23D77E4FF23C723431B917F50DCB41319ECC2821F34C",
"PreviousTxnLgrSeq": 6764892,
"Sequence": 10,
"TakerGets": "780000000000",
"TakerPays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "5850"
},
"index": "0000A8791F78CC9B39200E12A9BDAACCF40A72A512FA815525CFC9BA772990F7"
},
{
"Account": "rh3C81VfNDhhWPQWCU8ZGgknvdgNUvRtM9",
"Balance": "13000000000",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 0,
"PreviousTxnID": "286498B513710CFEB2D723A554C7557983D1952DF4DEE342C40DCB43067C9A21",
"PreviousTxnLgrSeq": 4092975,
"Sequence": 1,
"index": "0000B717320558E2DE1A3B9FDB24E9A695BF05D1A44E4A4683212BB1DD0FBA23"
},
{
"Balance": {
"currency": "BTC",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "0"
},
"Flags": 131072,
"HighLimit": {
"currency": "BTC",
"issuer": "rKUK9omZqVEnraCipKNFb5q4tuNTeqEDZS",
"value": "10"
},
"HighNode": "0000000000000000",
"LedgerEntryType": "RippleState",
"LowLimit": {
"currency": "BTC",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "0"
},
"LowNode": "0000000000000000",
"PreviousTxnID": "87591A63051645F37B85D1FBA55EE69B1C96BFF16904F5C99F03FB93D42D0375",
"PreviousTxnLgrSeq": 746872,
"index": "000103996A3BAD918657F86E12A67D693E8FC8A814DA4B958A244B5F14D93E58"
}
]
},
"status": "success",
"type": "response"
}</code></pre></div>
<div style="display: none;" id="code-20-2"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"ledger_hash": "842B57C1CC0613299A686D3E9F310EC0422C84D3911E5056389AA7E5808A93C8",
"ledger_index": "6885842",
"marker": "0002A590029B53BE7857EFF9985F770EC792CE483720EB5E963C4D6A607D43DF",
"state": [
{
"data": "11006122000000002400000001250062FEA42D0000000055C204A65CF2542946289A3358C67D991B5E135FABFA89F271DBA7A150C08CA0466240000000354540208114C909F42250CFE8F12A7A1A0DFBD3CBD20F32CD79",
"index": "00001A2969BE1FC85F1D7A55282FA2E6D95C71D2E4B9C0FDD3D9994F3C00FF8F"
},
{
"data": "11006F22000000002400000003250035788533000000000000000034000000000000000055555B93628BF3EC318892BB7C7CDCB6732FF53D12B6EEC4FAF60DD1AEE1C6101F501071633D7DE1B6AEB32F87F1A73258B13FC8CC32942D53A66D4F038D7EA4C6800064D4838D7EA4C68000000000000000000000000000425443000000000035DD7DF146893456296BF4061FBE68735D28F3286540000000000F42408114A4B8F5F7B644AEDC3447F9459C132EEB016A133B",
"index": "000037C6659BB98F8D09F2F4CFEB27DE8EFEAFE54DD9E1C13AECDF5794B0C0F5"
},
{
"data": "11006F2200020000240000000A250067395C33000000000000000034000000000000000055A160BC41A45B6BB118DF23D77E4FF23C723431B917F50DCB41319ECC2821F34C5010DFA3B6DDAB58C7E8E5D944E736DA4B7046C30E4F460FD9DE4C1AA535D3D0C00064D554C88B43EFA00000000000000000000000000055534400000000000A20B3C85F482532A9578DBB3950B85CA06594D165400000B59B9F780081148366FB9ACD2A0FD822E31112D2EB6F98C317C2C1",
"index": "0000A8791F78CC9B39200E12A9BDAACCF40A72A512FA815525CFC9BA772990F7"
},
{
"data": "1100612200000000240000000125003E742F2D0000000055286498B513710CFEB2D723A554C7557983D1952DF4DEE342C40DCB43067C9A21624000000306DC42008114225BAB89C4A4B94624BB069D6DB3C819F934991C",
"index": "0000B717320558E2DE1A3B9FDB24E9A695BF05D1A44E4A4683212BB1DD0FBA23"
},
{
"data": "110072220002000025000B65783700000000000000003800000000000000005587591A63051645F37B85D1FBA55EE69B1C96BFF16904F5C99F03FB93D42D03756280000000000000000000000000000000000000004254430000000000000000000000000000000000000000000000000166800000000000000000000000000000000000000042544300000000000A20B3C85F482532A9578DBB3950B85CA06594D167D4C38D7EA4C680000000000000000000000000004254430000000000C795FDF8A637BCAAEDAD1C434033506236C82A2D",
"index": "000103996A3BAD918657F86E12A67D693E8FC8A814DA4B958A244B5F14D93E58"
}
],
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>ledger_index</td>
<td>Unsigned Integer</td>
<td>Sequence number of this ledger</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>Unique identifying hash of the entire ledger.</td>
</tr>
<tr>
<td>state</td>
<td>Array</td>
<td>Array of JSON objects containing data from the tree, as defined below</td>
</tr>
<tr>
<td>marker</td>
<td>(Not Specified)</td>
<td>Server-defined value. Pass this to the next call in order to resume where this call left off.</td>
</tr>
</tbody>
</table><p>The format of each object in the <code title="Double-click to expand/collapse">state</code> array depends on whether <code title="Double-click to expand/collapse">binary</code> was set to true or not in the request. Each <code title="Double-click to expand/collapse">state</code> object may include the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>data</td>
<td>String</td>
<td>(Only included if <code title="Double-click to expand/collapse">"binary":true</code>) Hex representation of the requested data</td>
</tr>
<tr>
<td>LedgerEntryType</td>
<td>String</td>
<td>(Only included if <code title="Double-click to expand/collapse">"binary":false</code>) String indicating what type of object this is. See <a href="https://ripple.com/wiki/Ledger_Format#Entries">LedgerEntryType</a></td>
</tr>
<tr>
<td>(Additional fields)</td>
<td>(Various)</td>
<td>(Only included if <code title="Double-click to expand/collapse">"binary":false</code>) Additional fields describing this object, depending on which LedgerEntryType it is.</td>
</tr>
<tr>
<td>index</td>
<td>String</td>
<td>Unique identifier for this ledger entry, as hex.</td>
</tr>
</tbody>
</table><h2 id="ledger-entry">ledger_entry</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/LedgerEntry.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">ledger_entry</code> method returns a single entry from the specified ledger. See <a href="https://ripple.com/wiki/Ledger_Format#Entries">LedgerEntryType</a> for information on the different types of objects you can retrieve. <em>Note:</em> There is no commandline version of this method. You can use the <a href="#json"><code title="Double-click to expand/collapse">json</code></a> command to access this method from the commandline instead.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-21" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-21-0">WebSocket</a></li><li><a href="#code-21-1">JSON-RPC</a></li></ul>
<div id="code-21-0"><pre><code title="Double-click to expand/collapse">{
"id": 3,
"command": "ledger_entry",
"type": "account_root",
"account_root": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger_index": "validated"
}</code></pre></div>
<div style="display: none;" id="code-21-1"><pre><code title="Double-click to expand/collapse">{
"method": "ledger_entry",
"params": [
{
"account_root": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"ledger_index": "validated",
"type": "account_root"
}
]
}</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#ledger_entry">Try it!</a></p><p>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:</p><ol>
<li><code title="Double-click to expand/collapse">index</code> - Retrieve an individual ledger node by its unique index</li>
<li><code title="Double-click to expand/collapse">account_root</code> - Retrieve an account node, similar to the <a href="#account-info">account_info</a> command</li>
<li><code title="Double-click to expand/collapse">directory</code> - Retrieve a directory node, which contains a list of IDs linking things</li>
<li><code title="Double-click to expand/collapse">offer</code> - Retrieve an offer node, which defines an offer to exchange currency</li>
<li><code title="Double-click to expand/collapse">ripple_state</code> - Retrieve a RippleState node, which a trust line along which non-XRP balances are held</li>
</ol><p>If you specify more than one of the above items, the server will retrieve only of them; it is undefined which one will be chosen.</p><p>The full list of parameters recognized by this method is as follows:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>index</td>
<td>String</td>
<td>(Optional) Specify the unique identifier of a single ledger entry to retrieve.</td>
</tr>
<tr>
<td>account_root</td>
<td>String</td>
<td>(Optional) Specify the unique address of an account object to retrieve.</td>
</tr>
<tr>
<td>directory</td>
<td>Object or String</td>
<td>(Optional) Specify a directory node to retrieve from the tree. (Directory nodes each contain a list of IDs for things contained in them.) If a string, interpret as the unique key to the directory, in hex. If an object, requires either <code title="Double-click to expand/collapse">dir_root</code> or <code title="Double-click to expand/collapse">owner</code> as a sub-field, plus optionally a <code title="Double-click to expand/collapse">sub_index</code> sub-field.</td>
</tr>
<tr>
<td>directory.sub_index</td>
<td>Unsigned Integer</td>
<td>(Optional) If provided, jumps to a further sub-node in the directory linked-list.</td>
</tr>
<tr>
<td>directory.dir_root</td>
<td>String</td>
<td>(Required if <code title="Double-click to expand/collapse">directory</code> is specified as an object and <code title="Double-click to expand/collapse">directory.owner</code> is not provided) Unique index identifying the directory to retrieve, as a hex string.</td>
</tr>
<tr>
<td>directory.owner</td>
<td>String</td>
<td>(Required if <code title="Double-click to expand/collapse">directory</code> is specified as an object and <code title="Double-click to expand/collapse">directory.dir_root</code> is not provided) Unique address of the account associated with this directory</td>
</tr>
<tr>
<td>offer</td>
<td>Object or String</td>
<td>(Optional) Specify an offer to retrieve. If a string, interpret as a 256-key hex hash. If an object, requires the sub-fields <code title="Double-click to expand/collapse">account</code> and <code title="Double-click to expand/collapse">seq</code> to uniquely identify the offer.</td>
</tr>
<tr>
<td>offer.account</td>
<td>String</td>
<td>(Required if <code title="Double-click to expand/collapse">offer</code> specified) The unique address of the account making the offer to retrieve.</td>
</tr>
<tr>
<td>offer.seq</td>
<td>Unsigned Integer</td>
<td>(Required if <code title="Double-click to expand/collapse">offer</code> specified) The sequence number of the transaction making the offer to retrieve.</td>
</tr>
<tr>
<td>ripple_state</td>
<td>Object</td>
<td>(Optional) Object specifying the RippleState entry to retrieve. The <code title="Double-click to expand/collapse">accounts</code> and <code title="Double-click to expand/collapse">currency</code> sub-fields are required to uniquely specify the RippleState entry to retrieve.</td>
</tr>
<tr>
<td>ripple_state.accounts</td>
<td>Array</td>
<td>(Required if <code title="Double-click to expand/collapse">ripple_state</code> specified) 2-length array of account address strings, defining the two accounts linked by this RippleState entry</td>
</tr>
<tr>
<td>ripple_state.currency</td>
<td>String</td>
<td>(Required if <code title="Double-click to expand/collapse">ripple_state</code> specified) String representation of a currency that this RippleState entry relates to, as either a 3-letter currency code or a 40-character hex code</td>
</tr>
<tr>
<td>binary</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, return hashed data as hex strings. Otherwise, return data in JSON format.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) A 20-byte hex string for the ledger version to use. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String or Unsigned Integer</td>
<td>(Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
</tbody>
</table><p>The <code title="Double-click to expand/collapse">generator</code> and <code title="Double-click to expand/collapse">ledger</code> parameters are deprecated and may be removed without further notice.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-22" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-22-0">WebSocket</a></li><li><a href="#code-22-1">JSON-RPC</a></li></ul>
<div id="code-22-0"><pre><code title="Double-click to expand/collapse">{
"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"
}</code></pre></div>
<div style="display: none;" id="code-22-1"><pre><code title="Double-click to expand/collapse">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
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>index</td>
<td>String</td>
<td>Unique identifying key for this ledger_entry</td>
</tr>
<tr>
<td>ledger_index</td>
<td>Unsigned Integer</td>
<td>Unique sequence number of the ledger from which this data was retrieved</td>
</tr>
<tr>
<td>node</td>
<td>Object</td>
<td>(<code title="Double-click to expand/collapse">"binary":false</code> only) Object containing the data of this ledger node; the exact contents vary depending on the <a href="https://ripple.com/wiki/Ledger_Format#Entries">LedgerEntryType</a> of node retrieved.</td>
</tr>
<tr>
<td>node_binary</td>
<td>String</td>
<td>(<code title="Double-click to expand/collapse">"binary":true</code> only) Binary data of the ledger node retrieved, as hex.</td>
</tr>
</tbody>
</table><h1 id="managing-transactions">Managing Transactions</h1><p>Transactions are the only thing that can modify the shared global ledger of the Ripple Network. All business on the Ripple Network takes the form of transactions, which include not only payments, but also currency-exchange offers, account settings, and changes to the properties of the network itself (like adopting new features).</p><p>There are several sources of complication in transactions. Unlike traditional banking, where a trusted third party (the bank, or the <a href="http://en.wikipedia.org/wiki/Automated_Clearing_House">ACH</a>) verifies the participants’ identities and ensures their balances are adjusted accurately, Ripple uses cryptography and decentralized computing power to accomplish the same thing. Sending XRP, the Ripple Network’s native crypto-currency, requires no third party aside from the distributed network itself. However, that is missing out on the key feature of Ripple: unlike individual crypto-currencies, the Ripple Network natively supports balances in any currency. This brings far more power, but it also means that the system must account for <a href="http://en.wikipedia.org/wiki/Counterparty_risk#Counterparty_risk">counterparty risk</a>, currency conversions, and other issues. The Ripple Network must be robust to keep track of which transactions have been completely validated, even when subject to hardware failures, attacks, or natural disasters.</p><h2 id="tx">tx</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/Tx.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">tx</code> method retrieves information on a single transaction. </p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-23" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-23-0">WebSocket</a></li><li><a href="#code-23-1">JSON-RPC</a></li><li><a href="#code-23-2">Commandline</a></li></ul>
<div id="code-23-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"command": "tx",
"transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
"binary": false
}</code></pre></div>
<div style="display: none;" id="code-23-1"><pre><code title="Double-click to expand/collapse">{
"method": "tx",
"params": [
{
"transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
"binary": false
}
]
}</code></pre></div>
<div style="display: none;" id="code-23-2"><pre><code title="Double-click to expand/collapse">#Syntax: tx transaction [binary]
tx E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7 false</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#tx">Try it!</a></p><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>transaction</td>
<td>String</td>
<td>The 256-bit hash of the transaction, as hex.</td>
</tr>
<tr>
<td>binary</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, return transaction data and metadata as hex strings instead of JSON</td>
</tr>
</tbody>
</table><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-24" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-24-0">WebSocket</a></li></ul>
<div id="code-24-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"result": {
"Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"Amount": {
"currency": "USD",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "1"
},
"Destination": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Fee": "10",
"Flags": 0,
"Paths": [
[
{
"account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"currency": "USD",
"issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"type": 49,
"type_hex": "0000000000000031"
}
],
[
{
"account": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x",
"currency": "USD",
"issuer": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x",
"type": 49,
"type_hex": "0000000000000031"
},
{
"account": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY",
"currency": "USD",
"issuer": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY",
"type": 49,
"type_hex": "0000000000000031"
},
{
"account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"currency": "USD",
"issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"type": 49,
"type_hex": "0000000000000031"
}
]
],
"SendMax": {
"currency": "USD",
"issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"value": "1.01"
},
"Sequence": 88,
"SigningPubKey": "02EAE5DAB54DD8E1C49641D848D5B97D1B29149106174322EDF98A1B2CCE5D7F8E",
"TransactionType": "Payment",
"TxnSignature": "30440220791B6A3E036ECEFFE99E8D4957564E8C84D1548C8C3E80A87ED1AA646ECCFB16022037C5CAC97E34E3021EBB426479F2ACF3ACA75DB91DCC48D1BCFB4CF547CFEAA0",
"hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
"inLedger": 348734,
"ledger_index": 348734,
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"Balance": "59328999119",
"Flags": 0,
"OwnerCount": 11,
"Sequence": 89
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06",
"PreviousFields": {
"Balance": "59328999129",
"Sequence": 88
},
"PreviousTxnID": "C26AA6B4F7C3B9F55E17CD0D11F12032A1C7AD2757229FFD277C9447A8815E6E",
"PreviousTxnLgrSeq": 348700
}
},
{
"ModifiedNode": {
"FinalFields": {
"Balance": {
"currency": "USD",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "-1"
},
"Flags": 131072,
"HighLimit": {
"currency": "USD",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "100"
},
"HighNode": "0000000000000000",
"LowLimit": {
"currency": "USD",
"issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"value": "0"
},
"LowNode": "0000000000000000"
},
"LedgerEntryType": "RippleState",
"LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959",
"PreviousFields": {
"Balance": {
"currency": "USD",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "0"
}
},
"PreviousTxnID": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8",
"PreviousTxnLgrSeq": 343570
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"validated": true
},
"status": "success",
"type": "response"
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the fields of the <a href="transactions.html">Transaction object</a> as well as the following additional fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>hash</td>
<td>String</td>
<td>The SHA-512 hash of the transaction</td>
</tr>
<tr>
<td>inLedger</td>
<td>Unsigned Integer</td>
<td>(Deprecated) Alias for <code title="Double-click to expand/collapse">ledger_index</code>.</td>
</tr>
<tr>
<td>ledger_index</td>
<td>Unsigned Integer</td>
<td>The sequence number of the ledger that includes this transaction.</td>
</tr>
<tr>
<td>meta</td>
<td>Object</td>
<td>Various metadata about the transaction.</td>
</tr>
<tr>
<td>validated</td>
<td>Boolean</td>
<td>True if this data is from a validated ledger version; if omitted or set to false, this data is not final.</td>
</tr>
<tr>
<td>(Various)</td>
<td>(Various)</td>
<td>Other fields from the <a href="transactions.html">Transaction object</a></td>
</tr>
</tbody>
</table><p><em>Note:</em> If the transaction was not found, it means that the rippled server could not find it from the ledger versions on hand. However, that does not mean that the transaction does not exist; it may simply have been included in an older ledger version that the <code title="Double-click to expand/collapse">rippled</code> does not have on hand anymore.</p><h2 id="transaction-entry">transaction_entry</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/TransactionEntry.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">transaction_entry</code> method retrieves information on a single transaction from a specific ledger version. (The <a href="#tx"><code title="Double-click to expand/collapse">tx</code></a> command, by contrast, searches all ledgers for the specified transaction. We recommend using that method instead.) </p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-25" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-25-0">WebSocket</a></li><li><a href="#code-25-1">JSON-RPC</a></li><li><a href="#code-25-2">Commandline</a></li></ul>
<div id="code-25-0"><pre><code title="Double-click to expand/collapse">{
"id": 4,
"command": "transaction_entry",
"tx_hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
"ledger_index": 348734
}</code></pre></div>
<div style="display: none;" id="code-25-1"><pre><code title="Double-click to expand/collapse">{
"method": "transaction_entry",
"params": [
{
"tx_hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
"ledger_index": 348734
}
]
}</code></pre></div>
<div style="display: none;" id="code-25-2"><pre><code title="Double-click to expand/collapse">#Syntax: transaction_entry transaction_hash ledger_index|ledger_hash
rippled -- transaction_entry E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7 348734</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#transaction_entry">Try it!</a></p><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) A 20-byte hex string for the ledger version to use. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String or Unsigned Integer</td>
<td>(Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>tx_hash</td>
<td>String</td>
<td>Unique hash of the transaction you are looking up</td>
</tr>
</tbody>
</table><p><em>Note:</em> This method does not support retrieving information from the current in-progress ledger. You must specify a ledger version in either <code title="Double-click to expand/collapse">ledger_index</code> or <code title="Double-click to expand/collapse">ledger_hash</code>. </p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-26" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-26-0">WebSocket</a></li></ul>
<div id="code-26-0"><pre><code title="Double-click to expand/collapse">{
"id": 4,
"result": {
"ledger_index": 348734,
"metadata": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"Balance": "59328999119",
"Flags": 0,
"OwnerCount": 11,
"Sequence": 89
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06",
"PreviousFields": {
"Balance": "59328999129",
"Sequence": 88
},
"PreviousTxnID": "C26AA6B4F7C3B9F55E17CD0D11F12032A1C7AD2757229FFD277C9447A8815E6E",
"PreviousTxnLgrSeq": 348700
}
},
{
"ModifiedNode": {
"FinalFields": {
"Balance": {
"currency": "USD",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "-1"
},
"Flags": 131072,
"HighLimit": {
"currency": "USD",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "100"
},
"HighNode": "0000000000000000",
"LowLimit": {
"currency": "USD",
"issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"value": "0"
},
"LowNode": "0000000000000000"
},
"LedgerEntryType": "RippleState",
"LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959",
"PreviousFields": {
"Balance": {
"currency": "USD",
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
"value": "0"
}
},
"PreviousTxnID": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8",
"PreviousTxnLgrSeq": 343570
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx_json": {
"Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"Amount": {
"currency": "USD",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "1"
},
"Destination": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"Fee": "10",
"Flags": 0,
"Paths": [
[
{
"account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"currency": "USD",
"issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"type": 49,
"type_hex": "0000000000000031"
}
],
[
{
"account": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x",
"currency": "USD",
"issuer": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x",
"type": 49,
"type_hex": "0000000000000031"
},
{
"account": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY",
"currency": "USD",
"issuer": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY",
"type": 49,
"type_hex": "0000000000000031"
},
{
"account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"currency": "USD",
"issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
"type": 49,
"type_hex": "0000000000000031"
}
]
],
"SendMax": {
"currency": "USD",
"issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
"value": "1.01"
},
"Sequence": 88,
"SigningPubKey": "02EAE5DAB54DD8E1C49641D848D5B97D1B29149106174322EDF98A1B2CCE5D7F8E",
"TransactionType": "Payment",
"TxnSignature": "30440220791B6A3E036ECEFFE99E8D4957564E8C84D1548C8C3E80A87ED1AA646ECCFB16022037C5CAC97E34E3021EBB426479F2ACF3ACA75DB91DCC48D1BCFB4CF547CFEAA0",
"hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
"inLedger": 348734,
"ledger_index": 348734
}
},
"status": "success",
"type": "response"
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>ledger_index</td>
<td>Unsigned Integer</td>
<td>Sequence number of the ledger version the transaction was found in; this is the same as the one from the request.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(May be omitted) Unique hash of the ledger version the transaction was found in; this is the same as the one from the request.</td>
</tr>
<tr>
<td>metadata</td>
<td>Object</td>
<td>Various metadata about the transaction.</td>
</tr>
<tr>
<td>tx_json</td>
<td>Object</td>
<td>JSON representation of the <a href="transactions.html">Transaction object</a></td>
</tr>
</tbody>
</table><p>There are a couple possible reasons the server may fail to find the transaction:</p><ul>
<li>The transaction just does not exist</li>
<li>The transaction exists, but not in the specified ledger version</li>
<li>The server does not have the specified ledger version available. Another server that has the correct version on hand may have a different response.</li>
</ul><h2 id="tx-history">tx_history</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/TxHistory.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">tx_history</code> method retrieves a selection of the most recent transactions made.</p><p><em>Caution:</em> This method is deprecated, and may be removed without further notice.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-27" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-27-0">WebSocket</a></li><li><a href="#code-27-1">JSON-RPC</a></li><li><a href="#code-27-2">Commandline</a></li></ul>
<div id="code-27-0"><pre><code title="Double-click to expand/collapse">{
"id": 5,
"command": "tx_history",
"start": 0
}</code></pre></div>
<div style="display: none;" id="code-27-1"><pre><code title="Double-click to expand/collapse">{
"method": "tx_history",
"params": [
{
"start": 0
}
]
}</code></pre></div>
<div style="display: none;" id="code-27-2"><pre><code title="Double-click to expand/collapse">#Syntax: tx_history [start]
rippled -- tx_history 0</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#tx_history">Try it!</a></p><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>start</td>
<td>Unsigned Integer</td>
<td>Number of transactions to skip over.</td>
</tr>
</tbody>
</table><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-28" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-28-0">WebSocket</a></li><li><a href="#code-28-1">JSON-RPC</a></li></ul>
<div id="code-28-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"status": "success",
"type": "response",
"result": {
"index": 0,
"txs": [
{
"Account": "r9bf8V4ae5xReYnKPXgnwERDFPoW34FhGy",
"Fee": "12",
"Flags": 2147483648,
"LastLedgerSequence": 6907169,
"Sequence": 3276,
"SigningPubKey": "03B7857216DF96BABCC839686670A67602B3EE50D0F12B41C15F73760B8ED394C1",
"TransactionType": "AccountSet",
"TxnSignature": "3045022100CC0A2688DC36DC47BDBD5A571407316DD16A6CB3289E60C9589531707D30EBDB022010A2ED1F8562FEF61461B89E90E9D7245F5DD1AAE6680401A60F7FDA60184312",
"hash": "30FF69D2F2C2FF517A82EC8BA62AA4879E27A6EAF2C9B4AA422B77C23CD11B35",
"inLedger": 6907162,
"ledger_index": 6907162
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"Sequence": 1479735,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TakerGets": "9999999999",
"TakerPays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "48.050907917"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3045022100C110F47609CED085E0C184396877685ACAFF0A5846C859E9A57A8E238788FAE2022042A578D36F3D911E2536A39D74B10A741EF4C77B40738DB66E9E4FA85B797DF2",
"hash": "A5DE72E2E97CB0FA548713FB7C8542FD1A9723EC556D386F13B25F052435B29F",
"inLedger": 6907162,
"ledger_index": 6907162
},
{
"Account": "r9bf8V4ae5xReYnKPXgnwERDFPoW34FhGy",
"Fee": "12",
"Flags": 2147483648,
"LastLedgerSequence": 6907169,
"Sequence": 3275,
"SigningPubKey": "03B7857216DF96BABCC839686670A67602B3EE50D0F12B41C15F73760B8ED394C1",
"TransactionType": "AccountSet",
"TxnSignature": "3044022030E4CCDCBA8D9984C16AD9807D0FE654D4C558C08728B33A6D9F4D05DA811CF102202A6B53015583A6C24054EE93D9B9DDF0D17133676848304BBA5156DD2C2875BE",
"hash": "55DFC8F7EF3976B5968DC462D91B29274E8097C35D43D6B3740AB20584336A9C",
"inLedger": 6907162,
"ledger_index": 6907162
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 131072,
"Sequence": 1479734,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TakerGets": {
"currency": "BTC",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "0.009194668"
},
"TakerPays": "1073380944",
"TransactionType": "OfferCreate",
"TxnSignature": "304402202C0D26EABE058FCE8B6862EF5CAB70674637CE32B1B4E2F3551B9D5A2E1CDC7E02202C191D2697C65478BC2C1489721EB5799A6F3D4A1ECD8FE87A0C4FDCA3704A03",
"hash": "2499BAE9947BE731D7FE2F8E7B6A55E1E5B43BA8D3A9F22E39F79A0CC027A1C8",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 131072,
"Sequence": 1479733,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TakerGets": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "5.298037873"
},
"TakerPays": {
"currency": "BTC",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "0.008937558999999999"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3044022075EF6054ABD08F9B8287314AD4904944A74A6C3BBED9D035BCE7D409FC46E49E022025CFEE7F72BEC1F87EA83E3565CB653643A57CDD13661798D6B70F47AF63FDB6",
"hash": "F873CB065791DDD503580931A500BB896B9DBAFC9C285C1159B884354F3EF48B",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"OfferSequence": 1479726,
"Sequence": 1479732,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TransactionType": "OfferCancel",
"TxnSignature": "3045022100E82B813DA3896051EAAA3D53E197F8F426DF4E51F07A2AB83E43B10CD4008D8402204D93BABA74E63E775D44D77F4F9B07D69B0C86930F2865BBBBD2DC956FA8AE4E",
"hash": "203613CFA3CB7BFBCFABBBCF80D932DFBBFDECCBB869CCDBE756EAA4C8EEA41D",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"OfferSequence": 1479725,
"Sequence": 1479731,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TransactionType": "OfferCancel",
"TxnSignature": "30440220678FF2E754A879EAE72207F191614BBA01B8088CD174AF509E9AA11448798CD502205B326E187A0530E4E90BDD1ED875492836657E4D593FBD655F64604178693D2F",
"hash": "1CF4D0D583F6FC85BFD15A0BEF5E4779A8ACAD0DE43823F07C9CC2A20E29E422",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"OfferSequence": 1479724,
"Sequence": 1479730,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TransactionType": "OfferCancel",
"TxnSignature": "3045022100A5533E81A67B6A88B674864E898FDF31D83787FECE496544EBEE88E6FC220500022002438599B2A0E4F70C2B46FB049CD339F76E466399CA4A8F72C4ADA03F615D90",
"hash": "D96EC06F2ADF3CF7ED59BD76B8F1BDB127CDE46B45977B477703DB05B8DF5208",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"OfferSequence": 1479723,
"Sequence": 1479729,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TransactionType": "OfferCancel",
"TxnSignature": "304402206DEF8C70103AE45BCED6762B238E6F155A57D46300E8FF0A1CD0197362483CAE022007BBDFD93A0BC2473EE4537B44095D1BB5EB83F76661A14230FB3B27C4EABB6D",
"hash": "089D22F601FB52D0E55A8E27D393F05570DC24E92028BB9D9DCAD7BC3337ADF9",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"OfferSequence": 1479722,
"Sequence": 1479728,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TransactionType": "OfferCancel",
"TxnSignature": "3044022065051B7240DE1D46865453B3D7F8FC59FB2B9FD609196AB394F857B75E2B8409022044683F3A35740FC97655A8A4516184D8C582E5D88CA360301B1AD308F4126763",
"hash": "F6A660EF99E32D02B9AF761B14993CA1ED8BAF3507F580D90A7759ABFAF0284E",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rUBLCjWdsPPMkppdFXVJWhHnr3FNqCzgG3",
"Fee": "15",
"Flags": 0,
"LastLedgerSequence": 6907168,
"Sequence": 173286,
"SigningPubKey": "03D606359EEA9C0A49CA9EF55F6AED6C8AEDDE604223C1BE51A2D0460A725CF173",
"TakerGets": {
"currency": "BTC",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "0.44942631"
},
"TakerPays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "260"
},
"TransactionType": "OfferCreate",
"TxnSignature": "304502205395AF4127AD0B890AC9C47F765B4F4046C70C3DFC6F8DCD2729552FAA97F13C022100C8C2DBA6A466D76D0F103AC88DB166D1EC7F6339238E2C4245C2C26308B38058",
"hash": "F20F06F36B5FEFF43DD1E8AEDBE9A0ECEF0CE41402AE6F0FE4BEE1F2F82A4D54",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rDVynssGDojUPpM4abx9rxYeHG4HiLGxC",
"Fee": "15",
"Flags": 2147483648,
"LastLedgerSequence": 6907169,
"OfferSequence": 859,
"Sequence": 860,
"SigningPubKey": "02C37DA8D793142BD190CE13BB697521A89D1DC318A045816EE657F42527EBFC4E",
"TakerGets": "19871628459",
"TakerPays": {
"currency": "BTC",
"issuer": "rfYv1TXnwgDDK4WQNbFALykYuEBnrR4pDX",
"value": "0.166766470665369"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3044022074737D253A0DB39DBB6C63E5BD522C1313CC57658B0A567E1F1DD3414DA3817502201F333D81F29845C53A0271D0C5B005DEE4A250529DAD1A880838E242D358EE35",
"hash": "AD197326AEF75AA466F32FEA87358C9FB587F1C1ABF41C73E2C3EFDD83B6F33B",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"OfferSequence": 1479721,
"Sequence": 1479727,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TransactionType": "OfferCancel",
"TxnSignature": "3045022100CCD7336F78291E1BCAA4F86695119175E0DBC26281B2F13B30A24C726419DFCA022062547E0A4894CEAE87C42CABA94E0731134560F07D8860AE62F4A87AFD16BC43",
"hash": "20353EA4152C32E63941DE2F3175BA69657BA9FAB39D22BCE38B6CA1B3734D4B",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "r9bf8V4ae5xReYnKPXgnwERDFPoW34FhGy",
"Fee": "12",
"Flags": 2147483648,
"LastLedgerSequence": 6907168,
"Sequence": 3274,
"SigningPubKey": "03B7857216DF96BABCC839686670A67602B3EE50D0F12B41C15F73760B8ED394C1",
"TransactionType": "AccountSet",
"TxnSignature": "3045022100F8412BBB1DB830F314F7400E99570A9F92668ACCDEA6096144A47EDF98E18D5D02204AD89122224F353155EACC30F80BA214350968F744A480B4CD5A3174B473D6AF",
"hash": "16F266ABCC617CF906A25AA83BDDAD2577125E6A692A36543934AA0F0C3B77C0",
"inLedger": 6907161,
"ledger_index": 6907161
},
{
"Account": "r9bf8V4ae5xReYnKPXgnwERDFPoW34FhGy",
"Fee": "12",
"Flags": 2147483648,
"LastLedgerSequence": 6907167,
"Sequence": 3273,
"SigningPubKey": "03B7857216DF96BABCC839686670A67602B3EE50D0F12B41C15F73760B8ED394C1",
"TakerGets": "5397",
"TakerPays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "0.00002593363079073453"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3044022061685E23375A299747DE45DA302966C6AF8C07D2DA9BEBB4F5572E3B02C6564D02207187E626EC817EFAFFAD002E75FC16E17A5BD54DA41D4E339F3C2A9F86FFD523",
"hash": "C9112B7C246FC8A9B377BD762F1D64F0DCA1128D55254A442E5735935A09D83E",
"inLedger": 6907160,
"ledger_index": 6907160
},
{
"Account": "rBHMbioz9znTCqgjZ6Nx43uWY43kToEPa9",
"Amount": {
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"value": "4"
},
"Destination": "r4X3WWZ3UZMDw3Z7T32FXK2NAaiitSWZ9c",
"Fee": "12",
"Flags": 0,
"LastLedgerSequence": 6907168,
"Paths": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rwmUaXsWtXU4Z843xSYwgt1is97bgY8yj6",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rwmUaXsWtXU4Z843xSYwgt1is97bgY8yj6",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rfsEoNBUBbvkf4jPcFe2u9CyaQagLVHGfP",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rfsEoNBUBbvkf4jPcFe2u9CyaQagLVHGfP",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"SendMax": {
"currency": "USD",
"issuer": "rBHMbioz9znTCqgjZ6Nx43uWY43kToEPa9",
"value": "4.132649022"
},
"Sequence": 4660,
"SigningPubKey": "03DFEFC9A95AEF55232A2B89867745CE45373F5CE23C34D51D21343CEA92BD61AD",
"TransactionType": "Payment",
"TxnSignature": "30450220636E405B96C998BF5EBB665D519FA8B4431A6CB5962F754EEDD48EBE95F8C45F02210097851E297FEDA44F7DFED844AE109CF2D968BD58CD3C0E951B435278A91002FA",
"hash": "5007E8ECAE64482D258E915FFDEFAF2FE35ED9520BA7BB424BE280691F997435",
"inLedger": 6907160,
"ledger_index": 6907160
},
{
"Account": "rfESTMcbvbvCBqU1FTvGWiJP8cmUSu4GKg",
"Amount": {
"currency": "BTC",
"issuer": "rTJdjjQ5wWAMh8TL1ToXXD2mZzesa6DSX",
"value": "0.0998"
},
"Destination": "r3AWbdp2jQLXLywJypdoNwVSvr81xs3uhn",
"Fee": "10",
"Flags": 2147483648,
"InvoiceID": "A98FD36C17BE2B8511AD36DC335478E7E89F06262949F36EB88E2D683BBCC50A",
"SendMax": {
"currency": "BTC",
"issuer": "rTJdjjQ5wWAMh8TL1ToXXD2mZzesa6DSX",
"value": "0.100798"
},
"Sequence": 18697,
"SigningPubKey": "025D9E40A50D78347EB8AFF7A36222BBE173CB9D06E68D109D189FF8616FC21107",
"TransactionType": "Payment",
"TxnSignature": "3044022007AA39E0117963ABF03BAEF0C5AB45862093525344362D34B9F6BA8373A0C9DC02206AB4FE915F4CBDA84E668F7F21A9914DC95C83A72FB3F9A114B10D4ECB697A25",
"hash": "C738A5095DCE3A256C843AA48BB26F0339EAD3FF09B6D75C2EF50C4AD4B4D17C",
"inLedger": 6907159,
"ledger_index": 6907159
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"Sequence": 1479726,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TakerGets": "37284087",
"TakerPays": {
"currency": "NZD",
"issuer": "rsP3mgGb2tcYUrxiLFiHJiQXhsziegtwBc",
"value": "0.291570426"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3045022100F246F043C97C0DA7947793E9390DBA5AB0C6EB4A0165DADF0E96C939B70D113C0220797F572368EF68490813663C0E2ACF03424CB73B64F3D6C8508C7E8F6D2CC767",
"hash": "CAE39A38C222DF0BBC9AA25D30320220DC216646CE0A447F330BE279B20BD008",
"inLedger": 6907159,
"ledger_index": 6907159
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"Sequence": 1479725,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TakerGets": "10000000000",
"TakerPays": {
"currency": "BTC",
"issuer": "ra9eZxMbJrUcgV8ui7aPc161FgrqWScQxV",
"value": "0.091183099"
},
"TransactionType": "OfferCreate",
"TxnSignature": "30440220376E6D149435B87CA761ED1A9BD205BA93C0C30D6EB1FB26D8B5D06A55977F510220213E882DD43BC78C96B51E43273D9BD451F8337DDF6960CBFB9802A347FF18E4",
"hash": "CC07A503ED60F14AF023AB839C726B73591DE5C986D1234671E2518D8F840E12",
"inLedger": 6907159,
"ledger_index": 6907159
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "15",
"Flags": 0,
"Sequence": 1479724,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TakerGets": "9094329166",
"TakerPays": {
"currency": "XAG",
"issuer": "r9Dr5xwkeLegBeXq6ujinjSBLQzQ1zQGjH",
"value": "3.022830117"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3045022100CFD63762B3809B37B6A1294C4B4C8DA39023D66893045BA4AA9767DD8570A8F9022005F42B08E94190637158E80DAE99F3FB104EC2AA30F69BBA3417E5BBCDB5DB77",
"hash": "64029D736C34D21CDB100D976A06A988E2CA6E3BBC0DDFCE840D9619B853B47C",
"inLedger": 6907159,
"ledger_index": 6907159
}
]
}
}</code></pre></div>
<div style="display: none;" id="code-28-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"index": 0,
"status": "success",
"txs": [
{
"Account": "rPJnufUfjS22swpE7mWRkn2VRNGnHxUSYc",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 567546,
"SigningPubKey": "0317766BFFC0AAF5DB4AFDE23236624304AC4BC903AA8B172AE468F6B512616D6A",
"TakerGets": {
"currency": "BTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "1.12582"
},
"TakerPays": {
"currency": "ILS",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "1981.893528"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3045022100C66F3EE8F955724D750D148E3BB9DCAC16A002F9E4FC612C03AFBE9D8C13888902202607508AD0546C496093C9743B13FD596A1F5BE2B778EFE85BDB99F0E5B1D55F",
"hash": "A95C701F6120061BC40323AE846BBDA51576E67EC38105030BE75C1D32231B61",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rwpxNWdpKu2QVgrh5LQXEygYLshhgnRL1Y",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 1865518,
"SigningPubKey": "02BD6F0CFD0182F2F408512286A0D935C58FF41169DAC7E721D159D711695DFF85",
"TakerGets": {
"currency": "LTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "1.12095"
},
"TakerPays": {
"currency": "ILS",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "20.77526133899999"
},
"TransactionType": "OfferCreate",
"TxnSignature": "304402203F7435A2587A71878B09129A1F4C05066CE6E6463A4A10CD5C40C15FCBD9E42502207E0CB8421FEA4CE8FC052E5A63ACD2444ADAE253B174A153A1DBE901E21B3695",
"hash": "A8C79DF180167E4D1281247325E2869984F54CBFA68631C1AF13DA346E6B3370",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rMWUykAmNQDaM9poSes8VLDZDDKEbmo7MX",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 1886203,
"SigningPubKey": "0256C64F0378DCCCB4E0224B36F7ED1E5586455FF105F760245ADB35A8B03A25FD",
"TakerGets": {
"currency": "LTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "24.154"
},
"TakerPays": {
"currency": "BTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.26907556"
},
"TransactionType": "OfferCreate",
"TxnSignature": "30440220102CF96A86AF56BA11698C70D60F22436D763634FEA179D2FF45EB329CFF1CF8022029BF9301B11D09B38EBD4E8EB445ECC53B98C4F0CA7E19BE895272085ED6DBA2",
"hash": "9EE340379612529F308CA1E4619EC0C8842C1D4308FCA136E25316CE28C28189",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rJJksugQDMVu12NrZyw3C55fEUmPtRYVRC",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 119205,
"SigningPubKey": "03B918730C9FA2451284A00B1EFD08E9BEFD735D84CE09C6B3D7CB8FB0D1F9A84F",
"TakerGets": "10136500000",
"TakerPays": {
"currency": "USD",
"issuer": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"value": "50"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3044022044DB48A760AA7FBA2B1840E1357EF6B1EA9CC9DBBFFB5415C6BE301597B66766022021AA86070416330312E3AFC938376AD0A67A28195D7CD92EC8B03A6039D5C86C",
"hash": "8149067582081FA1499A53841642345D21FE0750E29C61C6DC3C914E0D1819AB",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rLPrL6KUtVZZbDfJMjDXzTKkwH39Udfw6e",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 428775,
"SigningPubKey": "03B2B67209DBDE2FA68555FB10BD791C4732C685349979FDC47D0DEF2B27EFA364",
"TakerGets": {
"currency": "PPC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "8.0635"
},
"TakerPays": {
"currency": "BTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.01355474349999999"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3045022100EDDC17FE2C32DEAD8ED5D9540B2ECE25D6CD1C65414211D2E4F98FC5BDABB99E0220389D6B3DE8BA50D27406BCE28E67D1E270C6A3A854CDEF25F042BBA52CDB53F8",
"hash": "70B7DB8E2BD65E554CBF418D591E050A6FD0A387E9500ED0B79BEB775019D9CA",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rM7WN56kktEkE5qKwNkQ1af4BZ56bynVUf",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 435008,
"SigningPubKey": "0256AE48790FEF5F61C1AB3765287EABCBE6B47C5098271F596A576DF7CFA15720",
"TakerGets": {
"currency": "PPC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.365"
},
"TakerPays": {
"currency": "ILS",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.9977421"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3044022057ECAE71B36746AA1574936B03016DC5747EB7DBBA7D85533063E8D35DD2BAF402204F37BCA51CB0D943758BCA89641C2655FB76F20B8AD1883A3ABF232D1E964E80",
"hash": "572B0B2E96F4A9A88C7EDBDEB6D90AD2975528478186D9179AEC0E366D2778FC",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rLjhDX8zT6vy8T7hjUDvK48wTy5SYFpfwZ",
"Fee": "10",
"Flags": 2147483648,
"OfferSequence": 432536,
"Sequence": 432561,
"SigningPubKey": "03892D08CE3CE600369BA83A92C3C7785FEA162739643358F1F35F8BE672AFD4A3",
"TransactionType": "OfferCancel",
"TxnSignature": "3045022100C25CE3756EB273F6ADD219E951DB7585ADFAF28090BEA3510458785D2EB91866022057A480F167F6D7263CDBFB0E13D571041313F6476176FFE2645CE867BA85DC2D",
"hash": "521D7F2CF76DEAC8ED695AC5570DFF1E445EB8C599158A351BD46F1D34528373",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rn694SpeUFw3VJwapyRKx6bpru3ZpDHzji",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 396235,
"SigningPubKey": "03896496732D098F2D8EE22D65ED9A88C0FF116785AE448EA1F521534C7C5BC6E3",
"TakerGets": {
"currency": "ILS",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.700491"
},
"TakerPays": {
"currency": "NMC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.22"
},
"TransactionType": "OfferCreate",
"TxnSignature": "30440220218B5B90AB26EAE9FC9833E580653B20A15CEE86E8F1166F626FCDF4EFD4146902207FD99E35EE67E45142776CCD8F910A9E6E1A3C498737B59F182C73183C63D51F",
"hash": "454479D7EEE4081CF25378571D74858C01B0B43D3A2530781647BD40CD0465E5",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 676061,
"SigningPubKey": "030BB49C591C9CD65C945D4B78332F27633D7771E6CF4D4B942D26BA40748BB8B4",
"TakerGets": {
"currency": "BTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.09675"
},
"TakerPays": "10527647107",
"TransactionType": "OfferCreate",
"TxnSignature": "3044022014196BC5867AC2689F7EF31F23E4B2D1D1B7755465AC388B20F8E7721333EEE302201575263F381755E47AFCD37C1D5CCA4C012D624E7947140B40ABF1975959AA78",
"hash": "22B2F477ADE9C22599EB5CEF70B3377C0478D708D74A47866D9E59B7A2CF57CF",
"inLedger": 8696235,
"ledger_index": 8696235
},
{
"Account": "rJJksugQDMVu12NrZyw3C55fEUmPtRYVRC",
"Fee": "10",
"Flags": 2147483648,
"OfferSequence": 119183,
"Sequence": 119204,
"SigningPubKey": "03B918730C9FA2451284A00B1EFD08E9BEFD735D84CE09C6B3D7CB8FB0D1F9A84F",
"TransactionType": "OfferCancel",
"TxnSignature": "30440220481760ED4F771F960F37FDF32DDEC70D10F9D5F9868571A58D6F5C09D75B71DE022049B35BEA448686D0929271E64EADA684D7684A9195D22826288AD9D9526B4FE9",
"hash": "5E0E42BDDC7A929875F5E9214AB00C3673CC047833C0EFC093532F2EE1F790C2",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rM7WN56kktEkE5qKwNkQ1af4BZ56bynVUf",
"Fee": "10",
"Flags": 2147483648,
"OfferSequence": 434977,
"Sequence": 435007,
"SigningPubKey": "0256AE48790FEF5F61C1AB3765287EABCBE6B47C5098271F596A576DF7CFA15720",
"TransactionType": "OfferCancel",
"TxnSignature": "304402204B04325A39F3D394A7EBC91CE3A1232E538EFFC80014473C97E84310886A19B302205B2D18C544086BB99E49A1037B65ADDF4864DA60545E33E4116A41599EEE63E3",
"hash": "E8E55606C757219A740AFA0700506FE99781797E2F54A5144EF43582C65BF0F2",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rLPrL6KUtVZZbDfJMjDXzTKkwH39Udfw6e",
"Fee": "10",
"Flags": 2147483648,
"OfferSequence": 428744,
"Sequence": 428774,
"SigningPubKey": "03B2B67209DBDE2FA68555FB10BD791C4732C685349979FDC47D0DEF2B27EFA364",
"TransactionType": "OfferCancel",
"TxnSignature": "304402202BCB4FCE73C3417AD3E67D795077DE025E766A9136CA20D5B07DA28EA717643E0220579CA32A7BB225DA01999637B316BF7D3902059F9A8DDB2D721F8A62685E5BB7",
"hash": "E86788EC72CA9CFBBAE4C399744C6B7495E3F6443FE87D7A4118F16FA4A316DB",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rHsZHqa5oMQNL5hFm4kfLd47aEMYjPstpg",
"Fee": "64",
"Flags": 0,
"Sequence": 4216371,
"SigningPubKey": "025718736160FA6632F48EA4354A35AB0340F8D7DC7083799B9C57C3E937D71851",
"TakerGets": "12566721624",
"TakerPays": {
"currency": "USD",
"issuer": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"value": "74.999999999"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3045022100D0FA06A78D3333D35C798B45590CD47BD844164ED25FCA4149F5F0CF24BE9A380220243EB636C656D1FBA6888CE8E2873CDA40FE6DE5987BE2FF1C418610D8BDC300",
"hash": "DD4CAD3EBCF67CE9B184A917FF2C78A80F0FE40A01187840E0EBC6B479DBFE1A",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rJJksugQDMVu12NrZyw3C55fEUmPtRYVRC",
"Fee": "10",
"Flags": 2147483648,
"OfferSequence": 119182,
"Sequence": 119203,
"SigningPubKey": "03B918730C9FA2451284A00B1EFD08E9BEFD735D84CE09C6B3D7CB8FB0D1F9A84F",
"TransactionType": "OfferCancel",
"TxnSignature": "304402202F13D25C82240ABBBEE0D7E8BC2351C49FD6FDD62359EA232233C5A6C989BFAA022005A521A2C5A67BAC27218A6AD9E6917689CBD2F9BB9CE884B6B0EAAEDDEC2057",
"hash": "C9D8A2ECE636057E8255A231E6C6B6464A730155BA0E75B5111A81EA769FBC89",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rGJrzrNBfv6ndJmzt1hTUJVx7z8o2bg3of",
"Fee": "15",
"Flags": 2147483648,
"LastLedgerSequence": 8696241,
"OfferSequence": 1579754,
"Sequence": 1579755,
"SigningPubKey": "03325EB29A014DDE22289D0EA989861D481D54D54C727578AB6C2F18BC342D3829",
"TransactionType": "OfferCancel",
"TxnSignature": "3045022100C9F283D461F8A56575A56F8AA31F84683AB0B44D58C9EFD5DC20D448D8AC13E3022012E0A8726BE2D900C4FB7A61AB8FBFEBEBE1F12B2A9880A2BA2AB8D3EC61CB8C",
"hash": "C4953FE328D54E9104F66253AF50AEBC26E30D5826B433465A795262DFA75B48",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rn694SpeUFw3VJwapyRKx6bpru3ZpDHzji",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 396234,
"SigningPubKey": "03896496732D098F2D8EE22D65ED9A88C0FF116785AE448EA1F521534C7C5BC6E3",
"TakerGets": {
"currency": "ILS",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.3335471399999999"
},
"TakerPays": {
"currency": "NMC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.102"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3045022100DEA2B6D5B0D555D54A4EB7A8FADC187F44C6A9CF7282A1D5491538200DFC97DA022033A52D1EC219553C86DB829108BB5A52B49ED7EF0A566941665DE7FFF70917ED",
"hash": "A6BE633AECE9FF9CA83D67D09E7EF67F614A9D8B952D7AFB5CB630D03C54C9FC",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rwpxNWdpKu2QVgrh5LQXEygYLshhgnRL1Y",
"Fee": "10",
"Flags": 2147483648,
"OfferSequence": 1865490,
"Sequence": 1865517,
"SigningPubKey": "02BD6F0CFD0182F2F408512286A0D935C58FF41169DAC7E721D159D711695DFF85",
"TransactionType": "OfferCancel",
"TxnSignature": "3044022074A4E9859A5A94169B2C902F074AA964C45E2B86EABEA73E83E083E1EC7549A402203E8F4D46705AFEDFC78C2D40FAA036792E6485AF8CADF7445EA3D427E9DC2474",
"hash": "A49285E2CA7C5765B68A41EF4A8A65AD5CC7D4EF6C7B7F6D5040B2DE429E0125",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rPJnufUfjS22swpE7mWRkn2VRNGnHxUSYc",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 567545,
"SigningPubKey": "0317766BFFC0AAF5DB4AFDE23236624304AC4BC903AA8B172AE468F6B512616D6A",
"TakerGets": {
"currency": "BTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.66099"
},
"TakerPays": {
"currency": "ILS",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "1157.5521276"
},
"TransactionType": "OfferCreate",
"TxnSignature": "3045022100CABC7C1F9FB42C8498E1E9C6C5E8482F325D39B15D9DAE4BD9878D5E508B8FDD0220407B059A22BBBF4FC4AE18BEDCD2DDA80109EE7226D679A8A3BBFC108EFDD3AB",
"hash": "A0BED2F5A85C48A2AFBA252FF91FD2D5C90A6D6B769068B18891B031812E2AC0",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rLLq27Wat93Gxkq5mV5GxtKkT146Su949V",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 722529,
"SigningPubKey": "02A1BC1CCFACECD00ADC6EE990E2E27148E00D5386A99791F25B6A880BCEC94EC9",
"TakerGets": "130272502088",
"TakerPays": {
"currency": "BTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "1.3177"
},
"TransactionType": "OfferCreate",
"TxnSignature": "30440220436C4A368D534FE1E9A2596C51D1D54931432B789F249E312877FF9B38A3F4D502202A2DBF9517358C009FBEA61EE927DAF72A065A840C7B9136B10C125F25FCD175",
"hash": "9627AEFC735A848AAE6C36D1089CB8797373DBE95B60E89F5412508CA907243A",
"inLedger": 8696234,
"ledger_index": 8696234
},
{
"Account": "rMWUykAmNQDaM9poSes8VLDZDDKEbmo7MX",
"Fee": "10",
"Flags": 2147483648,
"OfferSequence": 1886173,
"Sequence": 1886202,
"SigningPubKey": "0256C64F0378DCCCB4E0224B36F7ED1E5586455FF105F760245ADB35A8B03A25FD",
"TransactionType": "OfferCancel",
"TxnSignature": "304402202C7BD2C125A0B837CBD2E2FF568AEA1E0EE94615B22564A51C0434460C506C6F02204E39A7BD49086AA794B20F4EE28656217561909ECFBB18636CD400AB33AB0B17",
"hash": "57277F527B8EBD68FE85906E613338D68F8F8BC4EB3D1748D9A204D7CDC3E174",
"inLedger": 8696234,
"ledger_index": 8696234
}
]
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>index</td>
<td>Unsigned Integer</td>
<td>The value of <code title="Double-click to expand/collapse">start</code> used in the request.</td>
</tr>
<tr>
<td>txs</td>
<td>Array</td>
<td>Array of transaction objects.</td>
</tr>
</tbody>
</table><p>The fields included in each transaction object vary slightly depending on the type of transaction. See <a href="transactions.html">Transaction Format</a> for details.</p><h2 id="path-find">path_find</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/PathFind.cpp" title="Source">[Source]<br></a></p><p><em>WebSocket API only!</em> The <code title="Double-click to expand/collapse">path_find</code> method searches for a path along which a transaction can possibly be made, and periodically sends updates when the path changes over time. For a simpler version that is supported by JSON-RPC, see <a href="#ripple-path-find"><code title="Double-click to expand/collapse">ripple_path_find</code></a>. For payments occurring strictly in XRP, it is not necessary to find a path, because XRP can be sent directly to any account. </p><p>There are three different modes, or sub-commands, of the path_find command. Specify which one you want with the <code title="Double-click to expand/collapse">subcommand</code> parameter:</p><ul>
<li><code title="Double-click to expand/collapse">create</code> - Start sending pathfinding information </li>
<li><code title="Double-click to expand/collapse">close</code> - Stop sending pathfinding information</li>
<li><code title="Double-click to expand/collapse">status</code> - Get the information of the currently-open pathfinding request</li>
</ul><p>Although the <code title="Double-click to expand/collapse">rippled</code> server attempts to find the cheapest path or combination of paths for making a payment, it is not guaranteed that the paths returned by this method are, in fact, the best paths. Due to server load, pathfinding may not find the best results. Additionally, you should be careful with the pathfinding results from untrusted servers. A server could be modified to return less-than-optimal paths in order to earn money for its operators. If you do not have your own server that you can trust with pathfinding, you should compare the results of pathfinding from multiple servers operated by different parties, to minimize the risk of a single server returning poor results. (<em>Note:</em> A server returning less-than-optimal results is not necessarily proof of malicious behavior; it could also be a symptom of heavy server load.)</p><h3 id="path-find-create">path_find create</h3><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/PathFind.cpp#L38" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">create</code> subcommand of <code title="Double-click to expand/collapse">path_find</code> creates an ongoing request to find possible paths along which a payment transaction could be made from one specified account such that another account receives a desired amount of some currency. The initial response contains a suggested path between the two addresses that would result in the desired amount being received. After that, the server sends additional messages, with <code title="Double-click to expand/collapse">"type": "path_find"</code>, with updates to the potential paths. The frequency of updates is left to the discretion of the server, but it usually means once every few seconds when there is a new ledger version.</p><p>A client can only have one pathfinding request open at a time. If another pathfinding request is already open on the same connection, the old request is automatically closed and replaced with the new request.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-29" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-29-0">WebSocket</a></li></ul>
<div id="code-29-0"><pre><code title="Double-click to expand/collapse">{
"id": 8,
"command": "path_find",
"subcommand": "create",
"source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"destination_amount": {
"value": "0.001",
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
}
}</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#path_find">Try it!</a></p><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>subcommand</td>
<td>String</td>
<td>Use <code title="Double-click to expand/collapse">"create"</code> to send the create subcommand</td>
</tr>
<tr>
<td>source_account</td>
<td>String</td>
<td>Unique address of the account to find a path from. (In other words, the account that would be sending a payment.)</td>
</tr>
<tr>
<td>destination_account</td>
<td>String</td>
<td>Unique address of the account to find a path to. (In other words, the account that would receive a payment.)</td>
</tr>
<tr>
<td>destination_amount</td>
<td>String (XRP)<br>Object (Otherwise)</td>
<td>The amount of currency that needs to arrive at the destination. (See <a href="#specifying-currency-amounts">Specifying Currency Amounts</a>. Set the issuer to the destination account’s address to use any issuer the destination accepts.)</td>
</tr>
<tr>
<td>paths</td>
<td>Array</td>
<td>(Optional) Array of arrays of objects, representing paths to confirm. You can use this to keep updated on changes to particular paths you already know about, or to check the overall cost to make a payment along a certain path.</td>
</tr>
</tbody>
</table><p>The server also recognizes the following fields, but the results of using them are not guaranteed: <code title="Double-click to expand/collapse">source_currencies</code>, <code title="Double-click to expand/collapse">bridges</code>. These fields should be considered reserved for future use.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-30" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-30-0">WebSocket</a></li></ul>
<div id="code-30-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"status": "success",
"type": "response",
"result": {
"alternatives": [
{
"paths_computed": [
[
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "r9vbV3EHvXWjSkeQ6CAcYVPGeq7TuiXY2X",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "r9vbV3EHvXWjSkeQ6CAcYVPGeq7TuiXY2X",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": "251686"
},
{
"paths_computed": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "BTC",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.000001541291269274307"
}
},
{
"paths_computed": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "CHF",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.0009211546262510451"
}
},
{
"paths_computed": [
[
{
"account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "CNY",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.006293562"
}
},
{
"paths_computed": [
[
{
"account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "DYM",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.0007157142857142858"
}
},
{
"paths_computed": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "EUR",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.0007409623616236163"
}
},
{
"paths_computed": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "JPY",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.103412412"
}
}
],
"destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"destination_amount": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "0.001"
},
"id": 1,
"source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
}
}</code></pre></div>
</div><p>The initial response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>alternatives</td>
<td>Array</td>
<td>Array of objects with suggested paths to take, as described below. If empty, then no paths were found connecting the source and destination accounts.</td>
</tr>
<tr>
<td>destination_account</td>
<td>String</td>
<td>Unique address of the account that would receive a transaction</td>
</tr>
<tr>
<td>destination_amount</td>
<td>String or Object</td>
<td><a href="#specifying-currency-amounts">Currency amount</a> that the destination would receive in a transaction</td>
</tr>
<tr>
<td>id</td>
<td>(Various)</td>
<td>(WebSocket only) The ID provided in the WebSocket request is included again at this level.</td>
</tr>
<tr>
<td>source_account</td>
<td>String</td>
<td>Unique address of the account that would initiate a transaction</td>
</tr>
</tbody>
</table><p>Each element in the <code title="Double-click to expand/collapse">alternatives</code> array is an object that represents a path from one possible source currency (held by the initiating account) to the destination account and currency. This object has the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>paths_computed</td>
<td>Array</td>
<td>Array of arrays of objects defining <a href="https://ripple.com/wiki/Payment_paths">payment paths</a></td>
</tr>
<tr>
<td>source_amount</td>
<td>String or Object</td>
<td><a href="#specifying-currency-amounts">Currency amount</a> that the source would have to send along this path in order for the destination to receive the desired amount</td>
</tr>
</tbody>
</table><h4>Asynchronous Follow-ups</h4><p>In addition to the initial response, the server sends more messages in a similar format to update on the status of the paths over time. These messages include the <code title="Double-click to expand/collapse">id</code> of the original WebSocket request so you can tell which request prompted them, and the field <code title="Double-click to expand/collapse">"type": "path_find"</code> at the top level to indicate that they are additional responses. The other fields are defined in the same way as the initial response.</p><p>Here is an example of an asychronous follow-up from a path_find create request:</p><div id="code-31" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-31-0">WebSocket</a></li></ul>
<div id="code-31-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"type": "path_find",
"alternatives": [
{
"paths_computed": [
[
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rG2pEp6WtqLfThH8wsVM9XYYvy9wSe9Zqu",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rULnR9YhAkj9HrcxAcudzBhaXRSqT7zJkq",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rwBWBFZrbLzHoe3PhwWYv89iHJdxAFrxcB",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": "251686"
},
{
"paths_computed": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rpgKWEmNqSDAGFhy5WDnsyPqfQxbWxKeVd",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "BTC",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.000001529347313523348"
}
},
{
"paths_computed": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "CHF",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.0009211546262510451"
}
},
{
"paths_computed": [
[
{
"account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "CNY",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.00626921726264844"
}
},
{
"paths_computed": [
[
{
"account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "DYM",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.0007157142857142858"
}
},
{
"paths_computed": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "EUR",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.0007390991477027603"
}
},
{
"paths_computed": [
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "JPY",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.103412412"
}
},
{
"paths_computed": [
[
{
"account": "rHpXfibHgSb64n8kK9QWDpdbfqSpYbM9a4",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rHpXfibHgSb64n8kK9QWDpdbfqSpYbM9a4",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rHpXfibHgSb64n8kK9QWDpdbfqSpYbM9a4",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rBVuBbPYvLyf8HvMdf48nayR8XF8X9J3Ds",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"account": "rHpXfibHgSb64n8kK9QWDpdbfqSpYbM9a4",
"type": 1,
"type_hex": "0000000000000001"
},
{
"currency": "XRP",
"type": 16,
"type_hex": "0000000000000010"
},
{
"currency": "USD",
"issuer": "rHHa9t2kLQyXRbdLkSzEgkzwf9unmFgZs9",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rHHa9t2kLQyXRbdLkSzEgkzwf9unmFgZs9",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": {
"currency": "MXN",
"issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"value": "0.03202111959287532"
}
}
],
"destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"destination_amount": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "0.001"
},
"source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
}</code></pre></div>
</div><h3 id="path-find-close">path_find close</h3><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/PathFind.cpp#L46" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">close</code> subcommand of <code title="Double-click to expand/collapse">path_find</code> instructs the server to stop sending information about the current open pathfinding request.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-32" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-32-0">WebSocket</a></li></ul>
<div id="code-32-0"><pre><code title="Double-click to expand/collapse">{
"id": 57,
"command": "path_find",
"subcommand": "close"
}</code></pre></div>
</div><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>subcommand</td>
<td>String</td>
<td>Use <code title="Double-click to expand/collapse">"close"</code> to send the close subcommand</td>
</tr>
</tbody>
</table><h4>Response Format</h4><p>If a pathfinding request was successfully closed, the response follows the same format as the initial response to <a href="#path_find-create"><code title="Double-click to expand/collapse">path_find create</code></a>. If there was no outstanding pathfinding request, an error is returned instead.</p><h3 id="path-find-status">path_find status</h3><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/PathFind.cpp#L57" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">status</code> subcommand of <code title="Double-click to expand/collapse">path_find</code> requests an immediate update about the client’s currently-open pathfinding request.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-33" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-33-0">WebSocket</a></li></ul>
<div id="code-33-0"><pre><code title="Double-click to expand/collapse">{
"id": 58,
"command": "path_find",
"subcommand": "status"
}</code></pre></div>
</div><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>subcommand</td>
<td>String</td>
<td>Use <code title="Double-click to expand/collapse">"status"</code> to send the status subcommand</td>
</tr>
</tbody>
</table><h4>Response Format</h4><p>If a pathfinding request is open, the response follows the same format as the initial response to <a href="#path_find-create"><code title="Double-click to expand/collapse">path_find create</code></a>. If there was no outstanding pathfinding request, an error is returned instead. (Prior to version 0.26, the server erroneously reports success. See <a href="https://ripplelabs.atlassian.net/browse/RIPD-293">RIPD-293</a> for more information.)</p><h2 id="ripple-path-find">ripple_path_find</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/RipplePathFind.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">ripple_path_find</code> method is a simplified version of <a href="#path-find"><code title="Double-click to expand/collapse">path_find</code></a> that provides a single response to be used to make a payment transaction immediately. It is available in both the WebSocket and JSON-RPC APIs. However, the results tend to become outdated as time passes. Instead of making many subsequent calls, you should use <a href="#path-find"><code title="Double-click to expand/collapse">path_find</code></a> instead where possible.</p><p>Although the <code title="Double-click to expand/collapse">rippled</code> server attempts to find the cheapest path or combination of paths for making a payment, it is not guaranteed that the paths returned by this method are, in fact, the best paths. Due to server load, pathfinding may not find the best results. Additionally, you should be careful with the pathfinding results from untrusted servers. A server could be modified to return less-than-optimal paths in order to earn money for its operators. If you do not have your own server that you can trust with pathfinding, you should compare the results of pathfinding from multiple servers operated by different parties, to minimize the risk of a single server returning poor results. (<em>Note:</em> A server returning less-than-optimal results is not necessarily proof of malicious behavior; it could also be a symptom of heavy server load.)</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-34" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-34-0">WebSocket</a></li><li><a href="#code-34-1">JSON-RPC</a></li><li><a href="#code-34-2">Commandline</a></li></ul>
<div id="code-34-0"><pre><code title="Double-click to expand/collapse">{
"id": 8,
"command": "ripple_path_find",
"source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"source_currencies": [
{
"currency": "XRP"
},
{
"currency": "USD"
}
],
"destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"destination_amount": {
"value": "0.001",
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
}
}</code></pre></div>
<div style="display: none;" id="code-34-1"><pre><code title="Double-click to expand/collapse">{
"method": "ripple_path_find",
"params": [
{
"destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"destination_amount": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "0.001"
},
"source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"source_currencies": [
{
"currency": "XRP"
},
{
"currency": "USD"
}
]
}
]
}</code></pre></div>
<div style="display: none;" id="code-34-2"><pre><code title="Double-click to expand/collapse">#Syntax ripple_path_find json ledger_index|ledger_hash
rippled -- ripple_path_find '{"source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "source_currencies": [ { "currency": "XRP" }, { "currency": "USD" } ], "destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "destination_amount": { "value": "0.001", "currency": "USD", "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B" } }'</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#ripple_path_find">Try it!</a></p><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>source_account</td>
<td>String</td>
<td>Unique address of the account that would send funds in a transaction</td>
</tr>
<tr>
<td>destination_account</td>
<td>String</td>
<td>Unique address of the account that would receive funds in a transaction</td>
</tr>
<tr>
<td>destination_amount</td>
<td>String or Object</td>
<td><a href="#specifying-currency-amounts">Currency amount</a> that the destination account would receive in a transaction</td>
</tr>
<tr>
<td>source_currencies</td>
<td>Array</td>
<td>(Optional, defaults to all available) Array of currencies that the source account might want to spend. Each entry in the array should be a JSON object with a mandatory <code title="Double-click to expand/collapse">currency</code> field and optional <code title="Double-click to expand/collapse">issuer</code> field, similar to <a href="#specifying-currency-amounts">currency amounts</a>.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Optional) A 20-byte hex string for the ledger version to use. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
<tr>
<td>ledger_index</td>
<td>String or Unsigned Integer</td>
<td>(Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See <a href="#specifying-a-ledger-instance">Specifying a Ledger</a>)</td>
</tr>
</tbody>
</table><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-35" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-35-0">WebSocket</a></li><li><a href="#code-35-1">JSON-RPC</a></li></ul>
<div id="code-35-0"><pre><code title="Double-click to expand/collapse">{
"id": 8,
"status": "success",
"type": "response",
"result": {
"alternatives": [
{
"paths_canonical": [],
"paths_computed": [
[
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rLpq4LgabRfm1xEX5dpWfJovYBH6g7z99q",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rPuBoajMjFoDjweJBrtZEBwUMkyruxpwwV",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": "256987"
}
],
"destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"destination_currencies": [
"015841551A748AD2C1F76FF6ECB0CCCD00000000",
"JOE",
"DYM",
"EUR",
"CNY",
"MXN",
"BTC",
"USD",
"XRP"
]
}
}</code></pre></div>
<div style="display: none;" id="code-35-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"alternatives": [
{
"paths_canonical": [],
"paths_computed": [
[
{
"currency": "USD",
"issuer": "rpDMez6pm6dBve2TJsmDpv7Yae6V5Pyvy2",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rpDMez6pm6dBve2TJsmDpv7Yae6V5Pyvy2",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rfDeu7TPUmyvUrffexjMjq3mMcSQHZSYyA",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "raspZSGNiTKi5jmvFxUYCuYXPv1V8WhL5g",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
],
[
{
"currency": "USD",
"issuer": "rpHgehzdpfWRXKvSv6duKvVuo1aZVimdaT",
"type": 48,
"type_hex": "0000000000000030"
},
{
"account": "rpHgehzdpfWRXKvSv6duKvVuo1aZVimdaT",
"type": 1,
"type_hex": "0000000000000001"
},
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"type": 1,
"type_hex": "0000000000000001"
}
]
],
"source_amount": "207414"
}
],
"destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"destination_currencies": [
"USD",
"JOE",
"BTC",
"DYM",
"CNY",
"EUR",
"015841551A748AD2C1F76FF6ECB0CCCD00000000",
"MXN",
"XRP"
],
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>alternatives</td>
<td>Array</td>
<td>Array of objects with possible paths to take, as described below. If empty, then there are no paths connecting the source and destination accounts.</td>
</tr>
<tr>
<td>destination_account</td>
<td>String</td>
<td>Unique address of the account that would receive a payment transaction</td>
</tr>
<tr>
<td>destination_currencies</td>
<td>Array</td>
<td>Array of strings representing the currencies that the destination accepts, as 3-letter codes like <code title="Double-click to expand/collapse">"USD"</code> or as 40-character hex like <code title="Double-click to expand/collapse">"015841551A748AD2C1F76FF6ECB0CCCD00000000"</code></td>
</tr>
</tbody>
</table><p>Each element in the <code title="Double-click to expand/collapse">alternatives</code> array is an object that represents a path from one possible source currency (held by the initiating account) to the destination account and currency. This object has the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>paths_computed</td>
<td>Array</td>
<td>Array of arrays of objects defining <a href="https://ripple.com/wiki/Payment_paths">payment paths</a></td>
</tr>
<tr>
<td>source_amount</td>
<td>String or Object</td>
<td><a href="#specifying-currency-amounts">Currency amount</a> that the source would have to send along this path in order for the destination to receive the desired amount</td>
</tr>
</tbody>
</table><p>The following fields are deprecated, and may be omitted: <code title="Double-click to expand/collapse">paths_canonical</code>, and <code title="Double-click to expand/collapse">paths_expanded</code>. If they appear, you should disregard them.</p><h2 id="sign">sign</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/Sign.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">sign</code> method takes a transaction, specified as JSON, and a secret key, and returns a signed binary representation of the transaction that can be submitted. The result is always different, even when you provide the same transaction and secret key.</p><p><em>Note:</em> It is possible and preferable to sign a transaction without connecting to a server instead of using this command. For example, <a href="https://github.com/ripple/ripple-lib/blob/develop/bin/rsign.js">ripple-lib’s rsign.js</a> demonstrates offline signing of a transaction. You should prefer to do offline signing of a transaction, especially when you do not control the server you are sending a transaction to. An untrustworthy server can abuse its position to change the transaction before signing it, or worse, use your secret to sign additional arbitrary transactions as if they came from you.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-36" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-36-0">WebSocket</a></li><li><a href="#code-36-1">JSON-RPC</a></li><li><a href="#code-36-2">Commandline</a></li></ul>
<div id="code-36-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"command": "sign",
"tx_json" : {
"TransactionType" : "Payment",
"Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"Amount" : {
"currency" : "USD",
"value" : "1",
"issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
}
},
"secret" : "sssssssssssssssssssssssssssss",
"offline": false
}</code></pre></div>
<div style="display: none;" id="code-36-1"><pre><code title="Double-click to expand/collapse">{
"method": "sign",
"params": [
{
"offline": false,
"secret": "sssssssssssssssssssssssssssss",
"tx_json": {
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Amount": {
"currency": "USD",
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"value": "1"
},
"Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"TransactionType": "Payment"
}
}
]
}</code></pre></div>
<div style="display: none;" id="code-36-2"><pre><code title="Double-click to expand/collapse">#Syntax: sign secret tx_json [offline]
rippled -- sign sssssssssssssssssssssssssssss '{"TransactionType": "Payment", "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", "Amount": { "currency": "USD", "value": "1", "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn" }}' false</code></pre></div>
</div><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>tx_json</td>
<td>Object</td>
<td><a href="transactions.html">Transaction definition</a> in JSON format</td>
</tr>
<tr>
<td>secret</td>
<td>String</td>
<td>Secret key of the account supplying the transaction, used to sign it. Do not send your secret to untrusted servers or through unsecured network connections.</td>
</tr>
<tr>
<td>offline</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, when constructing the transaction, do not attempt to automatically fill in or validate values.</td>
</tr>
<tr>
<td>build_path</td>
<td>Boolean</td>
<td>(Optional) If provided for a Payment-type transaction, automatically fill in the <code title="Double-click to expand/collapse">Paths</code> field before signing. <em>Caution:</em> The server looks for the presence or absence of this field, not its value. This behavior may change. (See <a href="https://ripplelabs.atlassian.net/browse/RIPD-173">RIPD-173</a> for status.)</td>
</tr>
</tbody>
</table><p>The server automatically attempts to fill in certain fields from the <code title="Double-click to expand/collapse">tx_json</code> object if they are omitted, unless you specified <code title="Double-click to expand/collapse">offline</code> as true. Otherwise, the following fields from the <a href="transactions.html">transaction format</a> are automatically filled in:</p><ul>
<li><code title="Double-click to expand/collapse">Sequence</code> - The server automatically uses the next Sequence number from the sender’s account information. Be careful: the next sequence number for the account is not incremented until this transaction is applied. If you sign multiple transactions without submitting and waiting for the response to each one, you must provide the correct sequence numbers in the request. Automatically filled unless <code title="Double-click to expand/collapse">offline</code> is true.</li>
<li><code title="Double-click to expand/collapse">Fee</code> - The server can automatically fill in an appropriate transaction fee (in drops of XRP) unless you specified <code title="Double-click to expand/collapse">offline</code> as true. Otherwise, you must fill in the appropriate fee. Be careful: a malicious server can specify an excessively high fee. Automatically filled unless <code title="Double-click to expand/collapse">offline</code> is true.</li>
<li><code title="Double-click to expand/collapse">Paths</code> - For Payment-type transactions (excluding XRP-to-XRP transfers), the Paths field can be automatically filled, as if you did a <a href="#ripple-path-find">ripple_path_find</a>. Only filled if <code title="Double-click to expand/collapse">build_path</code> is provided. </li>
</ul><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-37" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-37-0">WebSocket</a></li><li><a href="#code-37-1">JSON-RPC</a></li></ul>
<div id="code-37-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"result": {
"tx_blob": "1200002280000000240000000361D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000A732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100BF06B6C01646005DEDD8F4F6D458AF4EE4006205A623FF31E0B5BCCE42564BA1022063C372D476379C109E3C22C5C04071594CD9EF64615C00B048AFFA5D7D6701F981144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754",
"tx_json": {
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Amount": {
"currency": "USD",
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"value": "1"
},
"Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 3,
"SigningPubKey": "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB",
"TransactionType": "Payment",
"TxnSignature": "3045022100BF06B6C01646005DEDD8F4F6D458AF4EE4006205A623FF31E0B5BCCE42564BA1022063C372D476379C109E3C22C5C04071594CD9EF64615C00B048AFFA5D7D6701F9",
"hash": "B4CBEBBA9E65A5BED25205806797600149599AAF2FD8103B3B75AE97B1B5F3E2"
}
},
"status": "success",
"type": "response"
}</code></pre></div>
<div style="display: none;" id="code-37-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"status": "success",
"tx_blob": "1200002280000000240000000361D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000A732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100D184EB4AE5956FF600E7536EE459345C7BBCF097A84CC61A93B9AF7197EDB98702201CEA8009B7BEEBAA2AACC0359B41C427C1C5B550A4CA4B80CF2174AF2D6D5DCE81144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754",
"tx_json": {
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Amount": {
"currency": "USD",
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"value": "1"
},
"Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 3,
"SigningPubKey": "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB",
"TransactionType": "Payment",
"TxnSignature": "3045022100D184EB4AE5956FF600E7536EE459345C7BBCF097A84CC61A93B9AF7197EDB98702201CEA8009B7BEEBAA2AACC0359B41C427C1C5B550A4CA4B80CF2174AF2D6D5DCE",
"hash": "82230B9D489370504B39BC2CE46216176CAC9E752E5C1774A8CBEC9FBB819208"
}
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>tx_blob</td>
<td>String</td>
<td>Binary representation of the fully-qualified, signed transaction, as hex</td>
</tr>
<tr>
<td>tx_json</td>
<td>Object</td>
<td>JSON specification of the <a href="transactions.html">complete transaction</a> as signed, including any fields that were automatically filled in</td>
</tr>
</tbody>
</table><p><em>Warning:</em> If this command results in an error messages, the message can contain the account secret from the request. Make sure that these errors are not visible to others, including:</p><ul>
<li>Do not write this error to a log file that can be seen by multiple people</li>
<li>Do not paste this error to a public place for debugging</li>
<li>Do not display the error message on a website, even by accident</li>
</ul><h2 id="submit">submit</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/Submit.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">submit</code> method sends a <a href="transactions.html">transaction</a> to the network to be confirmed and included in future ledgers. </p><p>This command has two modes:</p><ul>
<li>Submit-only mode takes a signed, serialized transaction as a binary blob, and submits it to the network as-is. Since signed transaction objects are immutable, no portion of the transaction can be modified or automatically filled in after submission.</li>
<li>Sign-and-submit mode takes a JSON-formatted Transaction object, completes and signs the transaction in the same manner as the <a href="#sign">sign command</a>, and then submits the signed transaction. We recommend only using this mode for testing and development.</li>
</ul><p>To send a transaction as robustly as possible, you should construct and <a href="#sign"><code title="Double-click to expand/collapse">sign</code></a> it in advance, persist it somewhere that you can access even after a power outage, then <code title="Double-click to expand/collapse">submit</code> it as a <code title="Double-click to expand/collapse">tx_blob</code>. After submission, monitor the network with the <a href="#tx"><code title="Double-click to expand/collapse">tx</code></a> command to see if the transaction was successfully applied; if a restart or other problem occurs, you can safely re-submit the <code title="Double-click to expand/collapse">tx_blob</code> transaction: it won’t be applied twice since it has the same sequence number as the old transaction. </p><h3 id="submit-only-mode">Submit-Only Mode</h3><p>A submit-only request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>tx_blob</td>
<td>String</td>
<td>Hex representation of the signed transaction to submit.</td>
</tr>
<tr>
<td>fail_hard</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, and the transaction fails locally, do not retry or relay the transaction to other servers</td>
</tr>
</tbody>
</table><h4>Request Format</h4><div id="code-38" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-38-0">WebSocket</a></li><li><a href="#code-38-1">JSON-RPC</a></li><li><a href="#code-38-2">Commandline</a></li></ul>
<div id="code-38-0"><pre><code title="Double-click to expand/collapse">{
"id": 3,
"command": "submit",
"tx_blob": "1200002280000000240000001E61D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000B732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB7447304502210095D23D8AF107DF50651F266259CC7139D0CD0C64ABBA3A958156352A0D95A21E02207FCF9B77D7510380E49FF250C21B57169E14E9B4ACFD314CEDC79DDD0A38B8A681144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754"
}</code></pre></div>
<div style="display: none;" id="code-38-1"><pre><code title="Double-click to expand/collapse">{
"method": "submit",
"params": [
{
"tx_blob": "1200002280000000240000000361D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000A732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100D184EB4AE5956FF600E7536EE459345C7BBCF097A84CC61A93B9AF7197EDB98702201CEA8009B7BEEBAA2AACC0359B41C427C1C5B550A4CA4B80CF2174AF2D6D5DCE81144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754"
}
]
}</code></pre></div>
<div style="display: none;" id="code-38-2"><pre><code title="Double-click to expand/collapse">#Syntax: submit tx_blob
submit 1200002280000000240000000361D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000A732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100D184EB4AE5956FF600E7536EE459345C7BBCF097A84CC61A93B9AF7197EDB98702201CEA8009B7BEEBAA2AACC0359B41C427C1C5B550A4CA4B80CF2174AF2D6D5DCE81144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754</code></pre></div>
</div><h3 id="sign-and-submit-mode">Sign-and-Submit Mode</h3><p>A sign-and-submit request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>tx_json</td>
<td>Object</td>
<td><a href="transactions.html">Transaction definition</a> in JSON format, optionally omitting any auto-fillable fields.</td>
</tr>
<tr>
<td>secret</td>
<td>String</td>
<td>(Required if <code title="Double-click to expand/collapse">tx_json</code> is supplied) Secret key of the account supplying the transaction, used to sign it. Do not send your secret to untrusted servers or through unsecured network connections.</td>
</tr>
<tr>
<td>fail_hard</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, and the transaction fails locally, do not retry or relay the transaction to other servers</td>
</tr>
<tr>
<td>offline</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, when constructing the transaction, do not attempt to automatically fill in or validate values.</td>
</tr>
<tr>
<td>build_path</td>
<td>Boolean</td>
<td>(Optional) If provided for a Payment-type transaction, automatically fill in the <code title="Double-click to expand/collapse">Paths</code> field before signing. You must omit this field if the transaction is a direct XRP-to-XRP transfer. <em>Caution:</em> The server looks for the presence or absence of this field, not its value. This behavior may change. (See <a href="https://ripplelabs.atlassian.net/browse/RIPD-173">RIPD-173</a> for status.)</td>
</tr>
</tbody>
</table><h4>Request Format</h4><p>An example of the request format:</p><div id="code-39" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-39-0">WebSocket</a></li><li><a href="#code-39-1">JSON-RPC</a></li><li><a href="#code-39-2">Commandline</a></li></ul>
<div id="code-39-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"command": "submit",
"tx_json" : {
"TransactionType" : "Payment",
"Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"Amount" : {
"currency" : "USD",
"value" : "1",
"issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
}
},
"secret" : "sssssssssssssssssssssssssssss"
}</code></pre></div>
<div style="display: none;" id="code-39-1"><pre><code title="Double-click to expand/collapse">{
"method": "submit",
"params": [
{
"secret": "sssssssssssssssssssssssssssss",
"tx_json": {
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Amount": {
"currency": "USD",
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"value": "1"
},
"Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"TransactionType": "Payment"
}
}
]
}</code></pre></div>
<div style="display: none;" id="code-39-2"><pre><code title="Double-click to expand/collapse">#Syntax: submit secret json [offline]
submit sssssssssssssssssssssssssssss '{"TransactionType":"Payment", "Account":"rJYMACXJd1eejwzZA53VncYmiK2kZSBxyD", "Amount":"200000000","Destination":"r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV" }'</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#submit">Try it!</a></p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-40" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-40-0">WebSocket</a></li><li><a href="#code-40-1">JSON-RPC</a></li></ul>
<div id="code-40-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"status": "success",
"type": "response",
"result": {
"engine_result": "tesSUCCESS",
"engine_result_code": 0,
"engine_result_message": "The transaction was applied.",
"tx_blob": "1200002280000000240000000161D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000A732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100F8A650C1D58325FE8D74634C1DC0802BB2271EB84773793EF34085CFC7E32B1302206ECE43AFE94B7F9F0359D53E6B195C2D526DFDFBBBF328D6FE3A598F1D51DEBA81144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754",
"tx_json": {
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Amount": {
"currency": "USD",
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"value": "1"
},
"Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 1,
"SigningPubKey": "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB",
"TransactionType": "Payment",
"TxnSignature": "3045022100F8A650C1D58325FE8D74634C1DC0802BB2271EB84773793EF34085CFC7E32B1302206ECE43AFE94B7F9F0359D53E6B195C2D526DFDFBBBF328D6FE3A598F1D51DEBA",
"hash": "7BF105CFE4EFE78ADB63FE4E03A851440551FE189FD4B51CAAD9279C9F534F0E"
}
}
}</code></pre></div>
<div style="display: none;" id="code-40-1"><pre><code title="Double-click to expand/collapse">{
"result": {
"engine_result": "tesSUCCESS",
"engine_result_code": 0,
"engine_result_message": "The transaction was applied.",
"status": "success",
"tx_blob": "1200002280000000240000000361D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000A732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100D184EB4AE5956FF600E7536EE459345C7BBCF097A84CC61A93B9AF7197EDB98702201CEA8009B7BEEBAA2AACC0359B41C427C1C5B550A4CA4B80CF2174AF2D6D5DCE81144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754",
"tx_json": {
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Amount": {
"currency": "USD",
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"value": "1"
},
"Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
"Fee": "10",
"Flags": 2147483648,
"Sequence": 3,
"SigningPubKey": "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB",
"TransactionType": "Payment",
"TxnSignature": "3045022100D184EB4AE5956FF600E7536EE459345C7BBCF097A84CC61A93B9AF7197EDB98702201CEA8009B7BEEBAA2AACC0359B41C427C1C5B550A4CA4B80CF2174AF2D6D5DCE",
"hash": "82230B9D489370504B39BC2CE46216176CAC9E752E5C1774A8CBEC9FBB819208"
}
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>engine_result</td>
<td>String</td>
<td>Code indicating the status of the transaction, for example <code title="Double-click to expand/collapse">tesSUCCESS</code></td>
</tr>
<tr>
<td>engine_result_code</td>
<td>Integer</td>
<td>Numeric code indicating the status of the transaction, directly correlated to <code title="Double-click to expand/collapse">engine_result</code></td>
</tr>
<tr>
<td>engine_result_message</td>
<td>String</td>
<td>Human-readable explanation of the status of the transaction</td>
</tr>
<tr>
<td>tx_blob</td>
<td>String</td>
<td>The complete transaction in hex string format</td>
</tr>
<tr>
<td>tx_json</td>
<td>Object</td>
<td>The complete transaction in JSON format</td>
</tr>
</tbody>
</table><p><em>Important:</em> Even if the WebSocket response has <code title="Double-click to expand/collapse">"status":"success"</code>, indicating that the command was successfully received, that does not necessarily indicate that the transaction has taken place. There are many cases that can prevent a transaction from processing successfully, such as a lack of trust lines connecting the two accounts in a payment, or changes in the state of the network since the time the transaction was constructed. Even if nothing is wrong, it may take several seconds to close and validate the ledger version that includes the transaction. See the <a href="https://ripple.com/wiki/Transaction_errors">full list of transaction responses</a> for details, and do not consider the transaction’s results final until they appear in a validated ledger version.</p><p><em>Warning:</em> If this command results in an error messages, the message can contain an account secret, if one was provided in the request. (This is not a problem if the request contained a signed tx_blob instead.) Make sure that these errors are not visible to others, including:</p><ul>
<li>Do not write an error including your secret to a log file that can be seen by multiple people</li>
<li>Do not paste an error including your secret to a public place for debugging</li>
<li>Do not display an error message including your secret on a website, even by accident</li>
</ul><h2 id="book-offers">book_offers</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/BookOffers.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">book_offers</code> method retrieves a list of offers, also known as the <a href="http://www.investopedia.com/terms/o/order-book.asp">order book</a>, between two currencies. If the results are very large, a partial result is returned with a marker so that subsequent requests can resume from where the previous one left off.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-41" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-41-0">WebSocket</a></li><li><a href="#code-41-1">JSON-RPC</a></li><li><a href="#code-41-2">Commandline</a></li></ul>
<div id="code-41-0"><pre><code title="Double-click to expand/collapse">{
"id": 4,
"command": "book_offers",
"taker": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"taker_gets": {
"value": "1",
"currency": "EUR",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
},
"taker_pays": {
"value": "1",
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
}
}</code></pre></div>
Request:
<div style="display: none;" id="code-41-1"><pre><code title="Double-click to expand/collapse">{
"method": "book_offers",
"params": [
{
"taker": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
"taker_gets": {
"currency": "EUR",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "1"
},
"taker_pays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "1"
}
}
]
}</code></pre></div>
<div style="display: none;" id="code-41-2"><pre><code title="Double-click to expand/collapse">#Syntax: book_offers taker_pays taker_gets [taker [ledger [limit [proof [marker]]]]] [autobridge]
rippled -- book_offers 'USD/rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B' 'EUR/rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B'</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#book_offers">Try it!</a></p><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>taker</td>
<td>String</td>
<td>(Optional, defaults to <a href="https://ripple.com/wiki/Accounts#ACCOUNT_ONE">ACCOUNT_ONE</a>) Unique base-58 address of an account to use as point-of-view. (This affects which unfunded offers are returned.) </td>
</tr>
<tr>
<td>taker_gets</td>
<td>Object</td>
<td>Specification of which currency the account taking the offer would receive, as an object with <code title="Double-click to expand/collapse">currency</code> and <code title="Double-click to expand/collapse">issuer</code> fields (omit issuer for XRP), similar to <a href="#specifying-currency-amounts">currency amounts</a>.</td>
</tr>
<tr>
<td>taker_pays</td>
<td>Object</td>
<td>Specification of which currency the account taking the offer would pay, as an object with <code title="Double-click to expand/collapse">currency</code> and <code title="Double-click to expand/collapse">issuer</code> fields (omit issuer for XRP), similar to <a href="#specifying-currency-amounts">currency amounts</a>.</td>
</tr>
</tbody>
</table><p><em>Note:</em> The other parameters of this command — <code title="Double-click to expand/collapse">marker</code>, <code title="Double-click to expand/collapse">limit</code>, <code title="Double-click to expand/collapse">proof</code>, and <code title="Double-click to expand/collapse">autobridge</code> — are not yet fully implemented. (See <a href="https://ripplelabs.atlassian.net/browse/RIPD-295">RIPD-295</a>).</p><p>Normally, offers that are not funded are omitted; however, offers made by the specified <code title="Double-click to expand/collapse">taker</code> account are always displayed. This allows you to look up your own unfunded offers in order to cancel them with an OfferCancel transaction.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-42" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-42-0">WebSocket</a></li><li><a href="#code-42-1">JSON-RPC</a></li></ul>
<div id="code-42-0"><pre><code title="Double-click to expand/collapse">{
"id": 11,
"status": "success",
"type": "response",
"result": {
"ledger_current_index": 7035305,
"offers": [
{
"Account": "rM3X3QSr8icjTGpaF52dozhbT2BZSXJQYM",
"BookDirectory": "7E5F614417C2D0A7CEFEB73C4AA773ED5B078DE2B5771F6D55055E4C405218EB",
"BookNode": "0000000000000000",
"Flags": 0,
"LedgerEntryType": "Offer",
"OwnerNode": "0000000000000AE0",
"PreviousTxnID": "6956221794397C25A53647182E5C78A439766D600724074C99D78982E37599F1",
"PreviousTxnLgrSeq": 7022646,
"Sequence": 264542,
"TakerGets": {
"currency": "EUR",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "17.90363633316433"
},
"TakerPays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "27.05340557506234"
},
"index": "96A9104BF3137131FF8310B9174F3B37170E2144C813CA2A1695DF2C5677E811",
"quality": "1.511056473200875"
},
{
"Account": "rhsxKNyN99q6vyYCTHNTC1TqWCeHr7PNgp",
"BookDirectory": "7E5F614417C2D0A7CEFEB73C4AA773ED5B078DE2B5771F6D5505DCAA8FE12000",
"BookNode": "0000000000000000",
"Flags": 131072,
"LedgerEntryType": "Offer",
"OwnerNode": "0000000000000001",
"PreviousTxnID": "8AD748CD489F7FF34FCD4FB73F77F1901E27A6EFA52CCBB0CCDAAB934E5E754D",
"PreviousTxnLgrSeq": 7007546,
"Sequence": 265,
"TakerGets": {
"currency": "EUR",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "2.542743233917848"
},
"TakerPays": {
"currency": "USD",
"issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"value": "4.19552633596446"
},
"index": "7001797678E886E22D6DE11AF90DF1E08F4ADC21D763FAFB36AF66894D695235",
"quality": "1.65"
}
]
}
}</code></pre></div>
<div style="display: none;" id="code-42-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"ledger_current_index": 8696243,
"offers": [],
"status": "success",
"validated": false
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>ledger_current_index</td>
<td>Integer</td>
<td>(Omitted if ledger version provided) Sequence number of the ledger version used when retrieving this data.</td>
</tr>
<tr>
<td>ledger_index</td>
<td>Integer</td>
<td>(Omitted if ledger_current_index provided instead) Sequence number, provided in the request, of the ledger version that was used when retrieving this data.</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(May be omitted) Hex hash, provided in the request, of the ledger version that was used when retrieving this data.</td>
</tr>
<tr>
<td>offers</td>
<td>Array</td>
<td>Array of offer objects, each of which has the fields of an <a href="transactions.html#offercreate">OfferCreate transaction</a></td>
</tr>
</tbody>
</table><p>In addition to the standard Offer fields, the following fields may be included in members of the <code title="Double-click to expand/collapse">offers</code> array:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>taker_gets_funded</td>
<td>String (XRP) or Object (non-XRP)</td>
<td>(Only included in partially-funded offers) The maximum amount of currency that the taker can get, given the funding status of the offer.</td>
</tr>
<tr>
<td>taker_pays_funded</td>
<td>String (XRP) or Object (non-XRP)</td>
<td>(Only included in partially-funded offers) The maximum amount of currency that the taker would pay, given the funding status of the offer.</td>
</tr>
<tr>
<td>quality</td>
<td>Number</td>
<td>The exchange rate, as the ratio <code title="Double-click to expand/collapse">taker_pays</code> divided by <code title="Double-click to expand/collapse">taker_gets</code>. For fairness, offers that have the same quality are automatically taken first-in, first-out. (In other words, if multiple people offer to exchange currency at the same rate, the oldest offer is taken first.)</td>
</tr>
</tbody>
</table><h1 id="subscriptions">Subscriptions</h1><p>Using subscriptions, you can have the server push updates to your client when various events happen, so that you can know right away and react accordingly. Subscriptions are only supported in the WebSocket API, where you can receive additional responses in the same channel.</p><p>JSON-RPC support for subscription callbacks is deprecated and may not work as expected.</p><h2 id="subscribe">subscribe</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/Subscribe.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">subscribe</code> method requests periodic notifications from the server when certain events happen. </p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-43" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-43-0">WebSocket - accounts</a></li><li><a href="#code-43-1">WebSocket - offer book</a></li></ul>
<div id="code-43-0"><pre><code title="Double-click to expand/collapse">{
"id": "Example watch Bitstamp's hot wallet",
"command": "subscribe",
"accounts": ["rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"]
}</code></pre></div>
<div style="display: none;" id="code-43-1"><pre><code title="Double-click to expand/collapse">{
"command": "subscribe",
"books": [
{
"taker_pays": {
"currency": "XRP"
},
"taker_gets": {
"currency": "USD",
"issuer": "rUQTpMqAF5jhykj4FExVeXakrZpiKF6cQV"
},
"snapshot": true
}
]
}</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#subscribe">Try it!</a></p><p>The request includes the following parameters:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>streams</td>
<td>Array</td>
<td>(Optional) Array of string names of generic streams to subscribe to, as explained below</td>
</tr>
<tr>
<td>accounts</td>
<td>Array</td>
<td>(Optional) Array with the unique base-58 addresses of accounts to monitor for validated transactions. The server sends a notification for any transaction that affects at least one of these accounts.</td>
</tr>
<tr>
<td>accounts_proposed</td>
<td>Array</td>
<td>(Optional) Like <code title="Double-click to expand/collapse">accounts</code>, but include transactions that are not yet finalized.</td>
</tr>
<tr>
<td>books</td>
<td>Array</td>
<td>(Optional) Array of objects defining <a href="http://www.investopedia.com/terms/o/order-book.asp">order books</a> to monitor for updates, as detailed below.</td>
</tr>
<tr>
<td>url</td>
<td>String</td>
<td>(Optional for Websocket; Required otherwise) URL where the server will send a JSON-RPC callback with each event. <em>Admin-only.</em></td>
</tr>
<tr>
<td>url_username</td>
<td>String</td>
<td>(Optional) Username to provide for basic authentication at the callback URL.</td>
</tr>
<tr>
<td>url_password</td>
<td>String</td>
<td>(Optional) Password to provide for basic authentication at the callback URL.</td>
</tr>
</tbody>
</table><p>The following parameters are deprecated and may be removed without further notice: <code title="Double-click to expand/collapse">user</code>, <code title="Double-click to expand/collapse">password</code>, <code title="Double-click to expand/collapse">rt_accounts</code>.</p><p>The <code title="Double-click to expand/collapse">streams</code> parameter provides access to the following default streams of information:</p><ul>
<li><code title="Double-click to expand/collapse">server</code> - Sends a message whenever the status of the rippled server (for example, network connectivity) changes</li>
<li><code title="Double-click to expand/collapse">ledger</code> - Sends a message whenever a new ledger version closes</li>
<li><code title="Double-click to expand/collapse">transactions</code> - Sends a message whenever a transaction is included in a closed ledger</li>
<li><code title="Double-click to expand/collapse">transactions_proposed</code> - Sends a message whenever a transaction is included in a closed ledger, as well as some transactions that have not yet been included in a validated ledger and may never be. Not all proposed transactions appear before validation, however. (Note that <a href="https://ripple.com/wiki/Transaction_errors#Claimed_fee_only">even some transactions that don’t succeed are included</a> in validated ledgers, because they take the anti-spam transaction fee.)</li>
</ul><p>Each member of the <code title="Double-click to expand/collapse">books</code> array, if provided, is an object with the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>taker_gets</td>
<td>Object</td>
<td>Specification of which currency the account taking the offer would receive, as a <a href="#specifying-currencies-without-amounts">currency object with no amount</a>.</td>
</tr>
<tr>
<td>taker_pays</td>
<td>Object</td>
<td>Specification of which currency the account taking the offer would pay, as a <a href="#specifying-currencies-without-amounts">currency object with no amount</a>.</td>
</tr>
<tr>
<td>taker</td>
<td>String</td>
<td>Unique base-58 account address to use as a perspective for viewing offers. (This affects the funding status and fees of offers.)</td>
</tr>
<tr>
<td>snapshot</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, return the current state of the order book once when you subscribe before sending updates</td>
</tr>
<tr>
<td>both</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, return both sides of the order book.</td>
</tr>
</tbody>
</table><p>The field <code title="Double-click to expand/collapse">proof</code> is reserved for future use.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-44" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-44-0">WebSocket</a></li></ul>
<div id="code-44-0"><pre><code title="Double-click to expand/collapse">{
"id": "Example watch Bitstamp's hot wallet",
"status": "success",
"type": "response",
"result": {}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>. The fields contained in the response vary depending on what subscriptions were included in the request.</p><ul>
<li><code title="Double-click to expand/collapse">accounts</code> and <code title="Double-click to expand/collapse">accounts_proposed</code> - No fields returned</li>
<li><em>Stream: server</em> - Information about the server status, such as <code title="Double-click to expand/collapse">load_base</code> (the current load level of the server), <code title="Double-click to expand/collapse">random</code> (a randomly-generated value), and others, subject to change. </li>
<li><em>Stream: transactions</em> and <em>Stream: transactions_proposed</em> - No fields returned</li>
<li><em>Stream: ledger</em> - Information about the ledgers on hand and current fee schedule, such as <code title="Double-click to expand/collapse">fee_base</code> (current base fee for transactions in XRP), <code title="Double-click to expand/collapse">fee_ref</code> (current base fee for transactions in fee units), <code title="Double-click to expand/collapse">ledger_hash</code> (hash of the latest validated ledger), <code title="Double-click to expand/collapse">reserve_base</code> (minimum reserve for accounts), and more.</li>
<li><code title="Double-click to expand/collapse">books</code> - No fields returned by default. If <code title="Double-click to expand/collapse">"snapshot": true</code> is set in the request, returns <code title="Double-click to expand/collapse">offers</code> (an array of offer definition objects defining the order book)</li>
</ul><h3 id="subscription-stream-messages">Subscription Stream Messages</h3><p>When you subscribe to a particular stream, you will receive periodic responses on that stream until you unsubscribe or close the WebSocket connection. The content of those responses depends on what you subscribed to. Here are some examples:</p><h4>Stream: ledger Message</h4><pre><code title="Double-click to expand/collapse">{
"type": "ledgerClosed",
"fee_base": 10,
"fee_ref": 10,
"ledger_hash": "687F604EF6B2F67319E8DCC8C66EF49D84D18A1E18F948421FC24D2C7C3DB464",
"ledger_index": 7125358,
"ledger_time": 455751310,
"reserve_base": 20000000,
"reserve_inc": 5000000,
"txn_count": 7,
"validated_ledgers": "32570-7125358"
}</code></pre><p>The fields from a ledger stream message are as follows:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>String</td>
<td><code title="Double-click to expand/collapse">ledgerClosed</code> indicates this is from the ledger stream</td>
</tr>
<tr>
<td>fee_base</td>
<td>Unsigned Integer</td>
<td>Cost of the ‘reference transaction’ in drops of XRP. (See <a href="https://ripple.com/wiki/Transaction_Fee#Fee_Terminology">Transaction Fee Terminology</a></td>
</tr>
<tr>
<td>fee_ref</td>
<td>Unsigned Integer</td>
<td>Cost of the ‘reference transaction’ in ‘fee units’. (See <a href="https://ripple.com/wiki/Transaction_Fee#Fee_Terminology">Transaction Fee Terminology</a></td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>Unique hash of the ledger that was closed, as hex</td>
</tr>
<tr>
<td>ledger_index</td>
<td>Unsigned Integer</td>
<td>Sequence number of the ledger that was closed</td>
</tr>
<tr>
<td>ledger_time</td>
<td>Unsigned Integer</td>
<td>The time this ledger was closed, in seconds since the <a href="#specifying-time">Ripple Epoch</a></td>
</tr>
<tr>
<td>reserve_base</td>
<td>Unsigned Integer</td>
<td>The minimum reserve, in drops of XRP, that is required for an account</td>
</tr>
<tr>
<td>reserve_inc</td>
<td>Unsigned Integer</td>
<td>The increase in account reserve that is added for each item the account owns, such as offers or trust lines</td>
</tr>
<tr>
<td>txn_count</td>
<td>Unsigned Integer</td>
<td>Number of transactions newly included in this ledger</td>
</tr>
<tr>
<td>validated_ledgers</td>
<td>String</td>
<td>Range of ledgers that the server has available. This may be discontiguous.</td>
</tr>
</tbody>
</table><h4>Transaction Messages</h4><p>Most other subscriptions result in messages about transactions. The <code title="Double-click to expand/collapse">transactions_proposed</code> stream, strictly speaking, is a superset of the <code title="Double-click to expand/collapse">transactions</code> stream: it includes all validated transactions, as well as some suggested transactions that have not yet been included in a validated ledger and may never be. You can identify these “in-flight” transactions by their fields:</p><ul>
<li>The <code title="Double-click to expand/collapse">validated</code> field is missing or has a value of <code title="Double-click to expand/collapse">false</code>.</li>
<li>There is no <code title="Double-click to expand/collapse">meta</code> or <code title="Double-click to expand/collapse">metadata</code> field.</li>
<li>Instead of <code title="Double-click to expand/collapse">ledger_hash</code> and <code title="Double-click to expand/collapse">ledger_index</code> fields specifying in which ledger version the transactions were finalized, there is a <code title="Double-click to expand/collapse">ledger_current_index</code> field specifying in which ledger version they are currently proposed.</li>
</ul><p>Otherwise, the messages from the <code title="Double-click to expand/collapse">transactions_proposed</code> stream are identical to ones from the <code title="Double-click to expand/collapse">transactions</code> stream.</p><p>Since the only thing that can modify an account or an order book is a transaction, the messages that are sent as a result of subscribing to particular <code title="Double-click to expand/collapse">accounts</code> or <code title="Double-click to expand/collapse">books</code> also take the form of transaction messages, the same as the ones in the <code title="Double-click to expand/collapse">transactions</code> stream. The only difference is that you only receive messages for transactions that affect the accounts or order books you’re watching.</p><p>The <code title="Double-click to expand/collapse">accounts_proposed</code> subscription works the same way, except it also includes unconfirmed transactions, like the <code title="Double-click to expand/collapse">transactions_proposed</code> stream, for the accounts you’re watching.</p><pre><code title="Double-click to expand/collapse">{
"status": "closed",
"type": "transaction",
"engine_result": "tesSUCCESS",
"engine_result_code": 0,
"engine_result_message": "The transaction was applied.",
"ledger_hash": "989AFBFD65D820C6BD85301B740F5D592F060668A90EEF5EC1815EBA27D58FE8",
"ledger_index": 7125442,
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Flags": 0,
"IndexPrevious": "0000000000000000",
"Owner": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL",
"RootIndex": "ABD8CE2D1205D0C062876E9E1F3CBDC902ED8EF4E8D3D071B962C7ED0E113E68"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "0BBDEE7D0BE120F7BF27640B5245EBFE0C5FD5281988BA823C44477A70262A4D"
}
},
{
"DeletedNode": {
"FinalFields": {
"Account": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL",
"BookDirectory": "892E892DC63D8F70DCF5C9ECF29394FF7DD3DC6F47DB8EB34A03920BFC5E99BE",
"BookNode": "0000000000000000",
"Flags": 0,
"OwnerNode": "000000000000006E",
"PreviousTxnID": "58A17D95770F8D07E08B81A85896F4032A328B6C2BDCDEC0A00F3EF3914DCF0A",
"PreviousTxnLgrSeq": 7125330,
"Sequence": 540691,
"TakerGets": "4401967683",
"TakerPays": {
"currency": "BTC",
"issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9",
"value": "0.04424"
}
},
"LedgerEntryType": "Offer",
"LedgerIndex": "386B7803A9210747941B0D079BB408F31ACB1CB98832184D0287A1CBF4FE6D00"
}
},
{
"DeletedNode": {
"FinalFields": {
"ExchangeRate": "4A03920BFC5E99BE",
"Flags": 0,
"RootIndex": "892E892DC63D8F70DCF5C9ECF29394FF7DD3DC6F47DB8EB34A03920BFC5E99BE",
"TakerGetsCurrency": "0000000000000000000000000000000000000000",
"TakerGetsIssuer": "0000000000000000000000000000000000000000",
"TakerPaysCurrency": "0000000000000000000000004254430000000000",
"TakerPaysIssuer": "92D705968936C419CE614BF264B5EEB1CEA47FF4"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "892E892DC63D8F70DCF5C9ECF29394FF7DD3DC6F47DB8EB34A03920BFC5E99BE"
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL",
"Balance": "11133297300",
"Flags": 0,
"OwnerCount": 9,
"Sequence": 540706
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "A6C2532E1008A513B3F822A92B8E5214BD0D413DC20AD3631C1A39AD6B36CD07",
"PreviousFields": {
"Balance": "11133297310",
"OwnerCount": 10,
"Sequence": 540705
},
"PreviousTxnID": "484D57DFC4E446DA83B4540305F0CE836D4E007361542EC12CC0FFB5F0A1BE3A",
"PreviousTxnLgrSeq": 7125358
}
}
],
"TransactionIndex": 1,
"TransactionResult": "tesSUCCESS"
},
"transaction": {
"Account": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL",
"Fee": "10",
"Flags": 2147483648,
"OfferSequence": 540691,
"Sequence": 540705,
"SigningPubKey": "030BB49C591C9CD65C945D4B78332F27633D7771E6CF4D4B942D26BA40748BB8B4",
"TransactionType": "OfferCancel",
"TxnSignature": "30450221008223604A383F3AED25D53CE7C874700619893A6EEE4336508312217850A9722302205E0614366E174F2DFF78B879F310DB0B3F6DA1967E52A32F65E25DCEC622CD68",
"date": 455751680,
"hash": "94CF924C774DFDBE474A2A7E40AEA70E7E15D130C8CBEF8AF1D2BE97A8269F14"
},
"validated": true
}</code></pre><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>String</td>
<td><code title="Double-click to expand/collapse">transaction</code> indicates this is the notification of a transaction, which could come from the <code title="Double-click to expand/collapse">transactions</code> or <code title="Double-click to expand/collapse">transactions_proposed</code> streams, or from watching a particular account</td>
</tr>
<tr>
<td>engine_result</td>
<td>String</td>
<td>String <a href="https://ripple.com/wiki/Transaction_errors">transaction response code</a></td>
</tr>
<tr>
<td>engine_result_code</td>
<td>Number</td>
<td>Numeric <a href="https://ripple.com/wiki/Transaction_errors">transaction response code</a></td>
</tr>
<tr>
<td>engine_result_message</td>
<td>String</td>
<td>Human-readable explanation for the transaction response</td>
</tr>
<tr>
<td>ledger_current_index</td>
<td>Unsigned Integer</td>
<td>(Omitted for validated transactions) Sequence number of the current ledger version for which this transaction is currently proposed</td>
</tr>
<tr>
<td>ledger_hash</td>
<td>String</td>
<td>(Omitted for unvalidated transactions) Unique hash of the ledger version that includes this transaction, as hex</td>
</tr>
<tr>
<td>ledger_index</td>
<td>Unsigned Integer</td>
<td>(Omitted for unvalidated transactions) Sequence number of the ledger version that includes this transaction</td>
</tr>
<tr>
<td>meta</td>
<td>Object</td>
<td>(Omitted for unvalidated transactions) Various metadata about the transaction, including which ledger entries it affected</td>
</tr>
<tr>
<td>transaction</td>
<td>Object</td>
<td>The <a href="transactions.html">definition of the transaction</a> in JSON format</td>
</tr>
<tr>
<td>validated</td>
<td>Boolean</td>
<td>If true, this transaction is included in a validated ledger. Responses from the <code title="Double-click to expand/collapse">transaction</code> stream should always be validated.</td>
</tr>
</tbody>
</table><h2 id="unsubscribe">unsubscribe</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/Unsubscribe.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">unsubscribe</code> command tells the server to stop sending messages for a particular subscription or set of subscriptions.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-45" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-45-0">WebSocket</a></li></ul>
<div id="code-45-0"><pre><code title="Double-click to expand/collapse">{
"id": "Unsubscribe a lot of stuff",
"command": "unsubscribe",
"streams": ["ledger","server","transactions","transactions_proposed"],
"accounts": ["rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"],
"accounts_proposed": ["rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"],
"books": [
{
"taker_pays": {
"currency": "XRP"
},
"taker_gets": {
"currency": "USD",
"issuer": "rUQTpMqAF5jhykj4FExVeXakrZpiKF6cQV"
},
"both": true
}
]
}</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#unsubscribe">Try it!</a></p><p>The parameters in the request are specified almost exactly like the parameters to <a href="#subscribe"><code title="Double-click to expand/collapse">subscribe</code></a>, except that they are used to define which subscriptions to end instead. The parameters are:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>streams</td>
<td>Array</td>
<td>(Optional) Array of string names of generic streams to unsubscribe from, including <code title="Double-click to expand/collapse">ledger</code>, <code title="Double-click to expand/collapse">server</code>, <code title="Double-click to expand/collapse">transactions</code>, and <code title="Double-click to expand/collapse">transactions_proposed</code>.</td>
</tr>
<tr>
<td>accounts</td>
<td>Array</td>
<td>(Optional) Array of unique base-58 account addresses to stop receiving updates for. (This only stops those messages if you previously subscribed to those accounts specifically. You cannot use this to filter accounts out of the general transactions stream.)</td>
</tr>
<tr>
<td>accounts_proposed</td>
<td>Array</td>
<td>(Optional) Like <code title="Double-click to expand/collapse">accounts</code>, but for <code title="Double-click to expand/collapse">accounts_proposed</code> subscriptions that included not-yet-validated transactions.</td>
</tr>
<tr>
<td>books</td>
<td>Array</td>
<td>(Optional) Array of objects defining order books to unsubscribe from, as explained below.</td>
</tr>
</tbody>
</table><p>The <code title="Double-click to expand/collapse">rt_accounts</code> and <code title="Double-click to expand/collapse">url</code> parameters, and the <code title="Double-click to expand/collapse">rt_transactions</code> stream name, are deprecated and may be removed without further notice.</p><p>The objects in the <code title="Double-click to expand/collapse">books</code> array are defined almost like the ones from subscribe, except that they don’t have all the fields. The fields they have are as follows:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>taker_gets</td>
<td>Object</td>
<td>Specification of which currency the account taking the offer would receive, as an object with <code title="Double-click to expand/collapse">currency</code> and <code title="Double-click to expand/collapse">issuer</code> fields (omit issuer for XRP), similar to <a href="#specifying-currency-amounts">currency amounts</a>.</td>
</tr>
<tr>
<td>taker_pays</td>
<td>Object</td>
<td>Specification of which currency the account taking the offer would pay, as an object with <code title="Double-click to expand/collapse">currency</code> and <code title="Double-click to expand/collapse">issuer</code> fields (omit issuer for XRP), similar to <a href="#specifying-currency-amounts">currency amounts</a>.</td>
</tr>
<tr>
<td>both</td>
<td>Boolean</td>
<td>(Optional, defaults to false) If true, remove a subscription for both sides of the order book.</td>
</tr>
</tbody>
</table><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-46" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-46-0">WebSocket</a></li></ul>
<div id="code-46-0"><pre><code title="Double-click to expand/collapse">{
"id": "Unsubscribe a lot of stuff",
"result": {},
"status": "success",
"type": "response"
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing no fields.</p><h1 id="server-information">Server Information</h1><p>There are also commands that retrieve information about the current state of the server. These may be useful for monitoring the health of the server, or in preparing for making other API methods. For example, you may query for the current fee schedule before sending a transaction, or you may check which ledger versions are available before digging into the ledger history for a specific record.</p><h2 id="server-info">server_info</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/ServerInfo.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">server_info</code> command asks the server for a human-readable version of various information about the <code title="Double-click to expand/collapse">rippled</code> server being queried.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-47" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-47-0">WebSocket</a></li><li><a href="#code-47-1">JSON-RPC</a></li></ul>
<div id="code-47-0"><pre><code title="Double-click to expand/collapse">{
"id": 11,
"command": "server_info"
}</code></pre></div>
<div style="display: none;" id="code-47-1"><pre><code title="Double-click to expand/collapse">{
"method": "server_info",
"params": [
{}
]
}</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#server_info">Try it!</a></p><p>The request does not takes any parameters.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-48" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-48-0">WebSocket</a></li><li><a href="#code-48-1">JSON-RPC</a></li></ul>
<div id="code-48-0"><pre><code title="Double-click to expand/collapse">{
"id": 11,
"status": "success",
"type": "response",
"result": {
"info": {
"build_version": "0.25.2",
"complete_ledgers": "32570-7695432",
"hostid": "AIR",
"io_latency_ms": 1,
"last_close": {
"converge_time_s": 2.037,
"proposers": 5
},
"load_factor": 1,
"peers": 56,
"pubkey_node": "n9LVtEwRBRfLhrs5cZcKYiYMw6wT9MgmAZEMQEXmX4Bwkq4D6hc1",
"server_state": "full",
"validated_ledger": {
"age": 3,
"base_fee_xrp": 0.00001,
"hash": "274C27799A91DF08603AF9B5CB03372ECF844B6D643CAF69F25205C9509E212F",
"reserve_base_xrp": 20,
"reserve_inc_xrp": 5,
"seq": 7695432
},
"validation_quorum": 3
}
}
}</code></pre></div>
<div style="display: none;" id="code-48-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"info": {
"build_version": "0.26.3",
"complete_ledgers": "32570-8696244",
"hostid": "AIR",
"io_latency_ms": 1,
"last_close": {
"converge_time_s": 3.123,
"proposers": 5
},
"load_factor": 1,
"peers": 62,
"pubkey_node": "n9LVtEwRBRfLhrs5cZcKYiYMw6wT9MgmAZEMQEXmX4Bwkq4D6hc1",
"server_state": "full",
"validated_ledger": {
"age": 3,
"base_fee_xrp": 1e-05,
"hash": "43660857C8FD74D8D5B9D6D9E3D4BE11FAD92985F6B8C9A406DC1F87FF6CB77F",
"reserve_base_xrp": 20,
"reserve_inc_xrp": 5,
"seq": 8696244
},
"validation_quorum": 3
},
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing an <code title="Double-click to expand/collapse">info</code> object as its only field.</p><p>The <code title="Double-click to expand/collapse">info</code> object may have some arrangement of the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>build_version</td>
<td>String</td>
<td>The version number of the running <code title="Double-click to expand/collapse">rippled</code> version.</td>
</tr>
<tr>
<td>complete_ledgers</td>
<td>String</td>
<td>Range expression indicating the sequence numbers of the ledger versions the local rippled has in its database. It is possible to be a disjoint sequence, e.g. “2500-5000,32570-7695432”.</td>
</tr>
<tr>
<td>hostid</td>
<td>String</td>
<td>On an admin request, returns the hostname of the server running the <code title="Double-click to expand/collapse">rippled</code> instance; otherwise, returns a unique four letter word.</td>
</tr>
<tr>
<td>io_latency_ms</td>
<td>Number</td>
<td>Amount of time spent waiting for I/O operations to be performed, in milliseconds. If this number is not very, very low, then the <code title="Double-click to expand/collapse">rippled</code> server is probably having serious load issues.</td>
</tr>
<tr>
<td>last_close</td>
<td>Object</td>
<td>Information about the last time the server closed a ledger, including the amount of time it took to reach a consensus and the number of trusted validators participating.</td>
</tr>
<tr>
<td>load</td>
<td>Object</td>
<td><em>Admin only</em> Detailed information about the current load state of the server</td>
</tr>
<tr>
<td>load.job_types</td>
<td>Array</td>
<td><em>Admin only</em> Information about the rate of different types of jobs being performed by the server and how much time it spends on each.</td>
</tr>
<tr>
<td>load.threads</td>
<td>Number</td>
<td><em>Admin only</em> The number of threads in the server’s main job pool, performing various Ripple Network operations.</td>
</tr>
<tr>
<td>load_factor</td>
<td>Number</td>
<td>The load factor the server is currently enforcing, which affects transaction fees. The load factor is determined by the highest of the individual server’s load factor, cluster’s load factor, and the overall network’s load factor. See <a href="https://ripple.com/wiki/Calculating_the_Transaction_Fee">Calculating Transaction Fees</a> for more details.</td>
</tr>
<tr>
<td>peers</td>
<td>Number</td>
<td>How many other <code title="Double-click to expand/collapse">rippled</code> servers the node is currently connected to.</td>
</tr>
<tr>
<td>pubkey_node</td>
<td>String</td>
<td>Public key used to verify this node for internal communications; this key is automatically generated by the server the first time it starts up. (If deleted, the node can just create a new pair of keys.)</td>
</tr>
<tr>
<td>pubkey_validator</td>
<td>String</td>
<td><em>Admin only</em> Public key used by this node to sign ledger validations; .</td>
</tr>
<tr>
<td>server_state</td>
<td>String</td>
<td>A string indicating to what extent the server is participating in the network. See <a href="#possible-server-states">Possible Server States</a> for more details.</td>
</tr>
<tr>
<td>validated_ledger</td>
<td>Object</td>
<td>Information about the fully-validated ledger with the highest sequence number (the most recent)</td>
</tr>
<tr>
<td>validated_ledger.age</td>
<td>Unsigned Integer</td>
<td>The time since the ledger was closed, in seconds</td>
</tr>
<tr>
<td>validated_ledger.base_fee_xrp</td>
<td>Number</td>
<td>Base fee, in XRP. This may be represented in scientific notation such as 1e-05 for 0.00005</td>
</tr>
<tr>
<td>validated_ledger.hash</td>
<td>String</td>
<td>Unique hash for the ledger, as hex</td>
</tr>
<tr>
<td>validated_ledger.reserve_base_xrp</td>
<td>Unsigned Integer</td>
<td>Minimum amount of XRP (not drops) necessary for every account to keep in reserve</td>
</tr>
<tr>
<td>validated_ledger.reserve_inc_xrp</td>
<td>Unsigned Integer</td>
<td>Amount of XRP (not drops) added to the account reserve for each object an account is responsible for in the ledger</td>
</tr>
<tr>
<td>validated_ledger.seq</td>
<td>Unsigned Integer</td>
<td>Identifying sequence number of this ledger version</td>
</tr>
<tr>
<td>validation_quorum</td>
<td>Number</td>
<td>Minimum number of trusted validations required in order to validate a ledger version. Some circumstances may cause the server to require more validations.</td>
</tr>
</tbody>
</table><h2 id="server-state">server_state</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/ServerState.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">server_state</code> command asks the server for various machine-readable information about the <code title="Double-click to expand/collapse">rippled</code> server’s current state. The results are very similar to <a href="#server-info"><code title="Double-click to expand/collapse">server_info</code></a>, but generally the units are chosen to be easier to process instead of easier to read. (For example, XRP values are given in integer drops instead of scientific notation or decimal values, and time is given in milliseconds instead of seconds.)</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-49" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-49-0">WebSocket</a></li><li><a href="#code-49-1">JSON-RPC</a></li></ul>
<div id="code-49-0"><pre><code title="Double-click to expand/collapse">{
"id": 12,
"command": "server_state"
}</code></pre></div>
<div style="display: none;" id="code-49-1"><pre><code title="Double-click to expand/collapse">{
"method": "server_state",
"params": [
{}
]
}</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#server_state">Try it!</a></p><p>The request does not takes any parameters.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-50" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-50-0">WebSocket</a></li><li><a href="#code-50-1">JSON-RPC</a></li></ul>
<div id="code-50-0"><pre><code title="Double-click to expand/collapse">{
"id": 2,
"status": "success",
"type": "response",
"result": {
"state": {
"build_version": "0.25.2",
"complete_ledgers": "32570-7696746",
"io_latency_ms": 1,
"last_close": {
"converge_time": 2097,
"proposers": 4
},
"load_base": 256,
"load_factor": 256,
"peers": 61,
"pubkey_node": "n9L4DuE6NsZiVWyYdHcYbKoELTXr4fs32VY8bdic5c4uVrfrADmX",
"server_state": "full",
"validated_ledger": {
"base_fee": 10,
"close_time": 458432860,
"hash": "95A05F232C8C4B4DC313CB91A4C823A221120DD8692395150A3012876C8CD772",
"reserve_base": 20000000,
"reserve_inc": 5000000,
"seq": 7696746
},
"validation_quorum": 3
}
}
}</code></pre></div>
<div style="display: none;" id="code-50-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"state": {
"build_version": "0.26.3",
"complete_ledgers": "32570-8696244",
"io_latency_ms": 1,
"last_close": {
"converge_time": 2120,
"proposers": 5
},
"load_base": 256,
"load_factor": 256,
"peers": 58,
"pubkey_node": "n9LJ5eCNjeUXQpNXHCcLv9PQ8LMFYy4W8R1BdVNcpjc1oDwe6XZF",
"server_state": "full",
"validated_ledger": {
"base_fee": 10,
"close_time": 463192610,
"hash": "43660857C8FD74D8D5B9D6D9E3D4BE11FAD92985F6B8C9A406DC1F87FF6CB77F",
"reserve_base": 20000000,
"reserve_inc": 5000000,
"seq": 8696244
},
"validation_quorum": 3
},
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing a <code title="Double-click to expand/collapse">state</code> object as its only field.</p><p>The <code title="Double-click to expand/collapse">state</code> object may have some arrangement of the following fields:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>build_version</td>
<td>String</td>
<td>The version number of the running <code title="Double-click to expand/collapse">rippled</code> version.</td>
</tr>
<tr>
<td>complete_ledgers</td>
<td>String</td>
<td>Range expression indicating the sequence numbers of the ledger versions the local rippled has in its database. It is possible to be a disjoint sequence, e.g. “2500-5000,32570-7695432”.</td>
</tr>
<tr>
<td>io_latency_ms</td>
<td>Number</td>
<td>Amount of time spent waiting for I/O operations to be performed, in milliseconds. If this number is not very, very low, then the <code title="Double-click to expand/collapse">rippled</code> server is probably having serious load issues.</td>
</tr>
<tr>
<td>load</td>
<td>Object</td>
<td><em>Admin only</em> Detailed information about the current load state of the server</td>
</tr>
<tr>
<td>load.job_types</td>
<td>Array</td>
<td><em>Admin only</em> Information about the rate of different types of jobs being performed by the server and how much time it spends on each.</td>
</tr>
<tr>
<td>load.threads</td>
<td>Number</td>
<td><em>Admin only</em> The number of threads in the server’s main job pool, performing various Ripple Network operations.</td>
</tr>
<tr>
<td>load_base</td>
<td>Number</td>
<td>This amount of server load is the baseline that is used to decide how much to charge in transaction fees; if the <code title="Double-click to expand/collapse">load_factor</code> is equal to the <code title="Double-click to expand/collapse">load_base</code> then only the base fee is enforced; if the <code title="Double-click to expand/collapse">load_factor</code> is double the <code title="Double-click to expand/collapse">load_base</code> then transaction fees are doubled. See <a href="https://ripple.com/wiki/Calculating_the_Transaction_Fee">Calculating Transaction Fees</a> for more details.</td>
</tr>
<tr>
<td>load_factor</td>
<td>Number</td>
<td>The load factor the server is currently enforcing, which affects transaction fees. The load factor is determined by the highest of the individual server’s load factor, cluster’s load factor, and the overall network’s load factor.</td>
</tr>
<tr>
<td>peers</td>
<td>Number</td>
<td>How many other <code title="Double-click to expand/collapse">rippled</code> servers the node is currently connected to.</td>
</tr>
<tr>
<td>pubkey_node</td>
<td>String</td>
<td>Public key used by this server (along with the corresponding private key) for secure communications between nodes. This key pair is automatically created and stored in rippled’s local database the first time it starts up; if lost or deleted, a new key pair can be generated with no ill effects.</td>
</tr>
<tr>
<td>pubkey_validator</td>
<td>String</td>
<td><em>Admin only</em> Public key used by this server (along with the corresponding private key) to sign proposed ledgers for validation.</td>
</tr>
<tr>
<td>server_state</td>
<td>String</td>
<td>A string indicating to what extent the server is participating in the network. See <a href="#possible-server-states">Possible Server States</a> for more details.</td>
</tr>
<tr>
<td>validated_ledger</td>
<td>Object</td>
<td>Information about the fully-validated ledger with the highest sequence number (the most recent)</td>
</tr>
<tr>
<td>validated_ledger.base_fee</td>
<td>Unsigned Integer</td>
<td>Base fee, in drops of XRP, for propagating a transaction to the network.</td>
</tr>
<tr>
<td>validated_ledger.close_time</td>
<td>Number</td>
<td>Time this ledger was closed, in seconds since the <a href="#specifying-time">Ripple Epoch</a></td>
</tr>
<tr>
<td>validated_ledger.hash</td>
<td>String</td>
<td>Unique hash of this ledger version, as hex</td>
</tr>
<tr>
<td>validated_ledger.reserve_base</td>
<td>Unsigned Integer</td>
<td>Minimum amount, in drops of XRP, necessary for every account to keep in reserve</td>
</tr>
<tr>
<td>validated_ledger.reserve_inc</td>
<td>Unsigned Integer</td>
<td>Amount, in drops of XRP, that is added to the account reserve for each item the account owns in the ledger.</td>
</tr>
<tr>
<td>validated_ledger.seq</td>
<td>Unsigned Integer</td>
<td>Unique sequence number of this ledger</td>
</tr>
<tr>
<td>validation_quorum</td>
<td>Number</td>
<td>Minimum number of trusted validations required in order to validate a ledger version. Some circumstances may cause the server to require more validations.</td>
</tr>
</tbody>
</table><h1 id="convenience-functions">Convenience Functions</h1><p>The rippled server also provides a few simple commands purely for convenience.</p><h2 id="ping">ping</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/Ping.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">ping</code> command returns an acknowledgement, so that clients can test the connection status and latency.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-51" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-51-0">WebSocket</a></li><li><a href="#code-51-1">JSON-RPC</a></li><li><a href="#code-51-2">Commandline</a></li></ul>
<div id="code-51-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"command": "ping"
}</code></pre></div>
<div style="display: none;" id="code-51-1"><pre><code title="Double-click to expand/collapse">{
"method": "ping",
"params": [
{}
]
}</code></pre></div>
<div style="display: none;" id="code-51-2"><pre><code title="Double-click to expand/collapse">#Syntax: ping
rippled -- ping</code></pre></div>
</div><p><a class="button" href="ripple-api-tool.html#ping">Try it!</a></p><p>The request includes no parameters.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-52" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-52-0">WebSocket</a></li><li><a href="#code-52-1">JSON-RPC</a></li></ul>
<div id="code-52-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"result": {},
"status": "success",
"type": "response"
}</code></pre></div>
<div style="display: none;" id="code-52-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing no fields. The client can measure the round-trip time from request to response as latency.</p><h2 id="random">random</h2><p><a href="https://github.com/ripple/rippled/blob/master/src/ripple/module/rpc/handlers/Random.cpp" title="Source">[Source]<br></a></p><p>The <code title="Double-click to expand/collapse">random</code> command provides a random number to be used as a source of entropy for random number generation by clients.</p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-53" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-53-0">WebSocket</a></li><li><a href="#code-53-1">JSON-RPC</a></li><li><a href="#code-53-2">Commandline</a></li></ul>
<div id="code-53-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"command": "random"
}</code></pre></div>
<div style="display: none;" id="code-53-1"><pre><code title="Double-click to expand/collapse">{
"method": "random",
"params": [
{}
]
}</code></pre></div>
<div style="display: none;" id="code-53-2"><pre><code title="Double-click to expand/collapse">#Syntax: random
rippled -- random</code></pre></div>
</div><p>The request includes no parameters.</p><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-54" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-54-0">WebSocket</a></li><li><a href="#code-54-1">JSON-RPC</a></li></ul>
<div id="code-54-0"><pre><code title="Double-click to expand/collapse">{
"id": 1,
"result": {
"random": "8ED765AEBBD6767603C2C9375B2679AEC76E6A8133EF59F04F9FC1AAA70E41AF"
},
"status": "success",
"type": "response"
}</code></pre></div>
<div style="display: none;" id="code-54-1"><pre><code title="Double-click to expand/collapse">200 OK
{
"result": {
"random": "4E57146AA47BC6E88FDFE8BAA235B900126C916B6CC521550996F590487B837A",
"status": "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with a successful result containing the following field:</p><table>
<thead>
<tr>
<th>Field</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>random</td>
<td>String</td>
<td>Random 256-bit hex value.</td>
</tr>
</tbody>
</table><h2 id="json">json</h2><p>The <code title="Double-click to expand/collapse">json</code> method is a proxy to running other commands, and accepts the parameters for the command as a JSON value. It is <em>exclusive to the Commandline client</em>, and intended for cases where the commandline syntax for specifying parameters is inadequate or undesirable. </p><h4>Request Format</h4><p>An example of the request format:</p><div id="code-55" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-55-0">Commandline</a></li></ul>
<div id="code-55-0"><pre><code title="Double-click to expand/collapse"># Syntax: json method json_stanza
rippled -q -- json ledger_closed '{}'</code></pre></div>
</div><h4>Response Format</h4><p>An example of a successful response:</p><div id="code-56" class="multicode"><ul class="codetabs"><li><a class="current" href="#code-56-0">WebSocket</a></li></ul>
<div id="code-56-0"><pre><code title="Double-click to expand/collapse">{
"result" : {
"ledger_hash" : "8047C3ECF1FA66326C1E57694F6814A1C32867C04D3D68A851367EE2F89BBEF3",
"ledger_index" : 390308,
"status" : "success"
}
}</code></pre></div>
</div><p>The response follows the <a href="#response-formatting">standard format</a>, with whichever fields are appropriate to the type of command made.</p>
</div>
</div>
<div class="footer">
<div class="container">
<p class="text-muted">
</p><div class="row">
<div class="col-md-2">
<ul class="footer_links applications">
<li><a href="https://www.rippletrade.com">Ripple Trade</a>
</li><li><a href="https://www.ripplecharts.com">Ripple Charts</a>
</li><li><a href="https://ripple.com/graph">Ripple Graph</a>
</li><li><a href="http://codius.org/">Codius</a>
</li></ul>
</div>
<div class="col-md-2">
<ul class="footer_links middleware">
<li><a href="gatewayd.html">Gatewayd</a>
</li><li><a href="ripple-rest.html">Ripple REST</a>
</li><li><a href="https://github.com/ripple/ripple-lib">Ripple Lib</a>
</li></ul>
</div>
<div class="col-md-2">
<ul class="footer_links core_network">
<li><a href="rippled-apis.html">rippled</a>
<li><a href="transactions.html">Transactions</a>
<li><a href="consensus-whitepaper.html">Consensus</a>
</li></ul>
</div>
<div class="col-md-2">
<ul class="footer_links bounties">
<li><a href="https://www.bountysource.com/teams/ripple/bounties">Bounties</a>
</li><li><a href="https://ripplelabs.atlassian.net/">Bug tracking</a>
</li><li><a href="guidelines.html">Brand guidelines</a>
</li><li><a href="https://ripple.com/dev/blog/">Dev blog</a>
</li><li><a href="https://ripple.com/forum/viewforum.php?f=2&amp;sid=c016bc6b934120b7117c0e136e74de98">Forums</a>
</li><li><a href="https://ripple.com/wiki/Main_Page">Wiki</a>
</li></ul>
</div>
<div class="col-md-4 mail_chimp">
<p>Join the mailing list!</p>
<label for="mce-EMAIL">Email address</label>
<!-- Begin MailChimp Signup Form -->
<link href="//cdn-images.mailchimp.com/embedcode/slim-081711.css" rel="stylesheet" type="text/css">
<style type="text/css">
#mc_embed_signup{clear:left; font:14px; }
</style>
<div id="mc_embed_signup">
<form action="//ripple.us4.list-manage.com/subscribe/post?u=245dbc1c47849f034390dc5bf&amp;id=4dfbe160d0" method="post" id="mc-embedded-subscribe-form" name="mc-embedded-subscribe-form" class="validate" target="_blank" novalidate="">
<input type="email" value="" name="EMAIL" class="email" id="mce-EMAIL" placeholder="" required="">
<!-- real people should not fill this in and expect good things - do not remove this or risk form bot signups-->
<div style="position: absolute; left: -5000px; top: -50px;"><input type="text" name="b_245dbc1c47849f034390dc5bf_4dfbe160d0" tabindex="-1" value=""></div>
<input type="submit" value="Submit" name="subscribe" id="mc-embedded-subscribe" class="button btn btn-primary">
</form>
</div>
<!--End mc_embed_signup-->
</div>
</div>
</div>
</div>
</body></html>
Reference in New Issue View Git Blame Copy Permalink