Get Tickers

API Description

Retrieves 24-hour ticker statistics for a specific trading pair. This endpoint provides comprehensive market data including price changes, volume, mark price, spot price, open interest, funding rate, and other key metrics for the last 24 hours.

HTTP Request

GET /v4/public/mm/tickers

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)

Response Parameters

Parameter	Type	Description
instrumentAddress	string	Contract address of the instrument
symbol	string	Trading pair symbol (e.g., BTCUSDC)
expiry	uint32	Expiry timestamp (4294967295 for perpetual)
lastPrice	string	Last traded price
priceChange24H	string	Price change in 24 hours (absolute value)
priceChangePercent24h	string	Price change percentage in 24 hours
openPrice24h	float32	Opening price 24 hours ago
highPrice24h	float32	Highest price in 24 hours
lowPrice24h	float32	Lowest price in 24 hours
volume24h	string	Trading volume in 24 hours (base asset)
quoteVolume24h	string	Trading volume in 24 hours (quote asset)
openTime24h	uint64	Opening time timestamp (Unix timestamp in seconds)
closeTime24h	uint64	Closing time timestamp (Unix timestamp in seconds)
markPrice	string	Mark price for the instrument
spotPrice	string	Spot price of the underlying asset
openInterest	string	Open interest amount
fundingRate	string	Current funding rate (1-hour funding rate)
timestamp	uint64	Data timestamp (Unix timestamp in seconds)

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

Response Example

Success Response

{
    "data": {
        "instrumentAddress": "0x73ada1ea346cc3908f41cf67a040f0acd7808be0",
        "symbol": "BTCUSDC",
        "expiry": 4294967295,
        "lastPrice": "89000.2793433248690634",
        "priceChange24H": "-1104.74684510739491496075588384863976",
        "priceChangePercent24h": "-1.24128469400164",
        "openPrice24h": 89040.07,
        "highPrice24h": 89069.266,
        "lowPrice24h": 88943.55,
        "volume24h": "-0.0824027184037195",
        "quoteVolume24h": "1515945.856241239862354",
        "openTime24h": 1765728000,
        "closeTime24h": 1765731599,
        "markPrice": "89027.5214591985019293",
        "spotPrice": "89027.5214591985019293",
        "openInterest": "5.6786202800040269",
        "fundingRate": "0.0000126829942643",
        "timestamp": 1765729105
    },
    "msg": "",
    "code": 0,
    "requestId": "42d236d3-16c5-4694-997a-2023b105ebba"
}

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

• Response format: Returns a single ticker object (not an array)

• Price fields:

  • lastPrice, markPrice, spotPrice: String format for precision

  • openPrice24h, highPrice24h, lowPrice24h: Float32 format

  • priceChange24H: Absolute price change (string)

  • priceChangePercent24h: Percentage change (string, e.g., "-1.24128469400164" means -1.24%)

• Expiry: 4294967295 indicates a perpetual contract

• Time fields: All timestamps are Unix timestamps in seconds (not milliseconds)

• Volume fields:

  • volume24h: Base asset volume (may be negative in some cases)

  • quoteVolume24h: Quote asset volume

• Funding rate: Represents the 1-hour funding rate

• Open interest: Current open interest amount

• 24-hour statistics: Based on the most recent 24-hour period

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)