Overview
This API reference is aimed to help integrate XBO exchange into trading data aggregation platforms.
Base URL
The base url is https://api.xbo.com
As per RESTful design patterns, Public API uses following HTTP methods:
GET
- Read resources
When you are making a request, you can pass arguments in it as:
- Parameters
- Valid JSON with
application/json
header.
Timestamps and other time-related fields are in milliseconds.
Parameters for GET
endpoints must be sent as a query string.
Parameters can be sent in any order.
If a parameter is sent in both the query string and request body, the query string parameter will be used.
Return codes
200
Successful Request.
201
Created successfully.
400
Bad Request. Check the format of your request for mistakes and try again.
401
Unauthorized. Check if your API key is eligible for using the endpoint.
500
Server Error. Issue on our side. Contact us for more information.
404
Resource is missing. Contact us for more information.
Authentication
No authentication is required. All the endpoints listed are public.
Spot Trading API Endpoints
API endpoints listed below give access to XBO exchange Spot trading data.
Orderbook
The order book endpoint is used to request a complete level 2 order book, arranged by best asks/bids, for a particular market pair.
HTTP Request
[GET] /orderbook/{symbol}?depth={depth}
Parameters
Name | Type | Required | Description |
---|---|---|---|
symbol |
string |
+ | Market pair for which the orderbook is requested.Format example BTC/USDT |
depth |
number($int32) |
Orders depth quantity. Depth = 100 means 100 for each bid/ask side. Default depth is 50 Max depth is 250. |
Successful Response(BTC/USDT, depth=2)
{
{
"bids": [
[
50010,
0.02
],
[
40020,
0.15
]
],
"asks": [
[
70694.8,
0.0005
],
[
74000,
0.0005
]
],
"timestamp": 1719881818486
}
Response Fields
Name | Type | Description |
---|---|---|
bids |
number($decimal) |
An array containing two elements: the ask price and quantity for each ask order. |
asks |
number($decimal) |
An array containing two elements: the offer price and quantity for each bid order. |
timestamp |
int32 |
Unix UTC timestamp in milliseconds. States when the last updated time has occurred. |
Currencies
Currencies endpoint is used to provide a detailed summary for each currency available on XBO exchange.
HTTP Request
[GET] /currencies
Successful Response
[
{
"code": "ALGO",
"name": "Algorant, Ⱥ",
"type": "Crypto",
"isDepositEnabled": true,
"isWithdrawalEnabled": true,
"minWithdrawalAmount": 25
},
{
"code": "AOA",
"name": "Angolan Kwanza, Kz",
"type": "Fiat",
"isDepositEnabled": false,
"isWithdrawalEnabled": false
},
{
"code": "APE",
"name": "Ape coin, ௐ",
"type": "Crypto",
"isDepositEnabled": true,
"isWithdrawalEnabled": true,
"minWithdrawalAmount": 12
}
]
Response Fields
Name | Type | Description |
---|---|---|
code |
string |
Currency acronym. |
name |
string |
Full currency name. |
type |
string |
Type of currency. Can be Fiat or Crypto. |
isDepositEnabled |
boolean |
Are deposits available for the currency. |
isWithdrawalEnabled |
boolean |
Are deposits available for the currency. |
minWithdrawalAmount |
boolean |
Minimum withdrawal amount of a currency. |
Trading Pairs
Trading pairs endpoint is used to provide a 24-hour pricing and volume summary for each market pair available on XBO exchange.
HTTP Request
[GET] /trading-pairs
Successful Response
[
{
"symbol": "AAVE/EUR",
"description": "AAVE vs Euro",
"baseCurrency": "AAVE",
"quoteCurrency": "EUR",
"lastPrice": 91.5515,
"isEnabled": true,
"last24HTradeVolume": 3674.694
},
{
"symbol": "AAVE/USD",
"description": "AAVE vs US Dollar",
"baseCurrency": "AAVE",
"quoteCurrency": "USD",
"lastPrice": 97.8628,
"isEnabled": true,
"last24HTradeVolume": 2942.861
},
{
"symbol": "ADA/BTC",
"description": "Cardano vs Bitcoin",
"baseCurrency": "ADA",
"quoteCurrency": "BTC",
"lastPrice": 0.00000647,
"isEnabled": true,
"last24HTradeVolume": 636680.3
}
]
Response Fields
Name | Type | Description |
---|---|---|
symbol |
string |
Market pair in base currency/quote currency format. |
description |
string |
Full market pair currency names. |
baseCurrency |
string |
Acronym of a base currency. |
quoteCurrency |
string |
Acronym of a quote currency. |
lastPrice |
number($decimal) |
Last price of base currency based on given quote currency. |
isEnabled |
boolean |
Is the market enabled for the currency. Can be true or false. |
last24HTradeVolume |
number($decimal) |
Trading volume for the last 24 hours. |
Trades
Trades endpoint is used to return data on all recently completed trades for a particular market pair for the last 24 hours.
HTTP Request
[GET] /trades?symbol={symbol}
Parameter
Name | Type | Required | Description |
---|---|---|---|
symbol |
string |
+ | Market pair in base currency/quote currency format. Example: "BTC/USDT". |
Successful Response
[
{
"id": 251209707,
"symbol": "BTC/USDT",
"price": 56103.02,
"volume": 1,
"type": "Buy",
"timeStamp": 1719918009
},
{
"id": 251126073,
"symbol": "BTC/USDT",
"price": 56122.76,
"volume": 1.4363,
"type": "Sell",
"timeStamp": 1719909799
}
]
Response Fields
Name | Type | Description |
---|---|---|
id |
number($int32) |
A unique ID associated with the trade for the currency pair transaction. |
symbol |
string |
Market pair the trading order is associated with. in base currency/quote currency format. |
price |
number($decimal) |
Transacted price of base currency based on given quote currency. |
volume |
number($decimal) |
Transaction amount in BASE currency. |
type |
string |
Type of the transaction. Can be Buy or Sell. |
timeStamp |
boolean |
Unix UTC timestamp in milliseconds. States when the last updated time has occurred. |
Trading pairs Stats
Trading pairs stats endpoint is to provide a statistical overview of market data for all trading pairs on XBO exchange.
HTTP Request
[GET] /trading-pairs/stats
Successful Response
[
{
"symbol": "AAVE/EUR",
"lastPrice": 91.5615,
"lowestAsk": 90.5505,
"highestBid": 92.7372,
"last24HTradeVolume": 3190.956,
"priceChangePercent24H": 1.22,
"highestPrice24H": 92.9529,
"lowestPrice24H": 90.3496
},
{
"symbol": "AAVE/USD",
"lastPrice": 98.1573,
"lowestAsk": 97.4062,
"highestBid": 99.6304,
"last24HTradeVolume": 2697.422,
"priceChangePercent24H": 0.51,
"highestPrice24H": 99.9398,
"lowestPrice24H": 97.064
}
]
Response Fields
Name | Type | Description |
---|---|---|
symbol |
string |
Market pair in base currency/quote currency format. |
lastPrice |
number($decimal) |
Last price of base currency based on given quote currency. |
lowestAsk |
number($decimal) |
Lowest Ask price of base currency based on given quote currency. |
highestBid |
number($decimal) |
Highest bid price of base currency based on given quote currency. |
last24HTradeVolume |
number($decimal) |
Transaction amount in BASE currency. |
priceChangePercent24H |
number($decimal) |
24 hour price change of market pair in percent. |
highestPrice24H |
number($decimal) |
Highest price of base currency based on given quote currency in the last 24 hours. |
lowestPrice24H |
number($decimal) |
Lowest price of base currency based on given quote currency in the last 24 hours. |