List Available Books
The method GET /available_books/ enables you to retrieve a list of existing exchange order books and their respective order placement limits.
HTTP Request
JSON Response Payload
The endpoint returns a JSON array of available exchange order books. Every element in the array is a JSON object that contains the following fields:
| Field Name | Description | Type | Units |
|---|---|---|---|
book | The order book symbol | String | Major_Minor |
default_chart | Price chart that provides information about the current and past state of the market. Possible values: depth, candle, hollow, line, and trading view. | String | |
fees | The fee structure applied in the book. See the table below for its description. | Object | |
minimum_amount | The minimum amount of major when placing an order. | String | Major |
maximum_amount | The maximum amount of major when placing an order. | String | Major |
minimum_price | The minimum price when placing an order. | String | Minor |
maximum_price | The maximum price when placing an order. | String | Minor |
minimum_value | The minimum value amount (amount*price) when placing an order. | String | Minor |
maximum_value | The maximum value amount (amount*price) when placing an order. | String | Minor |
tick_size | The minimum price difference that must exist at all times between consecutive bid and offer prices in the order book. In other words, it is the minimum increment in which prices can change in the order book. | String |
The following table describes the fees object:
| Field Name | Description | Type | Units |
|---|---|---|---|
flat_rate | Acts as a fallback mechanism that specifies the fees to apply to makers and takers in case a fee structure is not defined for the book. | Object | |
structure | Describes the fee tiers defined based on the volume traded. For example, in the payload shown, the first tier goes from 0 to 1,500,000, the second from 1,500,001 to 2,000,000, and so forth. Increasing your trading volume lowers fees only if it reaches the next tier. Every tier shows the fee applied to makers and takers as a decimal, and the volume figures reported are denominated in the minor currency. | Array | Minor |
The following response object exemplifies the JSON array returned, showing only a small set of elements:
curl https://api-stage.bitso.com/api/v3/available_books
{
"payload":[
{
"default_chart":"candle",
"minimum_price":"500",
"fees":{
"flat_rate":{
"maker":"0.500",
"taker":"0.650"
},
"structure":[
{
"volume":"1500000",
"maker":"0.00500",
"taker":"0.00650"
},
{
"volume":"2000000",
"maker":"0.00490",
"taker":"0.00637"
},
{
"volume":"5000000",
"maker":"0.00480",
"taker":"0.00624"
},
{
"volume":"7000000",
"maker":"0.00440",
"taker":"0.00572"
},
{
"volume":"10000000",
"maker":"0.00420",
"taker":"0.00546"
},
{
"volume":"15000000",
"maker":"0.00400",
"taker":"0.00520"
},
{
"volume":"35000000",
"maker":"0.00370",
"taker":"0.00481"
},
{
"volume":"50000000",
"maker":"0.00300",
"taker":"0.00390"
},
{
"volume":"150000000",
"maker":"0.00200",
"taker":"0.00260"
},
{
"volume":"250000000",
"maker":"0.00100",
"taker":"0.00130"
},
{
"volume":"9999999999",
"maker":"0.0005",
"taker":"0.00130"
}
]
},
"maximum_price":"16000000",
"book":"btc_mxn",
"minimum_value":"5",
"maximum_amount":"500",
"maximum_value":"50000000",
"minimum_amount":".000075",
"tick_size":"0.01"
},
{
"default_chart":"candle",
"minimum_price":"0.00000100",
"fees":{
"flat_rate":{
"maker":"0.075",
"taker":"0.098"
},
"structure":[
{
"volume":"8",
"maker":"0.00075",
"taker":"0.00098"
},
{
"volume":"10",
"maker":"0.00072",
"taker":"0.00094"
},
{
"volume":"18",
"maker":"0.00071",
"taker":"0.00092"
},
{
"volume":"30",
"maker":"0.00070",
"taker":"0.00091"
},
{
"volume":"45",
"maker":"0.00067",
"taker":"0.00087"
},
{
"volume":"65",
"maker":"0.00065",
"taker":"0.00085"
},
{
"volume":"180",
"maker":"0.00063",
"taker":"0.00082"
},
{
"volume":"500",
"maker":"0.00059",
"taker":"0.00077"
},
{
"volume":"950",
"maker":"0.00055",
"taker":"0.00072"
},
{
"volume":"9999999999",
"maker":"0.00050",
"taker":"0.00065"
}
]
},
"maximum_price":"5000.00000000",
"book":"eth_btc",
"minimum_value":"0.00000100",
"maximum_amount":"1000.00000000",
"maximum_value":"2000.00000000",
"minimum_amount":"0.00000100",
"tick_size":"0.00000001"
}
]
}
Updated 2 months ago