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)
symbol	string	Optional	Trading pair symbol to filter results (e.g., "BTC/USDC"). If omitted, orders across all symbols for the address are returned.

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	oid(tick+nonce) mean nothing
orderId	string	Additional order identifier returned by API (string to preserve large integer precision)
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
instrumentAddr	string	Contract address of the trading instrument
expiry	uint32	Instrument pair expiry timestamp (4294967295 = perpetual/no expiry)
symbol	string	Trading pair symbol (e.g., "BTC/USDC")
status	string	Order status. Allowed values: open, canceled, filled, partial_filled

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',
    # Optional: filter by symbol
    # 'symbol': 'BTC/USDC'
}
# 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": 80485,
      "nonce": 0,
      "balance": "16665768580000000000000",
      "size": "15985526877351575552",
      "oid": 1350314229760,
      "side": 2,
      "limitPrice": "3127838912652004164864",
      "lastUpdateTime": 1768890735,
      "lastUpdateTxHash": "0x038cecd02e187077507155077eb6c033d546857d653ec28d9498638cd15b9ce7",
      "instrumentAddr": "0x44b60b6af9b615a5cf2d366e2143582557cff711",
      "expiry": 4294967295,
      "symbol": "ETH/USDC",
      "orderId": "1030049889949000023",
      "status": "open"
    },
    {
      "taken": "0",
      "tick": 80508,
      "nonce": 0,
      "balance": "16665768580000000000000",
      "size": "-15948935130379190272",
      "oid": 1350700105728,
      "side": 1,
      "limitPrice": "3135040861125726252480",
      "lastUpdateTime": 1768890735,
      "lastUpdateTxHash": "0x038cecd02e187077507155077eb6c033d546857d653ec28d9498638cd15b9ce7",
      "instrumentAddr": "0x44b60b6af9b615a5cf2d366e2143582557cff711",
      "expiry": 4294967295,
      "symbol": "ETH/USDC",
      "orderId": "1030049889949000026",
      "status": "open"
    }
  ],
  "msg": "",
  "code": 0,
  "requestId": "8069cd38-1931-48af-b88d-86b24dd9c3af"
}

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

• Optional parameter: symbol — when provided, results are filtered to the specified trading pair; when omitted, returns orders across all symbols for the 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