Get Open Orders

API Description

Retrieves all open orders for a specific trader address. This endpoint provides real-time information about pending limit orders across all trading pairs. Only orders that are currently active and not yet filled or cancelled are returned.

HTTP Request

GET /v4/public/mm/order/realtime

Request Parameters

Parameter	Type	Required	Description
chainId	uint64	Yes	Chain ID (e.g., 143 for Monad mainnet)
address	string	Yes	Trader address (EVM address format)

Response Parameters

The response is an array of open order objects.

Parameter	Type	Description
taken	string	Amount already filled (usually "0" for open orders)
tick	int64	Price tick level
nonce	uint64	Order nonce
balance	string	Order balance (in wei/smallest unit)
size	string	Order size (positive for long, negative for short)
oid	uint64	Order ID
side	uint32	Order side (1 = SHORT, 2 = LONG)
limitPrice	string	Limit price for the order (in wei/smallest unit)
lastUpdateTime	uint64	Last update timestamp (Unix timestamp in seconds)
lastUpdateTxHash	string	Transaction hash of last update

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,
    'address': '0x8bcef483f1c9226c192430b8f5191ee801601480'
}
# Sort parameters alphabetically for signature
sorted_params = sorted(params.items())
query_string = urlencode(sorted_params)
request_path = f"/v4/public/mm/order/realtime?{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/order/realtime?{urlencode(params)}"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Response Example

Success Response

{
    "data": [
        {
            "taken": "0",
            "tick": 114145,
            "nonce": 4,
            "balance": "2749078000000000000",
            "size": "-303515210538787",
            "oid": 1915035320324,
            "side": 1,
            "limitPrice": "90574619339635346723809",
            "lastUpdateTime": 1765762537,
            "lastUpdateTxHash": "0x2662ee1f57359ad78a825cc2c0f991bcbd57da75f1b32470bb9928ab0d681a93"
        },
        {
            "taken": "0",
            "tick": 113674,
            "nonce": 0,
            "balance": "4181371000000000000",
            "size": "231468547388760",
            "oid": 1907133251584,
            "side": 2,
            "limitPrice": "86407665151518819447518",
            "lastUpdateTime": 1765680235,
            "lastUpdateTxHash": "0xcd6a846d66db1e10564aac7f73ea9c8ab8bf2430b4b723e0a1a2716ebb5ad300"
        }
    ],
    "msg": "",
    "code": 0,
    "requestId": "7e12f3e1-6411-426e-827c-15b65f2838d7"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "bbf4fa1a-0f41-449f-8d9c-44fdceae0bf7"
}

Notes

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

• Required parameters: chainId, address

• Response format: Returns an array of open order objects

• Order filtering: Only returns orders that are currently active (not filled or cancelled)

• Order side:

  • side: 1 = SHORT order

  • side: 2 = LONG order

• Order size:

  • Positive value = LONG order

  • Negative value = SHORT order

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

• Taken field: Usually "0" for open orders (indicates how much of the order has been filled)

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

• Nonce: Order nonce used for ordering and cancellation

• Balance: Order balance (collateral allocated to this order)

• Limit price: The price at which the order will be executed

• Time fields: lastUpdateTime is a Unix timestamp in seconds (not milliseconds)

• Transaction hash: lastUpdateTxHash is the transaction hash of the last order update

• Order ID: Unique identifier for the order

• Note: This endpoint only returns limit orders. Market orders are executed immediately and won't appear here

• Note: Orders are returned across all trading pairs for the specified address

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)