#An API wrapper for Poloniex.com written in Python #####poloniex.py - Tested on Python 2.7.6 & 3.4.3 Inspired by this wrapper written by 'oipminer' ##UPDATE!

If you have been using an older version of python-poloniex wrapper you may need to generate new api keys. This is because (once again) the nonce has been 'optimized' (even more)! This is the last time, I swear...

###Features:

• ApiKey and Secret are optional if used for just public commands.
• Api Commands have been 'mapped' into methods for your conveniance.
• The poloniex.Poloniex() object has an optional 'timeout' attribute/arg that adjusts the number of seconds to wait for a response from polo (default = 3 sec)
• Optional api 'coach' can restrict the amount of calls per sec, keeping your api calls (that aren't threaded) under the limit (6 calls per sec). Activate the coach using poloniex.Poloniex(coach=True) when creating the polo object or by defining polo._coaching = True.
• We now build apon our last 'nonce' instead of generating a new one everytime a private command is called! Nonces are now incemented by 1.
• Raises ValueError if the command supplied does not exist or if the api keys are not defined

##Install:

git clone https://github.com/s4w3d0ff/python-poloniex.git
cd python-poloniex

# Python 2
sudo python setup.py install
# Python 3
sudo python3 setup.py install

##Uninstall:

# Python 2
sudo pip uninstall poloniex
# Python 3
sudo pip3 uninstall poloniex

##Update:

## Uninstall old ##
# Python 2
sudo pip uninstall poloniex
# Python 3
sudo pip3 uninstall poloniex

## Pull updates into cloned repo ##
cd python-poloniex
git pull

## Install update ##
# Python 2
sudo python setup.py install
# Python 3
sudo python3 setup.py install

##Useage:

Basic Public Setup (no ApiKey/Secret):

import poloniex
polo = poloniex.Poloniex()
polo.timeout = 2

Get Ticker

ticker = polo.api('returnTicker')
print(ticker['BTC_CGA'])
# or
ticker = polo.marketTicker()
print(ticker['BTC_CGA'])

Get Market Loan Orders

BTCloanOrders = polo.api('returnLoanOrders',{'currency':'BTC'})
print(BTCloanOrders)
# or 
BTCloanOrders = polo.marketLoans('BTC')
print(BTCloanOrders)

Basic Private Setup (ApiKey/Secret required):

import poloniex

polo = poloniex.Poloniex('your-Api-Key-Here-xxxx','yourSecretKeyHere123456789', timeout=1)
# or
polo.APIKey = 'your-Api-Key-Here-xxxx'
polo.Secret = 'yourSecretKeyHere123456789'

Get all your balances

balance = polo.api('returnBalances')
print("I have %s CGA!" % balance['CGA'])
# or
balance = polo.myBalances()
print("I have %s BTC!" % balance['BTC'])

Make new CGA deposit address

print(polo.api('generateNewAddress',{'currency':'CGA'}))
# or
print(polo.generateNewAddress('CGA'))

Sell 10 CGA for 0.003 BTC

print(polo.api('sell', {'currencyPair': 'BTC_CGA', 'rate': '0.003' , 'amount': '10' }))
# or
print(polo.sell('BTC_CGA', '0.003', '10'))

Examples of WAMP applications using the websocket push API can be found here.

You like?!

CGA: aZ1yHGx4nA64aWMDNQKXJrojso7gfQ1J5P
BTC: 15D8VaZco22GTLVrFMAehXyif6EGf8GMYV
LTC: LakbntAYrwpVSnLWj1fCLttVzpiDXDa5JV
DOGE: DAQjkQNbhpUoQw7KHAGkDYZ3yySKi751dd