---
title: "Get Orderbook"
method: GET
path: "/api/v1/market/orderbook"
tags: ["Market"]
---

# Get Orderbook

`GET /api/v1/market/orderbook`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/market/orderbook`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/market/orderbook/get.ts> (a function with typed inputs; its response is checked against the schema)

Query for orderbook depth data.

## Query parameters

- `symbol` string, required
- `depth` Depth (unresolved $ref)

## Response `200`

Orderbook

- GetOrderBookResponse: Get OrderBook response.
  - `result` OrderBookSnapshot, required: Order book Snapshot at a specific point in time.
    - `a` OrderBookLevel[], required: Ask levels
      - string[]: Order book level consisting of price and size.
    - `b` OrderBookLevel[], required: Bid levels
      - string[]: Order book level consisting of price and size.
    - `mts` string, date-time, required: The timestamp from the matching engine when this orderbook data is produced. It can be correlated with T from public trade channel
    - `s` string, required
    - `seq` integer, required
    - `ts` string, date-time, required: The timestamp (ms) that the system generates the data
    - `u` integer, required: Update ID, is always in sequence
  - `time` string, date-time, required

## Changes

- **2026-01-29** `16fe50636aa5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/market/orderbook/get.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)