Get market orderbook
Rate limit: 5 every second
API Overview
HTTP method
GET
Path
/api/v3/depth
Summary
Returns the order book of a given trading pair.
API description
HTTP Header
None
Request parameters
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| market | string | Y | The ID of a trading pair. | "LRC-ETH" |
| level | integer | Y | Order book aggregation level, larger value means further price aggregation. | 2 |
| limit | integer | N | Maximum numbers of bids/asks. Default : 50 |
50 |
Request example
HTTP
CURL
GET https://api3.loopring.io/api/v3/depth?market=LRC-ETH&level=2&limit=50 HTTP/1.1
Host: api3.loopring.io
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9curl https://api3.loopring.io/api/v3/depth\?market\=LRC-ETH\&level\=2\&limit\=50Response fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| version | integer | Y | An ever-increasing numeric version number that reflects its change history. | 147 |
| timestamp | integer | Y | Update timestamp | 432312312 |
| market | string | Y | Trading pair | "LRC-ETH" |
| bids | List[List[string]] | Y | Array of bids, each item is an array that contains the price, size, volume and the number of orders aggregated at this price. | "[["0.002","2 1000","33220 000","4"]]" |
| asks | List[List[string]] | Y | Array of asks, each item is an array that contains the price, size, volume and the number of orders aggregated at this price. | "[]" |
Response example
{
"version" : 147,
"timestamp" : 432312312,
"market" : "LRC-ETH",
"bids" : [["0.002","21000","33220000","4"]],
"asks" : []
}
Status code
| Value | Description |
|---|---|
| 100000 | Unknown error |
| 108000 | Unsupported market |
| 108001 | Unsupported depth level |