Get Order By ID

API Description

Retrieves a single order by its ID for a specific trader address. Use this endpoint to fetch the current state and metadata of a particular order.

HTTP Request

GET /v4/public/mm/orderById

Request Parameters

Parameter	Type	Required	Description
chainId	uint64	Yes	Chain ID (e.g., 143 for Monad mainnet)
orderId	string	Yes	Order identifier to query (the client-visible orderId)
address	string	Yes	Trader address (EVM address format)

Example request URL: https://mainnet-api.monday.trade/v4/public/mm/orderById?chainId=143&orderId=1030049889949000026&address=0x0540a308f7bbab36267bdcf1bf1380e61f03a540

Response Parameters

The response contains a data object representing the order.

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	Internal 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
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., "ETH/USDC")
orderId	string	The queried orderId (client-visible)
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,
    'orderId': '1030049889949000026',
    'address': '0x0540a308f7bbab36267bdcf1bf1380e61f03a540'
}
# Sort parameters alphabetically for signature
sorted_params = sorted(params.items())
query_string = urlencode(sorted_params)
request_path = f"/v4/public/mm/orderById?{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://mainnet-api.monday.trade/v4/public/mm/orderById?{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": 80508,
    "nonce": 0,
    "balance": "16665768580000000000000",
    "size": "-15948935130379190272",
    "oid": 1350700105728,
    "side": 1,
    "limitPrice": "3135040861125726252480",
    "lastUpdateTime": 1768890737,
    "lastUpdateTxHash": "0xf058775b89a26df3d6fc9f05cc6c992a7ea0f90c31811563fdb2cc6c5e3f1a12",
    "instrumentAddr": "0x44b60b6af9b615a5cf2d366e2143582557cff711",
    "expiry": 4294967295,
    "symbol": "ETH/USDC",
    "orderId": "1030049889949000026",
    "status": "canceled"
  },
  "msg": "",
  "code": 0,
  "requestId": "156d8037-8fca-4b8f-b40b-ca2d0848d83d"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "<request-id>"
}

Notes

• This endpoint returns the order object for the specified orderId scoped to the provided address and chainId.

• All three parameters chainId, orderId, and address are required.

• orderId in the response is returned as a string to preserve large integer precision in JSON.

• Time fields are Unix timestamps in seconds.

• Rate limit: 120 requests per minute (consistent with other trading endpoints)

• Success response has code: 0 (not 200)