​

Monaco Protocol SDK v0.5.3

​

Candlestick API Refactor & Market Metadata

​

Breaking Changes

// Before (v0.5.2)
sdk.market.getCandlesticks("BTC-USDC", "1h", startTime, endTime);

// After (v0.5.3)
const pair = await sdk.market.getTradingPairBySymbol("BTC-USDC");
sdk.market.getCandlesticks(pair.id, "1h", { startTime, endTime, limit: 350 });

​

New Features

• Optional startTime, endTime, and limit parameters via GetCandlesticksParams
• Support for backward pagination (endTime + limit) — TradingView’s countBack pattern
• Support for forward pagination (startTime + limit)
• Limit validation: max 500 bars per request, server defaults to 350
• Automatic backfilling when time range contains fewer bars than requested

• New getMarketMetadata() method for comprehensive market information
• Returns 24-hour statistics, latest price, and market initialization data
• Useful for building market overview dashboards

• Auto-connect flag for authenticated WebSocket channels
• Simplified connection management after authentication

• Vault deposit/withdraw methods now use assetId (UUID) instead of token addresses
• Consistent with the platform-wide shift to UUID-based asset identification

​

Migration Guide

// Step 1: Get trading pair (if you only have the symbol)
const pair = await sdk.market.getTradingPairBySymbol("BTC-USDC");

// Step 2: Use the new method signature
const candles = await sdk.market.getCandlesticks(pair.id, "1h", {
  startTime: Date.now() - 24 * 60 * 60 * 1000,
  endTime: Date.now(),
  limit: 350
});

// Fetch historical data going backwards from a point in time
const historicalCandles = await sdk.market.getCandlesticks(pair.id, "1h", {
  endTime: oldestCandleTime,
  limit: 350
});

// Fetch latest candles from a starting point
const latestCandles = await sdk.market.getCandlesticks(pair.id, "1h", {
  startTime: lastKnownCandleTime,
  limit: 100
});

​

API Reference