Get Orderbook

API Description

Retrieves the current order book (market depth) for a specific trading pair. This endpoint provides real-time bid and ask prices with their corresponding quantities at multiple depth levels (1, 10, 100, 200), essential for market analysis and trading decisions.

HTTP Request

GET /v4/public/mm/orderBook

Request Parameters

Parameter	Type	Required	Description
chainId	uint64	Yes	Chain ID (e.g., 143 for Monad mainnet)
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDC)

Note: The depth parameter is not used. The API returns order book data at multiple depth levels (1, 10, 100, 200) automatically.

Response Parameters

The response is a map where keys are depth levels (1, 10, 100, 200) and values are order book data objects.

Parameter	Type	Description
data	object	Map of depth levels to order book data
-> {depth}	object	Order book data for a specific depth level
-> blockInfo	object	Block information
-> -> height	uint64	Block height
-> -> timestamp	uint64	Block timestamp (Unix timestamp in seconds)
-> bids	array	Array of bid orders
-> -> tick	int64	Price tick
-> -> price	string	Price (in wei/smallest unit)
-> -> baseSize	string	Base asset size at this price level
-> -> quoteSize	string	Quote asset size at this price level
-> -> baseSum	string	Cumulative base asset sum up to this level
-> -> quoteSum	string	Cumulative quote asset sum up to this level
-> asks	array	Array of ask orders
-> -> tick	int64	Price tick
-> -> price	string	Price (in wei/smallest unit)
-> -> baseSize	string	Base asset size at this price level
-> -> quoteSize	string	Quote asset size at this price level
-> -> baseSum	string	Cumulative base asset sum up to this level
-> -> quoteSum	string	Cumulative quote asset sum up to this level

Request Example

Python (requests)

Note: This endpoint requires API authentication. See Quick Start Guide for signature generation details.

import hmac
import hashlib
import base64
import json
import requests
from datetime import datetime, timezone
from urllib.parse import urlencode

def generate_mm_signature(secret_key, timestamp, method, request_path, body="", content_type=""):
    """Generate API signature"""
    message = timestamp + method.upper() + request_path
    if body and method.upper() in ["POST", "PUT", "PATCH"]:
        if content_type and "application/json" in content_type.lower():
            data = json.loads(body)
            body = json.dumps(data, sort_keys=True, separators=(',', ':'))
        message += body
    
    mac = hmac.new(
        secret_key.encode('utf-8'),
        message.encode('utf-8'),
        hashlib.sha256
    )
    return base64.b64encode(mac.digest()).decode('utf-8')

# Generate timestamp
timestamp = datetime.now(timezone.utc).isoformat(timespec='milliseconds').replace('+00:00', 'Z')

# Build request path with sorted query parameters
params = {
    'chainId': 143,
    'symbol': 'BTCUSDC'
}
# Sort parameters alphabetically for signature
sorted_params = sorted(params.items())
query_string = urlencode(sorted_params)
request_path = f"/v4/public/mm/orderBook?{query_string}"

# Generate signature
signature = generate_mm_signature(secret_key, timestamp, "GET", request_path)

# Make request
headers = {
    "X-ACCESS-KEY": api_key,
    "X-ACCESS-SIGN": signature,
    "X-ACCESS-TIMESTAMP": timestamp,
    "X-ACCESS-PASSPHRASE": passphrase,
}

url = f"https://api.monday.trade/v4/public/mm/orderBook?{urlencode(params)}"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Response Example

Success Response

{
    "data": {
        "1": {
            "blockInfo": {
                "height": 42013519,
                "timestamp": 1765728535
            },
            "bids": [
                {
                    "tick": 113966,
                    "price": "88967837587920101456516",
                    "baseSize": "803572195167175",
                    "quoteSize": "71492080549801659660",
                    "baseSum": "803572195167175",
                    "quoteSum": "71492080549801659660"
                },
                {
                    "tick": 113965,
                    "price": "88958941693750726383877",
                    "baseSize": "661643289026855",
                    "quoteSize": "58859086770601453729",
                    "baseSum": "1465215484194030",
                    "quoteSum": "130351167320403113389"
                }
            ],
            "asks": [
                {
                    "tick": 113968,
                    "price": "88985632045116061356008",
                    "baseSize": "519615145489909",
                    "quoteSize": "46238282141634490772",
                    "baseSum": "519615145489909",
                    "quoteSum": "46238282141634490772"
                },
                {
                    "tick": 113969,
                    "price": "88994530608320572962144",
                    "baseSize": "661544054937865",
                    "quoteSize": "58873802645920333417",
                    "baseSum": "1181159200427774",
                    "quoteSum": "105112084787554824189"
                }
            ]
        },
        "10": {
            "blockInfo": {
                "height": 42013519,
                "timestamp": 1765728535
            },
            "bids": [...],
            "asks": [...]
        },
        "100": {
            "blockInfo": {
                "height": 42013519,
                "timestamp": 1765728535
            },
            "bids": [
                {
                    "tick": 113629,
                    "price": "86019723578250686574564",
                    "baseSize": "231972966439363235",
                    "quoteSize": "19954250450740848881383",
                    "baseSum": "231972966439363235",
                    "quoteSum": "19954250450740848881383"
                }
            ],
            "asks": [
                {
                    "tick": 114027,
                    "price": "89512172715234876662243",
                    "baseSize": "45412815490166610",
                    "quoteSize": "4064999783640887388971",
                    "baseSum": "45412815490166610",
                    "quoteSum": "4064999783640887388971"
                }
            ]
        },
        "200": {
            "blockInfo": {
                "height": 42013519,
                "timestamp": 1765728535
            },
            "bids": [...],
            "asks": [...]
        }
    },
    "msg": "",
    "code": 0,
    "requestId": "0e8d27c5-4f7e-44f7-bbea-f8e3e094feaf"
}

Error Response

{
    "code": 400,
    "msg": "invalid request parameters",
    "data": {},
    "requestId": "..."
}

Notes

• This endpoint requires API authentication (see Quick Start Guide)

• Required parameters: chainId, symbol

• Note: The depth parameter is not used. The API automatically returns order book data at multiple depth levels (1, 10, 100, 200)

• Response structure: Returns a map where keys are depth levels ("1", "10", "100", "200") and values are order book data

• Price format: All prices and sizes are returned as strings in wei/smallest unit format to preserve precision

• Cumulative sums: baseSum and quoteSum are cumulative totals up to and including the current price level

• Order book sorting:

  • Bids are sorted in descending order (highest price first)

  • Asks are sorted in ascending order (lowest price first)

• Block information: Each depth level includes block height and timestamp when the data was captured

• Tick: Represents the price tick level in the order book

• Depth levels:

  • "1": Most granular depth (individual price levels)

  • "10": Aggregated depth with 10x tick spacing

  • "100": Aggregated depth with 100x tick spacing

  • "200": Aggregated depth with 200x tick spacing

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)