Get Instruments Info

API Description

Retrieves detailed information about trading instruments including contract specifications, trading rules, and market data. This endpoint provides essential information for trading operations. If symbol is not provided, it returns information for all instruments on the specified chain.

HTTP Request

GET /v4/public/mm/instruments-info

Request Parameters

Parameter	Type	Required	Description
chainId	uint64	Yes	Chain ID (e.g., 143 for Monad mainnet)
symbol	string	No	Trading pair symbol (e.g., BTCUSDC). If not provided, returns all instruments

Response Parameters

Parameter	Type	Description
instrumentAddress	string	Contract address of the instrument
symbol	string	Trading pair symbol (e.g., BTCUSDC)
base	object	Base asset information
-> symbol	string	Base token symbol (e.g., BTC)
quote	object	Quote asset information
-> symbol	string	Quote token symbol (e.g., USDC)
-> address	string	Quote token contract address
-> decimals	number	Quote token decimal places
market	object	Market information
-> address	string	Market contract address
-> type	string	Market type (e.g., STORK)
initialMarginRatio	number	Initial margin ratio (in basis points, e.g., 1000 = 10%)
maintenanceMarginRatio	number	Maintenance margin ratio (in basis points, e.g., 500 = 5%)
minMarginAmount	string	Minimum margin amount (in wei/smallest unit)
tradingFeeRatio	number	Trading fee ratio (in basis points, e.g., 2 = 0.02%)
protocolFeeRatio	number	Protocol fee ratio (in basis points)
tip	string	Tip amount (in wei/smallest unit)
quoteType	string	Quote type: "STABLE", "NONSTABLE", or "INVALID"
minTradeValue	string	Minimum trade value (in wei/smallest unit)
minOrderValue	string	Minimum order value (in wei/smallest unit)
minRangeValue	string	Minimum range value (in wei/smallest unit)
fundingIntervalHour	number	Funding interval in hours (0 for perpetual)
minRangeTickDelta	number	Minimum range tick delta
instrumentCondition	string	Instrument condition: "NORMAL", "FROZEN", or "RESOLVED"
placeLimitOrderPaused	boolean	Whether limit orders are paused
disableMakerOrderRebate	boolean	Whether maker order rebates are disabled

Request Example

Python (requests)

Note: This endpoint requires API authentication. See Quick Start Guide for signature generation details.

Example 1: Get specific instrument by symbol

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/instruments-info?{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/instruments-info?{urlencode(params)}"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Example 2: Get all instruments (without symbol parameter)

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

# Build request path - only chainId, no symbol
params = {
    'chainId': 143
}
request_path = f"/v4/public/mm/instruments-info?chainId=143"

# 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 = "https://api.monday.trade/v4/public/mm/instruments-info?chainId=143"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Response Example

Success Response

Single instrument (with symbol parameter):

{
    "data": [
        {
            "instrumentAddress": "0x73ada1ea346cc3908f41cf67a040f0acd7808be0",
            "symbol": "BTCUSDC",
            "base": {
                "symbol": "BTC"
            },
            "quote": {
                "symbol": "USDC",
                "address": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
                "decimals": 6
            },
            "market": {
                "address": "0x6e77d8ef45f572ce59b0d9b95be5f12a5906ba65",
                "type": "STORK"
            },
            "initialMarginRatio": 1000,
            "maintenanceMarginRatio": 500,
            "minMarginAmount": "1000000000000000000",
            "tradingFeeRatio": 2,
            "protocolFeeRatio": 0,
            "tip": "10000000000000000",
            "quoteType": "STABLE",
            "minTradeValue": "10000000000000000000",
            "minOrderValue": "20000000000000000000",
            "minRangeValue": "100000000000000000000",
            "fundingIntervalHour": 0,
            "minRangeTickDelta": 1000,
            "instrumentCondition": "NORMAL",
            "placeLimitOrderPaused": false,
            "disableMakerOrderRebate": false
        }
    ],
    "msg": "",
    "code": 0,
    "requestId": "1ad5dc0b-d468-471f-aa2e-1d82c4f7a067"
}

Multiple instruments (without symbol parameter):

{
    "data": [
        {
            "instrumentAddress": "0x73ada1ea346cc3908f41cf67a040f0acd7808be0",
            "symbol": "BTCUSDC",
            ...
        },
        {
            "instrumentAddress": "0x...",
            "symbol": "ETHUSDC",
            ...
        }
    ],
    "msg": "",
    "code": 0,
    "requestId": "..."
}

Error Response

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

Notes

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

• chainId is required; symbol is optional

• If symbol is not provided, returns all instruments on the specified chain

• If symbol is provided but not found, returns an error

• Returns comprehensive instrument specifications including:

  • Margin requirements (initial and maintenance)

  • Fee ratios (trading and protocol)

  • Minimum trade/order/range values

  • Market type and contract addresses

  • Instrument condition and status flags

• All amount values are returned in wei/smallest unit format (strings to preserve precision)

• Ratios are in basis points (e.g., 1000 = 10%, 2 = 0.02%)

• fundingIntervalHour: 0 indicates a perpetual contract

• quoteType: "STABLE" for stablecoins, "NONSTABLE" for other tokens

• instrumentCondition: "NORMAL" for active trading, "FROZEN" for paused, "RESOLVED" for resolved

• Useful for validating trading parameters before placing orders

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)