Ripple ledger extractor
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
grapple docstring updates, version 0.2.2 Sep 2, 2014
test py2.6 unittest compatibility Sep 2, 2014
.travis.yml coveralls requirement Sep 2, 2014
README.rst Update README.rst Jan 23, 2015
requirements.txt updated requirements Oct 28, 2014
test_requirements.txt coveralls requirement Sep 2, 2014



Grapple extracts the full Ripple ledger directly from rippled via websocket. It queries rippled for the current ledger index, then walks backwards until it reaches the genesis ledger, recording every transaction it finds.

Data can be collected from a local or a remote rippled instance. If you have a local rippled instance running that has downloaded all or most of the ledger, I strongly recommend doing local data collection. Fetching data from Ripple's public websocket is very slow!

Grapple also resamples each currency pair's price time series to create "Open-Hi-Lo-Close" time series. These resampled datasets can be useful for statistical tests, technical market analysis, or simply for drawing charts.


Bitcoin: 1NUqhGjJEedXxUSxJThfDAHzF2mFosk3fo
Ripple: ~tinybike (rLvcQ6ctvr12aQq29AcZT6JMWH7iZ8esHS)


The easiest way to install Grapple is using pip:

pip install grapple

Grapple is designed to integrate with PostgreSQL, using connection information in By default, it assumes that your database is located on localhost (, and that your database's name, password, username and are all "grapple".

(While this is certainly not a secure setup, it may be convenient for people who install Grapple via pip, and do not wish to edit its source code.)


Grapple can be used as a Python module:

from grapple import Grapple

grapple = Grapple()

The Grapple constructor accepts the following keyword arguments:

socket_url (str):
rippled websocket URL (default="ws://")
full (bool):
True if downloading the full ledger (starting from the current ledger and walking back to the genesis ledger). False if the download should stop at the last current ledger (i.e., the last time grapple was run). (default=True)
genesis (int):
Genesis block index and download halting point. (default=152370)
quiet (bool):
If True, suppress console output. (default=True)
resampling_frequencies (tuple):
Resampling frequencies, using pandas frequency codes. If None, then resampling is disabled. (default=('D',) or daily)

It can also be run as a script:

python [-flags]

Optional flags:

-w, --websocket [websocket url]:
    Specify the rippled websocket url. (default=ws://

-p, --public:
    Use Ripple Labs' public websocket, wss://

-f, --full:
    Download the full Ripple ledger.  Automatic on your first run.

-g, --genesis [ledger index]:
    Genesis ledger index and download halting point.

-q, --quiet:
    Suppress command line output.


Unit tests are in the test/ directory. Coverage is limited at the moment, but slowly improving!

Note: tests that require a local rippled and/or Postgres database connection are disabled by default. See test/ for details.