Public API Overview
The HTTP API allows read access to public market data through the public endpoint -
Public HTTP Endpoint: https://xeniosmarkets.com/api/public
xeniosmarkets provides HTTP APIs for interacting with the exchange only for public market data:
xeniosmarkets provides HTTP API endpoints specific to Coinmarketcap as defined in the relevant quidelines for better integration support:
Public API Implementation
returnTicker
Retrieves summary information for each currency/coin pair listed on the exchange.
Ticker Endpoint:https://xeniosmarkets.com/api/public?command=returnTicker
| Field | Description |
| last | Execution price for the most recent trade for this pair. |
| change | Price change percentage. |
| high24hr | The highest execution price for this pair within thec last 24 hours. |
| low24hr | The lowest execution price for this pair within the last 24 hours. |
| baseVolume | Base units traded in the last 24 hours. |
| tradeVolume | trade units traded in the last 24 hours. |
Example:
{ "BTC_USD": { "last": "8180.000000000", "low24hr": "8183.00000000", "high24hr": "10369.00000000", "change": "5.99", "tradeVolume": "614.24470018", "baseVolume": "5694762.62500284" }, "DOGE_BTC": { "last": "0.000000200", "low24hr": "0.000000190", "high24hr": "0.000000210", "change": "10.58", "tradeVolume": "1614.24470018", "baseVolume": "4694762.62500284" } }
Retrieving summary information for a specified currency/coin pair listed on the exchange -
| Request Parameter | Description |
| tradePair | A pair like BTC_USD |
Ticker Endpoint: https://xeniosmarkets.com/api/public?command=returnTicker&tradePair=XNC_EURX
Example:
{ "last": "8180.000000000", "low24hr": "8183.00000000", "high24hr": "10369.00000000", "change": "5.99", "tradeVolume": "614.24470018", "baseVolume": "5694762.62500284" }
returnOrderBook
Retrieves the latest 50 order book of each order type information for a specified currency/coin pair listed on the exchange
Order book Endpoint: https://xeniosmarkets.com/api/public?command=returnTicker&tradePair=XNC_EURX
Input Fields:
| tradePair | A pair like BTC_ETH |
Out Fields:
| Field | Description |
| asks | An array of price aggregated offers in the book ordered from low to high price. |
| bids | An array of price aggregated bids in the book ordered from high to low price. |
Example:
{ "asks": [ { "price": "0.09000000", "amount": "500.00000000", "total": "45.00000000" }, { "price": "0.11000000", "amount": "700.00000000", "total": "77.00000000" } ... ], "bids": [ { "price": "0.10000000", "amount": "700.00000000", "total": "70.00000000" }, { "price": "0.09000000", "amount": "500.00000000", "total": "45.00000000" } ... ] }
returnTradeHistory
Returns the past 100 trades for a given market, You may set a range specified in UNIX timestamps by the “start” and “end” GET parameters.
Trade History Endpoint: https://xeniosmarkets.com/api/public?command=returnTradeHistory&tradePair=XNC_EURX
Trade History Endpoint: https://xeniosmarkets.com/api/public?command=returnTradeHistory&tradePair=XNC_EURX&start=1640631221&end=1640687221
Input Fields:
| Request Parameter | Description |
| tradePair | A pair like BTC_ETH |
| start (optional) | The start of the window in seconds since the unix epoch. |
| end (optional) | The end of the window in seconds since the unix epoch. |
Out Fields:
| Field | Description |
| date | The UTC date and time of the trade execution. |
| type | Designates this trade as a buy or a sell from the side of the taker. |
| price | The price in base currency for this asset. |
| amount | The number of units transacted in this trade. |
| total | The total price in base units for this trade. |
Example:
[ { "price": "9860.86031280", "amount": "0.85441089", "total": "8425.22643602", "type": "buy", "date": "2020-06-29 10:03:00" }, { "price": "9862.25325181", "amount": "0.15549235", "total": "1533.50493441", "type": "sell", "date": "2020-06-29 10:02:00" }, ... ]
returnChartData
Returns candlestick chart data. Required GET parameters are tradePair, (candlestick period in seconds; valid values are 300, 900, 1800, 7200, 14400, and 86400), start, and end. Start and end are given in UNIX timestamp format and used to specify the date range for the data returned. Fields include:
Chart Data Endpoint: https://xeniosmarkets.com/api/public?command=returnChartData&tradePair=XNC_EURX&interval=900&start=1640617221&end=1640687221
Input Fields:
| Request Parameter | Description |
| tradePair | The currency pair of the market being requested. |
| interval | Candlestick period/interval in seconds. Valid values are 300, 900, 1800, 7200, 14400, and 86400. |
| start | The start of the window in seconds since the unix epoch. |
| end | The end of the window in seconds since the unix epoch. |
Out Fields:
| Field | Description |
| date | The UTC date for this candle in miliseconds since the Unix epoch. |
| high | The highest price for this asset within this candle. |
| low | The lowest price for this asset within this candle. |
| open | The price for this asset at the start of the candle. |
| close | The price for this asset at the end of the candle. |
| volume | The total amount of this asset transacted within this candle. |
Example:
[ { "date": 1593396900, "low": "10112.27439575", "high": "10115.44996344", "volume": "1.54063724", "open": "10115.44996344", "close": "10112.27439575" }, { "date": 1593397800, "low": "10061.35948383", "high": "10112.27439575", "volume": "6.88096652", "open": "10112.27439575", "close": "10061.35948383" }, ... ]
Public API Coimarketcap Implementation
summary_cmc
The summary endpoint is to provide an overview of market data for all tickers and all market pairs on the exchange.
Summary Coinmarketcap Endpoint: https://xeniosmarkets.com/api/public?command=summary_cmc
| Field | Description |
| trading_pairs | Identifier of a ticker with delimiter to separate base/quote, eg. BTC-USD (Price of BTC is quoted in USD) |
| base_currency | Symbol/currency code of base currency, eg. BTC |
| quote_currency | Symbol/currency code of quote currency, eg. USD |
| last_price | Last transacted price of base currency based on given quote currency |
| lowest_ask | Lowest Ask price of base currency based on given quote currency |
| highest_bid | Highest bid price of base currency based on given quote currency |
| base_volume | 24-hr volume of market pair denoted in BASE currency |
| quote_volume | 24-hr volume of market pair denoted in QUOTE currency |
| price_change_percent_24h | 24-hr % price change of market pair |
| highest_price_24h | Highest price of base currency based on given quote currency in the last 24-hrs |
| lowest_price_24h | Lowest price of base currency based on given quote currency in the last 24-hrs |
Example:
[{"trading_pairs":"BTC_EURX","base_currency":"BTC","quote_currency":"EURX","last_price":"47000.00000000","lowest_ask":"0","highest_bid":"0","base_volume":"0","quote_volume":"0","price_change_percent_24h":"0","highest_price_24h ":"0","lowest_price_24h":"0"},{"trading_pairs":"BTC_USDT.ERC20","base_currency":"BTC","quote_currency":"USDT.ERC20","last_price":"55000.00000000","lowest_ask":"0","highest_bid":"0","base_volume":"0","quote_volume":"0","price_change_percent_24h":"0","highest_price_24h ":"0","lowest_price_24h":"0"},{"trading_pairs":"ETH_EURX","base_currency":"ETH","quote_currency":"EURX","last_price":"1400.00000000","lowest_ask":"0","highest_bid":"0","base_volume":"0","quote_volume":"0","price_change_percent_24h":"0","highest_price_24h ":"0","lowest_price_24h":"0"},{"trading_pairs":"ETH_USDT.ERC20","base_currency":"ETH","quote_currency":"USDT.ERC20","last_price":"1.34000000","lowest_ask":"0","highest_bid":"0","base_volume":"0","quote_volume":"0","price_change_percent_24h":"0","highest_price_24h ":"0","lowest_price_24h":"0"},{"trading_pairs":"EUR_EURX","base_currency":"EUR","quote_currency":"EURX","last_price":"1.00000000","lowest_ask":"0","highest_bid":"0","base_volume":"2228.70585667","quote_volume":"2228.70585667","price_change_percent_24h":"0.00","highest_price_24h":"1.00000000","lowest_price_24h":"1.00000000"},{"trading_pairs":"XNC_BTC","base_currency":"XNC","quote_currency":"BTC","last_price":"0.00001900","lowest_ask":"0","highest_bid":"0","base_volume":"0","quote_volume":"0","price_change_percent_24h":"0","highest_price_24h ":"0","lowest_price_24h":"0"},{"trading_pairs":"XNC_EURX","base_currency":"XNC","quote_currency":"EURX","last_price":"0.90300000","lowest_ask":"0.79500000","highest_bid":"0.90300000","base_volume":"2028.57686043","quote_volume":"2167.54912562","price_change_percent_24h":"-8.32","highest_price_24h":"0.99000000","lowest_price_24h":"0.90300000"}]
ticker_cmc
The ticker endpoint is to provide a 24-hour pricing and volume summary for each market pair available on the exchange.
Ticker Coinmarketcap Encdpoint: https://xeniosmarkets.com/api/public?command=ticker_cmc
| Field | Description |
| last_price | Last transacted price of base currency based on given quote currency |
| base_volume | 24-hour trading volume denoted in BASE currency |
| quote_volume | 24 hour trading volume denoted in QUOTE currency |
| isFrozen | Indicates if the market is currently enabled (0) or disabled (1). |
Example:
{"BTC_EURX":{"last_price":"47000.00000000","base_volume":"0","quote_volume":"0","isFrozen":0},"BTC_USDT.ERC20":{"last_price":"55000.00000000","base_volume":"0","quote_volume":"0","isFrozen":0},"ETH_EURX":{"last_price":"1400.00000000","base_volume":"0","quote_volume":"0","isFrozen":0},"ETH_USDT.ERC20":{"last_price":"1.34000000","base_volume":"0","quote_volume":"0","isFrozen":0},"EUR_EURX":{"last_price":"1.00000000","base_volume":"2228.70585667","quote_volume":"2228.70585667","isFrozen":0},"XNC_BTC":{"last_price":"0.00001900","base_volume":"0","quote_volume":"0","isFrozen":0},"XNC_EURX":{"last_price":"0.89765480","base_volume":"2294.96601030","quote_volume":"2531.00100000","isFrozen":0}}
orderbook_cmc
The order book endpoint is to provide a complete level 2 order book (arranged by best asks/bids) with full depth returned for a given market pair.
Orderbook Coinmarketcap Endpoint: https://xeniosmarkets.com/api/public?command=orderbook_cmc&market_pair=XNC_EURX&depth=10
Input Fields:
| Request Parameter | Description |
| market_pair (Required) |
The currency pair of the market being requested. |
| depth (Optional) |
Orders depth quantity: [0,5,10,20,50,100,500] Not defined or 0 = full order book Depth = 100 means 50 for each bid/ask side. |
Out Fields:
| Field | Description |
| timestamp | Unix timestamp in milliseconds for when the last updated time occurred. |
| bids | An array containing 2 elements. The offer price and quantity for each bid order. |
| asks | An array containing 2 elements. The ask price and quantity for each ask order. |
Example:
{"timestamp":1637516902,"bids":[{"price":"0.88500000","amount":"140.00000000"},{"price":"0.88000000","amount":"200.00000000"},{"price":"0.87500000","amount":"150.00000000"},{"price":"0.87000000","amount":"250.00000000"},{"price":"0.86500000","amount":"350.00000000"}],"asks":[{"price":"0.89000000","amount":"750.00000000"},{"price":"0.90000000","amount":"635.00000000"},{"price":"0.91000000","amount":"8.40000000"},{"price":"0.92000000","amount":"3134.50000000"},{"price":"0.93000000","amount":"10.00000000"}]}
trades_cmc
The trades endpoint is to return data on all recently completed trades for a given market pair.
Trades Coinmarketcap Endpoint: https://xeniosmarkets.com/api/public?command=trades_cmc&market_pair=XNC_EURX
Input Fields:
| Request Parameter | Description |
| market_pair (Required) |
The currency pair of the market being requested. |
Out Fields:
| Field | Description |
| trade_id | A unique ID associated with the trade for the currency pair transaction |
| price | Last transacted price of base currency based on given quote currency |
| base_volume | An array containing 2 elements. The ask price and quantity for each ask order. |
| quote_volume | Transaction amount in QUOTE currency. |
| timestamp | Unix timestamp in milliseconds for when the transaction occurred. |
| type |
Used to determine whether or not the transaction originated as a buy or sell. Buy – Identifies an ask was removed from the order book. Sell – Identifies a bid was removed from the order book. |
Example:
[{"trade_id":"61c1c55a-eeaa-4cd2-8926-4e91e2cc652f","price":"0.84900000","base_volume":"24.65127174","timestamp":1637521321,"type":"sell"},{"trade_id":"6b90eba5-3f04-4125-9ce3-82a31c62399e","price":"0.84900000","base_volume":"24.65127174","timestamp":1637521321,"type":"buy"}]