Command-line Kraken Crypto API wrapper written in Dart. Inspired by the Python clikraken project.
This is my first Dart project, used to learn the language. Keep that in mind! :-D
- https://github.com/zertrin/clikraken - primary inspiration
- https://github.com/veox/python3-krakenex - used by clikraken
- https://github.com/Dimibe/kraken_api - additional inspiration
- https://pub.dev/packages/cli_util - for config folder lookup
- https://pub.dev/packages/ansi - for log output coloring
The primary reason I created this project was to have a "Kraken API syntax"-like "DSL". Some examples for this first. Then some more boring details in below sections.
Show open orders, expanding the "descr" column, then pick only status, margin, leverage and order columns:
$ krok open -d expand -c status,_leverage,_order
| status | _leverage | _order |
-----------------------------------------------------------------------------------
| open | 3:1 | sell 3.00000000 BCHUSD @ trailing stop +3.3000% |
| open | 5:1 | sell 1000.00000000 XRPUSD @ trailing stop +5.0000% |
Place limit buy order using Kraken API syntax, expiring in 10 minutes from now:
$ krok buy '150.00000000 CFGUSD @ limit 0.7' --expire 10m
ORDER0-TXID0-HERE00
Or a take profit limit order, expiring in 8 hours:
$ krok sell "150.0 CFGUSD @ take profit 1.0 -> limit 0.9" --expire 8h
ORDER0-TXID0-HERE00
Cancel all open orders:
$ krok cancel all
For now, the clikraken key file is used. This has to be available at <confighome>/clikraken/kraken.key and contain the
public and private Kraken API keys in two lines. You can use the -k (--keyfile) option to specify a different
location.
Use $ krok -h to see the available command line options. Besides -k for the keyfile path and -l to
change the log level, there is a semi-working -c option to auto-cache results from the public Kraken API endpoints.
Auto-caching is always on for now. But applies only to public, parameterless API calls. This probably needs to be
revisited.
Besides these options, everything else is driven by 'commands'. Please use -h after a command to get more information.
Some basic usage examples implemented so far:
$ krok ap -c cost_decimals,ordermin,status | grep USD
| pair | cost_decimals | ordermin | status |
------------------------------------------------------
| 1INCHEUR | 5 | 11 | online |
| 1INCHUSD | 5 | 11 | online |
| AAVEETH | 10 | 0.05 | online |
| AAVEEUR | 5 | 0.05 | online |
| AAVEGBP | 5 | 0.05 | online |
| AAVEUSD | 5 | 0.05 | online |
...$ krok a
| pair | aclass | altname | decimals | display_decimals | status | collateral_value |
-----------------------------------------------------------------------------------------------
| 1INCH | currency | 1INCH | 10 | 5 | enabled | null |
| AAVE | currency | AAVE | 10 | 5 | enabled | null |
| ACA | currency | ACA | 10 | 5 | enabled | null |
| ACH | currency | ACH | 10 | 5 | enabled | null |
| ADA | currency | ADA | 8 | 6 | enabled | 0.9 |
...$ krok t | head
| pair | a | b | c | v | p | t | l | h | o |
------------------------------------------------------------------------------------------------------------------------------------------------------------------
| 1INCHEUR | 0.52700 | 0.52600 | 0.52900 | 73.85599325 | 0.52860 | 4 | 0.52600 | 0.52900 | 0.52600 |
| 1INCHUSD | 0.57000 | 0.56900 | 0.57200 | 22902.59597987 | 0.56893 | 28 | 0.56600 | 0.57300 | 0.56600 |
| AAVEETH | 0.03620 | 0.03610 | 0.03630 | 13.84197784 | 0.03655 | 21 | 0.03610 | 0.03670 | 0.03610 |
| AAVEEUR | 115.90000 | 115.83000 | 116.00000 | 67.95210235 | 116.29878 | 53 | 115.00000 | 117.42000 | 115.33000 |
| AAVEGBP | 99.46000 | 99.38000 | 99.94000 | 3.44096121 | 99.99908 | 12 | 98.75000 | 100.70000 | 98.75000 |
| AAVEUSD | 125.40000 | 125.39000 | 125.46000 | 1752.80161737 | 125.40680 | 649 | 123.97000 | 127.14000 | 124.85000 |
...Note: By default only the first values of columns containing 'lists' are shown. The --full option will show
everything.
The command is openorders with aliases oo or open:
$ krok oo -c descr -d order
| txid | _order |
------------------------------------------------------------------------------------------
| OZOSD7-7YEGF-ZDOVUX | sell 1892.64687153 TVKUSD @ take profit 0.41646 -> limit 0.40177 |
...
Note: -c descr will hide all columns except the 'descr' column. But -d order transforms the 'descr' column by
removing all parts except the order.
At the time of this writing, these commands are available:
assetpairs Retrieve asset pairs. Alias: [ap]
assets Retrieve asset information. Alias: [a]
balance Retrieve account balance data. Alias: [b]
cancelallorders Cancel all orders. Alias: [ca, cao, cancelall]
cancelorder Cancel order via txid. Alias: [c, cancel]
closedorders Retrieve closed orders. Alias: [co, closed]
limitorder Add basic limit order. Alias: [lo, limit]
marketorder Add basic market order. Alias: [mo, market]
ohlc Retrieve ohlc data. Alias: [o]
openorders Retrieve open orders. Alias: [oo, open]
queryorders Retrieve order data via txid. Alias: [q, qo, query]
spread Retrieve spread data. Alias: [sp]
status Retrieve Kraken system status. Alias: [s]
ticker Retrieve ticker data. Alias: [t]
tradebalance Retrieve trade balance data. Alias: [tb, tbal]
tradevolume Retrieve trade volume data. Alias: [tv, tvol]
Run "krok help " for more information about a command.
Because adding the order and cancel commands shown above felt weird, I decided to provide three "DSL style" commands:
buy, sell and cancel.
These allow "clear text" commands like these:
cancel SOME-ORDER-TXID
cancel SOME-ORDER-TXID,MORE-ORDER-TXIDS...
cancel all
krok sell "8.0 CFGUSD @ take profit 1.0 -> limit 1.0"
krok buy "8.0 CFGUSD @ take profit 1.0 -> limit 1.0" --expire 10s
This feels like the right approach. I'll probably remove the "options-based" commands at some point.
Please see bin/example.dart for a first impression. Then continue by looking at the lib/cli/command/ files for more
details.
Note that at least for now, this is meant to be used as a command line app primarily.
I have no idea.
Yes, I guess. But it is probably aligned with my use cases too much to be generally useful.
As I said, to learn Dart.
My actual goal is to get a little bit into Flutter to understand if this will work for me.
I've been an Android developer for a very long time. And switching from Kotlin to Dart is really hard. Not that Dart is too difficult to learn. But coming from Kotlin, you realize how awkward and overly complex Dart feels. But I'm new to it. Maybe some 'Aha!' moments await. We'll see.
Anyway, doesn't hurt to learn something new now and then, does it? And there is the Flutter Flame game engine I want to take a look at. So there's that...
This being said, I probably won't invest too much time into this project.
Update after a few days:
Had some minor 'Aha!' moments. Still like Kotlin at lot better! 😂
But Dart is actually OK. Will continue some more with this… 🙃
Some random TODOs. There are a lot more TODOs, actually. But haven't bothered writing it all down for now… 🙈
-
TODO add key file option to pass keys instead of reading from file
-
TODO how to handle price/volume decimals?
-
TODO use a wrapper around the asset info to create prices?
-
TODO what about volume?
-
TODO batch order
-
TODO add userref support
-
TODO consider existing log solutions