Metadata-Version: 1.1
Name: pyfinex
Version: 1.0.1
Summary: Python wrapper for Bitfinex API v1 and v2
Home-page: https://github.com/faberquisque/pyfinex
Author: faberquisque
Author-email: faberquisque@hotmail.com
License: UNKNOWN
Description: pyfinex
        ======
        Python wrapper for Bitfinex API.
        
        Dependencies
        ======
        Requests library is required.
        
        Usage
        ======
        
        Include the pyfinex module and use it as a toolbox. For trading, a key and a secret key must be provided.
        
        	import pyfinex
        
            API_KEY = 'insert key'
            API_SECRET = 'insert secret'
        
        	resp = pyfinex.v1.positions.active(key=API_KEY, secret_key=API_SECRET)
            resp = pyfinex.v1.public.ticker(symbol='btcusd')
        
        Function names are organized for better coding
        
        **Function names are referred in part to the api doc's html, which you can see [Bitfinex API web page](http://docs.bitfinex.com/).**
        **Required params to build the request's url are coded in the function's args, other query params are to be added acording to api doc**
        
        **BEWARE: some inputs varies from v1 to v2. Example: v1>> 'BTCUSD' v2>> 'tBTCUSD'**
        
        All documented API calls are implemented!
        
        Examples
        ======
        
        ### Get the latest BTCUSD price
        	resp = pyfinex.v1.public.ticker(symbol='btcusd')
        ### View your active orders
            resp = pyfinex.v1.positions.active(API_KEY,API_SECRET)
        ### Get the BTCUSD order book
            resp = pyfinex.v1.public.order_book(symbol='btcusd')
        ### Get the last BTCUSD 1m candle 
            resp = pyfinex.v2.public.candles(Symbol='tBTCUSD', TimeFrame='1m', Section='last')
        ### Submit a new order
        For example, if you'd like to buy 0.001 BTC as 0.01 BTC/USD, you need to specify the parameters acording to the api doc. You may parse the response to get the order id for future use.
        
        	resp = pyfinex.v1.orders.new(symbol="BTCUSD", amount=0.001, price=0.01, side='buy', type='market')
        
        ### In case there is a new call you can do it yourself!:
            pyfinex.api.request(authenticate=True, 
                key=API_KEY, 
                secret_key=API_SECRET, 
                version=1, 
                endpoint='new/api/call/here', 
                method='POST', 
                body_params={}, 
                query_params={})
        
        Known Issues
        ======
        - Authenticated post requests to v2 are still buggy, presumably server-side
        
        TODO
        =====
        - Debug v2 auth posts!
        
        
        ## Contributing
        
        1. Create an issue and discuss.
        1. Fork it.
        1. Create a feature branch containing only your fix or feature.
        1. Add tests, please!!
        1. Create a pull request.
        1. Thanks!
        
        ## References
        - [https://github.com/scottjbarr/bitfinex](https://github.com/scottjbarr/bitfinex)
        - [https://github.com/jimako1989/bitfinexpy](https://github.com/jimako1989/bitfinexpy)
        - [Bitfinex official API wrapper for Ruby](https://github.com/bitfinexcom/bitfinex-api-rb)
        - [Bitfinex v1 API doc](https://bitfinex.readme.io/v1/docs)
        - [Bitfinex v2 API doc](https://bitfinex.readme.io/v2/docs)
        ## Licence
        
        The MIT License (MIT)
        
        Copyright (c) 2018 faberquisque
        
        See [LICENSE.md](LICENSE.md)
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
