30 releases

0.5.12 Oct 3, 2018
0.5.10 Mar 25, 2018
0.5.9 Jan 8, 2018
0.5.8 Dec 28, 2017
0.1.8 Mar 10, 2017

#13 in Cryptocurrencies

Download history 36/week @ 2019-04-19 5/week @ 2019-04-26 4/week @ 2019-05-03 72/week @ 2019-05-10 67/week @ 2019-05-17 61/week @ 2019-05-24 33/week @ 2019-05-31 147/week @ 2019-06-07 1/week @ 2019-06-14 176/week @ 2019-06-21 90/week @ 2019-06-28 149/week @ 2019-07-05 121/week @ 2019-07-12 31/week @ 2019-07-19 28/week @ 2019-07-26

166 downloads per month

MIT license

280KB
5K SLoC

Coinnect

crates.io Downloads from crates.io Build Status doc.rs MIT licensed

Coinnect is a Rust library aiming to provide a complete access to REST APIs for various crypto-currencies exchanges (see below for a list of supported exchanges). All methods consume HTTPS api. The purpose of this crate is not to stream data (you should use websocket/FIX in that case).

You basically have 2 choices to retrieve data : use the raw API provided by the platform you target or use the generic Coinnect API, which is more user-friendly and safe. Ideally, use the raw API when the Coinnect API could not retrieve the data/perform the action you want.

WARNING: This library is highly experimental at the moment. Please do not invest what you can't afford to lose. This is a personal project, I cannot be held responsible for the library malfunction, which can lead to a loss of money.

The project is licensed under the terms of the MIT License.

Exchanges support:

Exchange Raw API supported Generic API supported Note
Bitstamp X X Not every method is implemented for now.
Kraken X X -
Poloniex X X -
Bittrex X X -

If your favorite exchange is not listed above, you can vote here to add it in the next release of Coinnect.

Generic API supports:

  • Ticker
  • Orderbook
  • Balances
  • Add a new order
  • ... more to come!

Feel free to make a PR to add support to your favorite exchange ;)

Documentation

Usage

Add this to your Cargo.toml:

[dependencies]
coinnect = "0.5"

and this to your crate root:

extern crate coinnect;

For optional parameters, most methods require an empty str ("") or Option (None) if you don't want to specify them.

Since 0.2, you have access to a generic API to communicate across exchanges in the same way. Note that this functionality is under active development. For more informations, look at ExchangeApi trait doc.

Example

The example below shows you how to connect to Poloniex

extern crate coinnect;

use coinnect::poloniex::api::PoloniexApi;
use coinnect::poloniex::credentials::PoloniexCreds;

fn main() {
    // We create a PoloniexApi by providing API key/secret
    // You can give an empty str if you only use public methods
    let creds = PoloniexCreds::new("my_optionnal_name", "api_key", "api_secret");
    let mut my_api = PoloniexApi::new(creds).unwrap();

    // Let's look at the ticker!
    let list_coins = my_api.return_ticker().unwrap();

    for coin in list_coins {
        // please visit Poloniex API documentation to know how the data is returned
        // or look at the coinnect documentation
        let name = coin.0;
        let price = coin.1.as_object().unwrap().get("last").unwrap().as_str().unwrap();

        println!("Coin {} has price : {}", name, price);
    }
}

For more examples, please see examples.

Testing

You can run the tests suite with cargo test for testing non private data requests (this will ignore tests related to private requests). You can use cargo test --features "bitstamp_private_tests" to run private tests related to bitstamp exchange for example. Before running private tests, make sure you have a keys_real.json file at the root with the following structure :

{
    "account_kraken": {
        "api_key"   : "123456789ABCDEF",
        "api_secret": "ABC&EF?abcdef"
    },
    "account_poloniex": {
        "api_key"   : "XYXY-XYXY-XYXY-XY",
        "api_secret": "A0A0B1B1C2C2"
    },
    "account_bitstamp": {
        "api_key"    : "XYXY-XYXY-XYXY-XY",
        "api_secret" : "A0A0B1B1C2C2",
        "customer_id": "123456"
    }
}

You must insert your real API keys, otherwise private tests may fail. No action is performed if you run the tests : no test will open position, or withdraw, etc. Tests only check for correct authentication method and correct parsing. You can examine the tests folder just to be sure and look at the Cargo.toml file for a complete list of features.

Contribution

Your contribution is highly appreciated. Do not hesitate to open an issue or a pull request. Note that any contribution submitted for inclusion in the project will be licensed according to the terms given in LICENSE.

Disclaimer

This SOFTWARE PRODUCT is provided by THE PROVIDER "as is" and "with all faults." THE PROVIDER makes no representations or warranties of any kind concerning the safety, suitability, lack of viruses, inaccuracies, typographical errors, or other harmful components of this SOFTWARE PRODUCT. There are inherent dangers in the use of any software, and you are solely responsible for determining whether this SOFTWARE PRODUCT is compatible with your equipment and other software installed on your equipment. You are also solely responsible for the protection of your equipment and backup of your data, and THE PROVIDER will not be liable for any damages you may suffer in connection with using, modifying, or distributing this SOFTWARE PRODUCT.

Dependencies

~4.5–6MB
~119K SLoC