🚀 Nepal Stock API Proxy

A proxy service for Nepal Stock Exchange API with automatic authentication

Version 1.0.0 | Base URL: http://localhost:3000

GET /today

Get today's market data with all securities (always uses current date)

Example Request:

GET /today

Example Response:

{
  "content": [
    {
      "symbol": "NABIL",
      "securityName": "Nabil Bank Limited",
      "closePrice": 1200.50,
      "totalTradedQuantity": 50000,
      "businessDate": "2025-12-14"
    }
  ]
}

GET /api/nots/sector

Get all market sectors

Example Response:

{
  "sectors": [
    {
      "id": 37,
      "sectorDescription": "Commercial Banks",
      "regulatoryBody": "Nepal Rastra Bank"
    }
  ]
}

GET /api/nots/security

Get securities list

Query Parameters:

nonPromoter boolean Optional

Filter non-promoter securities

Example Request:

GET /api/nots/security?nonPromoter=true

GET /api/nots/company/list

Get all listed companies

GET /api/metadata/province

Get province metadata

GET /api/metadata/district

Get district metadata

GET /api/metadata/municipality

Get municipality metadata

GET /api/nots/security/promoters

Get promoter securities

GET /api/nots/security/classification

Get security classifications

GET /api/nots/security/shareGroup/

Get share groups

📝 Important Notes

All endpoints automatically handle authentication with Nepal Stock API
The proxy adds necessary headers and tokens for each request
Returns 'market is down' message when API returns 401 or other errors
All Nepal Stock API endpoints are accessible through /api/* path

⚠️ Error Responses

When the Nepal Stock API is unavailable or returns 401:

{
  "message": "market is down"
}