borsajs 0.1.4 → 0.2.0

package/LICENSE

@@ -210,12 +210,12 @@ https://github.com/saidsurucu/borsapy
 This library accesses publicly available data from the following sources:
 
 - Paratic (https://www.paratic.com/) - Stock and index data
-- doviz.com (https://www.doviz.com/) - Forex, gold, and commodity data
+- doviz.com (https://www.doviz.com/) - Forex, gold, commodity, economic calendar, and bond data
 - BtcTurk (https://www.btcturk.com/) - Cryptocurrency data
 - TEFAS (https://www.tefas.gov.tr/) - Investment fund data
 - TCMB (https://www.tcmb.gov.tr/) - Inflation data
 - KAP (https://www.kap.org.tr/) - Company information
-- İş Yatırım (https://www.isyatirim.com.tr/) - Derivatives (VIOP) data
+- İş Yatırım (https://www.isyatirim.com.tr/) - Derivatives (VIOP) and stock screening data
 
 ================================================================================
                         IMPORTANT NOTICE FOR COMMERCIAL USE

package/README.en.md

@@ -10,6 +10,27 @@ A TypeScript/JavaScript data library for Turkey financial markets. yfinance-like
 npm install borsajs
 ```
 
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+  - [Ticker (Stocks)](#ticker-stocks)
+  - [FX (Forex & Commodities)](#fx-forex--commodities)
+  - [Crypto](#crypto)
+  - [Index](#index)
+  - [Fund (Investment Funds)](#fund-investment-funds)
+  - [Inflation](#inflation)
+  - [KAP (Public Disclosure Platform)](#kap-public-disclosure-platform)
+  - [EconomicCalendar](#economiccalendar)
+  - [Bond](#bond)
+  - [Screener](#screener)
+  - [VIOP (Derivatives)](#viop-derivatives)
+  - [Symbols](#symbols)
+  - [Download (Multiple Tickers)](#download-multiple-tickers)
+- [Data Sources](#data-sources)
+- [Important Notices](#️-important-notices)
+- [License](#license)
+
 ## Quick Start
 
 ```typescript
@@ -39,6 +60,8 @@ const cryptoList = await cryptoSymbols(); // → ['BTCTRY', 'ETHTRY', ...] (173
 
 ### Ticker (Stocks)
 
+**Get real-time BIST stock prices and volume data in seconds.** The Ticker API provides instant access to current price, daily change, volume, and OHLC (Open-High-Low-Close) values for any stock. Perfect for technical analysis, portfolio tracking, or automated trading strategies.
+
 ```typescript
 import { Ticker } from 'borsajs';
 
@@ -83,6 +106,8 @@ const history = await stock.getHistory({ period: '5d', interval: '1d' });
 
 ### FX (Forex & Commodities)
 
+**Track live exchange rates and commodity prices effortlessly.** Access real-time data for major currencies (USD, EUR, GBP) and precious metals (gold, silver). Essential for currency arbitrage, gold investment strategies, or exchange rate monitoring.
+
 ```typescript
 import { FX, fxSymbols } from 'borsajs';
 
@@ -107,6 +132,8 @@ const current = await usd.getCurrent();
 
 ### Crypto
 
+**Live data from Turkey's largest crypto exchange, BtcTurk.** Access price, volume, and change information for 173 cryptocurrency pairs. The fastest way to track Bitcoin, Ethereum, and other cryptos in Turkish Lira.
+
 ```typescript
 import { Crypto, cryptoSymbols } from 'borsajs';
 
@@ -136,6 +163,8 @@ const current = await btc.getCurrent();
 
 ### Index
 
+**Monitor BIST indices in real-time.** Get current values and percentage changes for market and sector indices like XU100, XU030, XBANK. Essential for analyzing market trends and comparing sectoral performance.
+
 ```typescript
 import { Index, indexSymbols } from 'borsajs';
 
@@ -163,6 +192,8 @@ const info = await xu100.getInfo();
 
 ### Fund (Investment Funds)
 
+**Search and track Turkish investment funds from TEFAS.** Access fund prices, returns, and performance metrics. Compare funds and make informed investment decisions with official data.
+
 ```typescript
 import { Fund, searchFunds } from 'borsajs';
 
@@ -186,6 +217,8 @@ const info = await fund.getInfo();
 
 ### Inflation
 
+**Access official inflation data directly from TCMB (Central Bank).** Query monthly and annual CPI rates, or calculate inflation between any two dates. Critical for evaluating investments on a real return basis.
+
 ```typescript
 import { Inflation } from 'borsajs';
 
@@ -220,6 +253,14 @@ const calc = await inflation.calculate(100000, '2020-01', '2024-01');
 
 ### KAP (Public Disclosure Platform)
 
+**One-stop access to official company announcements and disclosures.** Query disclosures, expected report calendars, and corporate information for all 731 BIST companies. Make investment decisions based on official company statements.
+
+**Features:**
+- 🏢 **731 BIST Companies** - Complete list with details
+- 📢 **Live Disclosures** - All company announcements
+- 📅 **Disclosure Calendar** - Financial report dates
+- 🏛️ **Corporate Info** - Sector, market, website
+
 ```typescript
 import { getKapProvider } from 'borsajs';
 
@@ -299,8 +340,109 @@ const details = await kap.getCompanyDetails('THYAO');
 }
 ```
 
+### EconomicCalendar
+
+**Track global economic indicators and events in real-time.** Access economic data, reports, and announcements from TR, US, EU, and other countries. Make investment decisions based on macroeconomic indicators.
+
+```typescript
+import { EconomicCalendar, economicCalendar } from 'borsajs';
+
+const cal = new EconomicCalendar();
+const events = await cal.thisWeek();
+const highEvents = await cal.highImportance({ period: '1w' });
+
+// Convenience function
+const trEvents = await economicCalendar({ country: 'TR', importance: 'high' });
+```
+
+**Response:**
+```json
+[
+  {
+    "date": "2026-01-15T00:00:00.000Z",
+    "time": "10:00",
+    "country": "Türkiye",
+    "countryCode": "TR",
+    "event": "Inflation (YoY)",
+    "importance": "high",
+    "period": "December",
+    "actual": "64.77%",
+    "forecast": "65.00%",
+    "previous": "61.98%"
+  }
+]
+```
+
+**Supported Countries:** TR, US, EU, DE, GB, JP, CN, FR, IT, CA, AU, CH
+
+### Bond
+
+**Track Turkish government bond yields in real-time.** Access yields and changes for 2, 5, and 10-year bonds. Get risk-free rate for DCF calculations.
+
+```typescript
+import { Bond, bonds, riskFreeRate } from 'borsajs';
+
+// Get all bonds
+const allBonds = await bonds();
+// → [{ maturity: '2Y', yield: 36.71, ... }, ...]
+
+// Specific bond
+const bond10y = new Bond('10Y');
+const yieldRate = await bond10y.getYieldRate();
+const yieldDecimal = await bond10y.getYieldDecimal();
+
+// Risk-free rate for DCF
+const rfr = await riskFreeRate();
+// → 0.2905 (for 29.05%)
+```
+
+**Response (bonds):**
+```json
+[
+  {
+    "name": "TR 2 Year Bond Rate",
+    "maturity": "2Y",
+    "yield": 36.71,
+    "yieldDecimal": 0.3671,
+    "change": 0.17,
+    "changePct": 0.47
+  }
+]
+```
+
+### Screener
+
+**Screen BIST stocks with 40+ criteria.** Find stocks by market cap, P/E ratio, dividend yield, ROE, and more. Use 15 ready-made templates or custom filters.
+
+```typescript
+import { Screener, screenStocks, sectors } from 'borsajs';
+
+// Use template
+const highDivStocks = await screenStocks({ template: 'high_dividend' });
+
+// Custom filters
+const customStocks = await screenStocks({
+  marketCapMin: 1000,  // Min 1000M TL
+  peMax: 15,           // Max 15 P/E
+  dividendYieldMin: 3, // Min 3% dividend
+});
+
+// Fluent API
+const screener = new Screener();
+const results = await screener
+  .addFilter('market_cap', { min: 215000 })
+  .addFilter('roe', { min: 15 })
+  .run();
+```
+
+**Templates:** `small_cap`, `mid_cap`, `large_cap`, `high_dividend`, `high_upside`, `buy_recommendation`, `high_net_margin`, `low_pe`, `high_roe`, `high_foreign_ownership`
+
+**Filter Criteria:** price, market_cap, pe, pb, ev_ebitda, dividend_yield, roe, roa, net_margin, return_1w, return_1m, foreign_ratio, upside_potential, and 30+ more criteria.
+
 ### Symbols
 
+**Access all market symbols in a single call.** Get comprehensive lists of stocks, cryptocurrencies, currencies, and indices. Perfect starting point for automated data collection or screening algorithms.
+
 ```typescript
 import { symbols, searchSymbols, cryptoSymbols, fxSymbols, indexSymbols } from 'borsajs';
 
@@ -320,17 +462,52 @@ console.log(indexSymbols); // → 19 indices
 
 ### VIOP (Derivatives)
 
+**Track Turkish derivatives market (futures and options).** Access real-time data for stock futures, index futures, currency futures, and options contracts. Essential for hedging strategies and derivatives trading.
+
 ```typescript
 import { VIOP } from 'borsajs';
 
 const viop = new VIOP();
+
+// Get all futures
 const futures = await viop.getFutures();
+
+// Stock futures
+const stockFutures = await viop.getStockFutures();
+
+// Index futures (XU100, XU030, etc.)
+const indexFutures = await viop.getIndexFutures();
+
+// Currency futures (USD, EUR)
+const currencyFutures = await viop.getCurrencyFutures();
+
+// Commodity futures (Gold)
+const commodityFutures = await viop.getCommodityFutures();
+
+// Options
 const options = await viop.getOptions();
-const thyao = await viop.getBySymbol('THYAO');
+
+// Contracts for specific stock
+const thyaoContracts = await viop.getBySymbol('THYAO');
+```
+
+**Response (Contract Data):**
+```json
+{
+  "code": "THYAO",
+  "contract": "THYAO0226",
+  "price": 275.5,
+  "change": 1.25,
+  "volumeTl": 15420000,
+  "volumeQty": 56000,
+  "category": "stock"
+}
 ```
 
 ### Download (Multiple Tickers)
 
+**Batch download historical data for multiple stocks at once.** Efficient way to collect OHLCV data for portfolio analysis or backtesting strategies. Get data for dozens of stocks in a single request.
+
 ```typescript
 import { download, Tickers } from 'borsajs';
 
@@ -351,6 +528,9 @@ This library accesses publicly available data from the following sources:
 | Fund | TEFAS | [tefas.gov.tr](https://www.tefas.gov.tr/) | Investment fund data |
 | Inflation | TCMB | [tcmb.gov.tr](https://www.tcmb.gov.tr/) | Inflation data |
 | KAP | KAP | [kap.org.tr](https://www.kap.org.tr/) | Company information |
+| EconomicCalendar | doviz.com | [doviz.com](https://www.doviz.com/) | Economic calendar |
+| Bond | doviz.com | [doviz.com](https://www.doviz.com/) | Bond yields |
+| Screener | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Stock screening |
 | VIOP | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Futures and options |
 
 ## ⚠️ Important Notices

package/README.md

@@ -10,6 +10,26 @@ Türkiye finansal piyasaları için TypeScript/JavaScript veri kütüphanesi. BI
 npm install borsajs
 ```
 
+## İçindekiler
+
+- [Hızlı Başlangıç](#hızlı-başlangıç)
+- [API Referansı](#api-referansı)
+  - [Ticker (Hisse Senedi)](#ticker-hisse-senedi)
+  - [FX (Döviz & Emtia)](#fx-döviz--emtia)
+  - [Crypto (Kripto Para)](#crypto-kripto-para)
+  - [Index (Endeksler)](#index-endeksler)
+  - [Fund (Yatırım Fonları)](#fund-yatırım-fonları)
+  - [Inflation (Enflasyon)](#inflation-enflasyon)
+  - [KAP (Kamu Aydınlatma Platformu)](#kap-kamu-aydınlatma-platformu)
+  - [EconomicCalendar (Ekonomik Takvim)](#economiccalendar-ekonomik-takvim)
+  - [Bond (Tahvil Getirileri)](#bond-tahvil-getirileri)
+  - [Screener (Hisse Tarayıcı)](#screener-hisse-tarayıcı)
+  - [VIOP (Vadeli İşlem ve Opsiyon Piyasası)](#viop-vadeli-i̇şlem-ve-opsiyon-piyasası)
+  - [Symbols (Sembol Listeleri)](#symbols-sembol-listeleri)
+- [Veri Kaynakları](#veri-kaynakları)
+- [Önemli Uyarılar](#️-önemli-uyarılar)
+- [Lisans](#lisans)
+
 ## Hızlı Başlangıç
 
 ```typescript
@@ -39,6 +59,8 @@ const cryptoList = await cryptoSymbols(); // → ['BTCTRY', 'ETHTRY', ...] (173
 
 ### Ticker (Hisse Senedi)
 
+**BIST hisselerinin anlık fiyat ve hacim verilerine saniyeler içinde ulaşın.** Ticker API, bir hisse senedinin güncel fiyatı, günlük değişimi, işlem hacmi ve OHLC (açılış-en yüksek-en düşük-kapanış) değerlerini kolayca almanızı sağlar. Teknik analiz, portföy takibi veya otomatik alım-satım stratejileri için ideal.
+
 ```typescript
 import { Ticker } from 'borsajs';
 
@@ -65,6 +87,8 @@ const info = await stock.getInfo();
 
 ### FX (Döviz & Emtia)
 
+**Döviz kurları ve emtia fiyatlarını canlı takip edin.** FX API ile USD, EUR gibi döviz kurlarının yanı sıra altın, gümüş ve ons fiyatlarına anında erişebilirsiniz. Kur takibi, döviz arbitrajı veya altın yatırım stratejileri için güvenilir veri kaynağı.
+
 ```typescript
 import { FX, fxSymbols } from 'borsajs';
 
@@ -89,6 +113,8 @@ const current = await usd.getCurrent();
 
 ### Crypto (Kripto Para)
 
+**Türkiye'nin en büyük kripto borsası BtcTurk'ten anlık veriler.** 173 kripto para çiftinin fiyat, hacim ve değişim bilgilerine erişin. Bitcoin, Ethereum ve diğer kripto paraların TRY karşılığını takip etmek için en hızlı yol.
+
 ```typescript
 import { Crypto, cryptoSymbols } from 'borsajs';
 
@@ -118,6 +144,8 @@ const current = await btc.getCurrent();
 
 ### Index (Endeksler)
 
+**BIST endekslerini gerçek zamanlı izleyin.** XU100, XU030, XBANK gibi sektör ve piyasa endekslerinin güncel değerleri ve yüzdesel değişimlerini alın. Piyasa trendlerini analiz etmek ve sektörel performansı karşılaştırmak için vazgeçilmez.
+
 ```typescript
 import { Index, indexSymbols } from 'borsajs';
 
@@ -145,6 +173,8 @@ const info = await xu100.getInfo();
 
 ### Inflation (Enflasyon)
 
+**TCMB'nin resmi enflasyon verilerine doğrudan erişin.** Aylık ve yıllık TÜFE oranlarını sorgulayın veya geçmiş tarihler arasında enflasyon hesaplayın. Yatırım kararlarınızı reel getiri bazında değerlendirmek için kritik.
+
 ```typescript
 import { Inflation } from 'borsajs';
 
@@ -179,6 +209,14 @@ const calc = await inflation.calculate(100000, '2020-01', '2024-01');
 
 ### KAP (Kamu Aydınlatma Platformu)
 
+**Şirketlerin resmi açıklamalarına ve bildirimlerine tek noktadan ulaşın.** KAP API ile 731 BIST şirketinin bildirimlerini, beklenen rapor takvimlerini ve kurumsal bilgilerini sorgulayabilirsiniz. Yatırım kararlarınızı şirketlerin resmi açıklamaları ışığında alın.
+
+**Özellikler:**
+- 🏢 **731 BIST şirketi** - Tüm halka açık şirketlerin listesi ve bilgileri
+- 📢 **Anlık Bildirimler** - Şirketlerin KAP'a yaptığı tüm açıklamalar
+- 📅 **Bildirim Takvimi** - Finansal rapor ve açıklama tarihleri
+- 🏛️ **Kurumsal Bilgiler** - Sektör, pazar, web sitesi bilgileri
+
 ```typescript
 import { getKapProvider } from 'borsajs';
 
@@ -258,8 +296,153 @@ const details = await kap.getCompanyDetails('THYAO');
 }
 ```
 
+### EconomicCalendar (Ekonomik Takvim)
+
+**Küresel ekonomik göstergeleri ve etkinlikleri gerçek zamanlı takip edin.** EconomicCalendar API ile TR, US, EU ve diğer ülkelerin önemli ekonomik verilerini, raporlarını ve açıklamalarını önceden öğrenin. Yatırım kararlarınızı makro ekonomik göstergeler ışığında alın.
+
+```typescript
+import { EconomicCalendar, economicCalendar } from 'borsajs';
+
+const cal = new EconomicCalendar();
+const events = await cal.thisWeek();
+const highEvents = await cal.highImportance({ period: '1w' });
+
+// Convenience fonksiyonu
+const trEvents = await economicCalendar({ country: 'TR', importance: 'high' });
+```
+
+**Response:**
+```json
+[
+  {
+    "date": "2026-01-15T00:00:00.000Z",
+    "time": "10:00",
+    "country": "Türkiye",
+    "countryCode": "TR",
+    "event": "Enflasyon (YoY)",
+    "importance": "high",
+    "period": "Aralık",
+    "actual": "64.77%",
+    "forecast": "65.00%",
+    "previous": "61.98%"
+  }
+]
+```
+
+**Desteklenen Ülkeler:** TR, US, EU, DE, GB, JP, CN, FR, IT, CA, AU, CH
+
+### Bond (Tahvil Getirileri)
+
+**Türk devlet tahvillerinin getirilerini anlık izleyin.** Bond API ile 2, 5 ve 10 yıllık tahvil faizlerini ve değişimlerini takip edin. DCF hesaplamaları için risksiz getiri oranına kolayca erişin.
+
+```typescript
+import { Bond, bonds, riskFreeRate } from 'borsajs';
+
+// Tüm tahvilleri al
+const allBonds = await bonds();
+// → [{ maturity: '2Y', yield: 36.71, ... }, ...]
+
+// Belirli bir tahvil
+const bond10y = new Bond('10Y');
+const yieldRate = await bond10y.getYieldRate();
+const yieldDecimal = await bond10y.getYieldDecimal();
+
+// DCF hesaplamaları için risksiz getiri
+const rfr = await riskFreeRate();
+// → 0.2905 (29.05% için)
+```
+
+**Response (bonds):**
+```json
+[
+  {
+    "name": "TR 2 Yıllık Tahvil Faizi",
+    "maturity": "2Y",
+    "yield": 36.71,
+    "yieldDecimal": 0.3671,
+    "change": 0.17,
+    "changePct": 0.47
+  }
+]
+```
+
+### Screener (Hisse Tarayıcı)
+
+**BIST hisselerini 40+ farklı kritere göre tarayın.** Screener API ile piyasa değeri, F/K oranı, temettü verimi, ROE ve daha fazla kritere göre hisse senedi bulun. 15 hazır şablon veya özel filtreler ile yatırım stratejinize uygun hisseleri keşfedin.
+
+```typescript
+import { Screener, screenStocks, sectors } from 'borsajs';
+
+// Hazır şablon kullan
+const highDivStocks = await screenStocks({ template: 'high_dividend' });
+
+// Özel filtreler
+const customStocks = await screenStocks({
+  marketCapMin: 1000,  // Min 1000M TL
+  peMax: 15,           // Maks 15 F/K
+  dividendYieldMin: 3, // Min %3 temettü
+});
+
+// Fluent API
+const screener = new Screener();
+const results = await screener
+  .addFilter('market_cap', { min: 215000 })
+  .addFilter('roe', { min: 15 })
+  .run();
+```
+
+**Hazır Şablonlar:** `small_cap`, `mid_cap`, `large_cap`, `high_dividend`, `high_upside`, `buy_recommendation`, `high_net_margin`, `low_pe`, `high_roe`, `high_foreign_ownership`
+
+**Filtre Kriterleri:** price, market_cap, pe, pb, ev_ebitda, dividend_yield, roe, roa, net_margin, return_1w, return_1m, foreign_ratio, upside_potential ve 30+ kriter daha.
+
+### VIOP (Vadeli İşlem ve Opsiyon Piyasası)
+
+**Türk türev piyasasını gerçek zamanlı takip edin.** Hisse senedi vadeli işlemleri, endeks vadeli işlemleri, döviz ve emtia kontratlarına anında erişin. Riskten korunma (hedging) stratejileri ve türev ürün ticareti için vazgeçilmez.
+
+```typescript
+import { VIOP } from 'borsajs';
+
+const viop = new VIOP();
+
+// Tüm vadeli işlemleri al
+const futures = await viop.getFutures();
+
+// Hisse senedi vadeli işlemleri
+const stockFutures = await viop.getStockFutures();
+
+// Endeks vadeli işlemleri
+const indexFutures = await viop.getIndexFutures();
+
+// Döviz vadeli işlemleri
+const currencyFutures = await viop.getCurrencyFutures();
+
+// Emtia vadeli işlemleri
+const commodityFutures = await viop.getCommodityFutures();
+
+// Opsiyonlar
+const options = await viop.getOptions();
+
+// Belirli bir hisse için kontratlar
+const thyaoContracts = await viop.getBySymbol('THYAO');
+```
+
+**Response (Contract Data):**
+```json
+{
+  "code": "THYAO",
+  "contract": "THYAO0226",
+  "price": 275.5,
+  "change": 1.25,
+  "volumeTl": 15420000,
+  "volumeQty": 56000,
+  "category": "stock"
+}
+```
+
 ### Symbols (Sembol Listeleri)
 
+**Tüm piyasa sembollerine tek çağrıda erişin.** Hisse senetleri, kripto paralar, dövizler ve endekslerin sembol listelerini alın. Otomatik veri çekme veya tarama algoritmaları için mükemmel başlangıç noktası.
+
 ```typescript
 import { symbols, searchSymbols, cryptoSymbols, fxSymbols, indexSymbols } from 'borsajs';
 
@@ -290,6 +473,9 @@ Bu kütüphane aşağıdaki kamuya açık veri kaynaklarından yararlanmaktadır
 | Fund | TEFAS | [tefas.gov.tr](https://www.tefas.gov.tr/) | Yatırım fonu verileri |
 | Inflation | TCMB | [tcmb.gov.tr](https://www.tcmb.gov.tr/) | Enflasyon verileri |
 | KAP | KAP | [kap.org.tr](https://www.kap.org.tr/) | Şirket bilgileri |
+| EconomicCalendar | doviz.com | [doviz.com](https://www.doviz.com/) | Ekonomik takvim |
+| Bond | doviz.com | [doviz.com](https://www.doviz.com/) | Tahvil getirileri |
+| Screener | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Hisse tarama |
 | VIOP | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Vadeli işlem ve opsiyon |
 
 ## ⚠️ Önemli Uyarılar

package/dist/bond.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Bond class for Turkish government bond yields - yfinance-like API.
+ */
+import { type BondData } from './providers/dovizcom-bond.js';
+export type { BondData };
+export declare class Bond {
+    private maturity;
+    private provider;
+    private dataCache;
+    /**
+     * Create a Bond instance for a specific maturity.
+     *
+     * @param maturity - Bond maturity (2Y, 5Y, or 10Y)
+     *
+     * @example
+     * ```typescript
+     * const bond = new Bond('10Y');
+     * const yieldRate = await bond.getYieldRate();
+     * ```
+     */
+    constructor(maturity: '2Y' | '5Y' | '10Y');
+    private getData;
+    /**
+     * Get the bond maturity.
+     */
+    getMaturity(): string;
+    /**
+     * Get the bond name.
+     */
+    getName(): Promise<string>;
+    /**
+     * Get the current yield as percentage.
+     * @returns Yield rate as percentage (e.g., 28.03 for 28.03%)
+     */
+    getYieldRate(): Promise<number>;
+    /**
+     * Get the current yield as decimal.
+     * @returns Yield rate as decimal (e.g., 0.2803 for 28.03%)
+     */
+    getYieldDecimal(): Promise<number>;
+    /**
+     * Get the absolute change in yield.
+     */
+    getChange(): Promise<number | null>;
+    /**
+     * Get the percentage change in yield.
+     */
+    getChangePct(): Promise<number | null>;
+    /**
+     * Get all bond information.
+     */
+    getInfo(): Promise<BondData>;
+}
+/**
+ * Get all Turkish government bond yields.
+ *
+ * @returns Array of bond data
+ *
+ * @example
+ * ```typescript
+ * import { bonds } from 'borsajs';
+ * const allBonds = await bonds();
+ * ```
+ */
+export declare function bonds(): Promise<BondData[]>;
+/**
+ * Get the risk-free rate for Turkish market (10Y bond yield).
+ *
+ * @returns 10-year government bond yield as decimal
+ *
+ * @example
+ * ```typescript
+ * import { riskFreeRate } from 'borsajs';
+ * const rfr = await riskFreeRate();
+ * console.log(`Risk-free rate: ${(rfr * 100).toFixed(2)}%`);
+ * ```
+ */
+export declare function riskFreeRate(): Promise<number | null>;
+//# sourceMappingURL=bond.d.ts.map

package/dist/bond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bond.d.ts","sourceRoot":"","sources":["../src/bond.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,qBAAa,IAAI;IACb,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAyB;IAE1C;;;;;;;;;;OAUG;gBACS,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK;YAI3B,OAAO;IAOrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAKhC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKzC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK5C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;CAGrC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAGjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG3D"}