Get Server Time

API Description

Retrieves the current server time. This endpoint is useful for synchronizing client applications with the server time and can be used for timestamp validation when generating API signatures.

HTTP Request

GET /v4/public/mm/serverTime

Request Parameters

Parameter	Type	Required	Description
N/A	N/A	N/A	No parameters required

Response Parameters

Parameter	Type	Description
data	int64	Server time in Unix timestamp format (milliseconds)
msg	string	Response message (empty on success)
code	number	Response code (0 for success)
requestId	string	Request ID for tracking

Authentication

This endpoint requires API authentication. See Quick Start Guide for detailed authentication instructions.

Required Headers

X-ACCESS-KEY: [your_api_key]
X-ACCESS-SIGN: [signature]
X-ACCESS-TIMESTAMP: [timestamp]
X-ACCESS-PASSPHRASE: [your_passphrase]

Request Example

Python (requests)

import hmac
import hashlib
import base64
import requests
from datetime import datetime, timezone

# Your API credentials
API_KEY = "your_api_key"
SECRET_KEY = "your_secret_key"
PASSPHRASE = "your_passphrase"

# Base URL
BASE_URL = "https://api.monday.trade"
ENDPOINT = "/v4/public/mm/serverTime"

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

# Build message for signature
method = "GET"
request_path = ENDPOINT
body = ""
message = timestamp + method + request_path + body

# Generate signature
signature = base64.b64encode(
    hmac.new(
        SECRET_KEY.encode('utf-8'),
        message.encode('utf-8'),
        hashlib.sha256
    ).digest()
).decode('utf-8')

# Set headers
headers = {
    "X-ACCESS-KEY": API_KEY,
    "X-ACCESS-SIGN": signature,
    "X-ACCESS-TIMESTAMP": timestamp,
    "X-ACCESS-PASSPHRASE": PASSPHRASE,
    "Content-Type": "application/json"
}

# Make request
url = BASE_URL + ENDPOINT
response = requests.get(url, headers=headers)
result = response.json()
print(result)
# Output: {"data": 1765804277008, "msg": "", "code": 0, "requestId": "..."}

# Extract server time
server_time_ms = result["data"]
print(f"Server time: {server_time_ms} ms")
print(f"Server time (seconds): {server_time_ms / 1000}")

JavaScript (Fetch)

const crypto = require('crypto');

// Your API credentials
const API_KEY = "your_api_key";
const SECRET_KEY = "your_secret_key";
const PASSPHRASE = "your_passphrase";

// Base URL
const BASE_URL = "https://api.monday.trade";
const ENDPOINT = "/v4/public/mm/serverTime";

// Generate timestamp (ISO 8601 UTC format)
const timestamp = new Date().toISOString();

// Build message for signature
const method = "GET";
const requestPath = ENDPOINT;
const body = "";
const message = timestamp + method + requestPath + body;

// Generate signature
const signature = crypto
    .createHmac('sha256', SECRET_KEY)
    .update(message)
    .digest('base64');

// Set headers
const headers = {
    "X-ACCESS-KEY": API_KEY,
    "X-ACCESS-SIGN": signature,
    "X-ACCESS-TIMESTAMP": timestamp,
    "X-ACCESS-PASSPHRASE": PASSPHRASE,
    "Content-Type": "application/json"
};

// Make request
fetch(BASE_URL + ENDPOINT, {
    method: "GET",
    headers: headers
})
.then(response => response.json())
.then(data => {
    console.log(data);
    // Output: {data: 1765804277008, msg: "", code: 0, requestId: "..."}
    
    // Extract server time
    const serverTimeMs = data.data;
    console.log(`Server time: ${serverTimeMs} ms`);
    console.log(`Server time (seconds): ${serverTimeMs / 1000}`);
})
.catch(error => console.error("Error:", error));

cURL

# Set your credentials
API_KEY="your_api_key"
SECRET_KEY="your_secret_key"
PASSPHRASE="your_passphrase"

# Generate timestamp
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.%3NZ")

# Build message
METHOD="GET"
REQUEST_PATH="/v4/public/mm/serverTime"
BODY=""
MESSAGE="${TIMESTAMP}${METHOD}${REQUEST_PATH}${BODY}"

# Generate signature
SIGNATURE=$(echo -n "$MESSAGE" | openssl dgst -sha256 -hmac "$SECRET_KEY" -binary | base64)

# Make request
curl -X GET "https://api.monday.trade/v4/public/mm/serverTime" \
  -H "X-ACCESS-KEY: $API_KEY" \
  -H "X-ACCESS-SIGN: $SIGNATURE" \
  -H "X-ACCESS-TIMESTAMP: $TIMESTAMP" \
  -H "X-ACCESS-PASSPHRASE: $PASSPHRASE" \
  -H "Content-Type: application/json"

Response Example

Success Response

{
    "data": 1765804277008,
    "msg": "",
    "code": 0,
    "requestId": "288cbcb2-2f24-4d1f-9b9f-38787bc14258"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "..."
}

Notes

• Authentication required: This endpoint requires API authentication using HMAC-SHA256 signature

• Time format: Returns Unix timestamp in milliseconds (not seconds)

• Use case:

  • Synchronize client clock with server time

  • Validate timestamp accuracy for API signature generation

  • Calculate time differences for request expiration checks

• Response format: The data field contains the timestamp as a number (int64)

• Example usage: Use this timestamp to generate the X-ACCESS-TIMESTAMP header for authenticated requests

• Conversion:

  • Milliseconds: data value directly

  • Seconds: data / 1000

  • ISO 8601 format: Convert using your programming language's datetime library

• Signature generation: See Quick Start Guide for detailed signature generation instructions

• Time window: Requests are valid within 30 seconds of the timestamp

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)