API connector to CYBEX exchange, the first realtime order matching decentralized exchange
Project description
CYBEX ROME API Library
The CYBEX ROME(Realtime Order Matching Engine) API library is designed to connect and trade on the exchange efficiently. Since Cybex is based on a decentralized blocchain, instead of logging in a session with passwords, all the API endpoints are public, but one would need his/her very own private key to sign a request for authentication.
Here we utilized a library coincurve with high performance C extension secp256k1 to accelerate the signing process, approximately 5ms for one signature. This API library is inspired by CCXT, an extendable, easy to use, exchange connection library.
We will try to get listed in CCXT in the coming future.
Installation
pip install romeapi
NOTE:
- python>=3.5 is required as python 2.x does not support bytes type, which is essential for signature generation.
- if both python 2.x and python 3.x exist, and python 3.x virtual env is not activated, then use
pip3 install romeapi
Demo Application
A demo application is available for quick start on how to use the CYBEX ROME API library.
API Methods
Please note the order type notation of Cybex ROME.
ID | Status | Type* | Details |
---|---|---|---|
1 | PENDING_NEW | open | New valid order, confirmed by ROME but not yet confirmed on chain. |
2 | OPEN | open | Open order, confirmed on chain. Status may change to either CANCELED or FILLED. |
3 | PENDING_CXL | open | Cancel order confirmed by ROME, not yet confirmed on chain. |
4 | CANCELED | closed | Order cancelled by user or expired, confirmed on chain. |
5 | FILLED | closed | Order fully filled. Filled order cannot be canceled. |
6 | REJECTED | closed | Order rejected by ROME if not valid. Order rejected by ROME will not go to chain. |
Order type is the category for function call get_open_orders and get_closed_orders.
Construct Cybex(account, password) (Recommended)
Construct a Cybex object with your account name and password.
from romeapi import Cybex
# init with accountName and password
cybex = Cybex(accountName="sample_user", password="sample_password")
# market data
cybex.load_markets()
# ticker
cybex.fetch_ticker("ETH/USDT")
# check account balance
cybex.fetch_balance()
# query with transcation id
# create a market buy order
order_transaction_id, result = cybex.create_market_buy_order("ETH/USDT", 0.1)
orders = cybex.fetch_order(order_transaction_id)
# cancel order
cancel_order = cybex.cancel_order(order_transaction_id)
Construct Cybex(account, private_key) (Optional)
Optionally, you can construct a Cybex object with your account name and private key NOTE that the private key is not your logon password on the CYBEX exchange. To find your private key, refer to demo application.
cybex = Cybex(accountName="sample_user", key="private_key")
If you know your account id, you can optionally provide it to speed up the initialization, e.g.
cybex = Cybex(accountName="sample_user", password="sample_password", account="1.2.00000")
# or
# cybex = Cybex(accountName="sample_user", key="private_key", account="1.2.00000")
fetch_markets
Fetch the list of all available markets from an exchange and returns an array of markets (objects with properties such as asset_pair, base, quote etc.). Some exchanges do not have means to obtain a list of markets via their online API. For those, the list of markets is hardcoded.
load_markets ([reload]):
Return the list of markets as an object indexed by asset_pair and caches it with the exchange instance. Return the cached markets if loaded already, unless the reload = true flag is forced.
fetch_order_book(asset_pair[, limit = undefined[, params = {}]]):
Fetch the order book for a particular market trading asset pair.
fetch_trades(asset_pair[, [limit, [params]]]):
Fetch the recent trades for a particular trading asset pair.
fetch_balance():
Fetch the user account balance.
create_order(asset_pair, type, side, amount[, price[, params]])
Create a limit order with given params
create_limit_buy_order(asset_pair, amount, price[, params])
Create a new limit buy order
create_limit_sell_order(asset_pair, amount, price[, params])
Create a new limit sell order
create_market_buy_order(asset_pair, amount[, params])
As the CYBEX exchange does not support market order, this function creates a new limit buy order with the best price
create_market_sell_order(asset_pair, amount[, params])
As the CYBEX exchange does not support market order, this function creates a new limit sell order with the best price
cancel_order(id[, params])
Cancel an order with a given transaction id
fetch_order(id[, asset_pair[, params]])
Fetch an order's detail with a given transaction id
fetch_orders([asset_pair[, since[, limit[, params]]]])
Fetch orders with a given asset pair
fetch_open_orders([asset_pair[, since, limit, params]]]])
Fetch user's open orders with a given asset pair
fetch_closed_orders([asset_pair[, since[, limit[, params]]]])
Fetch user's closed orders with a given asset pair
fetch_my_trades([asset_pair[, since[, limit[, params]]]])
Fetch user's trade history
fetch_best_price([asset_pair[, params]])
Fetch current best bid and ask prices for a given asset pair
fetch_ohlcv(self, asset_pair, interval='1m', limit=5, useTradePrice='true')
Fetch kline data for a given asset pair.
Parameter | Description |
---|---|
interval | The possible values are 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. The default value is 1m. |
useTradePrice | The default value is true, and this api returns our exchange's prices. If it is specified as false then this api returns market prices. |
fetch_klines(self, asset_pair, interval='1m', limit=5, useTradePrice='true')
Alias to fetch_ohlcv
FAQ
Why should we use this library?
The CYBEX ROME API library provides convenient access to the CYBEX ROME (Realtime Order Matching Engine) directly through the API server. High frequency trading or market making is thus made possible on our decentralized exchange. This API library utilizes coincurve to improve performance, so that it is efficient, cross platform, responsive, and easy to use.
Are the API endpoints connected to the CYBEX witness nodes/full nodes?
No, the API server is connected to the ROME (Realtime Order Matching Engine). Our previous library PyCybex is connected to full nodes.
What is the difference of this library from PyCybex?
PyCybex is forked from the bitshares python library, so that requests are executed mainly on full nodes. It takes at least one block time to confirm order.
Visit PyCybex's site to find more details.
Can I choose to use PyCybex instead?
Yes, you can. But you might find it less efficient.
Visit PyCybex's site to find out more details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for romeapi-0.1.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fdb62e068d9519b025111c500a15607934759e0d72cc13f344a6c53d411db7d3 |
|
MD5 | 9e63f87cf05eb8051735efe2e1eadc84 |
|
BLAKE2b-256 | 1a30c2bbccd861e68473b0f7a3272fdc52b7c52c1c905baef23f7d01b081c60a |