borsajs 0.1.1 → 0.1.4

package/README.md

@@ -2,9 +2,7 @@
 
 **[Türkçe](README.md) | [English](README.en.md)**
 
-> **TypeScript/JavaScript port of [borsapy](https://github.com/saidsurucu/borsapy)** - Python versiyonundan ilham alınarak geliştirilmiştir.
-
-Türk finansal piyasaları için TypeScript/JavaScript veri kütüphanesi. BIST hisseleri, döviz, kripto, yatırım fonları ve ekonomik veriler için yfinance benzeri API.
+Türkiye finansal piyasaları için TypeScript/JavaScript veri kütüphanesi. BIST hisseleri, döviz, kripto, yatırım fonları ve ekonomik veriler için finansal veri kaynaklarından veri çeken kütüphanedir.
 
 ## Kurulum
 
@@ -15,29 +13,268 @@ npm install borsajs
 ## Hızlı Başlangıç
 
 ```typescript
-import { Ticker, FX, Crypto, Fund, Inflation, download } from 'borsajs';
+import { Ticker, FX, Crypto, Fund, Inflation, symbols, cryptoSymbols } from 'borsajs';
 
-// Hisse senedi verisi
+// Hisse senedi
 const stock = new Ticker('THYAO');
 const info = await stock.getInfo();
-const history = await stock.getHistory({ period: '1mo' });
+// → { symbol: 'THYAO', last: 274.25, change: 5.75, changePercent: 2.14, ... }
 
 // Döviz
 const usd = new FX('USD');
 const rate = await usd.getCurrent();
+// → { symbol: 'USD', last: 43.02, updateTime: '2026-01-02T20:59:58.000Z' }
 
 // Kripto
 const btc = new Crypto('BTCTRY');
 const price = await btc.getCurrent();
+// → { symbol: 'BTCTRY', last: 3839080, bid: 3839136, ask: 3840481, ... }
+
+// Sembol listeleri
+const stockList = symbols();          // → ['AKBNK', 'ARCLK', 'ASELS', ...] (80 hisse)
+const cryptoList = await cryptoSymbols(); // → ['BTCTRY', 'ETHTRY', ...] (173 çift)
+```
+
+## API Referansı
+
+### Ticker (Hisse Senedi)
+
+```typescript
+import { Ticker } from 'borsajs';
+
+const stock = new Ticker('THYAO');
+const info = await stock.getInfo();
+```
+
+**Response:**
+```json
+{
+  "symbol": "THYAO",
+  "last": 274.25,
+  "open": 271,
+  "high": 274.25,
+  "low": 269.75,
+  "close": 268.5,
+  "volume": 7853192164.25,
+  "change": 5.75,
+  "changePercent": 2.14,
+  "updateTime": "2026-01-01T21:00:00.000Z",
+  "type": "stock"
+}
+```
+
+### FX (Döviz & Emtia)
+
+```typescript
+import { FX, fxSymbols } from 'borsajs';
+
+console.log(fxSymbols);
+// → ['USD', 'EUR', 'GBP', 'JPY', 'CHF', 'CAD', 'AUD', 'gram-altin', 'ceyrek-altin', ...]
+
+const usd = new FX('USD');
+const current = await usd.getCurrent();
+```
+
+**Response:**
+```json
+{
+  "symbol": "USD",
+  "last": 43.0237,
+  "open": 0,
+  "high": 0,
+  "low": 0,
+  "updateTime": "2026-01-02T20:59:58.000Z"
+}
+```
+
+### Crypto (Kripto Para)
+
+```typescript
+import { Crypto, cryptoSymbols } from 'borsajs';
+
+const pairs = await cryptoSymbols('TRY');
+// → ['BTCTRY', 'ETHTRY', 'XRPTRY', ...] (173 çift)
+
+const btc = new Crypto('BTCTRY');
+const current = await btc.getCurrent();
+```
+
+**Response:**
+```json
+{
+  "symbol": "BTCTRY",
+  "last": 3839080,
+  "open": 3822360,
+  "high": 3891234,
+  "low": 3793804,
+  "bid": 3839136,
+  "ask": 3840481,
+  "volume": 36.22,
+  "change": 18121,
+  "changePercent": 0.44,
+  "timestamp": 1767432414317
+}
+```
+
+### Index (Endeksler)
+
+```typescript
+import { Index, indexSymbols } from 'borsajs';
+
+console.log(indexSymbols);
+// → ['XU100', 'XU050', 'XU030', 'XBANK', 'XUSIN', ...]
+
+const xu100 = new Index('XU100');
+const info = await xu100.getInfo();
+```
+
+**Response:**
+```json
+{
+  "symbol": "XU100",
+  "last": 11498.38,
+  "open": 11296.52,
+  "high": 11498.38,
+  "low": 11296.52,
+  "change": 236.86,
+  "changePercent": 2.1,
+  "name": "BIST 100",
+  "type": "index"
+}
+```
 
-// Yatırım fonu
-const fund = new Fund('AAK');
-const fundInfo = await fund.getInfo();
+### Inflation (Enflasyon)
+
+```typescript
+import { Inflation } from 'borsajs';
 
-// Enflasyon
 const inflation = new Inflation();
 const latest = await inflation.getLatest();
-const calculation = await inflation.calculate(100000, '2020-01', '2024-01');
+const calc = await inflation.calculate(100000, '2020-01', '2024-01');
+```
+
+**Response (Latest):**
+```json
+{
+  "date": "2025-10-31",
+  "yearMonth": "11-2025",
+  "yearlyInflation": 31.07,
+  "monthlyInflation": 0.87,
+  "type": "TUFE"
+}
+```
+
+**Response (Calculate):**
+```json
+{
+  "startDate": "2020-01",
+  "endDate": "2024-01",
+  "initialValue": 100000,
+  "finalValue": 444399.15,
+  "totalYears": 4,
+  "totalChange": 344.4,
+  "avgYearlyInflation": 45.19
+}
+```
+
+### KAP (Kamu Aydınlatma Platformu)
+
+```typescript
+import { getKapProvider } from 'borsajs';
+
+const kap = getKapProvider();
+const companies = await kap.getCompanies();
+const search = await kap.search('türk hava');
+```
+
+**Response (Companies):**
+```json
+[
+  {
+    "ticker": "THYAO",
+    "name": "TÜRK HAVA YOLLARI A.O.",
+    "city": "İSTANBUL"
+  }
+]
+```
+
+**Response (Search):**
+```json
+[
+  {
+    "ticker": "THYAO",
+    "name": "TÜRK HAVA YOLLARI A.O.",
+    "city": "İSTANBUL"
+  }
+]
+```
+
+**KAP Bildirimleri:**
+```typescript
+const disclosures = await kap.getDisclosures('THYAO', 5);
+```
+
+**Response (Disclosures):**
+```json
+[
+  {
+    "date": "29.12.2025 19:21:18",
+    "title": "Haber ve Söylentilere İlişkin Açıklama",
+    "disclosureIndex": 1530826,
+    "url": "https://www.kap.org.tr/tr/Bildirim/1530826"
+  }
+]
+```
+
+**Beklenen Bildirim Takvimi:**
+```typescript
+const calendar = await kap.getCalendar('THYAO');
+```
+
+**Response (Calendar):**
+```json
+[
+  {
+    "startDate": "01.01.2026",
+    "endDate": "11.03.2026",
+    "subject": "Finansal Rapor",
+    "period": "Yıllık",
+    "year": "2025"
+  }
+]
+```
+
+**Şirket Detayları:**
+```typescript
+const details = await kap.getCompanyDetails('THYAO');
+```
+
+**Response (Company Details):**
+```json
+{
+  "sector": "ULAŞTIRMA VE DEPOLAMA",
+  "market": "YILDIZ PAZAR",
+  "website": "www.turkishairlines.com / http://investor.turkishairlines.com"
+}
+```
+
+### Symbols (Sembol Listeleri)
+
+```typescript
+import { symbols, searchSymbols, cryptoSymbols, fxSymbols, indexSymbols } from 'borsajs';
+
+// Hisse sembolleri
+const stocks = symbols();           // → 80 hisse
+const banks = searchSymbols('BNK'); // → ['AKBNK', 'YKBNK', 'SKBNK']
+
+// Kripto sembolleri
+const crypto = await cryptoSymbols('TRY'); // → 173 çift
+
+// FX sembolleri
+console.log(fxSymbols); // → 19 döviz/emtia
+
+// Endeks sembolleri
+console.log(indexSymbols); // → 19 endeks
 ```
 
 ## Veri Kaynakları
@@ -52,20 +289,15 @@ Bu kütüphane aşağıdaki kamuya açık veri kaynaklarından yararlanmaktadır
 | Crypto | BtcTurk | [btcturk.com](https://www.btcturk.com/) | Kripto para verileri |
 | 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 |
 | VIOP | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Vadeli işlem ve opsiyon |
-| Companies | KAP | [kap.org.tr](https://www.kap.org.tr/) | Şirket bilgileri ve bildirimleri |
 
 ## ⚠️ Önemli Uyarılar
 
-### Veri Kaynakları Hakkında
-Bu kütüphane aracılığıyla erişilen veriler, yukarıda listelenen üçüncü taraf kaynaklara aittir. Veriler ilgili kaynakların kullanım koşullarına tabidir.
-
 ### Ticari Kullanım
 **Bu kütüphane yalnızca kişisel ve eğitim amaçlı kullanım için tasarlanmıştır.**
 
-Ticari kullanım için:
-- İlgili veri kaynağı sağlayıcılarından açık izin almanız gerekmektedir
-- Bu kütüphanenin yazarları, verilerin izinsiz ticari kullanımından sorumlu değildir
+Ticari kullanım için ilgili veri kaynağı sağlayıcılarından açık izin almanız gerekmektedir.
 
 ### Referans Proje
 Bu proje, [borsapy](https://github.com/saidsurucu/borsapy) Python kütüphanesinden ilham alınarak TypeScript'e port edilmiştir.

package/dist/index.d.ts

@@ -13,7 +13,8 @@ export { Index, indices, index, INDICES } from './index-class.js';
 export type { IndexInfo } from './index-class.js';
 export { Inflation } from './inflation.js';
 export { VIOP } from './viop.js';
-export { companies, searchCompanies } from './market.js';
+export { symbols, searchSymbols, cryptoSymbols, fxSymbols, indexSymbols } from './market.js';
+export type { FXSymbol, IndexSymbol, StockSymbol, Company } from './market.js';
 export { BorsajsError, TickerNotFoundError, DataNotAvailableError, APIError, AuthenticationError, RateLimitError, InvalidPeriodError, InvalidIntervalError } from './exceptions.js';
 export { Cache, TTL, getCache } from './cache.js';
 export type { OHLCVData, HistoryOptions } from './providers/paratic.js';
@@ -21,6 +22,6 @@ export type { TickerData } from './providers/btcturk.js';
 export type { FXCurrentData, FXHistoryData } from './providers/dovizcom.js';
 export type { FundInfo, FundHistoryData, SearchResult } from './providers/tefas.js';
 export type { InflationLatest, InflationData, InflationCalculation } from './providers/tcmb.js';
-export type { ContractData, Company, Disclosure } from './providers/kap.js';
+export type { ContractData, Disclosure } from './providers/kap.js';
 export declare const VERSION = "0.1.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEpL,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC5E,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE5E,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7F,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEpL,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC5E,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEnE,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -9,7 +9,7 @@ export { Fund, searchFunds } from './fund.js';
 export { Index, indices, index, INDICES } from './index-class.js';
 export { Inflation } from './inflation.js';
 export { VIOP } from './viop.js';
-export { companies, searchCompanies } from './market.js';
+export { symbols, searchSymbols, cryptoSymbols, fxSymbols, indexSymbols } from './market.js';
 export { BorsajsError, TickerNotFoundError, DataNotAvailableError, APIError, AuthenticationError, RateLimitError, InvalidPeriodError, InvalidIntervalError } from './exceptions.js';
 export { Cache, TTL, getCache } from './cache.js';
 export const VERSION = '0.1.0';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEpL,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AASlD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEpL,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AASlD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/market.d.ts

@@ -1,7 +1,36 @@
+declare const BIST_STOCKS: readonly ["THYAO", "GARAN", "AKBNK", "YKBNK", "ISCTR", "HALKB", "VAKBN", "SAHOL", "SISE", "TUPRS", "TCELL", "EREGL", "BIMAS", "KOZAL", "PETKM", "ASELS", "KCHOL", "TOASO", "FROTO", "ARCLK", "MGROS", "TTKOM", "ENKAI", "PGSUS", "TAVHL", "EKGYO", "SASA", "DOHOL", "VESTL", "GUBRF", "KOZAA", "KLMSC", "KRDMD", "ODAS", "TSKB", "AKSEN", "AEFES", "KONTR", "CEMTS", "LOGO", "OYAKC", "ULKER", "CIMSA", "ALARK", "TURSG", "ISGYO", "GESAN", "SOKM", "DOAS", "OTKAR", "BTCIM", "BRISA", "NETAS", "IHLGM", "TKFEN", "TRGYO", "AYGAZ", "CCOLA", "MAVI", "HEKTS", "ANSGR", "ZOREN", "AGHOL", "ISMEN", "ANHYT", "IPEKE", "KORDS", "KARTN", "KLRHO", "BINHO", "AKSA", "NUHCM", "ALBRK", "SKBNK", "TMSN", "VERUS", "SISEB", "POLHO", "GLYHO", "TUREX"];
+export interface Company {
+    ticker: string;
+    name?: string;
+    sector?: string;
+}
 /**
- * Market-level functions for BIST data.
+ * Get common BIST stock symbols.
+ * @returns Array of stock symbols
  */
-import { Company } from './providers/kap.js';
-export declare function companies(): Promise<Company[]>;
-export declare function searchCompanies(query: string): Promise<Company[]>;
+export declare function symbols(): string[];
+/**
+ * Search stocks by ticker pattern.
+ * @param query - Search query (matches start of ticker)
+ * @returns Matching symbols
+ */
+export declare function searchSymbols(query: string): string[];
+/**
+ * Get available cryptocurrency pairs.
+ * @param quote - Quote currency (default: 'TRY')
+ * @returns Array of trading pairs (e.g., ['BTCTRY', 'ETHTRY', ...])
+ */
+export declare function cryptoSymbols(quote?: string): Promise<string[]>;
+/**
+ * Available FX symbols.
+ */
+export declare const fxSymbols: readonly ["USD", "EUR", "GBP", "JPY", "CHF", "CAD", "AUD", "gram-altin", "ceyrek-altin", "yarim-altin", "tam-altin", "cumhuriyet-altini", "gumus", "ons", "BRENT", "WTI", "diesel", "gasoline", "lpg"];
+/**
+ * Available BIST indices.
+ */
+export declare const indexSymbols: readonly ["XU100", "XU050", "XU030", "XBANK", "XUSIN", "XHOLD", "XUTEK", "XGIDA", "XTRZM", "XULAS", "XSGRT", "XMANA", "XKMYA", "XMADN", "XELKT", "XTEKS", "XILTM", "XUMAL", "XUTUM"];
+export type FXSymbol = typeof fxSymbols[number];
+export type IndexSymbol = typeof indexSymbols[number];
+export type StockSymbol = typeof BIST_STOCKS[number];
+export {};
 //# sourceMappingURL=market.d.ts.map

package/dist/market.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../src/market.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAkB,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7D,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAA4C;AACjG,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAA2C"}
+{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../src/market.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,WAAW,itBASP,CAAC;AAEX,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,MAAM,EAAE,CAElC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAGrD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE5E;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,wMAUZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,sLAIf,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC"}

package/dist/market.js

@@ -1,7 +1,62 @@
 /**
  * Market-level functions for BIST data.
  */
-import { getKapProvider } from './providers/kap.js';
-export async function companies() { return getKapProvider().getCompanies(); }
-export async function searchCompanies(query) { return getKapProvider().search(query); }
+import { getBtcTurkProvider } from './providers/btcturk.js';
+// Static list of major BIST stocks (commonly traded)
+const BIST_STOCKS = [
+    'THYAO', 'GARAN', 'AKBNK', 'YKBNK', 'ISCTR', 'HALKB', 'VAKBN', 'SAHOL', 'SISE', 'TUPRS',
+    'TCELL', 'EREGL', 'BIMAS', 'KOZAL', 'PETKM', 'ASELS', 'KCHOL', 'TOASO', 'FROTO', 'ARCLK',
+    'MGROS', 'TTKOM', 'ENKAI', 'PGSUS', 'TAVHL', 'EKGYO', 'SASA', 'DOHOL', 'VESTL', 'GUBRF',
+    'KOZAA', 'KLMSC', 'KRDMD', 'ODAS', 'TSKB', 'AKSEN', 'AEFES', 'KONTR', 'CEMTS', 'LOGO',
+    'OYAKC', 'ULKER', 'CIMSA', 'ALARK', 'TURSG', 'ISGYO', 'GESAN', 'SOKM', 'DOAS', 'OTKAR',
+    'BTCIM', 'BRISA', 'NETAS', 'IHLGM', 'TKFEN', 'TRGYO', 'AYGAZ', 'CCOLA', 'MAVI', 'HEKTS',
+    'ANSGR', 'ZOREN', 'AGHOL', 'ISMEN', 'ANHYT', 'IPEKE', 'KORDS', 'KARTN', 'KLRHO', 'BINHO',
+    'AKSA', 'NUHCM', 'ALBRK', 'SKBNK', 'TMSN', 'VERUS', 'SISEB', 'POLHO', 'GLYHO', 'TUREX',
+];
+/**
+ * Get common BIST stock symbols.
+ * @returns Array of stock symbols
+ */
+export function symbols() {
+    return [...BIST_STOCKS].sort();
+}
+/**
+ * Search stocks by ticker pattern.
+ * @param query - Search query (matches start of ticker)
+ * @returns Matching symbols
+ */
+export function searchSymbols(query) {
+    const q = query.toUpperCase();
+    return BIST_STOCKS.filter(s => s.includes(q));
+}
+/**
+ * Get available cryptocurrency pairs.
+ * @param quote - Quote currency (default: 'TRY')
+ * @returns Array of trading pairs (e.g., ['BTCTRY', 'ETHTRY', ...])
+ */
+export async function cryptoSymbols(quote = 'TRY') {
+    return getBtcTurkProvider().getPairs(quote);
+}
+/**
+ * Available FX symbols.
+ */
+export const fxSymbols = [
+    // Currencies
+    'USD', 'EUR', 'GBP', 'JPY', 'CHF', 'CAD', 'AUD',
+    // Precious Metals
+    'gram-altin', 'ceyrek-altin', 'yarim-altin', 'tam-altin', 'cumhuriyet-altini',
+    'gumus', 'ons',
+    // Energy
+    'BRENT', 'WTI',
+    // Fuel
+    'diesel', 'gasoline', 'lpg',
+];
+/**
+ * Available BIST indices.
+ */
+export const indexSymbols = [
+    'XU100', 'XU050', 'XU030', 'XBANK', 'XUSIN', 'XHOLD', 'XUTEK', 'XGIDA',
+    'XTRZM', 'XULAS', 'XSGRT', 'XMANA', 'XKMYA', 'XMADN', 'XELKT', 'XTEKS',
+    'XILTM', 'XUMAL', 'XUTUM',
+];
 //# sourceMappingURL=market.js.map

package/dist/market.js.map

@@ -1 +1 @@
-{"version":3,"file":"market.js","sourceRoot":"","sources":["../src/market.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAW,MAAM,oBAAoB,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,SAAS,KAAyB,OAAO,cAAc,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AACjG,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAa,IAAwB,OAAO,cAAc,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"market.js","sourceRoot":"","sources":["../src/market.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,qDAAqD;AACrD,MAAM,WAAW,GAAG;IAChB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IACvF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACxF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACvF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;IACrF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IACtF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IACvF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACxF,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;CAChF,CAAC;AAQX;;;GAGG;AACH,MAAM,UAAU,OAAO;IACnB,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACvC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,KAAK;IACrD,OAAO,kBAAkB,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,aAAa;IACb,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IAC/C,kBAAkB;IAClB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB;IAC7E,OAAO,EAAE,KAAK;IACd,SAAS;IACT,OAAO,EAAE,KAAK;IACd,OAAO;IACP,QAAQ,EAAE,UAAU,EAAE,KAAK;CACrB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACtE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACtE,OAAO,EAAE,OAAO,EAAE,OAAO;CACnB,CAAC"}

package/dist/providers/kap.d.ts

@@ -5,17 +5,38 @@ export interface Company {
     city: string;
 }
 export interface Disclosure {
-    id: string;
-    date: Date;
+    date: string;
     title: string;
-    type: string;
+    disclosureIndex: number;
     url: string;
 }
+export interface CalendarEvent {
+    startDate: string;
+    endDate: string;
+    subject: string;
+    period: string;
+    year: string;
+}
+export interface CompanyDetails {
+    sector?: string;
+    market?: string;
+    website?: string;
+}
 export declare class KapProvider extends BaseProvider {
     private static readonly BASE_URL;
+    private static readonly DISCLOSURE_URL;
+    private static readonly CALENDAR_API_URL;
+    private static readonly COMPANY_INFO_URL;
+    private oidMap;
+    private oidCacheTime;
+    private readonly CACHE_DURATION;
     constructor(options?: ProviderOptions);
     getCompanies(): Promise<Company[]>;
     search(query: string): Promise<Company[]>;
+    getMemberOid(symbol: string): Promise<string | null>;
+    getDisclosures(symbol: string, limit?: number): Promise<Disclosure[]>;
+    getCalendar(symbol: string): Promise<CalendarEvent[]>;
+    getCompanyDetails(symbol: string): Promise<CompanyDetails>;
 }
 export interface ContractData {
     code: string;

package/dist/providers/kap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kap.d.ts","sourceRoot":"","sources":["../../src/providers/kap.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAI1D,MAAM,WAAW,OAAO;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AACxE,MAAM,WAAW,UAAU;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;CAAE;AAEjG,qBAAa,WAAY,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAChD,OAAO,CAAC,EAAE,eAAe;IAE/B,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAiBlC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAKlD;AAED,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CAAE;AAEvJ,qBAAa,YAAa,SAAQ,YAAY;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAuE;gBAC3F,OAAO,CAAC,EAAE,eAAe;IAE/B,UAAU,CAAC,QAAQ,GAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,WAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyB3G,UAAU,CAAC,QAAQ,GAAE,KAAK,GAAG,OAAO,GAAG,OAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAsBzF;AAGD,wBAAgB,cAAc,IAAI,WAAW,CAA2E;AAExH,wBAAgB,eAAe,IAAI,YAAY,CAA+E"}
+{"version":3,"file":"kap.d.ts","sourceRoot":"","sources":["../../src/providers/kap.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAI1D,MAAM,WAAW,OAAO;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AACxE,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;CAAE;AAClG,MAAM,WAAW,aAAa;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AACrH,MAAM,WAAW,cAAc;IAAG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAAE;AAEvF,qBAAa,WAAY,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAoD;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAmE;IAC3G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAiD;IACzF,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAY;gBAE/B,OAAO,CAAC,EAAE,eAAe;IAE/B,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAoClC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAMzC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuCpD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAyCzE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA2DrD,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAyCnE;AAED,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CAAE;AAEvJ,qBAAa,YAAa,SAAQ,YAAY;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAuE;gBAC3F,OAAO,CAAC,EAAE,eAAe;IAE/B,UAAU,CAAC,QAAQ,GAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,WAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyB3G,UAAU,CAAC,QAAQ,GAAE,KAAK,GAAG,OAAO,GAAG,OAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAsBzF;AAGD,wBAAgB,cAAc,IAAI,WAAW,CAA2E;AAExH,wBAAgB,eAAe,IAAI,YAAY,CAA+E"}