Skip to main content
GET
/
trade
/
v1
/
market-data
/
order-book
/
{symbol}
Get market data order books
curl --request GET \
  --url https://api.staging.layer1.com/trade/v1/market-data/order-book/{symbol} \
  --header 'Authorization: Bearer <token>'
[
  {
    "timestamp": "2023-10-01T12:00:00Z",
    "venue": "kraken",
    "symbol": {
      "base": {
        "code": "BTC"
      },
      "counter": {
        "code": "USD"
      }
    },
    "bids": [
      {
        "price": "42700.00",
        "quantity": "0.5"
      },
      {
        "price": "42650.00",
        "quantity": "1.2"
      },
      {
        "price": "42600.00",
        "quantity": "0.8"
      }
    ],
    "asks": [
      {
        "price": "42800.00",
        "quantity": "0.3"
      },
      {
        "price": "42850.00",
        "quantity": "0.7"
      },
      {
        "price": "42900.00",
        "quantity": "1.1"
      }
    ],
    "type": "INDICATIVE"
  }
]

Documentation Index

Fetch the complete documentation index at: https://exness-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
symbol
string
required

Trading pair symbol (e.g., BTC-USD, ETH-EUR)

Required string length: 1 - 32

Query Parameters

​
venue
string

Filter order books by specific trading venue

Maximum string length: 255

Response

List of order books retrieved successfully

​
timestamp
string<date-time>

Timestamp when the order book data was recorded

​
venue
string

Trading venue identifier

Example:

"kraken"

​
venueAccount
string

Venue account of the venue

Example:

"kraken"

​
symbol
string

Trading pair symbol

​
bids
object[]

List of bid orders sorted by price in descending order

​
asks
object[]

List of ask orders sorted by price in ascending order

​
type
enum<string>

Type of order book (e.g., INDICATIVE, FIRM)

Available options:
INDICATIVE,
AGGREGATED