edennis / krakex

Elixir client for the Kraken Bitcoin Exchange API

Krakex

Elixir client for the Kraken Bitcoin Exchange API

Note that this README refers to the master branch of Krakex, not the latest released version on Hex. See the documentation for the documentation of the version you're using.

Installation

The package can be installed by adding krakex to your list of dependencies in mix.exs:

def deps do
  [
    {:krakex, "~> 0.7.0"}
  ]
end

Configuration

The Kraken API consists of public and private calls. While you can use the public API as you like, you'll need to create an account and get yourself an API key if you want to do more. To use the private API you'll need to add some configuration to your Mix config:

config :krakex,
  api_key: System.get_env("KRAKEN_API_KEY"),
  private_key: System.get_env("KRAKEN_PRIVATE_KEY")

Usage

The entire functionality of the API can be accessed via the Krakex module. To get started just configure your API credentials as described above and call the functions:

iex(1)> Krakex.balance()
{:ok,
 %{"BCH" => "0.0000000000", "XETH" => "0.0000000000", "ZEUR" => "50.00"}}

If you need to use multiple Kraken accounts in your application this can be achieved by explicitly defining Krakex.Client structs and passing them as the first argument to any of the functions defined in the Krakex module:

client1 = Krakex.Client.new("api_key1", "secret1")
client2 = Krakex.Client.new("api_key2", "secret2")

balance1 = client1 |> Krakex.trade_balance(asset: "ZUSD")
balance2 = client2 |> Krakex.trade_balance(asset: "EUR")

TODO - Help wanted!

Private user data

• add_export/3
• export_status/2
• retrieve_export/2
• remove_export/3

Private user trading

• cancel_all/1
• cancel_all_orders_after/2

Private user funding calls

• withdraw/5
• withdraw_status/3
• withdraw_cancel/4
• wallet_transfer/4

Contributing

1. Fork it (https://github.com/edennis/krakex/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2018 Erick Dennis

krakex's Issues

Conditional Closes on Limit Order

Hi,

I'm trying to figure out how to add a conditional close to a limit order, specifically a take profit condition. On a standard limit order you would write something like:

Krakex.add_order(pair, "buy", "limit", lot_size, [price: buy_price])

After looking through the Krakex docs and the Kraken API I see another order type called take-profit-limit. I've tried this as well in the following fashion:

Krakex.add_order(pair, "buy", "take-profit-limit", lot_size, [price: sell_price, price2: buy_price])

But I seem to get back an error of: EGeneral:Invalid arguments:ordertype

If you could give me a hand figuring out where I'm misapplying this it would be greatly appreciated.

Change AddOrder signature

In order to avoid float imprecision, AddOrder should use string instead of float for volume and price data.