python-buycoins-sdk 0.0.4

BUYCOINS SDK

Python-buycoin

A python SDK for BuyCoins

Update

New features to be added to SDK includes

1. Type hinting
2. NGNT manager and transactions
3. Extensive tests

Installations

pip install python-buycoins-sdk

Requirements

Python 3.0+

Documentation

You can view the official documentation for the BuyCoins APi can be found here on the BuyCoins developer portal.

Configuration

Create a .env file and set up authentication as follows:

BUYCOIN_PUBLIC_KEY="<BUYCOIN_PUBLIC_KEY>"
BUYCOIN_SECRET_KEY="<BUYCOIN_SECRET_KEY>"

To get public and private key, follow the process set at here

Usage

Most of the library's functionality lies in the managers.py file which contains all the managers required to perform wallet transactions, peer to peer transactions and NGNT transactions.

The Manager classes handle every direct interaction with the BuyCoins API.

Wallet Transactions

This involves direct purchase, sale, transfer orders of cryptocurrencies and creation of cryptocurrencies addresses A sample use-case

from BuyCoin.objects.wallet import Wallet
from BuyCoin.manager import CustomerWalletManager

# Start a  purchase transaction and then assign to manager for initialization
purchase_order = Wallet(operation="buy", cryptocurrency="bitcoin", coin_amount=0.01)
wallet_manager = CustomerWalletManager()
wallet_manager.initialize_transaction(purchase_order)

# To get prices for all cryptocurrencies
print(wallet_manager.get_prices())

# To get prices for a specific cryptocurrency for a side ('buy', 'sell')
print(wallet_manager.get_prices(cryptocurrency="bitcoin", side="buy"))

P2P Transactions

P2P Trading lets you trade cryptocurrencies with other users. If you are not familiar with p2p trading on the Buycoins platform, read about it here
A sample use-case

from BuyCoin.objects.p2p import P2P
from BuyCoin.manager import P2PManager

# To place limit orders 
limit_order = P2P(operation="plo", side="buy", coin_amount=0.01, cryptocurrency="bitcoin",
         price_type="dynamic", dynamic_exchange_rate=3000)

manager = P2PManager()
manager.initialize_transaction(limit_order)

# to post market orders
market_order = P2P(operation="pmo", side="sell", coin_amount=0.01, cryptocurrency="bitcoin")
manager.initialize_transaction(market_order)

# Get market orders

print(manager.get_market_order())

Custom Queries

If by chance, you need to perform queries outside the already provided ones, it can be done by creating an instance of the concerned transaction manager:

from BuyCoin.manager import CustomerWalletManager

query = """
    query {
        <query>
    }
"""

CustomerWalletManager._perform_request(query=query, variables={})
# Variables are arguments to be passed into the query, if none, specify empty bracket