Get Kline

API Description

Retrieves kline (candlestick) data for a specific trading pair. This endpoint provides historical price data including open, high, low, close prices and volume for specified time intervals.

HTTP Request

GET /v4/public/mm/kline

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)
interval	string	Yes	Kline interval (e.g., 1m, 5m, 15m, 30m, 1h, 4h, 8h, 12h, 1d, 1w, 1M)
start	uint64	No	Start time in Unix timestamp (seconds). Default: 0
end	uint64	No	End time in Unix timestamp (seconds). Default: current time
limit	uint64	No	Number of kline data points to retrieve. Default: 1000, max: 1000

Response Parameters

Parameter	Type	Description
symbol	string	Trading pair symbol
openTime	uint64	Opening time timestamp (Unix timestamp in seconds)
open	float32	Opening price
high	float32	Highest price in the period
low	float32	Lowest price in the period
close	float32	Closing price
closeTime	uint64	Closing time timestamp (Unix timestamp in seconds)
baseVolume	float32	Base asset volume
quoteVolume	float32	Quote asset volume

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

Example with optional time range parameters:

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

# Build request path with time range
params = {
    'chainId': 143,
    'symbol': 'BTCUSDC',
    'interval': '1h',
    'start': 1765728000,  # Optional: start time in seconds
    'end': 1765728600,    # Optional: end time in seconds
    'limit': 100
}
# Sort parameters alphabetically for signature
sorted_params = sorted(params.items())
query_string = urlencode(sorted_params)
request_path = f"/v4/public/mm/kline?{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/kline?{urlencode(params)}"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Response Example

Success Response

{
    "data": [
        {
            "symbol": "BTCUSDC",
            "openTime": 1765728240,
            "open": 89032.47,
            "high": 89032.47,
            "low": 89032.47,
            "close": 89032.47,
            "closeTime": 1765728299,
            "baseVolume": 0,
            "quoteVolume": 0
        },
        {
            "symbol": "BTCUSDC",
            "openTime": 1765728180,
            "open": 88985.63,
            "high": 89069.266,
            "low": 88978.83,
            "close": 89032.47,
            "closeTime": 1765728239,
            "baseVolume": 0.019537894,
            "quoteVolume": 1739.4907
        }
    ],
    "msg": "",
    "code": 0,
    "requestId": "d55bb2e2-cca0-4de7-a99a-681d479042a9"
}

Error Response

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

Notes

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

• Required parameters: chainId, symbol, interval

• Optional parameters: start, end, limit

• Time format: start and end are Unix timestamps in seconds (not milliseconds)

• Default values:

  • If start is not provided, defaults to 0 (beginning of time)

  • If end is not provided, defaults to current time

  • If limit is not provided, defaults to 1000

• Interval format: Use string format like "1m", "5m", "15m", "30m", "1h", "4h", "8h", "12h", "1d", "1w", "1M"

• Maximum limit: 1000 data points per request

• Response format: Array of kline objects with OHLCV data

• Time fields: openTime and closeTime are Unix timestamps in seconds

• Price fields: open, high, low, close are float32 values

• Volume fields: baseVolume and quoteVolume are float32 values

• Kline data is returned in reverse chronological order (newest first)

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)