laplace-api 3.0.1 → 4.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laplace-api",
-  "version": "3.0.1",
+  "version": "4.0.0",
   "description": "Client library for Laplace API for the US stock market and BIST (Istanbul stock market) fundamental financial data.",
   "main": "index.js",
   "scripts": {

package/src/client/broker.ts

@@ -0,0 +1,175 @@
+import { PaginatedResponse } from "./capital_increase";
+import { Client } from "./client";
+import { Region } from "./collections";
+import { AssetClass, AssetType } from "./stocks";
+
+export enum BrokerSort {
+  NetAmount = "netAmount",
+  TotalAmount = "totalAmount",
+  TotalVolume = "totalVolume",
+  TotalBuyAmount = "totalBuyAmount",
+  TotalBuyVolume = "totalBuyVolume",
+  TotalSellAmount = "totalSellAmount",
+  TotalSellVolume = "totalSellVolume",
+}
+
+export enum SortDirection {
+  Desc = "desc",
+  Asc = "asc",
+}
+
+export interface Broker {
+  id: number;
+  symbol: string;
+  name: string;
+  longName: string;
+  logo: string;
+}
+
+export interface BrokerStock {
+  symbol: string;
+  name: string;
+  id: string;
+  assetType: AssetType;
+  assetClass: AssetClass;
+}
+
+export interface BrokerStats {
+  totalBuyAmount: number;
+  totalSellAmount: number;
+  netAmount: number;
+  totalBuyVolume: number;
+  totalSellVolume: number;
+  totalVolume: number;
+  totalAmount: number;
+  averageCost?: number;
+}
+
+export interface BrokerItem extends BrokerStats {
+  broker?: Broker;
+  stock?: BrokerStock;
+}
+
+export interface BrokerList extends PaginatedResponse<BrokerItem> {
+  totalStats: BrokerStats;
+}
+
+export class BrokerClient extends Client {
+  private static readonly BASE = "/api/v1/brokers";
+
+  async getBrokers(
+    region: Region,
+    page: number,
+    size: number
+  ): Promise<PaginatedResponse<Broker>> {
+    return this.sendRequest<PaginatedResponse<Broker>>({
+      method: "GET",
+      url: BrokerClient.BASE,
+      params: {
+        region,
+        page,
+        size,
+      },
+    });
+  }
+
+  async getMarketStocks(
+    region: Region,
+    sortBy: BrokerSort,
+    sortDirection: SortDirection,
+    fromDate: string,
+    toDate: string,
+    page: number,
+    size: number
+  ): Promise<BrokerList> {
+    return this.sendRequest<BrokerList>({
+      method: "GET",
+      url: BrokerClient.BASE + "/market/stock",
+      params: {
+        region,
+        sortBy,
+        sortDirection,
+        fromDate,
+        toDate,
+        page,
+        size,
+      },
+    });
+  }
+
+  async getMarketBrokers(
+    region: Region,
+    sortBy: BrokerSort,
+    sortDirection: SortDirection,
+    fromDate: string,
+    toDate: string,
+    page: number,
+    size: number
+  ): Promise<BrokerList> {
+    return this.sendRequest<BrokerList>({
+      method: "GET",
+      url: BrokerClient.BASE + "/market",
+      params: {
+        region,
+        sortBy,
+        sortDirection,
+        fromDate,
+        toDate,
+        page,
+        size,
+      },
+    });
+  }
+
+  async getBrokersByStock(
+    symbol: string,
+    region: Region,
+    sortBy: BrokerSort,
+    sortDirection: SortDirection,
+    fromDate: string,
+    toDate: string,
+    page: number,
+    size: number
+  ): Promise<BrokerList> {
+    return this.sendRequest<BrokerList>({
+      method: "GET",
+      url: BrokerClient.BASE + "/" + symbol,
+      params: {
+        symbol,
+        region,
+        sortBy,
+        sortDirection,
+        fromDate,
+        toDate,
+        page,
+        size,
+      },
+    });
+  }
+
+  async getStocksByBroker(
+    symbol: string,
+    region: Region,
+    sortBy: BrokerSort,
+    sortDirection: SortDirection,
+    fromDate: string,
+    toDate: string,
+    page: number,
+    size: number
+  ): Promise<BrokerList> {
+    return this.sendRequest<BrokerList>({
+      method: "GET",
+      url: BrokerClient.BASE + "/stock/" + symbol,
+      params: {
+        symbol,
+        region,
+        sortBy,
+        sortDirection,
+        fromDate,
+        toDate,
+        page,
+        size,
+      },
+    });
+  }
+}

package/src/client/capital_increase.ts

@@ -1,5 +1,5 @@
 import { Client } from './client';
-import { Region, Locale } from './collections';
+import { Region } from './collections';
 
 // type PaginatedResponse[T any] struct {
 // 	RecordCount int `json:"recordCount"`
@@ -18,23 +18,23 @@ export interface CapitalIncrease {
   currentCapital: string;
   targetCapital: string;
   types: string[];
-  spkApplicationResult: string;
-  spkApplicationDate: string;
-  spkApprovalDate: string;
-  paymentDate: string;
-  registrationDate: string;
+  spkApplicationResult: string | null;
+  spkApplicationDate: string | null;
+  spkApprovalDate: string | null;
+  paymentDate: string | null;
+  registrationDate: string | null;
   specifiedCurrency: string;
   symbol: string;
-  relatedDisclosureIDs: number[];
+  relatedDisclosureIds: number[];
   rightsRate: string;
   rightsPrice: string;
   rightsTotalAmount: string;
-  rightsStartDate: string;
-  rightsEndDate: string;
-  rightsLastSellDate: string;
+  rightsStartDate: string | null;
+  rightsEndDate: string | null;
+  rightsLastSellDate: string | null;
   bonusRate: string;
   bonusTotalAmount: string;
-  bonusStartDate: string;
+  bonusStartDate: string | null;
   bonusDividendRate: string;
   bonusDividendTotalAmount: string;
   externalCapitalIncreaseAmount: string;

package/src/client/collections.ts

@@ -26,14 +26,14 @@ export enum SortBy {
 export interface Collection {
   id: string;
   title: string;
-  description: string;
-  region: Region[];
-  assetClass: string;
+  description?: string;
+  region?: Region[];
+  assetClass?: string;
   imageUrl: string;
   avatarUrl: string;
   numStocks: number;
-  image: string;
-  order: number;
+  image?: string;
+  order?: number;
   status?: string;
   metaData?: Record<string, any>;
 }
@@ -71,10 +71,6 @@ export class CollectionClient extends Client {
     return this.getAllCollectionsPrivate(CollectionType.Theme, region, locale);
   }
 
-  async getAllCustomThemes(region: Region, locale: Locale): Promise<Collection[]> {
-    return this.getAllCollectionsPrivate(CollectionType.CustomTheme, region, locale);
-  }
-
   async getAllCollections(region: Region, locale: Locale): Promise<Collection[]> {
     return this.getAllCollectionsPrivate(CollectionType.Collection, region, locale);
   }
@@ -91,10 +87,6 @@ export class CollectionClient extends Client {
     return this.getCollectionDetailPrivate(id, CollectionType.Theme, region, locale);
   }
 
-  async getCustomThemeDetail(id: string, region: Region, locale: Locale): Promise<CollectionDetail> {
-    return this.getCollectionDetailPrivate(id, CollectionType.CustomTheme, region, locale);
-  }
-
   async getCollectionDetail(id: string, region: Region, locale: Locale): Promise<CollectionDetail> {
     return this.getCollectionDetailPrivate(id, CollectionType.Collection, region, locale);
   }

package/src/client/financial_fundamentals.ts

@@ -3,37 +3,39 @@ import { Region } from './collections';
 import { AssetClass, AssetType } from './stocks';
 
 export interface StockDividend {
-  date: Date;
-  dividendAmount: number;
-  dividendRatio: number;
-  netDividendAmount: number;
-  netDividendRatio: number;
+  date: string;
+  netAmount: number;
+  netRatio: number;
+  grossAmount: number;
+  grossRatio: number;
   priceThen: number;
+  stoppageRatio: number;
+  stoppageAmount: number;
 }
 
 export interface StockStats {
-  previousClose: number;
-  marketCap: number;
-  peRatio: number;
-  pbRatio: number;
-  yearLow: number;
-  yearHigh: number;
-  weeklyReturn: number;
-  monthlyReturn: number;
-  '3MonthReturn': number;
-  ytdReturn: number;
-  yearlyReturn: number;
-  '3YearReturn': number;
-  '5YearReturn': number;
+  previousClose?: number;
+  marketCap?: number;
+  peRatio?: number;
+  pbRatio?: number;
+  yearLow?: number;
+  yearHigh?: number;
+  weeklyReturn?: number;
+  monthlyReturn?: number;
+  "3MonthReturn"?: number;
+  ytdReturn?: number;
+  yearlyReturn?: number;
+  "3YearReturn"?: number;
+  "5YearReturn"?: number;
   symbol: string;
-  latestPrice: number;
-  dailyChange: number;
-  dayLow: number;
-  dayHigh: number;
-  lowerPriceLimit: number;
-  upperPriceLimit: number;
-  dayOpen: number;
-  eps: number;
+  latestPrice?: number;
+  dailyChange?: number;
+  dayLow?: number;
+  dayHigh?: number;
+  lowerPriceLimit?: number;
+  upperPriceLimit?: number;
+  dayOpen?: number;
+  eps?: number;
 }
 
 export enum StockStatsKey {
@@ -59,8 +61,8 @@ export enum StockStatsKey {
 export interface TopMover {
   symbol: string;
   change: number;
-  assetClass: AssetClass;
-  assetType: AssetType
+  assetClass?: AssetClass;
+  assetType?: AssetType;
 }
 
 export enum TopMoverDirection {
@@ -69,10 +71,13 @@ export enum TopMoverDirection {
 }
 
 export class FinancialFundamentalsClient extends Client {
-  async getStockDividends(symbol: string, region: Region): Promise<StockDividend[]> {
-    const url = new URL(`${this['baseUrl']}/api/v1/stock/dividends`);
-    url.searchParams.append('symbol', symbol);
-    url.searchParams.append('region', region);
+  async getStockDividends(
+    symbol: string,
+    region: Region
+  ): Promise<StockDividend[]> {
+    const url = new URL(`${this["baseUrl"]}/api/v2/stock/dividends`);
+    url.searchParams.append("symbol", symbol);
+    url.searchParams.append("region", region);
 
     return this.sendRequest<StockDividend[]>({
       method: 'GET',
@@ -91,13 +96,16 @@ export class FinancialFundamentalsClient extends Client {
     });
   }
 
-  async getTopMovers(region: Region, page: number, pageSize: number, direction: TopMoverDirection, assetType?: AssetType): Promise<TopMover[]> {
+  async getTopMovers(region: Region, page: number, pageSize: number, direction: TopMoverDirection, assetType?: AssetType,
+    assetClass?: AssetClass
+  ): Promise<TopMover[]> {
     const url = new URL(`${this['baseUrl']}/api/v2/stock/top-movers`);
     url.searchParams.append('region', region);
     url.searchParams.append('page', page.toString());
     url.searchParams.append('pageSize', pageSize.toString());
     url.searchParams.append('direction', direction);
     if (assetType) url.searchParams.append('assetType', assetType);
+    if (assetClass) url.searchParams.append("assetClass", assetClass);
 
     return this.sendRequest<TopMover[]>({
       method: 'GET',

package/src/client/financial_ratios.ts

@@ -1,16 +1,21 @@
-import { Client } from './client';
-import { Region, Locale } from './collections';
+import { Client } from "./client";
+import { Region, Locale } from "./collections";
 
-export interface StockSectorFinancialRatioComparison {
-  metric_name: string;
+export enum RatioComparisonPeerType {
+  Industry = "industry",
+  Sector = "sector"
+}
+
+export interface StockPeerFinancialRatioComparison {
+  metricName: string;
   normalizedValue: number;
-  details: StockSectorFinancialRatioComparisonDetail[];
+  data: StockPeerFinancialRatioComparisonData[];
 }
 
-export interface StockSectorFinancialRatioComparisonDetail {
+export interface StockPeerFinancialRatioComparisonData {
   slug: string;
   value: number;
-  sectorAverage: number;
+  average: number;
 }
 
 export interface StockHistoricalRatios {
@@ -22,7 +27,7 @@ export interface StockHistoricalRatios {
   currency: Currency;
   format: HistoricalRatiosFormat;
   name: string;
-  items: StockHistoricalRatiosData[]
+  items: StockHistoricalRatiosData[];
 }
 
 export interface StockHistoricalRatiosData {
@@ -34,7 +39,7 @@ export interface StockHistoricalRatiosData {
 export enum HistoricalRatiosFormat {
   CURRENCY = "currency",
   PERCENTAGE = "percentage",
-  DECIMAL = "decimal"
+  DECIMAL = "decimal",
 }
 
 export enum HistoricalRatiosKey {
@@ -114,15 +119,16 @@ export enum HistoricalRatiosKey {
 }
 
 export interface StockHistoricalRatiosDescription {
+  id: number;
+  format: string;
+  currency: string;
   slug: string;
+  createdAt: string;
+  updatedAt: string;
   name: string;
-  suffix: string;
-  prefix: string;
-  display: boolean;
-  precision: number;
-  multiplier: number;
   description: string;
-  interval: string;
+  locale: string;
+  isRealtime: boolean;
 }
 
 export interface HistoricalFinancialSheets {
@@ -139,8 +145,6 @@ export interface HistoricalFinancialSheetRow {
   value: number;
   lineCodeId: number;
   indentLevel: number;
-  firstAncestorLineCodeId: number;
-  sectionLineCodeId: number;
 }
 
 export enum FinancialSheetType {
@@ -167,24 +171,36 @@ export interface FinancialSheetDate {
   year: number;
 }
 
-export class FinancialClient extends Client  {
-  async getFinancialRatioComparison(symbol: string, region: Region): Promise<StockSectorFinancialRatioComparison[]> {
-    const url = new URL(`${this['baseUrl']}/api/v1/stock/financial-ratio-comparison`);
-    url.searchParams.append('symbol', symbol);
-    url.searchParams.append('region', region);
-
-    return this.sendRequest<StockSectorFinancialRatioComparison[]>({
-      method: 'GET',
+export class FinancialClient extends Client {
+  async getFinancialRatioComparison(
+    symbol: string,
+    region: Region,
+    peerType: RatioComparisonPeerType
+  ): Promise<StockPeerFinancialRatioComparison[]> {
+    const url = new URL(
+      `${this["baseUrl"]}/api/v2/stock/financial-ratio-comparison`
+    );
+    url.searchParams.append("symbol", symbol);
+    url.searchParams.append("region", region);
+    url.searchParams.append("peerType", peerType);
+
+    return this.sendRequest<StockPeerFinancialRatioComparison[]>({
+      method: "GET",
       url: url.toString(),
     });
   }
 
-  async getHistoricalRatios(symbol: string, keys: HistoricalRatiosKey[], region: Region, locale: Locale): Promise<StockHistoricalRatios[]> {
-    const url = new URL(`${this['baseUrl']}/api/v2/stock/historical-ratios`);
-    url.searchParams.append('symbol', symbol);
-    url.searchParams.append('region', region);
-    url.searchParams.append('locale', locale);
-    url.searchParams.append('slugs', keys.join(','));
+  async getHistoricalRatios(
+    symbol: string,
+    keys: HistoricalRatiosKey[],
+    region: Region,
+    locale: Locale
+  ): Promise<StockHistoricalRatios[]> {
+    const url = new URL(`${this["baseUrl"]}/api/v2/stock/historical-ratios`);
+    url.searchParams.append("symbol", symbol);
+    url.searchParams.append("region", region);
+    url.searchParams.append("locale", locale);
+    url.searchParams.append("slugs", keys.join(","));
 
     return this.sendRequest<StockHistoricalRatios[]>({
       method: 'GET',
@@ -192,10 +208,15 @@ export class FinancialClient extends Client  {
     });
   }
 
-  async getHistoricalRatiosDescriptions(locale: Locale, region: Region): Promise<StockHistoricalRatiosDescription[]> {
-    const url = new URL(`${this['baseUrl']}/api/v1/stock/historical-ratios/descriptions`);
-    url.searchParams.append('locale', locale);
-    url.searchParams.append('region', region);
+  async getHistoricalRatiosDescriptions(
+    locale: Locale,
+    region: Region
+  ): Promise<StockHistoricalRatiosDescription[]> {
+    const url = new URL(
+      `${this["baseUrl"]}/api/v2/stock/historical-ratios/descriptions`
+    );
+    url.searchParams.append("locale", locale);
+    url.searchParams.append("region", region);
 
     return this.sendRequest<StockHistoricalRatiosDescription[]>({
       method: 'GET',

package/src/client/funds.ts

@@ -0,0 +1,139 @@
+import { Client } from "./client";
+import { Region } from "./collections";
+import { AssetType } from "./stocks";
+
+export enum FundType {
+  STOCK_UMBRELLA_FUND = "STOCK_UMBRELLA_FUND",
+  VARIABLE_UMBRELLA_FUND = "VARIABLE_UMBRELLA_FUND",
+  PARTICIPATION_UMBRELLA_FUND = "PARTICIPATION_UMBRELLA_FUND",
+  FLEXIBLE_UMBRELLA_FUND = "FLEXIBLE_UMBRELLA_FUND",
+  FUND_BASKET_UMBRELLA_FUND = "FUND_BASKET_UMBRELLA_FUND",
+  MONEY_MARKET_UMBRELLA_FUND = "MONEY_MARKET_UMBRELLA_FUND",
+  PRECIOUS_METALS_UMBRELLA_FUND = "PRECIOUS_METALS_UMBRELLA_FUND",
+  DEBT_INSTRUMENTS_UMBRELLA_FUND = "DEBT_INSTRUMENTS_UMBRELLA_FUND",
+  MIXED_UMBRELLA_FUND = "MIXED_UMBRELLA_FUND",
+  UNKNOWN_FUND_TYPE = "UNKNOWN_FUND_TYPE",
+}
+
+export interface Fund {
+  assetType: AssetType;
+  name: string;
+  symbol: string;
+  active: boolean;
+  managementFee: number;
+  riskLevel: number;
+  fundType: FundType;
+  ownerSymbol: string;
+}
+
+export interface FundStats {
+  yearBeta: number;
+  yearStdev: number;
+  ytdReturn: number;
+  yearMomentum: number;
+  yearlyReturn: number;
+  monthlyReturn: number;
+  fiveYearReturn: number;
+  sixMonthReturn: number;
+  threeYearReturn: number;
+  threeMonthReturn: number;
+}
+
+export enum FundContentType {
+  BIST_STOCK = "BIST_STOCK",
+  OTHER_STOCK = "OTHER_STOCK",
+  UNKNOWN = "UNKNOWN",
+}
+
+export enum FundAssetCategory {
+  OTHER = "OTHER",
+  EQUITY = "EQUITY",
+  LIQUID_DEPOSIT = "LIQUID_DEPOSIT",
+  FUTURES_CASH_COLLATERAL = "FUTURES_CASH_COLLATERAL",
+  INVESTMENT_FUNDS = "INVESTMENT_FUNDS",
+  PARTICIPATION_ACCOUNT = "PARTICIPATION_ACCOUNT",
+  PRECIOUS_METALS = "PRECIOUS_METALS",
+  CORPORATE_BOND = "CORPORATE_BOND",
+  CURRENCY = "CURRENCY",
+  PUBLIC_EXTERNAL_DEBT_SECURITIES = "PUBLIC_EXTERNAL_DEBT_SECURITIES",
+  PRIVATE_SECTOR_EXTERNAL_DEBT_SECURITIES = "PRIVATE_SECTOR_EXTERNAL_DEBT_SECURITIES",
+  PUBLIC_LEASE_CERTIFICATES = "PUBLIC_LEASE_CERTIFICATES",
+  PRIVATE_SECTOR_LEASE_CERTIFICATES = "PRIVATE_SECTOR_LEASE_CERTIFICATES",
+  FOREIGN_EXCHANGE_TRADED_FUNDS = "FOREIGN_EXCHANGE_TRADED_FUNDS",
+  PUBLIC_LEASE_CERTIFICATES_CURRENCY = "PUBLIC_LEASE_CERTIFICATES_CURRENCY",
+  GOVERNMENT_BOND = "GOVERNMENT_BOND",
+  PRIVATE_SECTOR_LEASE_CERTIFICATES_CURRENCY = "PRIVATE_SECTOR_LEASE_CERTIFICATES_CURRENCY",
+  UNKNOWN = "UNKNOWN",
+}
+
+export interface FundAsset {
+  type: FundContentType;
+  symbol: string;
+  wholePercentage: number;
+  categoryPercentage: number;
+}
+
+export interface FundDistribution {
+  categories: FundCategoryDistribution[];
+}
+
+export interface FundCategoryDistribution {
+  category: FundAssetCategory;
+  percentage: number;
+  assets?: FundAsset[];
+}
+
+export enum HistoricalFundPricePeriod {
+  OneWeek = "1H",
+  OneMonth = "1A",
+  ThreeMonth = "3A",
+  OneYear = "1Y",
+  ThreeYear = "3Y",
+  FiveYear = "5Y",
+}
+
+export interface FundHistoricalPrice {
+  aum: number;
+  date: string;
+  price: number;
+  shareCount: number;
+  investorCount: number;
+}
+
+export class FundsClient extends Client {
+  async getFunds(region: Region, page: number, pageSize: number) {
+    return this.sendRequest<Fund[]>({
+      method: "GET",
+      url: `/api/v1/fund`,
+      params: { region, page, pageSize },
+    });
+  }
+
+  async getFundStats(symbol: string, region: Region) {
+    return this.sendRequest<FundStats>({
+      method: "GET",
+      url: `/api/v1/fund/stats`,
+      params: { symbol, region },
+    });
+  }
+
+  async getFundDistribution(symbol: string, region: Region) {
+    return this.sendRequest<FundDistribution>({
+      method: "GET",
+      url: `/api/v1/fund/distribution`,
+      params: { symbol, region },
+    });
+  }
+
+  async getHistoricalFundPrices(
+    symbol: string,
+    region: Region,
+    period: HistoricalFundPricePeriod
+  ) {
+    return this.sendRequest<FundHistoricalPrice[]>({
+      method: "GET",
+      url: `/api/v1/fund/price`,
+      params: { symbol, region, period },
+    });
+  }
+}

package/src/client/key-insights.ts

@@ -0,0 +1,17 @@
+import { Client } from "./client";
+import { Region } from "./collections";
+
+export interface KeyInsight {
+  symbol: string;
+  insight: string;
+}
+
+export class KeyInsightClient extends Client {
+  async getKeyInsights(symbol: string, region: Region) {
+    return this.sendRequest<KeyInsight>({
+      method: "GET",
+      url: "/api/v1/key-insight",
+      params: { symbol, region },
+    });
+  }
+}