YONEPSE

[
  {
    "symbol": "ACLBSL",
    "name": "Aarambha Chautari Laghubitta Bittiya Sanstha Limited",
    "ltp": 970.0,
    "previous_close": 977.0,
    "change": -7.0,
    "percent_change": -0.72,
    "high": 980.0,
    "low": 960.4,
    "volume": 531,
    "turnover": 515567.8,
    "trades": 29,
    "last_updated": "2026-02-26T14:51:14.742578",
    "market_cap": 3561.29
  }
]

{
  "is_open": false,
  "last_checked": "2026-02-28T04:50:01.120000"
}

{
  "index": "Sensitive Index",
  "generatedTime": "2026-02-26T15:27:30.75",
  "close": 454.58,
  "high": 458.6923,
  "low": 454.4399,
  "previousClose": 456.5119,
  "change": 1.93,
  "perChange": 0.42,
  "currentValue": 456.51
}

{
  "indexCode": "BANK",
  "indexName": "Banking Index",
  "description": "...",
  "activeStatus": "A",
  "baseYearMarketCapitalization": 0
}

{
  "top_gainer": [
    {
      "symbol": "SABBL",
      "ltp": 584.5,
      "pointChange": 53.1,
      "percentageChange": 9.99
    }
  ],
  "top_loser": [],
  "top_turnover": [],
  "top_trade": [],
  "top_transaction": []
}

{
  "detail": "Total Turnover Rs:",
  "value": 4174630515.28
}

{
  "businessDate": "2026-02-26",
  "totalTurnover": 4174630515.28,
  "totalTradedShares": 10053145,
  "totalTransactions": 44204,
  "tradedScrips": 335
}

{
  "version": 1,
  "latestDate": "2026-05-18",
  "latestStatus": "final",
  "finalizedThrough": "2026-05-18",
  "availableMonths": ["2026-05"],
  "availableDays": ["2026-05-20"],
  "retention": "no-limit"
}

{
  "version": 1,
  "market": "NEPSE",
  "currency": "NPR",
  "date": "2026-05-20",
  "updatedAt": "2026-05-20T13:30:00+05:45",
  "times": ["11:00", "11:30", "12:00"],
  "columns": ["timeIndex", "ltp", "volume", "turnover", "trades"],
  "series": {
    "NABIL": [
      [0, 526, 44305, 23313421.6, 463],
      [1, 528, 51840, 27371520, 512]
    ]
  }
}

{
  "version": 1,
  "market": "NEPSE",
  "currency": "NPR",
  "month": "2026-05",
  "updatedAt": "2026-05-18T19:23:40+05:45",
  "dates": ["2026-05-18"],
  "columns": ["dateIndex", "ltp", "volume", "turnover", "trades"],
  "series": {
    "NABIL": [
      [0, 526, 44305, 23313421.6, 463]
    ]
  }
}

{
  "general": [{ "id": 1223, "title": "..." }],
  "last_updated": "2026-02-27T11:04:56.015637"
}

{
  "id": 44893,
  "symbol": "SIFC",
  "title": "Appointment of CEO",
  "body": "Appointment of CEO",
  "source": "Shree Investment Finance Co. Ltd.",
  "publishedAt": "2026-02-27T13:09:10.243",
  "documents": [
    {
      "id": 30000,
      "submittedDate": "2026-02-27",
      "fileUrl": "https://www.nepalstock.com.np/api/nots/security/fetchFiles?fileLocation=..."
    }
  ]
}

{
  "id": 208611,
  "symbol": "MSHL",
  "title": "Listing 15% Bonus Shares of Mid Solu Hydropower Limited",
  "body": "11,22,600 Units Bonus Shares of Mid Solu Hydropower Limited has been listed in NEPSE.",
  "publishedAt": "2026-05-15T14:36:07.55",
  "expiresAt": "2026-05-15"
}

{
  "memberCode": 1,
  "memberName": "Kumari Securities Private Limited",
  "membershipType": "Trading Cum Clearing Member",
  "phone": "4423689",
  "provinces": ["Province 3", "Province 4"],
  "districts": ["Kathmandu", "Baglung"],
  "tmsLink": "tms01.nepsetms.com.np",
  "branchCount": 2,
  "activeStatus": "A",
  "isDealer": "N"
}

{
  "id": 131,
  "companyName": "Nabil Bank Limited",
  "symbol": "NABIL",
  "securityName": "Nabil Bank Limited",
  "status": "A",
  "sectorName": "Commercial Banks",
  "instrumentType": "Equity"
}

{
  "id": 131,
  "symbol": "NABIL",
  "reports": [
    {
      "type": "Quarterly Report",
      "quarter": "Third Quarter",
      "fy": "2025-2026",
      "fy_nepali": "2082-2083",
      "pe": 16.05,
      "eps": 33.02,
      "paid_up_capital": 27056996729.0,
      "profit": 6764646000.0,
      "net_worth_per_share": 243.3,
      "documents": [
        {
          "submitted_date": "2026-04-28",
          "path": "nabil_user/2026-04-28/report.pdf"
        }
      ]
    }
  ]
}

{
  "supplyList": [],
  "demandList": []
}

{
  "company": "Beni Hydropower Project Limited",
  "units": "10,40,000.00",
  "date_range": "1st - 15th Chaitra, 2082",
  "announcement_date": "Feb 27, 2026",
  "full_text": "...",
  "url": "https://merolagani.com/AnnouncementDetail.aspx?id=64589",
  "is_reserved_share": false,
  "reserved_for": "",
  "scraped_at": "2026-02-28T04:48:41.131628"
}

{
  "company": "...",
  "units": "...",
  "date_range": "...",
  "announcement_date": "...",
  "url": "...",
  "reserved_for": "...",
  "scraped_at": "ISO timestamp"
}

{
  "id": 432,
  "symbol": "CZBIL",
  "company_name": "Citizen Bank International Limited",
  "bonus_share": "8.00",
  "cash_dividend": "4.00",
  "total_dividend": "12.00",
  "announcement_date": "2025-12-24",
  "bookclose_date": "2026-01-01 [Closed]",
  "distribution_date": null,
  "bonus_listing_date": null,
  "fiscal_year": "2081/2082",
  "ltp": "193.30",
  "price_as_of": "2026-03-01",
  "scraped_at": "2026-03-02T05:12:00.000000"
}

[
  {
    "symbol": "NABIL",
    "fiscal_year": "2081/2082",
    "total_dividend": "20.00",
    "announcement_date": "2025-09-15"
  }
]

{
  "last_run_at": "2026-03-02T05:12:00.000000",
  "mode": "latest",
  "latest_count": 186,
  "history_count": 2394,
  "smoke_passed": true
}

{
  "Commercial Banks": [
    { "symbol": "ADBL", "name": "Agriculture Development Bank Limited" }
  ],
  "Hydro Power": [
    { "symbol": "AHPC", "name": "Arun Valley Hydropower Development Co. Ltd." }
  ]
}

// 200 OK - Request successful
// 404 Not Found - Endpoint doesn't exist or file missing
// 500 Server Error - Temporary server issues

// Example error handling in JavaScript
async function fetchMarketData() {
  try {
    const response = await fetch('https://shubhamnpk.github.io/yonepse/data/nepse_data.json');
    
    if (!response.ok) {
      if (response.status === 404) {
        console.error('Data not available - market may be closed');
        return [];
      }
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    
    const data = await response.json();
    return data;
  } catch (error) {
    console.error('Failed to fetch market data:', error);
    return null;
  }
}

// Recommended: Cache data and refresh periodically
class MarketDataCache {
  constructor() {
    this.cache = new Map();
    this.cacheTimeout = 5 * 60 * 1000; // 5 minutes
  }
  
  async getData(endpoint) {
    const cached = this.cache.get(endpoint);
    const now = Date.now();
    
    if (cached && (now - cached.timestamp) < this.cacheTimeout) {
      return cached.data;
    }
    
    try {
      const response = await fetch(endpoint);
      const data = await response.json();
      
      this.cache.set(endpoint, {
        data,
        timestamp: now
      });
      
      return data;
    } catch (error) {
      // Return cached data if available on error
      return cached ? cached.data : null;
    }
  }
}

class NEPSECacheManager {
  constructor() {
    this.cache = new Map();
    this.cacheTimes = new Map();
    this.marketHoursCache = 5 * 60 * 1000;  // 5 minutes during market hours
    this.offMarketCache = 30 * 60 * 1000;   // 30 minutes off market hours
  }

  async getData(endpoint, forceRefresh = false) {
    const cacheKey = endpoint;
    const now = Date.now();
    const cached = this.cache.get(cacheKey);
    const cacheTime = this.cacheTimes.get(cacheKey);
    
    // Check if cache is valid
    if (!forceRefresh && cached && cacheTime) {
      const age = now - cacheTime;
      const maxAge = await this.getCacheDuration();
      
      if (age < maxAge) {
        console.log(`Cache hit for ${endpoint} (${Math.round(age/1000)}s old)`);
        return cached;
      }
    }
    
    // Fetch fresh data
    try {
      const response = await fetch(`https://shubhamnpk.github.io/yonepse/data/${endpoint}`);
      const data = await response.json();
      
      // Update cache
      this.cache.set(cacheKey, data);
      this.cacheTimes.set(cacheKey, now);
      
      console.log(`Fresh data fetched for ${endpoint}`);
      return data;
    } catch (error) {
      console.error(`Error fetching ${endpoint}:`, error);
      // Return cached data if available on error
      return cached || null;
    }
  }
  
  async getCacheDuration() {
    try {
      const status = await this.getData('market/status.json');
      return status.is_open ? this.marketHoursCache : this.offMarketCache;
    } catch {
      return this.offMarketCache; // Default to longer cache
    }
  }
  
  // Preload common endpoints
  async preloadData() {
    const endpoints = ['nepse_data.json', 'market/indices.json', 'market/summary.json'];
    await Promise.all(endpoints.map(endpoint => this.getData(endpoint)));
  }
  
  // Clear cache manually
  clearCache(endpoint = null) {
    if (endpoint) {
      this.cache.delete(endpoint);
      this.cacheTimes.delete(endpoint);
    } else {
      this.cache.clear();
      this.cacheTimes.clear();
    }
  }
}

class NEPSERateLimiter {
  constructor(maxRequests = 10, windowMs = 60000) { // 10 requests per minute
    this.maxRequests = maxRequests;
    this.windowMs = windowMs;
    this.requests = [];
  }

  async waitForSlot() {
    const now = Date.now();
    
    // Clean old requests
    this.requests = this.requests.filter(time => now - time < this.windowMs);
    
    // Check if we can make a request
    if (this.requests.length < this.maxRequests) {
      this.requests.push(now);
      return;
    }
    
    // Calculate wait time
    const oldestRequest = Math.min(...this.requests);
    const waitTime = this.windowMs - (now - oldestRequest);
    
    if (waitTime > 0) {
      console.log(`Rate limit reached, waiting ${Math.round(waitTime/1000)}s`);
      await new Promise(resolve => setTimeout(resolve, waitTime));
      return this.waitForSlot(); // Retry
    }
  }
}

// Usage with queue for multiple requests
class NEPSEQueue {
  constructor() {
    this.rateLimiter = new NEPSERateLimiter();
    this.queue = [];
    this.processing = false;
  }
  
  async add(endpoint, priority = 0) {
    return new Promise((resolve, reject) => {
      this.queue.push({ endpoint, priority, resolve, reject });
      this.queue.sort((a, b) => b.priority - a.priority);
      this.processQueue();
    });
  }
  
  async processQueue() {
    if (this.processing || this.queue.length === 0) return;
    
    this.processing = true;
    
    while (this.queue.length > 0) {
      const item = this.queue.shift();
      
      try {
        await this.rateLimiter.waitForSlot();
        const response = await fetch(`https://shubhamnpk.github.io/yonepse/data/${item.endpoint}`);
        const data = await response.json();
        item.resolve(data);
      } catch (error) {
        item.reject(error);
      }
    }
    
    this.processing = false;
  }
}