Planned API Endpoints
We are building a comprehensive set of APIs for Nepali data. Here is what is on the roadmap.
Nepali Date Converter API
Convert dates between Bikram Sambat (BS) and Gregorian (AD) calendars programmatically. Supports date ranges from 2000 BS to 2099 BS.
GET /api/v1/date/convertNRB Forex Rate API
Access Nepal Rastra Bank foreign exchange rates via a clean JSON API. Supports all NRB-listed currencies with historical data.
GET /api/v1/forex/ratesGold & Silver Price API
Get daily gold (hallmark, tejabi) and silver prices from FENEGOSIDA. Includes historical price data for charts and analysis.
GET /api/v1/gold/pricesNepali Calendar API
Full Nepali calendar data including tithis, festivals, public holidays, panchang, and important dates for any BS year.
GET /api/v1/calendarCode Examples
Simple integration in any language. Here are examples for the Date Converter API.
cURL
curl -X GET "https://api.onlinecalculatornepal.com/v1/date/convert?from=bs&date=2083-01-15" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"JavaScript (Fetch)
const response = await fetch(
"https://api.onlinecalculatornepal.com/v1/date/convert?from=bs&date=2083-01-15",
{
headers: {
Authorization: "Bearer YOUR_API_KEY",
Accept: "application/json",
},
}
);
const data = await response.json();
console.log(data);
// {
// "bs": { "year": 2083, "month": 1, "day": 15 },
// "ad": { "year": 2026, "month": 4, "day": 28 },
// "dayOfWeek": "Tuesday",
// "tithi": "Pratipada",
// "isHoliday": false
// }Python (Requests)
import requests
response = requests.get(
"https://api.onlinecalculatornepal.com/v1/date/convert",
params={"from": "bs", "date": "2083-01-15"},
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
},
)
data = response.json()
print(data["ad"]) # {'year': 2026, 'month': 4, 'day': 28}Pricing
Generous free tier for personal projects. Affordable Pro plan for production applications.
Free
100 requests/day
- All API endpoints
- JSON response format
- Community support
- Basic rate limiting
Pro
10,000 requests/day
- All API endpoints
- JSON & XML formats
- Priority support
- Higher rate limits
- Webhooks for price alerts
- Historical data access
Why Use Our API?
Fast & Reliable
Sub-100ms response times with 99.9% uptime SLA. CDN-backed endpoints for low latency worldwide.
Official Data Sources
Data sourced directly from NRB, FENEGOSIDA, and other official Nepali institutions. Updated daily.
Developer Friendly
Clean JSON responses, comprehensive documentation, and SDKs for JavaScript and Python. CORS enabled.
Available API Endpoints
The Online Calculator Nepal API is being built to offer comprehensive access to Nepali-specific data through clean, well-documented REST endpoints. The Date Converter API will allow you to programmatically convert dates between Bikram Sambat (BS) and Gregorian (AD) calendars, supporting the full range of dates from 2000 BS to 2099 BS with accurate day-of-week, tithi, and holiday information included in every response.
The NRB Forex Rate API will provide real-time and historical foreign exchange rates as published by Nepal Rastra Bank, supporting all NRB-listed currencies including USD, EUR, GBP, AUD, CAD, JPY, CNY, INR, and more. The Gold and Silver Price API will deliver daily hallmark gold, tejabi gold, and silver prices from FENEGOSIDA with historical data for trend analysis. The Nepali Calendar API will return full calendar data for any BS year, including tithis, festivals, public holidays, panchang details, and important dates — perfect for building Nepali calendar apps or integrating Nepali date features into existing applications.
Getting Started with Online Calculator Nepal API
Authentication: All API requests require a valid API key passed via the Authorization header as a Bearer token. You will receive your API key upon registration. The free tier provides 100 requests per day, which is sufficient for personal projects, prototyping, and small-scale applications. The Pro tier offers 10,000 requests per day for production applications.
Rate Limits: Requests are rate-limited based on your plan tier. If you exceed your daily limit, the API will return a 429 (Too Many Requests) response with a Retry-After header indicating when you can make requests again. Rate limits reset daily at midnight Nepal Standard Time (NPT, UTC+5:45).
Response Format: All endpoints return JSON by default with consistent response structures. Successful responses include the requested data along with metadata such as timestamps and source attribution. Error responses follow a standard format with error codes and human-readable messages. Pro tier users can also request XML responses by setting the Accept header to application/xml. All responses include CORS headers, making it easy to call the API directly from browser-based JavaScript applications.
API Use Cases
The Online Calculator Nepal API opens up a wide range of possibilities for developers and businesses working with Nepal-specific data. Build mobile apps that display live NRB exchange rates, gold prices, or Kalimati vegetable rates to Nepali users on the go. Integrate Nepali date conversion into your HR or payroll software so employees can view pay dates, holidays, and leave balances in Bikram Sambat. Create automated reporting dashboards that pull in daily forex rates, commodity prices, and market data without manual data entry. Set up price monitoring alerts for gold, silver, or currency fluctuations so your users are notified when rates cross a threshold. Whether you're a solo developer building a side project or a fintech company serving the Nepali market, the Online Calculator Nepal API gives you reliable, official data in a clean JSON format that is easy to integrate into any tech stack.