diff --git a/apps/docs/src/app/docs/api/economic/page.mdx b/apps/docs/src/app/docs/api/economic/page.mdx
index ddaf057..6567d1c 100644
--- a/apps/docs/src/app/docs/api/economic/page.mdx
+++ b/apps/docs/src/app/docs/api/economic/page.mdx
@@ -228,29 +228,6 @@ console.log('Latest Unemployment:', unemployment.data[0]);`}
 
 </CodeBlock>
 
-## Error Handling
-
-Always check the success property before accessing data:
-
-<CodeBlock language="typescript">
-{`const rates = await fmp.economic.getTreasuryRates({
-  from: '2024-01-01',
-  to: '2024-01-31'
-});
-
-if (rates.success && rates.data) {
-console.log('Treasury Rates:', rates.data[0]);
-} else {
-console.error('Error:', rates.error);
-console.error('Status:', rates.status);
-}`}
-
-</CodeBlock>
-
-## Rate Limiting
-
-Economic endpoints are subject to FMP's rate limits. For production applications, implement appropriate rate limiting and caching strategies.
-
 ## Data Frequency
 
 Economic data is typically updated:
@@ -269,7 +246,3 @@ Explore other endpoint categories:
 - [Calendar Endpoints](/docs/api/calendar) - Earnings and economic calendars
 - [List Endpoints](/docs/api/list) - Available symbols and instruments
 - [Examples](/docs/examples) - Practical code samples
-
----
-
-**Ready to explore financial data?** Check out the [Financial Endpoints](/docs/api/financial) for income statements, balance sheets, and more.
diff --git a/apps/docs/src/app/docs/api/insider/page.mdx b/apps/docs/src/app/docs/api/insider/page.mdx
index e3d72c4..fde8ab4 100644
--- a/apps/docs/src/app/docs/api/insider/page.mdx
+++ b/apps/docs/src/app/docs/api/insider/page.mdx
@@ -2,47 +2,57 @@
 
 The Insider Trading Endpoints provide access to real-time and historical insider trading data, transaction types, CIK mapping, beneficial ownership, and fail-to-deliver information. These endpoints help you analyze insider activity, compliance, and market sentiment.
 
+> **⚠️ Deprecation Notice:** Some endpoints use API version v4 which will be deprecated. Please use stable endpoints when available.
+
 ## Available Methods
 
 <ApiTable
   endpoints={[
     {
       method: 'GET',
-      path: '/insider-trading-rss-feed',
+      path: '/stable/insider-trading/latest',
       description: 'Get real-time insider trading RSS feed',
     },
     {
       method: 'GET',
-      path: '/insider-trading',
+      path: '/stable/insider-trading/search',
       description: 'Search insider trades by symbol, CIK, or type',
     },
     {
       method: 'GET',
-      path: '/insider-trading-transaction-type',
+      path: '/stable/insider-trading-transaction-type',
       description: 'Get all insider transaction types',
     },
-    { method: 'GET', path: '/insider-roaster', description: 'Get insiders by symbol' },
     {
       method: 'GET',
-      path: '/insider-roaster-statistic',
+      path: '/v4/insider-roaster',
+      description: 'Get insiders by symbol (DEPRECATED)',
+    },
+    {
+      method: 'GET',
+      path: '/stable/insider-trading/statistics',
       description: 'Get insider trade statistics',
     },
     {
       method: 'GET',
-      path: '/mapper-cik-name',
-      description: 'Get CIK to name mapping or search by name',
+      path: '/v4/mapper-cik-name',
+      description: 'Get CIK to name mapping or search by name (DEPRECATED)',
     },
     {
       method: 'GET',
-      path: '/mapper-cik-company/{symbol}',
-      description: 'Get CIK for a specific symbol',
+      path: '/v4/mapper-cik-company/{symbol}',
+      description: 'Get CIK for a specific symbol (DEPRECATED)',
     },
     {
       method: 'GET',
-      path: '/insider/ownership/acquisition_of_beneficial_ownership',
+      path: '/stable/acquisition-of-beneficial-ownership',
       description: 'Get beneficial ownership acquisitions',
     },
-    { method: 'GET', path: '/fail_to_deliver', description: 'Get fail to deliver data' },
+    {
+      method: 'GET',
+      path: '/v4/fail_to_deliver',
+      description: 'Get fail to deliver data (DEPRECATED)',
+    },
   ]}
 />
 
@@ -51,12 +61,23 @@ The Insider Trading Endpoints provide access to real-time and historical insider
 ## Get Insider Trading RSS Feed
 
 <CodeBlock language="typescript">{`
-const rssFeed = await fmp.insider.getInsiderTradingRSS({ page: 0 });
+const rssFeed = await fmp.insider.getInsiderTradingRSS({ page: 0, limit: 100 });
 `}</CodeBlock>
 
 <ParameterTable
   parameters={[
-    { name: 'page', type: 'number', required: true, description: 'Page number for pagination' },
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (default: 0)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Limit number of results (default: 100)',
+    },
   ]}
 />
 
@@ -67,12 +88,22 @@ const rssFeed = await fmp.insider.getInsiderTradingRSS({ page: 0 });
   success: true,
   data: [
     {
-      title: '4 - Atlantic Union Bankshares Corp (0000883948) (Issuer)',
-      fillingDate: '2022-10-05 13:43:47',
       symbol: 'AUB',
-      link: 'https://www.sec.gov/Archives/edgar/data/883948/000141588922010327/0001415889-22-010327-index.htm',
+      filingDate: '2022-10-05 13:43:47',
+      transactionDate: '2022-10-04',
       reportingCik: '0001745407',
-      issuerCik: '0000883948'
+      companyCik: '0000883948',
+      transactionType: 'S-Sale',
+      securitiesOwned: 50000,
+      reportingName: 'Atlantic Union Bankshares Corp',
+      typeOfOwner: 'officer: CEO',
+      acquisitionOrDisposition: 'D',
+      directOrIndirect: 'D',
+      formType: '4',
+      securitiesTransacted: 1000,
+      price: 25.50,
+      securityName: 'Common Stock',
+      url: 'https://www.sec.gov/Archives/edgar/data/883948/000141588922010327/0001415889-22-010327-index.htm'
     }
   ]
 }
@@ -83,7 +114,7 @@ const rssFeed = await fmp.insider.getInsiderTradingRSS({ page: 0 });
 ## Search Insider Trades
 
 <CodeBlock language="typescript">{`
-const trades = await fmp.insider.searchInsiderTrading({ symbol: 'AAPL', page: 0 });
+const trades = await fmp.insider.searchInsiderTrading({ symbol: 'AAPL', page: 0, limit: 100 });
 `}</CodeBlock>
 
 <ParameterTable
@@ -107,7 +138,18 @@ const trades = await fmp.insider.searchInsiderTrading({ symbol: 'AAPL', page: 0
       required: false,
       description: 'Transaction type to filter by',
     },
-    { name: 'page', type: 'number', required: true, description: 'Page number for pagination' },
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (default: 0)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Limit number of results (default: 100)',
+    },
   ]}
 />
 
@@ -128,11 +170,12 @@ const trades = await fmp.insider.searchInsiderTrading({ symbol: 'AAPL', page: 0
       companyCik: '0000320193',
       reportingName: "O'BRIEN DEIRDRE",
       typeOfOwner: 'officer: Senior Vice President',
-      link: 'https://www.sec.gov/Archives/edgar/data/320193/000032019322000097/0000320193-22-000097-index.htm',
-      securityName: 'Common Stock',
-      price: 141.09,
+      acquisitionOrDisposition: 'D',
+      directOrIndirect: 'D',
       formType: '4',
-      acquistionOrDisposition: 'D'
+      price: 141.09,
+      securityName: 'Common Stock',
+      url: 'https://www.sec.gov/Archives/edgar/data/320193/000032019322000097/0000320193-22-000097-index.htm'
     }
   ]
 }
@@ -152,7 +195,24 @@ const types = await fmp.insider.getTransactionTypes();
 {
   success: true,
   data: [
-    'J-Other', 'P-Purchase', 'W-Will', 'I-Discretionary', 'Z-Trust', 'F-InKind'
+    { transactionType: 'A-Award' },
+    { transactionType: 'C-Conversion' },
+    { transactionType: 'D-Return' },
+    { transactionType: 'E-ExpireShort' },
+    { transactionType: 'F-InKind' },
+    { transactionType: 'G-Gift' },
+    { transactionType: 'H-ExpireLong' },
+    { transactionType: 'I-Discretionary' },
+    { transactionType: 'J-Other' },
+    { transactionType: 'L-Small' },
+    { transactionType: 'M-Exempt' },
+    { transactionType: 'O-OutOfTheMoney' },
+    { transactionType: 'P-Purchase' },
+    { transactionType: 'S-Sale' },
+    { transactionType: 'U-Tender' },
+    { transactionType: 'W-Will' },
+    { transactionType: 'X-InTheMoney' },
+    { transactionType: 'Z-Trust' }
   ]
 }
 `}</CodeBlock>
@@ -161,6 +221,8 @@ const types = await fmp.insider.getTransactionTypes();
 
 ## Get Insiders by Symbol
 
+> **⚠️ Deprecated:** This endpoint uses API version v4 which will be deprecated. Please use stable endpoints when available.
+
 <CodeBlock language="typescript">{`
 const insiders = await fmp.insider.getInsidersBySymbol({ symbol: 'AAPL' });
 `}</CodeBlock>
@@ -207,15 +269,15 @@ const stats = await fmp.insider.getInsiderTradeStatistics({ symbol: 'AAPL' });
       cik: '0000320193',
       year: 2022,
       quarter: 4,
-      purchases: 6,
-      sales: 30,
-      buySellRatio: 0.2,
-      totalBought: 1492148,
-      totalSold: 2810029,
-      averageBought: 248691.3333,
-      averageSold: 93667.6333,
-      pPurchases: 0,
-      sSales: 15
+      acquiredTransactions: 6,
+      disposedTransactions: 30,
+      acquiredDisposedRatio: 0.2,
+      totalAcquired: 1492148,
+      totalDisposed: 2810029,
+      averageAcquired: 248691.3333,
+      averageDisposed: 93667.6333,
+      totalPurchases: 0,
+      totalSales: 15
     }
   ]
 }
@@ -225,6 +287,8 @@ const stats = await fmp.insider.getInsiderTradeStatistics({ symbol: 'AAPL' });
 
 ## Get CIK Mapper
 
+> **⚠️ Deprecated:** This endpoint uses API version v4 which will be deprecated. Please use stable endpoints when available.
+
 <CodeBlock language="typescript">{`
 const cikMapper = await fmp.insider.getCikMapper({ page: 0 });
 `}</CodeBlock>
@@ -253,6 +317,8 @@ const cikMapper = await fmp.insider.getCikMapper({ page: 0 });
 
 ## Get CIK Mapper by Name
 
+> **⚠️ Deprecated:** This endpoint uses API version v4 which will be deprecated. Please use stable endpoints when available.
+
 <CodeBlock language="typescript">{`
 const cikByName = await fmp.insider.getCikMapperByName({ name: 'zuckerberg', page: 0 });
 `}</CodeBlock>
@@ -287,6 +353,8 @@ const cikByName = await fmp.insider.getCikMapperByName({ name: 'zuckerberg', pag
 
 ## Get CIK Mapper by Symbol
 
+> **⚠️ Deprecated:** This endpoint uses API version v4 which will be deprecated. Please use stable endpoints when available.
+
 <CodeBlock language="typescript">{`
 const cikBySymbol = await fmp.insider.getCikMapperBySymbol({ symbol: 'MSFT' });
 `}</CodeBlock>
@@ -352,6 +420,8 @@ const beneficialOwnership = await fmp.insider.getBeneficialOwnership({ symbol: '
 
 ## Get Fail to Deliver Data
 
+> **⚠️ Deprecated:** This endpoint uses API version v4 which will be deprecated. Please use stable endpoints when available.
+
 <CodeBlock language="typescript">{`
 const failToDeliver = await fmp.insider.getFailToDeliver({ symbol: 'GE', page: 0 });
 `}</CodeBlock>
@@ -388,6 +458,26 @@ const failToDeliver = await fmp.insider.getFailToDeliver({ symbol: 'GE', page: 0
 
 ---
 
+## Convenience Methods
+
+The insider endpoints also provide convenience methods for common use cases:
+
+<CodeBlock language="typescript">{`
+// Get insider trades for a specific symbol
+const appleTrades = await fmp.insider.getInsiderTradesBySymbol('AAPL');
+
+// Get insider trades by transaction type
+const purchases = await fmp.insider.getInsiderTradesByType('P-Purchase');
+
+// Get insider trades by reporting CIK
+const cikTrades = await fmp.insider.getInsiderTradesByReportingCik('0000320193');
+
+// Get insider trades by company CIK
+const companyTrades = await fmp.insider.getInsiderTradesByCompanyCik('0000320193');
+`}</CodeBlock>
+
+---
+
 ## Error Handling
 
 Always check the `success` property before accessing `data`:
diff --git a/apps/docs/src/app/docs/api/layout.tsx b/apps/docs/src/app/docs/api/layout.tsx
index fe30d6b..4e0f292 100644
--- a/apps/docs/src/app/docs/api/layout.tsx
+++ b/apps/docs/src/app/docs/api/layout.tsx
@@ -2,6 +2,7 @@
 import { Card, CardContent } from '@/components/ui/card';
 import Link from 'next/link';
 import { usePathname } from 'next/navigation';
+import { Footer } from '@/components/layout/footer';
 
 const apiNavigationGroups = [
   {
@@ -31,6 +32,7 @@ const apiNavigationGroups = [
     items: [
       { name: 'Market Endpoints', href: '/docs/api/market' },
       { name: 'Economic Endpoints', href: '/docs/api/economic' },
+      { name: 'News Endpoints', href: '/docs/api/news' },
     ],
   },
   {
@@ -56,35 +58,38 @@ export default function APIDocsLayout({ children }: { children: React.ReactNode
   const pathname = usePathname();
 
   return (
-    <div className="min-h-screen">
-      {/* Header */}
-      <div className="bg-blue-50 dark:bg-blue-950/20 border-b border-blue-200 dark:border-blue-800">
-        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-4">
+    <div className="h-full flex flex-col">
+      {/* Header - Fixed at top */}
+      <header className="bg-blue-50 dark:bg-blue-950/20 border-b border-blue-200 dark:border-blue-800 flex-shrink-0">
+        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-3 lg:py-4">
           <div className="flex items-center justify-between">
-            <div className="flex items-center space-x-4">
+            <div className="flex items-center space-x-2 lg:space-x-4 min-w-0 flex-1">
               <Link
                 href="/"
-                className="text-blue-600 dark:text-blue-400 hover:text-blue-700 dark:hover:text-blue-300"
+                className="text-blue-600 dark:text-blue-400 hover:text-blue-700 dark:hover:text-blue-300 text-sm lg:text-base whitespace-nowrap"
               >
                 ← Back to Home
               </Link>
-              <div className="h-4 w-px bg-blue-300 dark:bg-blue-700"></div>
-              <h1 className="text-lg font-semibold text-blue-900 dark:text-blue-100">
+              <div className="h-4 w-px bg-blue-300 dark:bg-blue-700 hidden sm:block"></div>
+              <h1 className="text-base lg:text-lg font-semibold text-blue-900 dark:text-blue-100 truncate">
                 FMP Node API Documentation
               </h1>
             </div>
-            <div className="text-sm text-blue-600 dark:text-blue-400">Core API Wrapper</div>
+            <div className="text-xs lg:text-sm text-blue-600 dark:text-blue-400 hidden sm:block">
+              Core API Wrapper
+            </div>
           </div>
         </div>
-      </div>
+      </header>
 
-      {/* Main content */}
-      <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
-        <div className="flex flex-col lg:flex-row gap-8">
-          {/* Sidebar */}
-          <aside className="lg:w-64 flex-shrink-0">
-            <nav className="sticky top-8">
-              <div className="space-y-6">
+      {/* Main content area - Takes remaining height */}
+      <div className="flex-1 overflow-hidden">
+        {/* Desktop Layout - Side by side with separate scrolls */}
+        <div className="hidden lg:flex h-full">
+          {/* Sidebar - Fixed width with own scroll */}
+          <aside className="w-[25vw] flex-shrink-0 border-r border-neutral-200 dark:border-neutral-700 h-full">
+            <div className="h-full overflow-y-auto">
+              <div className="p-6 space-y-6 max-w-xs ml-auto">
                 {apiNavigationGroups.map(group => (
                   <div key={group.title}>
                     <h3 className="text-xs font-semibold text-neutral-500 dark:text-neutral-400 uppercase tracking-wider mb-3">
@@ -112,15 +117,59 @@ export default function APIDocsLayout({ children }: { children: React.ReactNode
                   </div>
                 ))}
               </div>
-            </nav>
+            </div>
           </aside>
 
-          {/* Content */}
-          <main className="flex-1 min-w-0">
+          {/* Content - Flexible width with own scroll */}
+          <main className="flex-1 overflow-y-auto h-full">
+            <div className="p-6 max-w-6xl mx-auto">
+              <Card>
+                <CardContent>{children}</CardContent>
+              </Card>
+            </div>
+            <Footer />
+          </main>
+        </div>
+
+        {/* Mobile Layout - Single scroll area */}
+        <div className="lg:hidden h-full overflow-y-auto">
+          {/* Mobile Navigation */}
+          <div className="p-4 space-y-4 bg-neutral-50 dark:bg-neutral-900 border-b border-neutral-200 dark:border-neutral-700">
+            {apiNavigationGroups.map(group => (
+              <div key={group.title}>
+                <h3 className="text-xs font-semibold text-neutral-500 dark:text-neutral-400 uppercase tracking-wider mb-2">
+                  {group.title}
+                </h3>
+                <ul className="space-y-1">
+                  {group.items.map(item => {
+                    const isActive = pathname === item.href;
+                    return (
+                      <li key={item.name}>
+                        <Link
+                          href={item.href}
+                          className={`px-3 py-2 text-sm block rounded-md transition-colors ${
+                            isActive
+                              ? 'text-blue-600 bg-blue-50 dark:text-blue-400 dark:bg-blue-950/50 font-medium'
+                              : 'text-neutral-600 hover:text-neutral-900 dark:text-neutral-300 dark:hover:text-neutral-100 hover:bg-neutral-100 dark:hover:bg-neutral-800'
+                          }`}
+                        >
+                          {item.name}
+                        </Link>
+                      </li>
+                    );
+                  })}
+                </ul>
+              </div>
+            ))}
+          </div>
+
+          {/* Mobile Content */}
+          <div className="sm:p-4 max-w-6xl mx-auto">
             <Card>
               <CardContent>{children}</CardContent>
             </Card>
-          </main>
+          </div>
+          <Footer />
         </div>
       </div>
     </div>
diff --git a/apps/docs/src/app/docs/api/news/page.mdx b/apps/docs/src/app/docs/api/news/page.mdx
new file mode 100644
index 0000000..587cc7a
--- /dev/null
+++ b/apps/docs/src/app/docs/api/news/page.mdx
@@ -0,0 +1,447 @@
+# News Endpoints
+
+Access financial news, market updates, and curated articles from Financial Modeling Prep and various financial sources.
+
+## Available Methods
+
+<ApiTable
+  endpoints={[
+    {
+      method: 'GET',
+      path: 'stable/fmp-articles',
+      description: 'Get FMP curated articles',
+    },
+    {
+      method: 'GET',
+      path: 'stable/news/stock-latest',
+      description: 'Get latest stock market news',
+    },
+    {
+      method: 'GET',
+      path: 'stable/news/crypto-latest',
+      description: 'Get latest cryptocurrency news',
+    },
+    {
+      method: 'GET',
+      path: 'stable/news/forex-latest',
+      description: 'Get latest forex market news',
+    },
+    {
+      method: 'GET',
+      path: 'stable/news/stock',
+      description: 'Get stock news by symbol',
+    },
+    {
+      method: 'GET',
+      path: 'stable/news/crypto',
+      description: 'Get crypto news by symbol',
+    },
+    {
+      method: 'GET',
+      path: 'stable/news/forex',
+      description: 'Get forex news by symbol',
+    },
+  ]}
+/>
+
+## Get FMP Articles
+
+Retrieve Financial Modeling Prep's curated articles covering market analysis, financial insights, and educational content.
+
+<CodeBlock language="typescript">
+  {`const articles = await fmp.news.getArticles({
+  page: 1,
+  limit: 10
+});
+
+// Get first page with default limit (100)
+const latestArticles = await fmp.news.getArticles({ page: 1 });`}
+
+</CodeBlock>
+
+<ParameterTable
+  parameters={[
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (defaults to 1)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Number of articles per page (defaults to 100)',
+    },
+  ]}
+/>
+
+### Example Response
+
+<CodeBlock language="typescript">
+  {`{
+  success: true,
+  data: [
+    {
+      title: 'Market Analysis: Tech Stocks Rally',
+      date: '2024-01-15',
+      content: 'Analysis of recent tech stock movements...',
+      tickers: 'AAPL,MSFT,GOOGL',
+      image: 'https://example.com/image.jpg',
+      link: 'https://example.com/article',
+      author: 'FMP Team',
+      site: 'Financial Modeling Prep'
+    }
+  ]
+}`}
+</CodeBlock>
+
+## Get Stock News
+
+Retrieve the most recent stock market news articles from multiple financial news sources.
+
+<CodeBlock language="typescript">
+  {`const stockNews = await fmp.news.getStockNews({
+  from: '2024-01-01',
+  to: '2024-01-15',
+  page: 1,
+  limit: 20
+});`}
+</CodeBlock>
+
+<ParameterTable
+  parameters={[
+    {
+      name: 'from',
+      type: 'string',
+      required: false,
+      description: 'Start date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'to',
+      type: 'string',
+      required: false,
+      description: 'End date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (defaults to 1)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Number of articles per page (defaults to 100)',
+    },
+  ]}
+/>
+
+### Example Response
+
+<CodeBlock language="typescript">
+  {`{
+  success: true,
+  data: [
+    {
+      symbol: 'AAPL',
+      publishedDate: '2024-01-15T10:30:00Z',
+      publisher: 'Reuters',
+      title: 'Apple Reports Strong Q4 Earnings',
+      image: 'https://example.com/apple-news.jpg',
+      site: 'reuters.com',
+      text: 'Apple Inc. reported better-than-expected earnings...',
+      url: 'https://reuters.com/apple-earnings'
+    }
+  ]
+}`}
+</CodeBlock>
+
+## Get Crypto News
+
+Retrieve the most recent cryptocurrency news articles covering market trends, regulatory updates, and technology developments.
+
+<CodeBlock language="typescript">
+  {`const cryptoNews = await fmp.news.getCryptoNews({
+  from: '2024-01-01',
+  to: '2024-01-15',
+  limit: 15
+});`}
+</CodeBlock>
+
+<ParameterTable
+  parameters={[
+    {
+      name: 'from',
+      type: 'string',
+      required: false,
+      description: 'Start date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'to',
+      type: 'string',
+      required: false,
+      description: 'End date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (defaults to 1)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Number of articles per page (defaults to 100)',
+    },
+  ]}
+/>
+
+## Get Forex News
+
+Retrieve the most recent forex market news covering currency movements, central bank announcements, and economic indicators.
+
+<CodeBlock language="typescript">
+  {`const forexNews = await fmp.news.getForexNews({
+  from: '2024-01-01',
+  to: '2024-01-15',
+  limit: 25
+});`}
+</CodeBlock>
+
+<ParameterTable
+  parameters={[
+    {
+      name: 'from',
+      type: 'string',
+      required: false,
+      description: 'Start date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'to',
+      type: 'string',
+      required: false,
+      description: 'End date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (defaults to 1)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Number of articles per page (defaults to 100)',
+    },
+  ]}
+/>
+
+## Get Stock News by Symbol
+
+Retrieve news articles specifically related to the provided stock symbols. Perfect for monitoring news about specific companies.
+
+<CodeBlock language="typescript">
+  {`const appleNews = await fmp.news.getStockNewsBySymbol({
+  symbols: ['AAPL'],
+  limit: 10
+});
+
+// Multiple symbols
+const techNews = await fmp.news.getStockNewsBySymbol({
+symbols: ['AAPL', 'MSFT', 'GOOGL', 'AMZN'],
+from: '2024-01-01',
+limit: 20
+});`}
+
+</CodeBlock>
+
+<ParameterTable
+  parameters={[
+    {
+      name: 'symbols',
+      type: 'string[]',
+      required: true,
+      description: 'Array of stock symbols to get news for',
+    },
+    {
+      name: 'from',
+      type: 'string',
+      required: false,
+      description: 'Start date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'to',
+      type: 'string',
+      required: false,
+      description: 'End date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (defaults to 1)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Number of articles per page (defaults to 100)',
+    },
+  ]}
+/>
+
+## Get Crypto News by Symbol
+
+Retrieve news articles specifically related to the provided cryptocurrency symbols.
+
+<CodeBlock language="typescript">
+  {`const bitcoinNews = await fmp.news.getCryptoNewsBySymbol({
+  symbols: ['BTCUSD'],
+  limit: 15
+});
+
+// Multiple cryptocurrencies
+const cryptoNews = await fmp.news.getCryptoNewsBySymbol({
+symbols: ['BTCUSD', 'ETHUSD', 'ADAUSD'],
+from: '2024-01-01',
+limit: 25
+});`}
+
+</CodeBlock>
+
+<ParameterTable
+  parameters={[
+    {
+      name: 'symbols',
+      type: 'string[]',
+      required: true,
+      description: 'Array of cryptocurrency symbols to get news for',
+    },
+    {
+      name: 'from',
+      type: 'string',
+      required: false,
+      description: 'Start date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'to',
+      type: 'string',
+      required: false,
+      description: 'End date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (defaults to 1)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Number of articles per page (defaults to 100)',
+    },
+  ]}
+/>
+
+## Get Forex News by Symbol
+
+Retrieve news articles specifically related to the provided forex currency pairs.
+
+<CodeBlock language="typescript">
+  {`const eurUsdNews = await fmp.news.getForexNewsBySymbol({
+  symbols: ['EURUSD'],
+  limit: 10
+});
+
+// Multiple currency pairs
+const forexNews = await fmp.news.getForexNewsBySymbol({
+symbols: ['EURUSD', 'GBPUSD', 'USDJPY'],
+from: '2024-01-01',
+limit: 20
+});`}
+
+</CodeBlock>
+
+<ParameterTable
+  parameters={[
+    {
+      name: 'symbols',
+      type: 'string[]',
+      required: true,
+      description: 'Array of forex currency pair symbols to get news for',
+    },
+    {
+      name: 'from',
+      type: 'string',
+      required: false,
+      description: 'Start date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'to',
+      type: 'string',
+      required: false,
+      description: 'End date (YYYY-MM-DD format)',
+    },
+    {
+      name: 'page',
+      type: 'number',
+      required: false,
+      description: 'Page number for pagination (defaults to 1)',
+    },
+    {
+      name: 'limit',
+      type: 'number',
+      required: false,
+      description: 'Number of articles per page (defaults to 100)',
+    },
+  ]}
+/>
+
+## Response Types
+
+### Article
+
+<CodeBlock language="typescript">
+  {`interface Article {
+  title: string;
+  date: string;
+  content: string;
+  tickers: string;
+  image: string;
+  link: string;
+  author: string;
+  site: string;
+}`}
+</CodeBlock>
+
+### News
+
+<CodeBlock language="typescript">
+  {`interface News {
+  symbol: string;
+  publishedDate: string;
+  publisher: string;
+  title: string;
+  image: string;
+  site: string;
+  text: string;
+  url: string;
+}`}
+</CodeBlock>
+
+## Next Steps
+
+Explore other endpoint categories:
+
+- [Stock Endpoints](/docs/api/stock) - Real-time quotes and historical data
+- [Financial Endpoints](/docs/api/financial) - Financial statements and ratios
+- [Market Endpoints](/docs/api/market) - Market indices and sector data
+- [Calendar Endpoints](/docs/api/calendar) - Earnings and economic calendars
+- [Economic Endpoints](/docs/api/economic) - Economic indicators and treasury rates
+- [List Endpoints](/docs/api/list) - Available symbols and instruments
+- [Examples](/docs/examples) - Practical code samples
diff --git a/apps/docs/src/app/docs/tools/layout.tsx b/apps/docs/src/app/docs/tools/layout.tsx
index e4dac31..fec6381 100644
--- a/apps/docs/src/app/docs/tools/layout.tsx
+++ b/apps/docs/src/app/docs/tools/layout.tsx
@@ -2,6 +2,7 @@
 import { Card, CardContent } from '@/components/ui/card';
 import Link from 'next/link';
 import { usePathname } from 'next/navigation';
+import { Footer } from '@/components/layout/footer';
 
 const toolsNavigationGroups = [
   {
@@ -26,35 +27,38 @@ export default function ToolsDocsLayout({ children }: { children: React.ReactNod
   const pathname = usePathname();
 
   return (
-    <div className="min-h-screen">
-      {/* Header */}
-      <div className="bg-purple-50 dark:bg-purple-950/20 border-b border-purple-200 dark:border-purple-800">
-        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-4">
+    <div className="h-full flex flex-col">
+      {/* Header - Fixed at top */}
+      <header className="bg-purple-50 dark:bg-purple-950/20 border-b border-purple-200 dark:border-purple-800 flex-shrink-0">
+        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-3 lg:py-4">
           <div className="flex items-center justify-between">
-            <div className="flex items-center space-x-4">
+            <div className="flex items-center space-x-2 lg:space-x-4 min-w-0 flex-1">
               <Link
                 href="/"
-                className="text-purple-600 dark:text-purple-400 hover:text-purple-700 dark:hover:text-purple-300"
+                className="text-purple-600 dark:text-purple-400 hover:text-purple-700 dark:hover:text-purple-300 text-sm lg:text-base whitespace-nowrap"
               >
                 ← Back to Home
               </Link>
-              <div className="h-4 w-px bg-purple-300 dark:bg-purple-700"></div>
-              <h1 className="text-lg font-semibold text-purple-900 dark:text-purple-100">
+              <div className="h-4 w-px bg-purple-300 dark:bg-purple-700 hidden sm:block"></div>
+              <h1 className="text-base lg:text-lg font-semibold text-purple-900 dark:text-purple-100 truncate">
                 FMP Tools Documentation
               </h1>
             </div>
-            <div className="text-sm text-purple-600 dark:text-purple-400">AI Tools for FMP API</div>
+            <div className="text-xs lg:text-sm text-purple-600 dark:text-purple-400 hidden sm:block">
+              AI Tools for FMP API
+            </div>
           </div>
         </div>
-      </div>
+      </header>
 
-      {/* Main content */}
-      <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
-        <div className="flex flex-col lg:flex-row gap-8">
-          {/* Sidebar */}
-          <aside className="lg:w-64 flex-shrink-0">
-            <nav className="sticky top-8">
-              <div className="space-y-6">
+      {/* Main content area - Takes remaining height */}
+      <div className="flex-1 overflow-hidden">
+        {/* Desktop Layout - Side by side with separate scrolls */}
+        <div className="hidden lg:flex h-full">
+          {/* Sidebar - Fixed width with own scroll */}
+          <aside className="w-[25vw] flex-shrink-0 border-r border-neutral-200 dark:border-neutral-700 h-full">
+            <div className="h-full overflow-y-auto">
+              <div className="p-6 space-y-6 max-w-xs ml-auto">
                 {toolsNavigationGroups.map(group => (
                   <div key={group.title}>
                     <h3 className="text-xs font-semibold text-neutral-500 dark:text-neutral-400 uppercase tracking-wider mb-3">
@@ -82,15 +86,59 @@ export default function ToolsDocsLayout({ children }: { children: React.ReactNod
                   </div>
                 ))}
               </div>
-            </nav>
+            </div>
           </aside>
 
-          {/* Content */}
-          <main className="flex-1 min-w-0">
+          {/* Content - Flexible width with own scroll */}
+          <main className="flex-1 overflow-y-auto h-full">
+            <div className="p-6 max-w-6xl mx-auto">
+              <Card>
+                <CardContent>{children}</CardContent>
+              </Card>
+            </div>
+            <Footer />
+          </main>
+        </div>
+
+        {/* Mobile Layout - Single scroll area */}
+        <div className="lg:hidden h-full overflow-y-auto">
+          {/* Mobile Navigation */}
+          <div className="p-4 space-y-4 bg-neutral-50 dark:bg-neutral-900 border-b border-neutral-200 dark:border-neutral-700">
+            {toolsNavigationGroups.map(group => (
+              <div key={group.title}>
+                <h3 className="text-xs font-semibold text-neutral-500 dark:text-neutral-400 uppercase tracking-wider mb-2">
+                  {group.title}
+                </h3>
+                <ul className="space-y-1">
+                  {group.items.map(item => {
+                    const isActive = pathname === item.href;
+                    return (
+                      <li key={item.name}>
+                        <Link
+                          href={item.href}
+                          className={`px-3 py-2 text-sm block rounded-md transition-colors ${
+                            isActive
+                              ? 'text-purple-600 bg-purple-50 dark:text-purple-400 dark:bg-purple-950/50 font-medium'
+                              : 'text-neutral-600 hover:text-neutral-900 dark:text-neutral-300 dark:hover:text-neutral-100 hover:bg-neutral-100 dark:hover:bg-neutral-800'
+                          }`}
+                        >
+                          {item.name}
+                        </Link>
+                      </li>
+                    );
+                  })}
+                </ul>
+              </div>
+            ))}
+          </div>
+
+          {/* Mobile Content */}
+          <div className="sm:p-4 max-w-6xl mx-auto">
             <Card>
               <CardContent>{children}</CardContent>
             </Card>
-          </main>
+          </div>
+          <Footer />
         </div>
       </div>
     </div>
diff --git a/apps/docs/src/app/layout.tsx b/apps/docs/src/app/layout.tsx
index 6df253e..7349465 100644
--- a/apps/docs/src/app/layout.tsx
+++ b/apps/docs/src/app/layout.tsx
@@ -2,7 +2,6 @@ import type { Metadata } from 'next';
 import { Inter } from 'next/font/google';
 import './globals.css';
 import { Header } from '@/components/layout/header';
-import { Footer } from '@/components/layout/footer';
 import { ThemeProvider } from '@/components/theme/theme-provider';
 
 const inter = Inter({ subsets: ['latin'] });
@@ -22,10 +21,9 @@ export default function RootLayout({ children }: { children: React.ReactNode })
           enableSystem
           disableTransitionOnChange
         >
-          <div className="min-h-screen flex flex-col">
+          <div className="h-screen flex flex-col">
             <Header />
-            <main className="flex-1">{children}</main>
-            <Footer />
+            <main className="flex-1 overflow-hidden">{children}</main>
           </div>
         </ThemeProvider>
       </body>
diff --git a/apps/docs/src/app/page.tsx b/apps/docs/src/app/page.tsx
index 9dd6b87..8c6b811 100644
--- a/apps/docs/src/app/page.tsx
+++ b/apps/docs/src/app/page.tsx
@@ -9,182 +9,206 @@ import {
   CardContent,
   CardFooter,
 } from '@/components/ui/card';
+import { Footer } from '@/components/layout/footer';
 
 export default function Home() {
   return (
-    <main className="min-h-screen p-8">
-      <div className="max-w-6xl mx-auto">
-        <div className="text-center mb-12">
-          <h1 className="text-5xl font-bold mb-6 text-neutral-900 dark:text-white">
-            FMP Node Wrapper
-          </h1>
-          <p className="text-lg text-neutral-500 dark:text-neutral-400">
-            A comprehensive Node.js ecosystem for the Financial Modeling Prep API
-          </p>
-          <Card className="h-full hover:shadow-lg transition-all duration-300 border-2 hover:border-orange-200 dark:hover:border-orange-800 mt-4">
-            <CardHeader className="text-center">
-              <CardDescription className="text-lg text-orange-600 dark:text-orange-400">
-                Financial Modeling Prep API Key - Link for 10% off
-              </CardDescription>
-            </CardHeader>
-            <CardContent className="space-y-4">
-              <a
-                href="https://site.financialmodelingprep.com/pricing-plans?couponCode=eroy"
-                target="_blank"
-                rel="noopener noreferrer"
-                className="text-lg text-blue-500 dark:text-blue-400 hover:underline"
-              >
-                https://site.financialmodelingprep.com/pricing-plans?couponCode=eroy
-              </a>
-              <div className="text-sm text-neutral-600 dark:text-neutral-300 italic">
-                I don't get paid for the working on this project. Using this link helps support the
-                project with affiliate earnings.
-              </div>
-              <div className="text-sm text-neutral-600 dark:text-neutral-300">
-                If this project helps you, consider giving it a star on GitHub.
-              </div>
-            </CardContent>
-          </Card>
-        </div>
-
-        {/* Main Library Selection */}
-        <div className="grid gap-8 md:grid-cols-2 mb-16">
-          {/* FMP Node API */}
-          <Card className="h-full hover:shadow-lg transition-all duration-300 border-2 hover:border-blue-200 dark:hover:border-blue-800">
-            <CardHeader className="text-center">
-              <div className="text-4xl mb-4">🚀</div>
-              <CardTitle className="text-3xl text-neutral-900 dark:text-white">
-                FMP Node API
-              </CardTitle>
-              <CardDescription className="text-lg text-neutral-600 dark:text-neutral-300">
-                Core API wrapper for direct FMP API access
-              </CardDescription>
-            </CardHeader>
-            <CardContent className="space-y-4">
-              <div className="space-y-2">
-                <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
-                  <span className="w-2 h-2 bg-green-500 rounded-full mr-2"></span>
-                  Complete TypeScript support
+    <div className="h-full flex flex-col">
+      <main className="flex-1 overflow-y-auto p-4 sm:p-6 lg:p-8">
+        <div className="max-w-6xl mx-auto">
+          <div className="text-center mb-8 lg:mb-12">
+            <h1 className="text-3xl sm:text-4xl lg:text-5xl font-bold mb-4 lg:mb-6 text-neutral-900 dark:text-white">
+              FMP Node Wrapper
+            </h1>
+            <p className="text-base lg:text-lg text-neutral-500 dark:text-neutral-400">
+              A comprehensive Node.js ecosystem for the Financial Modeling Prep API
+            </p>
+            <Card className="h-full hover:shadow-lg transition-all duration-300 border-2 hover:border-orange-200 dark:hover:border-orange-800 mt-4">
+              <CardHeader className="text-center">
+                <CardDescription className="text-lg text-orange-600 dark:text-orange-400">
+                  Financial Modeling Prep API Key - Link for 10% off
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <a
+                  href="https://site.financialmodelingprep.com/pricing-plans?couponCode=eroy"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="text-lg text-blue-500 dark:text-blue-400 hover:underline"
+                >
+                  https://site.financialmodelingprep.com/pricing-plans?couponCode=eroy
+                </a>
+                <div className="text-sm text-neutral-600 dark:text-neutral-300 italic">
+                  I don't get paid for the working on this project. Using this link helps support
+                  the project with affiliate earnings.
                 </div>
-                <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
-                  <span className="w-2 h-2 bg-green-500 rounded-full mr-2"></span>
-                  All FMP endpoints covered
+                <div className="flex items-center justify-center space-x-2 text-sm text-neutral-600 dark:text-neutral-300">
+                  <span>If this project helps you, consider giving it a</span>
+                  <a
+                    href="https://github.com/e-roy/fmp-node-wrapper"
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="inline-flex items-center space-x-1 text-yellow-600 dark:text-yellow-400 hover:text-yellow-700 dark:hover:text-yellow-300 transition-colors font-medium"
+                  >
+                    <svg
+                      className="w-4 h-4 fill-current"
+                      viewBox="0 0 24 24"
+                      xmlns="http://www.w3.org/2000/svg"
+                    >
+                      <path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
+                    </svg>
+                    <span>star</span>
+                  </a>
+                  <span>on GitHub.</span>
                 </div>
-                <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
-                  <span className="w-2 h-2 bg-green-500 rounded-full mr-2"></span>
-                  Built-in validation & error handling
+              </CardContent>
+            </Card>
+          </div>
+
+          {/* Main Library Selection */}
+          <div className="grid gap-6 lg:gap-8 sm:grid-cols-1 md:grid-cols-2 mb-12 lg:mb-16">
+            {/* FMP Node API */}
+            <Card className="h-full hover:shadow-lg transition-all duration-300 border-2 hover:border-blue-200 dark:hover:border-blue-800">
+              <CardHeader className="text-center">
+                <div className="text-3xl lg:text-4xl mb-3 lg:mb-4">🚀</div>
+                <CardTitle className="text-2xl lg:text-3xl text-neutral-900 dark:text-white">
+                  FMP Node API
+                </CardTitle>
+                <CardDescription className="text-base lg:text-lg text-neutral-600 dark:text-neutral-300">
+                  Core API wrapper for direct FMP API access
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="space-y-2">
+                  <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
+                    <span className="w-2 h-2 bg-green-500 rounded-full mr-2"></span>
+                    Complete TypeScript support
+                  </div>
+                  <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
+                    <span className="w-2 h-2 bg-green-500 rounded-full mr-2"></span>
+                    All FMP endpoints covered
+                  </div>
+                  <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
+                    <span className="w-2 h-2 bg-green-500 rounded-full mr-2"></span>
+                    Built-in validation & error handling
+                  </div>
+                  <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
+                    <span className="w-2 h-2 bg-green-500 rounded-full mr-2"></span>
+                    Modular design for flexibility
+                  </div>
                 </div>
-                <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
-                  <span className="w-2 h-2 bg-green-500 rounded-full mr-2"></span>
-                  Modular design for flexibility
+
+                <div className="bg-neutral-50 dark:bg-neutral-900 p-3 rounded-lg">
+                  <code className="text-sm text-neutral-800 dark:text-neutral-200">
+                    npm install fmp-node-api
+                  </code>
                 </div>
-              </div>
+              </CardContent>
+              <CardFooter className="justify-center">
+                <Link
+                  href="/docs/api"
+                  className="inline-flex items-center px-6 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors font-medium"
+                >
+                  View API Documentation →
+                </Link>
+              </CardFooter>
+            </Card>
 
-              <div className="bg-neutral-50 dark:bg-neutral-900 p-3 rounded-lg">
-                <code className="text-sm text-neutral-800 dark:text-neutral-200">
-                  npm install fmp-node-api
-                </code>
-              </div>
-            </CardContent>
-            <CardFooter className="justify-center">
-              <Link
-                href="/docs/api"
-                className="inline-flex items-center px-6 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors font-medium"
-              >
-                View API Documentation →
-              </Link>
-            </CardFooter>
-          </Card>
+            {/* FMP Tools */}
+            <Card className="h-full hover:shadow-lg transition-all duration-300 border-2 hover:border-purple-200 dark:hover:border-purple-800">
+              <CardHeader className="text-center">
+                <div className="text-3xl lg:text-4xl mb-3 lg:mb-4">🤖</div>
+                <CardTitle className="text-2xl lg:text-3xl text-neutral-900 dark:text-white">
+                  FMP Tools
+                </CardTitle>
+                <CardDescription className="text-base lg:text-lg text-neutral-600 dark:text-neutral-300">
+                  AI tools for Vercel AI SDK and LLM integrations
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="space-y-2">
+                  <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
+                    <span className="w-2 h-2 bg-purple-500 rounded-full mr-2"></span>
+                    Vercel AI SDK integration
+                  </div>
+                  <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
+                    <span className="w-2 h-2 bg-purple-500 rounded-full mr-2"></span>
+                    Ready-to-use AI tools
+                  </div>
+                  <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
+                    <span className="w-2 h-2 bg-purple-500 rounded-full mr-2"></span>
+                    Multi-platform AI support
+                  </div>
+                  <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
+                    <span className="w-2 h-2 bg-purple-500 rounded-full mr-2"></span>
+                    Chatbot & assistant ready
+                  </div>
+                </div>
 
-          {/* FMP Tools */}
-          <Card className="h-full hover:shadow-lg transition-all duration-300 border-2 hover:border-purple-200 dark:hover:border-purple-800">
-            <CardHeader className="text-center">
-              <div className="text-4xl mb-4">🤖</div>
-              <CardTitle className="text-3xl text-neutral-900 dark:text-white">FMP Tools</CardTitle>
-              <CardDescription className="text-lg text-neutral-600 dark:text-neutral-300">
-                AI tools for Vercel AI SDK and LLM integrations
-              </CardDescription>
+                <div className="bg-neutral-50 dark:bg-neutral-900 p-3 rounded-lg">
+                  <code className="text-sm text-neutral-800 dark:text-neutral-200">
+                    npm install fmp-ai-tools
+                  </code>
+                </div>
+              </CardContent>
+              <CardFooter className="justify-center">
+                <Link
+                  href="/docs/tools"
+                  className="inline-flex items-center px-6 py-3 bg-purple-600 text-white rounded-lg hover:bg-purple-700 transition-colors font-medium"
+                >
+                  View Tools Documentation →
+                </Link>
+              </CardFooter>
+            </Card>
+          </div>
+
+          {/* Features Overview */}
+          <Card className="bg-gradient-to-r from-blue-50 to-purple-50 dark:from-blue-900/20 dark:to-purple-900/20 border-blue-200 dark:border-blue-800">
+            <CardHeader>
+              <CardTitle className="text-xl lg:text-2xl text-neutral-900 dark:text-white text-center">
+                <h2>Why Choose FMP Node Wrapper?</h2>
+              </CardTitle>
             </CardHeader>
-            <CardContent className="space-y-4">
-              <div className="space-y-2">
-                <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
-                  <span className="w-2 h-2 bg-purple-500 rounded-full mr-2"></span>
-                  Vercel AI SDK integration
+            <CardContent>
+              <div className="grid gap-4 sm:gap-6 sm:grid-cols-2 lg:grid-cols-4">
+                <div className="text-center">
+                  <div className="text-3xl mb-2">⚡</div>
+                  <h3 className="font-semibold mb-2 text-neutral-900 dark:text-white">
+                    High Performance
+                  </h3>
+                  <p className="text-sm text-neutral-600 dark:text-neutral-300">
+                    Optimized for speed and efficiency
+                  </p>
                 </div>
-                <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
-                  <span className="w-2 h-2 bg-purple-500 rounded-full mr-2"></span>
-                  Ready-to-use AI tools
+                <div className="text-center">
+                  <div className="text-3xl mb-2">🛡️</div>
+                  <h3 className="font-semibold mb-2 text-neutral-900 dark:text-white">Type Safe</h3>
+                  <p className="text-sm text-neutral-600 dark:text-neutral-300">
+                    Full TypeScript support throughout
+                  </p>
                 </div>
-                <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
-                  <span className="w-2 h-2 bg-purple-500 rounded-full mr-2"></span>
-                  Multi-platform AI support
+                <div className="text-center">
+                  <div className="text-3xl mb-2">🔧</div>
+                  <h3 className="font-semibold mb-2 text-neutral-900 dark:text-white">
+                    Easy to Use
+                  </h3>
+                  <p className="text-sm text-neutral-600 dark:text-neutral-300">
+                    Simple, intuitive API design
+                  </p>
                 </div>
-                <div className="flex items-center text-sm text-neutral-600 dark:text-neutral-300">
-                  <span className="w-2 h-2 bg-purple-500 rounded-full mr-2"></span>
-                  Chatbot & assistant ready
+                <div className="text-center">
+                  <div className="text-3xl mb-2">🤖</div>
+                  <h3 className="font-semibold mb-2 text-neutral-900 dark:text-white">AI Ready</h3>
+                  <p className="text-sm text-neutral-600 dark:text-neutral-300">
+                    Built-in AI tool integrations
+                  </p>
                 </div>
               </div>
-
-              <div className="bg-neutral-50 dark:bg-neutral-900 p-3 rounded-lg">
-                <code className="text-sm text-neutral-800 dark:text-neutral-200">
-                  npm install fmp-ai-tools
-                </code>
-              </div>
             </CardContent>
-            <CardFooter className="justify-center">
-              <Link
-                href="/docs/tools"
-                className="inline-flex items-center px-6 py-3 bg-purple-600 text-white rounded-lg hover:bg-purple-700 transition-colors font-medium"
-              >
-                View Tools Documentation →
-              </Link>
-            </CardFooter>
           </Card>
         </div>
-
-        {/* Features Overview */}
-        <Card className="bg-gradient-to-r from-blue-50 to-purple-50 dark:from-blue-900/20 dark:to-purple-900/20 border-blue-200 dark:border-blue-800">
-          <CardHeader>
-            <CardTitle className="text-2xl text-neutral-900 dark:text-white text-center">
-              <h2>Why Choose FMP Node Wrapper?</h2>
-            </CardTitle>
-          </CardHeader>
-          <CardContent>
-            <div className="grid gap-6 md:grid-cols-2 lg:grid-cols-4">
-              <div className="text-center">
-                <div className="text-3xl mb-2">⚡</div>
-                <h3 className="font-semibold mb-2 text-neutral-900 dark:text-white">
-                  High Performance
-                </h3>
-                <p className="text-sm text-neutral-600 dark:text-neutral-300">
-                  Optimized for speed and efficiency
-                </p>
-              </div>
-              <div className="text-center">
-                <div className="text-3xl mb-2">🛡️</div>
-                <h3 className="font-semibold mb-2 text-neutral-900 dark:text-white">Type Safe</h3>
-                <p className="text-sm text-neutral-600 dark:text-neutral-300">
-                  Full TypeScript support throughout
-                </p>
-              </div>
-              <div className="text-center">
-                <div className="text-3xl mb-2">🔧</div>
-                <h3 className="font-semibold mb-2 text-neutral-900 dark:text-white">Easy to Use</h3>
-                <p className="text-sm text-neutral-600 dark:text-neutral-300">
-                  Simple, intuitive API design
-                </p>
-              </div>
-              <div className="text-center">
-                <div className="text-3xl mb-2">🤖</div>
-                <h3 className="font-semibold mb-2 text-neutral-900 dark:text-white">AI Ready</h3>
-                <p className="text-sm text-neutral-600 dark:text-neutral-300">
-                  Built-in AI tool integrations
-                </p>
-              </div>
-            </div>
-          </CardContent>
-        </Card>
-      </div>
-    </main>
+      </main>
+      <Footer />
+    </div>
   );
 }
diff --git a/packages/api/CHANGELOG.md b/packages/api/CHANGELOG.md
index 1dbbe9f..f2ca419 100644
--- a/packages/api/CHANGELOG.md
+++ b/packages/api/CHANGELOG.md
@@ -1,5 +1,11 @@
 # fmp-node-api
 
+## 0.1.9
+
+### Patch Changes
+
+- Added news endpoints - fmp-node-api, added shares float and executive compensation to fmp-ai-tools
+
 ## 0.1.8
 
 ### Patch Changes
diff --git a/packages/api/package.json b/packages/api/package.json
index f658bd8..e91d1b5 100644
--- a/packages/api/package.json
+++ b/packages/api/package.json
@@ -1,6 +1,6 @@
 {
   "name": "fmp-node-api",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "A comprehensive Node.js wrapper for Financial Modeling Prep API",
   "disclaimer": "This package is not affiliated with, endorsed by, or sponsored by Financial Modeling Prep (FMP). This is an independent, community-developed wrapper.",
   "main": "./dist/index.js",
diff --git a/packages/api/scripts/test-endpoint.ts b/packages/api/scripts/test-endpoint.ts
index 612f345..429a28e 100644
--- a/packages/api/scripts/test-endpoint.ts
+++ b/packages/api/scripts/test-endpoint.ts
@@ -264,12 +264,14 @@ async function testEndpoint() {
       case 'insider-trading-rss':
         result = await fmp.insider.getInsiderTradingRSS({
           page: 0,
+          limit: 10,
         });
         break;
       case 'insider-trading-search':
         result = await fmp.insider.searchInsiderTrading({
           symbol: 'AAPL',
           page: 0,
+          limit: 10,
         });
         break;
       case 'insider-trading-search-by-type':
@@ -310,6 +312,7 @@ async function testEndpoint() {
       case 'beneficial-ownership':
         result = await fmp.insider.getBeneficialOwnership({
           symbol: 'AAPL',
+          limit: 10,
         });
         break;
       case 'fail-to-deliver':
@@ -394,6 +397,65 @@ async function testEndpoint() {
         result = await fmp.mutualFund.getHolders('AAPL');
         break;
 
+      // News endpoints
+      case 'fmp-articles':
+        result = await fmp.news.getArticles({
+          limit: 10,
+          page: 0,
+        });
+        break;
+      case 'stock-news':
+        result = await fmp.news.getStockNews({
+          from: '2025-07-01',
+          to: '2025-07-31',
+          limit: 10,
+          page: 0,
+        });
+        break;
+      case 'crypto-news':
+        result = await fmp.news.getCryptoNews({
+          from: '2025-07-01',
+          to: '2025-07-31',
+          limit: 10,
+          page: 0,
+        });
+        break;
+      case 'forex-news':
+        result = await fmp.news.getForexNews({
+          from: '2025-07-01',
+          to: '2025-07-31',
+          limit: 10,
+          page: 0,
+        });
+        break;
+      case 'stock-news-by-symbol':
+        result = await fmp.news.getStockNewsBySymbol({
+          symbols: ['TSLA', 'GOOGL'],
+          from: '2025-07-01',
+          to: '2025-07-31',
+          limit: 10,
+          page: 0,
+        });
+        break;
+      case 'crypto-news-by-symbol':
+        result = await fmp.news.getCryptoNewsBySymbol({
+          symbols: ['BTCUSD', 'ETHUSD'],
+          from: '2025-07-01',
+          to: '2025-07-31',
+          limit: 10,
+          page: 0,
+        });
+        break;
+      case 'forex-news-by-symbol':
+        result = await fmp.news.getForexNewsBySymbol({
+          symbols: ['EURUSD', 'GBPUSD'],
+          from: '2025-07-01',
+          to: '2025-07-31',
+          limit: 10,
+          page: 0,
+        });
+        break;
+
       // Quote endpoints
       case 'quote':
         result = await fmp.quote.getQuote('AAPL');
diff --git a/packages/api/src/__tests__/endpoints/insider.test.ts b/packages/api/src/__tests__/endpoints/insider.test.ts
index fad29de..2255660 100644
--- a/packages/api/src/__tests__/endpoints/insider.test.ts
+++ b/packages/api/src/__tests__/endpoints/insider.test.ts
@@ -1,272 +1,562 @@
 import { FMP } from '../../fmp';
 import { TransactionType } from 'fmp-node-types';
-
-// Mock the client to avoid actual API calls during testing
-jest.mock('../../client');
+import { shouldSkipTests, createTestClient, API_TIMEOUT, FAST_TIMEOUT } from '../utils/test-setup';
 
 describe('InsiderEndpoints', () => {
   let fmp: FMP;
-  let mockClient: any;
 
   beforeEach(() => {
-    // Clear all mocks
-    jest.clearAllMocks();
-
     // Create a new FMP instance for each test
-    fmp = new FMP({ apiKey: 'testapikey123456789012345678901234567890' });
-    mockClient = fmp.getClient();
+    fmp = createTestClient();
   });
 
   describe('getInsiderTradingRSS', () => {
-    it('should call the correct endpoint with page parameter', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getInsiderTradingRSS({ page: 0 });
-
-      expect(mockClient.get).toHaveBeenCalledWith('/insider-trading-rss-feed', 'v4', { page: 0 });
-      expect(result).toEqual(mockResponse);
-    });
+    it(
+      'should return insider trading RSS data with pagination',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping insider trading RSS test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getInsiderTradingRSS({ page: 0, limit: 5 });
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+        expect(result.data!.length).toBeLessThanOrEqual(5);
+
+        if (result.data && result.data.length > 0) {
+          const firstTrade = result.data[0];
+          expect(firstTrade).toHaveProperty('symbol');
+          expect(firstTrade).toHaveProperty('filingDate');
+          expect(firstTrade).toHaveProperty('transactionDate');
+          expect(firstTrade).toHaveProperty('reportingCik');
+          expect(firstTrade).toHaveProperty('companyCik');
+          expect(firstTrade).toHaveProperty('transactionType');
+          expect(firstTrade).toHaveProperty('reportingName');
+        }
+      },
+      API_TIMEOUT,
+    );
   });
 
   describe('searchInsiderTrading', () => {
-    it('should call the correct endpoint with all parameters', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const params = {
-        symbol: 'AAPL',
-        reportingCik: '0001767094',
-        companyCik: '0000320193',
-        transactionType: TransactionType.SALE,
-        page: 0,
-      };
-
-      const result = await fmp.insider.searchInsiderTrading(params);
-
-      expect(mockClient.get).toHaveBeenCalledWith('/insider-trading', 'v4', params);
-      expect(result).toEqual(mockResponse);
-    });
+    it(
+      'should return insider trading data for a specific symbol',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping insider trading search test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.searchInsiderTrading({
+          symbol: 'AAPL',
+          page: 0,
+          limit: 3,
+        });
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+        expect(result.data!.length).toBeLessThanOrEqual(3);
+
+        if (result.data && result.data.length > 0) {
+          const firstTrade = result.data[0];
+          expect(firstTrade).toHaveProperty('symbol');
+          expect(firstTrade).toHaveProperty('filingDate');
+          expect(firstTrade).toHaveProperty('transactionDate');
+          expect(firstTrade).toHaveProperty('reportingCik');
+          expect(firstTrade).toHaveProperty('companyCik');
+          expect(firstTrade).toHaveProperty('transactionType');
+          expect(firstTrade).toHaveProperty('reportingName');
+          expect(firstTrade.symbol).toBe('AAPL');
+        }
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should return insider trading data with pagination only',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping insider trading search test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.searchInsiderTrading({
+          page: 0,
+          limit: 2,
+        });
 
-    it('should call the correct endpoint with only required parameters', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+        expect(result.data!.length).toBeLessThanOrEqual(2);
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should return insider trading data filtered by reporting CIK',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log(
+            'Skipping insider trading search by reporting CIK test - no API key available',
+          );
+          return;
+        }
+
+        const result = await fmp.insider.searchInsiderTrading({
+          reportingCik: '0000320193',
+          page: 0,
+          limit: 2,
+        });
 
-      const params = { page: 0 };
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+        expect(result.data!.length).toBeLessThanOrEqual(2);
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should return insider trading data filtered by company CIK',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping insider trading search by company CIK test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.searchInsiderTrading({
+          companyCik: '0000320193',
+          page: 0,
+          limit: 2,
+        });
 
-      const result = await fmp.insider.searchInsiderTrading(params);
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+        expect(result.data!.length).toBeLessThanOrEqual(2);
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should return insider trading data filtered by transaction type',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log(
+            'Skipping insider trading search by transaction type test - no API key available',
+          );
+          return;
+        }
+
+        const result = await fmp.insider.searchInsiderTrading({
+          transactionType: 'P-Purchase',
+          page: 0,
+          limit: 2,
+        });
 
-      expect(mockClient.get).toHaveBeenCalledWith('/insider-trading', 'v4', params);
-      expect(result).toEqual(mockResponse);
-    });
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+        expect(result.data!.length).toBeLessThanOrEqual(2);
+      },
+      API_TIMEOUT,
+    );
   });
 
   describe('getTransactionTypes', () => {
-    it('should call the correct endpoint', async () => {
-      const mockResponse = { success: true, data: ['P-Purchase', 'S-Sale'] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getTransactionTypes();
-
-      expect(mockClient.get).toHaveBeenCalledWith('/insider-trading-transaction-type', 'v4');
-      expect(result).toEqual(mockResponse);
-    });
+    it(
+      'should return array of transaction types',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping transaction types test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getTransactionTypes();
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+        expect(result.data!.length).toBeGreaterThan(0);
+
+        // Check that we have some expected transaction types
+        const transactionTypes = result.data!;
+        const typeStrings = transactionTypes.map((t: any) => t.transactionType);
+        expect(typeStrings).toContain('P-Purchase');
+        expect(typeStrings).toContain('S-Sale');
+      },
+      FAST_TIMEOUT,
+    );
   });
 
-  describe('getInsidersBySymbol', () => {
-    it('should call the correct endpoint with symbol parameter', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getInsidersBySymbol({ symbol: 'AAPL' });
-
-      expect(mockClient.get).toHaveBeenCalledWith('/insider-roaster', 'v4', { symbol: 'AAPL' });
-      expect(result).toEqual(mockResponse);
-    });
+  describe('getInsidersBySymbol (DEPRECATED)', () => {
+    it(
+      'should return insiders data for a symbol (v4 endpoint)',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping insiders by symbol test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getInsidersBySymbol({ symbol: 'AAPL' });
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const firstInsider = result.data[0];
+          expect(firstInsider).toHaveProperty('typeOfOwner');
+          expect(firstInsider).toHaveProperty('transactionDate');
+          expect(firstInsider).toHaveProperty('owner');
+        }
+      },
+      API_TIMEOUT,
+    );
   });
 
   describe('getInsiderTradeStatistics', () => {
-    it('should call the correct endpoint with symbol parameter', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getInsiderTradeStatistics({ symbol: 'AAPL' });
-
-      expect(mockClient.get).toHaveBeenCalledWith('/insider-roaster-statistic', 'v4', {
-        symbol: 'AAPL',
-      });
-      expect(result).toEqual(mockResponse);
-    });
+    it(
+      'should return insider trade statistics for a symbol',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping insider trade statistics test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getInsiderTradeStatistics({ symbol: 'AAPL' });
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const firstStat = result.data[0];
+          expect(firstStat).toHaveProperty('symbol');
+          expect(firstStat).toHaveProperty('cik');
+          expect(firstStat).toHaveProperty('year');
+          expect(firstStat).toHaveProperty('quarter');
+          expect(firstStat).toHaveProperty('totalPurchases');
+          expect(firstStat).toHaveProperty('totalSales');
+          expect(firstStat.symbol).toBe('AAPL');
+        }
+      },
+      API_TIMEOUT,
+    );
   });
 
-  describe('getCikMapper', () => {
-    it('should call the correct endpoint with page parameter', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getCikMapper({ page: 0 });
-
-      expect(mockClient.get).toHaveBeenCalledWith('/mapper-cik-name', 'v4', { page: 0 });
-      expect(result).toEqual(mockResponse);
-    });
+  describe('getCikMapper (DEPRECATED)', () => {
+    it(
+      'should return CIK mapper data with pagination (v4 endpoint)',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping CIK mapper test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getCikMapper({ page: 0 });
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const firstMapping = result.data[0];
+          expect(firstMapping).toHaveProperty('reportingCik');
+          expect(firstMapping).toHaveProperty('reportingName');
+        }
+      },
+      API_TIMEOUT,
+    );
   });
 
-  describe('getCikMapperByName', () => {
-    it('should call the correct endpoint with name and page parameters', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getCikMapperByName({ name: 'zuckerberg', page: 0 });
-
-      expect(mockClient.get).toHaveBeenCalledWith('/mapper-cik-name', 'v4', {
-        name: 'zuckerberg',
-        page: 0,
-      });
-      expect(result).toEqual(mockResponse);
-    });
-
-    it('should use default page value when not provided', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getCikMapperByName({ name: 'zuckerberg' });
-
-      expect(mockClient.get).toHaveBeenCalledWith('/mapper-cik-name', 'v4', {
-        name: 'zuckerberg',
-        page: 0,
-      });
-      expect(result).toEqual(mockResponse);
-    });
+  describe('getCikMapperByName (DEPRECATED)', () => {
+    it(
+      'should return CIK mapper data by name search (v4 endpoint)',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping CIK mapper by name test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getCikMapperByName({ name: 'apple', page: 0 });
+
+        // This endpoint might fail, so we'll check for success or handle the failure gracefully
+        if (result.success) {
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+
+          if (result.data && result.data.length > 0) {
+            const firstMapping = result.data[0];
+            expect(firstMapping).toHaveProperty('reportingCik');
+            expect(firstMapping).toHaveProperty('reportingName');
+            expect(firstMapping.reportingName.toLowerCase()).toContain('apple');
+          }
+        } else {
+          // If the API call fails, just log it but don't fail the test
+          console.log(
+            'CIK mapper by name API call failed, which is expected for deprecated endpoints',
+          );
+          expect(result.success).toBe(false);
+        }
+      },
+      API_TIMEOUT,
+    );
   });
 
-  describe('getCikMapperBySymbol', () => {
-    it('should call the correct endpoint with symbol parameter', async () => {
-      const mockResponse = { success: true, data: {} };
-      mockClient.getSingle.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getCikMapperBySymbol({ symbol: 'MSFT' });
-
-      expect(mockClient.getSingle).toHaveBeenCalledWith('/mapper-cik-company/MSFT', 'v4');
-      expect(result).toEqual(mockResponse);
-    });
+  describe('getCikMapperBySymbol (DEPRECATED)', () => {
+    it(
+      'should return CIK mapper data by symbol (v4 endpoint)',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping CIK mapper by symbol test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getCikMapperBySymbol({ symbol: 'AAPL' });
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(result.data).toHaveProperty('symbol');
+        expect(result.data).toHaveProperty('companyCik');
+        expect(result.data!.symbol).toBe('AAPL');
+      },
+      FAST_TIMEOUT,
+    );
   });
 
   describe('getBeneficialOwnership', () => {
-    it('should call the correct endpoint with symbol parameter', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getBeneficialOwnership({ symbol: 'AAPL' });
-
-      expect(mockClient.get).toHaveBeenCalledWith(
-        '/insider/ownership/acquisition_of_beneficial_ownership',
-        'v4',
-        { symbol: 'AAPL' },
-      );
-      expect(result).toEqual(mockResponse);
-    });
+    it(
+      'should return beneficial ownership data for a symbol',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping beneficial ownership test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getBeneficialOwnership({ symbol: 'AAPL' });
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const firstOwnership = result.data[0];
+          expect(firstOwnership).toHaveProperty('cik');
+          expect(firstOwnership).toHaveProperty('symbol');
+          expect(firstOwnership).toHaveProperty('filingDate');
+          expect(firstOwnership).toHaveProperty('nameOfReportingPerson');
+          expect(firstOwnership.symbol).toBe('AAPL');
+        }
+      },
+      API_TIMEOUT,
+    );
   });
 
-  describe('getFailToDeliver', () => {
-    it('should call the correct endpoint with symbol and page parameters', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getFailToDeliver({ symbol: 'GE', page: 0 });
-
-      expect(mockClient.get).toHaveBeenCalledWith('/fail_to_deliver', 'v4', {
-        symbol: 'GE',
-        page: 0,
-      });
-      expect(result).toEqual(mockResponse);
-    });
-
-    it('should use default page value when not provided', async () => {
-      const mockResponse = { success: true, data: [] };
-      mockClient.get.mockResolvedValue(mockResponse);
-
-      const result = await fmp.insider.getFailToDeliver({ symbol: 'GE' });
-
-      expect(mockClient.get).toHaveBeenCalledWith('/fail_to_deliver', 'v4', {
-        symbol: 'GE',
-        page: 0,
-      });
-      expect(result).toEqual(mockResponse);
-    });
+  describe('getFailToDeliver (DEPRECATED)', () => {
+    it(
+      'should return fail to deliver data for a symbol (v4 endpoint)',
+      async () => {
+        if (shouldSkipTests()) {
+          console.log('Skipping fail to deliver test - no API key available');
+          return;
+        }
+
+        const result = await fmp.insider.getFailToDeliver({ symbol: 'AAPL', page: 0 });
+
+        expect(result.success).toBe(true);
+        expect(result.data).not.toBeNull();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const firstEntry = result.data[0];
+          expect(firstEntry).toHaveProperty('symbol');
+          expect(firstEntry).toHaveProperty('date');
+          expect(firstEntry).toHaveProperty('price');
+          expect(firstEntry).toHaveProperty('quantity');
+          expect(firstEntry.symbol).toBe('AAPL');
+        }
+      },
+      API_TIMEOUT,
+    );
   });
 
   describe('convenience methods', () => {
     describe('getInsiderTradesBySymbol', () => {
-      it('should call searchInsiderTrading with symbol parameter', async () => {
-        const mockResponse = { success: true, data: [] };
-        mockClient.get.mockResolvedValue(mockResponse);
-
-        const result = await fmp.insider.getInsiderTradesBySymbol('AAPL', 1);
-
-        expect(mockClient.get).toHaveBeenCalledWith('/insider-trading', 'v4', {
-          symbol: 'AAPL',
-          page: 1,
-        });
-        expect(result).toEqual(mockResponse);
-      });
-
-      it('should use default page value when not provided', async () => {
-        const mockResponse = { success: true, data: [] };
-        mockClient.get.mockResolvedValue(mockResponse);
-
-        const result = await fmp.insider.getInsiderTradesBySymbol('AAPL');
+      it(
+        'should return insider trades for a specific symbol',
+        async () => {
+          if (shouldSkipTests()) {
+            console.log('Skipping insider trades by symbol test - no API key available');
+            return;
+          }
+
+          const result = await fmp.insider.getInsiderTradesBySymbol('AAPL', 0);
+
+          expect(result.success).toBe(true);
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+
+          if (result.data && result.data.length > 0) {
+            const firstTrade = result.data[0];
+            expect(firstTrade).toHaveProperty('symbol');
+            expect(firstTrade.symbol).toBe('AAPL');
+          }
+        },
+        API_TIMEOUT,
+      );
 
-        expect(mockClient.get).toHaveBeenCalledWith('/insider-trading', 'v4', {
-          symbol: 'AAPL',
-          page: 0,
-        });
-        expect(result).toEqual(mockResponse);
-      });
+      it(
+        'should use default page value when not provided',
+        async () => {
+          if (shouldSkipTests()) {
+            console.log(
+              'Skipping insider trades by symbol default page test - no API key available',
+            );
+            return;
+          }
+
+          const result = await fmp.insider.getInsiderTradesBySymbol('AAPL');
+
+          expect(result.success).toBe(true);
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+        },
+        API_TIMEOUT,
+      );
     });
 
     describe('getInsiderTradesByType', () => {
-      it('should call searchInsiderTrading with transaction type parameter', async () => {
-        const mockResponse = { success: true, data: [] };
-        mockClient.get.mockResolvedValue(mockResponse);
-
-        const result = await fmp.insider.getInsiderTradesByType(TransactionType.SALE, 1);
+      it(
+        'should return insider trades filtered by transaction type',
+        async () => {
+          if (shouldSkipTests()) {
+            console.log('Skipping insider trades by type test - no API key available');
+            return;
+          }
+
+          const result = await fmp.insider.getInsiderTradesByType(TransactionType.SALE, 0);
+
+          expect(result.success).toBe(true);
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+
+          if (result.data && result.data.length > 0) {
+            const firstTrade = result.data[0];
+            expect(firstTrade).toHaveProperty('transactionType');
+            expect(firstTrade.transactionType).toBe(TransactionType.SALE);
+          }
+        },
+        API_TIMEOUT,
+      );
 
-        expect(mockClient.get).toHaveBeenCalledWith('/insider-trading', 'v4', {
-          transactionType: TransactionType.SALE,
-          page: 1,
-        });
-        expect(result).toEqual(mockResponse);
-      });
+      it(
+        'should use default page value when not provided',
+        async () => {
+          if (shouldSkipTests()) {
+            console.log('Skipping insider trades by type default page test - no API key available');
+            return;
+          }
+
+          const result = await fmp.insider.getInsiderTradesByType(TransactionType.SALE);
+
+          expect(result.success).toBe(true);
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+        },
+        API_TIMEOUT,
+      );
     });
 
     describe('getInsiderTradesByReportingCik', () => {
-      it('should call searchInsiderTrading with reporting CIK parameter', async () => {
-        const mockResponse = { success: true, data: [] };
-        mockClient.get.mockResolvedValue(mockResponse);
-
-        const result = await fmp.insider.getInsiderTradesByReportingCik('0001767094', 1);
+      it(
+        'should return insider trades filtered by reporting CIK',
+        async () => {
+          if (shouldSkipTests()) {
+            console.log('Skipping insider trades by reporting CIK test - no API key available');
+            return;
+          }
+
+          const result = await fmp.insider.getInsiderTradesByReportingCik('0000320193', 0);
+
+          expect(result.success).toBe(true);
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+
+          if (result.data && result.data.length > 0) {
+            const firstTrade = result.data[0];
+            expect(firstTrade).toHaveProperty('reportingCik');
+          }
+        },
+        API_TIMEOUT,
+      );
 
-        expect(mockClient.get).toHaveBeenCalledWith('/insider-trading', 'v4', {
-          reportingCik: '0001767094',
-          page: 1,
-        });
-        expect(result).toEqual(mockResponse);
-      });
+      it(
+        'should use default page value when not provided',
+        async () => {
+          if (shouldSkipTests()) {
+            console.log(
+              'Skipping insider trades by reporting CIK default page test - no API key available',
+            );
+            return;
+          }
+
+          const result = await fmp.insider.getInsiderTradesByReportingCik('0000320193');
+
+          expect(result.success).toBe(true);
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+        },
+        API_TIMEOUT,
+      );
     });
 
     describe('getInsiderTradesByCompanyCik', () => {
-      it('should call searchInsiderTrading with company CIK parameter', async () => {
-        const mockResponse = { success: true, data: [] };
-        mockClient.get.mockResolvedValue(mockResponse);
-
-        const result = await fmp.insider.getInsiderTradesByCompanyCik('0000320193', 1);
+      it(
+        'should return insider trades filtered by company CIK',
+        async () => {
+          if (shouldSkipTests()) {
+            console.log('Skipping insider trades by company CIK test - no API key available');
+            return;
+          }
+
+          const result = await fmp.insider.getInsiderTradesByCompanyCik('0000320193', 0);
+
+          expect(result.success).toBe(true);
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+
+          if (result.data && result.data.length > 0) {
+            const firstTrade = result.data[0];
+            expect(firstTrade).toHaveProperty('companyCik');
+          }
+        },
+        API_TIMEOUT,
+      );
 
-        expect(mockClient.get).toHaveBeenCalledWith('/insider-trading', 'v4', {
-          companyCik: '0000320193',
-          page: 1,
-        });
-        expect(result).toEqual(mockResponse);
-      });
+      it(
+        'should use default page value when not provided',
+        async () => {
+          if (shouldSkipTests()) {
+            console.log(
+              'Skipping insider trades by company CIK default page test - no API key available',
+            );
+            return;
+          }
+
+          const result = await fmp.insider.getInsiderTradesByCompanyCik('0000320193');
+
+          expect(result.success).toBe(true);
+          expect(result.data).not.toBeNull();
+          expect(Array.isArray(result.data)).toBe(true);
+        },
+        API_TIMEOUT,
+      );
     });
   });
 });
diff --git a/packages/api/src/__tests__/endpoints/news.test.ts b/packages/api/src/__tests__/endpoints/news.test.ts
new file mode 100644
index 0000000..c2da2e3
--- /dev/null
+++ b/packages/api/src/__tests__/endpoints/news.test.ts
@@ -0,0 +1,446 @@
+import { FMP } from '../../fmp';
+import { shouldSkipTests, createTestClient, API_TIMEOUT, FAST_TIMEOUT } from '../utils/test-setup';
+import type { News, Article } from 'fmp-node-types';
+
+// Helper function to validate news article structure
+function validateNewsArticle(news: News): void {
+  expect(news.symbol).toBeDefined();
+  expect(typeof news.symbol).toBe('string');
+  expect(news.publishedDate).toBeDefined();
+  expect(typeof news.publishedDate).toBe('string');
+  expect(news.publisher).toBeDefined();
+  expect(typeof news.publisher).toBe('string');
+  expect(news.title).toBeDefined();
+  expect(typeof news.title).toBe('string');
+  expect(news.text).toBeDefined();
+  expect(typeof news.text).toBe('string');
+  expect(news.url).toBeDefined();
+  expect(typeof news.url).toBe('string');
+  expect(news.site).toBeDefined();
+  expect(typeof news.site).toBe('string');
+  expect(news.image).toBeDefined();
+  // Image can be string or object depending on API response
+  expect(typeof news.image === 'string' || typeof news.image === 'object').toBe(true);
+}
+
+// Helper function to validate FMP article structure
+function validateFMPArticle(article: Article): void {
+  expect(article.title).toBeDefined();
+  expect(typeof article.title).toBe('string');
+  expect(article.date).toBeDefined();
+  expect(typeof article.date).toBe('string');
+  expect(article.content).toBeDefined();
+  expect(typeof article.content).toBe('string');
+  expect(article.link).toBeDefined();
+  expect(typeof article.link).toBe('string');
+  expect(article.author).toBeDefined();
+  expect(typeof article.author).toBe('string');
+  expect(article.site).toBeDefined();
+  expect(typeof article.site).toBe('string');
+  expect(article.tickers).toBeDefined();
+  expect(typeof article.tickers).toBe('string');
+  expect(article.image).toBeDefined();
+  expect(typeof article.image).toBe('string');
+}
+
+describe('NewsEndpoints Integration Tests', () => {
+  let fmp: FMP;
+
+  beforeAll(async () => {
+    if (shouldSkipTests()) {
+      console.log('Skipping news integration tests - no API key available');
+      return;
+    }
+    fmp = createTestClient();
+  });
+
+  describe('getArticles', () => {
+    it(
+      'should fetch FMP articles successfully',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getArticles({ page: 1, limit: 5 });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const article = result.data[0];
+          validateFMPArticle(article);
+        }
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should fetch FMP articles with pagination',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getArticles({ page: 2, limit: 3 });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should handle pagination correctly',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        // Test with a reasonable page number
+        const result = await fmp.news.getArticles({ page: 5, limit: 2 });
+
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+        // Should return data or empty array, but not error
+        if (result.data) {
+          expect(result.data.length).toBeLessThanOrEqual(2);
+        }
+      },
+      FAST_TIMEOUT,
+    );
+  });
+
+  describe('getStockNews', () => {
+    it(
+      'should fetch stock news successfully',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getStockNews({ limit: 5 });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const news = result.data[0];
+          validateNewsArticle(news);
+        }
+      },
+      FAST_TIMEOUT,
+    );
+
+    it(
+      'should fetch stock news with date range',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getStockNews({
+          from: '2024-01-01',
+          to: '2024-01-15',
+          limit: 3,
+        });
+
+        // API might return success: false if no data for date range
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        // Data might be null/undefined or array depending on API response
+        if (result.data !== null && result.data !== undefined) {
+          expect(Array.isArray(result.data)).toBe(true);
+        }
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should fetch stock news with pagination',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getStockNews({
+          page: 1,
+          limit: 10,
+        });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+      },
+      API_TIMEOUT,
+    );
+  });
+
+  describe('getCryptoNews', () => {
+    it(
+      'should fetch crypto news successfully',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getCryptoNews({ limit: 5 });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const news = result.data[0];
+          validateNewsArticle(news);
+        }
+      },
+      FAST_TIMEOUT,
+    );
+
+    it(
+      'should fetch crypto news with date range',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getCryptoNews({
+          from: '2024-01-01',
+          to: '2024-01-15',
+          limit: 3,
+        });
+
+        // API might return success: false if no data for date range
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        // Data might be null/undefined or array depending on API response
+        if (result.data !== null && result.data !== undefined) {
+          expect(Array.isArray(result.data)).toBe(true);
+        }
+      },
+      API_TIMEOUT,
+    );
+  });
+
+  describe('getForexNews', () => {
+    it(
+      'should fetch forex news successfully',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getForexNews({ limit: 5 });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const news = result.data[0];
+          validateNewsArticle(news);
+        }
+      },
+      FAST_TIMEOUT,
+    );
+
+    it(
+      'should fetch forex news with date range',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getForexNews({
+          from: '2024-01-01',
+          to: '2024-01-15',
+          limit: 3,
+        });
+
+        // API might return success: false if no data for date range
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        // Data might be null/undefined or array depending on API response
+        if (result.data !== null && result.data !== undefined) {
+          expect(Array.isArray(result.data)).toBe(true);
+        }
+      },
+      API_TIMEOUT,
+    );
+  });
+
+  describe('getStockNewsBySymbol', () => {
+    it(
+      'should fetch stock news for specific symbols',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getStockNewsBySymbol({
+          symbols: ['AAPL'],
+          limit: 3,
+        });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const news = result.data[0];
+          validateNewsArticle(news);
+        }
+      },
+      FAST_TIMEOUT,
+    );
+
+    it(
+      'should fetch stock news for multiple symbols',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getStockNewsBySymbol({
+          symbols: ['AAPL', 'MSFT'],
+          limit: 5,
+        });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should handle invalid symbols gracefully',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getStockNewsBySymbol({
+          symbols: ['INVALID_SYMBOL_12345'],
+          limit: 3,
+        });
+
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+        // Should return empty array for invalid symbols
+        if (result.data) {
+          expect(result.data.length).toBe(0);
+        }
+      },
+      FAST_TIMEOUT,
+    );
+  });
+
+  describe('getCryptoNewsBySymbol', () => {
+    it(
+      'should fetch crypto news for specific symbols',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getCryptoNewsBySymbol({
+          symbols: ['BTCUSD'],
+          limit: 3,
+        });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const news = result.data[0];
+          validateNewsArticle(news);
+        }
+      },
+      FAST_TIMEOUT,
+    );
+
+    it(
+      'should fetch crypto news for multiple symbols',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getCryptoNewsBySymbol({
+          symbols: ['BTCUSD', 'ETHUSD'],
+          limit: 5,
+        });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should fetch crypto news with date range',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getCryptoNewsBySymbol({
+          symbols: ['BTCUSD'],
+          from: '2024-01-01',
+          to: '2024-01-15',
+          limit: 3,
+        });
+
+        // API might return success: false if no data for date range
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        // Data might be null/undefined or array depending on API response
+        if (result.data !== null && result.data !== undefined) {
+          expect(Array.isArray(result.data)).toBe(true);
+        }
+      },
+      API_TIMEOUT,
+    );
+  });
+
+  describe('getForexNewsBySymbol', () => {
+    it(
+      'should fetch forex news for specific symbols',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getForexNewsBySymbol({
+          symbols: ['EURUSD'],
+          limit: 3,
+        });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+
+        if (result.data && result.data.length > 0) {
+          const news = result.data[0];
+          validateNewsArticle(news);
+        }
+      },
+      FAST_TIMEOUT,
+    );
+
+    it(
+      'should fetch forex news for multiple symbols',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getForexNewsBySymbol({
+          symbols: ['EURUSD', 'GBPUSD'],
+          limit: 5,
+        });
+
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+        expect(Array.isArray(result.data)).toBe(true);
+      },
+      API_TIMEOUT,
+    );
+
+    it(
+      'should fetch forex news with date range',
+      async () => {
+        if (shouldSkipTests()) return;
+
+        const result = await fmp.news.getForexNewsBySymbol({
+          symbols: ['EURUSD'],
+          from: '2024-01-01',
+          to: '2024-01-15',
+          limit: 3,
+        });
+
+        // API might return success: false if no data for date range
+        expect(result).toBeDefined();
+        expect(result.data).toBeDefined();
+        // Data might be null/undefined or array depending on API response
+        if (result.data !== null && result.data !== undefined) {
+          expect(Array.isArray(result.data)).toBe(true);
+        }
+      },
+      API_TIMEOUT,
+    );
+  });
+});
diff --git a/packages/api/src/endpoints/insider.ts b/packages/api/src/endpoints/insider.ts
index b51bb8e..f747e91 100644
--- a/packages/api/src/endpoints/insider.ts
+++ b/packages/api/src/endpoints/insider.ts
@@ -25,6 +25,7 @@ export class InsiderEndpoints {
    *
    * @param params - RSS feed request parameters
    * @param params.page - Page number for pagination (default: 0)
+   * @param params.limit - Limit number of results (default: 100)
    *
    * @returns Promise resolving to array of insider trading RSS feed data
    *
@@ -40,13 +41,14 @@ export class InsiderEndpoints {
    * const nextPage = await fmp.insider.getInsiderTradingRSS({ page: 1 });
    * ```
    *
-   * @see {@link https://site.financialmodelingprep.com/developer/docs#insider-trades-rss-insider-trading|FMP Insider Trading RSS Documentation}
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#latest-insider-trade|FMP Insider Trading RSS Documentation}
    */
   async getInsiderTradingRSS(params: {
     page?: number;
+    limit?: number;
   }): Promise<APIResponse<InsiderTradingRSSResponse[]>> {
-    const { page = 0 } = params;
-    return this.client.get(`/insider-trading-rss-feed`, 'v4', { page });
+    const { page = 0, limit = 100 } = params;
+    return this.client.get(`/insider-trading/latest`, 'stable', { page, limit });
   }
 
   /**
@@ -62,6 +64,7 @@ export class InsiderEndpoints {
    * @param params.companyCik - Company CIK to filter by (optional)
    * @param params.transactionType - Transaction type to filter by (optional)
    * @param params.page - Page number for pagination (default: 0)
+   * @param params.limit - Limit number of results (default: 100)
    *
    * @returns Promise resolving to array of insider trading search results
    *
@@ -89,7 +92,7 @@ export class InsiderEndpoints {
    * });
    * ```
    *
-   * @see {@link https://site.financialmodelingprep.com/developer/docs#insider-trades-search-insider-trading|FMP Insider Trading Search Documentation}
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#search-insider-trades|FMP Insider Trading Search Documentation}
    */
   async searchInsiderTrading(params: {
     symbol?: string;
@@ -97,16 +100,17 @@ export class InsiderEndpoints {
     companyCik?: string;
     transactionType?: string;
     page?: number;
+    limit?: number;
   }): Promise<APIResponse<InsiderTradingSearchResponse[]>> {
-    const { symbol, reportingCik, companyCik, transactionType, page = 0 } = params;
-    const queryParams: Record<string, string | number> = { page };
+    const { symbol, reportingCik, companyCik, transactionType, page = 0, limit = 100 } = params;
+    const queryParams: Record<string, string | number> = { page, limit };
 
     if (symbol) queryParams.symbol = symbol;
     if (reportingCik) queryParams.reportingCik = reportingCik;
     if (companyCik) queryParams.companyCik = companyCik;
     if (transactionType) queryParams.transactionType = transactionType;
 
-    return this.client.get(`/insider-trading`, 'v4', queryParams);
+    return this.client.get(`/insider-trading/search`, 'stable', queryParams);
   }
 
   /**
@@ -127,10 +131,10 @@ export class InsiderEndpoints {
    * });
    * ```
    *
-   * @see {@link https://site.financialmodelingprep.com/developer/docs#transaction-types-insider-trading|FMP Transaction Types Documentation}
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#all-transaction-types|FMP Transaction Types Documentation}
    */
   async getTransactionTypes(): Promise<APIResponse<TransactionTypesResponse>> {
-    return this.client.get(`/insider-trading-transaction-type`, 'v4');
+    return this.client.get(`/insider-trading-transaction-type`, 'stable');
   }
 
   /**
@@ -140,6 +144,8 @@ export class InsiderEndpoints {
    * for a specific company. Essential for understanding corporate governance
    * structure and identifying key personnel.
    *
+   * @deprecated This endpoint uses API version v4 which will be deprecated.
+   *
    * @param params - Insiders request parameters
    * @param params.symbol - Stock symbol to get insiders for
    *
@@ -190,13 +196,13 @@ export class InsiderEndpoints {
    * const msftStats = await fmp.insider.getInsiderTradeStatistics({ symbol: 'MSFT' });
    * ```
    *
-   * @see {@link https://site.financialmodelingprep.com/developer/docs#insider-trade-statistics-insider-trading|FMP Insider Trade Statistics Documentation}
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#insider-trade-statistics|FMP Insider Trade Statistics Documentation}
    */
   async getInsiderTradeStatistics(params: {
     symbol: string;
   }): Promise<APIResponse<InsiderTradeStatisticsResponse[]>> {
     const { symbol } = params;
-    return this.client.get(`/insider-roaster-statistic`, 'v4', { symbol });
+    return this.client.get(`/insider-trading/statistics`, 'stable', { symbol });
   }
 
   /**
@@ -206,6 +212,8 @@ export class InsiderEndpoints {
    * names. Essential for converting between CIK numbers and company
    * identifiers in insider trading analysis.
    *
+   * @deprecated This endpoint uses API version v4 which will be deprecated.
+   *
    * @param params - CIK mapper request parameters
    * @param params.page - Page number for pagination (default: 0)
    *
@@ -237,6 +245,8 @@ export class InsiderEndpoints {
    * Useful for finding companies by partial name matches and
    * converting company names to CIK numbers.
    *
+   * @deprecated This endpoint uses API version v4 which will be deprecated.
+   *
    * @param params - CIK mapper by name request parameters
    * @param params.name - Company name or partial name to search for
    * @param params.page - Page number for pagination (default: 0)
@@ -278,6 +288,8 @@ export class InsiderEndpoints {
    * Essential for converting stock symbols to CIK numbers for use
    * in insider trading searches and analysis.
    *
+   * @deprecated This endpoint uses API version v4 which will be deprecated.
+   *
    * @param params - CIK mapper by symbol request parameters
    * @param params.symbol - Stock symbol to get CIK for
    *
@@ -311,6 +323,7 @@ export class InsiderEndpoints {
    *
    * @param params - Beneficial ownership request parameters
    * @param params.symbol - Stock symbol to get beneficial ownership data for
+   * @param params.limit - Limit number of results (default: 100)
    *
    * @returns Promise resolving to array of beneficial ownership acquisition data
    *
@@ -330,10 +343,12 @@ export class InsiderEndpoints {
    */
   async getBeneficialOwnership(params: {
     symbol: string;
+    limit?: number;
   }): Promise<APIResponse<BeneficialOwnershipResponse[]>> {
-    const { symbol } = params;
-    return this.client.get(`/insider/ownership/acquisition_of_beneficial_ownership`, 'v4', {
+    const { symbol, limit = 100 } = params;
+    return this.client.get(`/acquisition-of-beneficial-ownership`, 'stable', {
       symbol,
+      limit,
     });
   }
 
@@ -344,6 +359,8 @@ export class InsiderEndpoints {
    * when market participants fail to deliver securities on settlement date.
    * Important for understanding market mechanics and potential short interest.
    *
+   * @deprecated This endpoint uses API version v4 which will be deprecated.
+   *
    * @param params - Fail to deliver request parameters
    * @param params.symbol - Stock symbol to get fail to deliver data for
    * @param params.page - Page number for pagination (default: 0)
diff --git a/packages/api/src/endpoints/news.ts b/packages/api/src/endpoints/news.ts
new file mode 100644
index 0000000..188acf0
--- /dev/null
+++ b/packages/api/src/endpoints/news.ts
@@ -0,0 +1,346 @@
+// News endpoints for FMP API
+
+import { FMPClient } from '@/client';
+import { APIResponse, Article, News } from 'fmp-node-types';
+
+export class NewsEndpoints {
+  constructor(private client: FMPClient) {}
+
+  /**
+   * Get FMP's curated financial articles and market insights
+   *
+   * Retrieves Financial Modeling Prep's own articles covering market analysis,
+   * financial insights, and educational content. These articles provide valuable
+   * context and analysis beyond raw market data.
+   *
+   * @param params - Article request parameters
+   * @param params.page - Page number for pagination (optional, defaults to 1)
+   * @param params.limit - Number of articles per page (optional, defaults to 100)
+   *
+   * @returns Promise resolving to an array of FMP articles with content and metadata
+   *
+   * @example
+   * ```typescript
+   * // Get latest FMP articles
+   * const articles = await fmp.news.getArticles({
+   *   page: 1,
+   *   limit: 10
+   * });
+   *
+   * // Get first page with default limit
+   * const latestArticles = await fmp.news.getArticles({ page: 1 });
+   * ```
+   *
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#fmp-articles|FMP Articles Documentation}
+   */
+  async getArticles(
+    params: { page?: number; limit?: number } = {},
+  ): Promise<APIResponse<Article[]>> {
+    const { page = 1, limit = 100 } = params;
+    return this.client.get('/fmp-articles', 'stable', { page, limit });
+  }
+
+  /**
+   * Get latest stock market news from various financial sources
+   *
+   * Retrieves the most recent stock market news articles from multiple financial
+   * news sources. Perfect for staying updated on market movements, earnings
+   * announcements, and corporate developments.
+   *
+   * @param params - Stock news request parameters
+   * @param params.from - Start date in YYYY-MM-DD format (optional)
+   * @param params.to - End date in YYYY-MM-DD format (optional)
+   * @param params.page - Page number for pagination (optional, defaults to 1)
+   * @param params.limit - Number of articles per page (optional, defaults to 100)
+   *
+   * @returns Promise resolving to an array of stock news articles with timestamps and sources
+   *
+   * @example
+   * ```typescript
+   * // Get latest stock news
+   * const stockNews = await fmp.news.getStockNews({
+   *   limit: 20
+   * });
+   *
+   * // Get stock news from specific date range
+   * const recentNews = await fmp.news.getStockNews({
+   *   from: '2024-01-01',
+   *   to: '2024-01-15',
+   *   limit: 50
+   * });
+   * ```
+   *
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#stock-news|Stock News Documentation}
+   */
+  async getStockNews(
+    params: {
+      from?: string;
+      to?: string;
+      page?: number;
+      limit?: number;
+    } = {},
+  ): Promise<APIResponse<News[]>> {
+    const { from, to, page = 1, limit = 100 } = params;
+    const queryParams: { from?: string; to?: string; page: number; limit: number } = {
+      page,
+      limit,
+    };
+    if (from) queryParams.from = from;
+    if (to) queryParams.to = to;
+    return this.client.get('/news/stock-latest', 'stable', queryParams);
+  }
+
+  /**
+   * Get latest cryptocurrency news from various sources
+   *
+   * Retrieves the most recent cryptocurrency news articles covering market trends,
+   * regulatory updates, technology developments, and major crypto events.
+   * Essential for crypto traders and investors.
+   *
+   * @param params - Crypto news request parameters
+   * @param params.from - Start date in YYYY-MM-DD format (optional)
+   * @param params.to - End date in YYYY-MM-DD format (optional)
+   * @param params.page - Page number for pagination (optional, defaults to 1)
+   * @param params.limit - Number of articles per page (optional, defaults to 100)
+   *
+   * @returns Promise resolving to an array of cryptocurrency news articles
+   *
+   * @example
+   * ```typescript
+   * // Get latest crypto news
+   * const cryptoNews = await fmp.news.getCryptoNews({
+   *   limit: 15
+   * });
+   *
+   * // Get crypto news from last week
+   * const weeklyCryptoNews = await fmp.news.getCryptoNews({
+   *   from: '2024-01-08',
+   *   to: '2024-01-15'
+   * });
+   * ```
+   *
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#crypto-news|Crypto News Documentation}
+   */
+  async getCryptoNews(
+    params: {
+      from?: string;
+      to?: string;
+      page?: number;
+      limit?: number;
+    } = {},
+  ): Promise<APIResponse<News[]>> {
+    const { from, to, page = 1, limit = 100 } = params;
+    const queryParams: { from?: string; to?: string; page: number; limit: number } = {
+      page,
+      limit,
+    };
+    if (from) queryParams.from = from;
+    if (to) queryParams.to = to;
+    return this.client.get('/news/crypto-latest', 'stable', queryParams);
+  }
+
+  /**
+   * Get latest forex (foreign exchange) market news
+   *
+   * Retrieves the most recent forex market news covering currency movements,
+   * central bank announcements, economic indicators, and geopolitical events
+   * that impact currency markets.
+   *
+   * @param params - Forex news request parameters
+   * @param params.from - Start date in YYYY-MM-DD format (optional)
+   * @param params.to - End date in YYYY-MM-DD format (optional)
+   * @param params.page - Page number for pagination (optional, defaults to 1)
+   * @param params.limit - Number of articles per page (optional, defaults to 100)
+   *
+   * @returns Promise resolving to an array of forex news articles
+   *
+   * @example
+   * ```typescript
+   * // Get latest forex news
+   * const forexNews = await fmp.news.getForexNews({
+   *   limit: 25
+   * });
+   *
+   * // Get forex news from specific period
+   * const forexUpdates = await fmp.news.getForexNews({
+   *   from: '2024-01-10',
+   *   limit: 30
+   * });
+   * ```
+   *
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#forex-news|Forex News Documentation}
+   */
+  async getForexNews(
+    params: {
+      from?: string;
+      to?: string;
+      page?: number;
+      limit?: number;
+    } = {},
+  ): Promise<APIResponse<News[]>> {
+    const { from, to, page = 1, limit = 100 } = params;
+    const queryParams: { from?: string; to?: string; page: number; limit: number } = {
+      page,
+      limit,
+    };
+    if (from) queryParams.from = from;
+    if (to) queryParams.to = to;
+    return this.client.get('/news/forex-latest', 'stable', queryParams);
+  }
+
+  /**
+   * Get stock news filtered by specific company symbols
+   *
+   * Retrieves news articles specifically related to the provided stock symbols.
+   * Perfect for monitoring news about specific companies in your portfolio or
+   * watchlist. Supports multiple symbols for efficient batch news retrieval.
+   *
+   * @param params - Symbol-specific stock news request parameters
+   * @param params.symbols - Array of stock symbols to get news for (required)
+   * @param params.from - Start date in YYYY-MM-DD format (optional)
+   * @param params.to - End date in YYYY-MM-DD format (optional)
+   * @param params.page - Page number for pagination (optional, defaults to 1)
+   * @param params.limit - Number of articles per page (optional, defaults to 100)
+   *
+   * @returns Promise resolving to an array of news articles filtered by the specified symbols
+   *
+   * @example
+   * ```typescript
+   * // Get news for specific stocks
+   * const appleNews = await fmp.news.getStockNewsBySymbol({
+   *   symbols: ['AAPL'],
+   *   limit: 10
+   * });
+   *
+   * // Get news for multiple tech stocks
+   * const techNews = await fmp.news.getStockNewsBySymbol({
+   *   symbols: ['AAPL', 'MSFT', 'GOOGL', 'AMZN'],
+   *   from: '2024-01-01',
+   *   limit: 20
+   * });
+   * ```
+   *
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#search-stock-news|Search Stock News Documentation}
+   */
+  async getStockNewsBySymbol(params: {
+    symbols: string[];
+    from?: string;
+    to?: string;
+    page?: number;
+    limit?: number;
+  }): Promise<APIResponse<News[]>> {
+    const { symbols, from, to, page = 1, limit = 100 } = params;
+    const symbolsString = symbols.join(',');
+    const queryParams: { from?: string; to?: string; page: number; limit: number } = {
+      page,
+      limit,
+    };
+    if (from) queryParams.from = from;
+    if (to) queryParams.to = to;
+    return this.client.get(`/news/stock?symbols=${symbolsString}`, 'stable', queryParams);
+  }
+
+  /**
+   * Get cryptocurrency news filtered by specific crypto symbols
+   *
+   * Retrieves news articles specifically related to the provided cryptocurrency
+   * symbols. Ideal for monitoring news about specific cryptocurrencies in your
+   * portfolio or tracking particular digital assets.
+   *
+   * @param params - Symbol-specific crypto news request parameters
+   * @param params.symbols - Array of cryptocurrency symbols to get news for (required)
+   * @param params.from - Start date in YYYY-MM-DD format (optional)
+   * @param params.to - End date in YYYY-MM-DD format (optional)
+   * @param params.page - Page number for pagination (optional, defaults to 1)
+   * @param params.limit - Number of articles per page (optional, defaults to 100)
+   *
+   * @returns Promise resolving to an array of news articles filtered by the specified crypto symbols
+   *
+   * @example
+   * ```typescript
+   * // Get news for Bitcoin
+   * const bitcoinNews = await fmp.news.getCryptoNewsBySymbol({
+   *   symbols: ['BTCUSD'],
+   *   limit: 15
+   * });
+   *
+   * // Get news for multiple cryptocurrencies
+   * const cryptoNews = await fmp.news.getCryptoNewsBySymbol({
+   *   symbols: ['BTCUSD', 'ETHUSD', 'ADAUSD'],
+   *   from: '2024-01-01',
+   *   limit: 25
+   * });
+   * ```
+   *
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#search-crypto-news|Search Crypto News Documentation}
+   */
+  async getCryptoNewsBySymbol(params: {
+    symbols: string[];
+    from?: string;
+    to?: string;
+    page?: number;
+    limit?: number;
+  }): Promise<APIResponse<News[]>> {
+    const { symbols, from, to, page = 1, limit = 100 } = params;
+    const symbolsString = symbols.join(',');
+    const queryParams: { from?: string; to?: string; page: number; limit: number } = {
+      page,
+      limit,
+    };
+    if (from) queryParams.from = from;
+    if (to) queryParams.to = to;
+    return this.client.get(`/news/crypto?symbols=${symbolsString}`, 'stable', queryParams);
+  }
+
+  /**
+   * Get forex news filtered by specific currency pair symbols
+   *
+   * Retrieves news articles specifically related to the provided forex currency
+   * pairs. Perfect for monitoring news about specific currency pairs you're
+   * trading or analyzing for forex market movements.
+   *
+   * @param params - Symbol-specific forex news request parameters
+   * @param params.symbols - Array of forex currency pair symbols to get news for (required)
+   * @param params.from - Start date in YYYY-MM-DD format (optional)
+   * @param params.to - End date in YYYY-MM-DD format (optional)
+   * @param params.page - Page number for pagination (optional, defaults to 1)
+   * @param params.limit - Number of articles per page (optional, defaults to 100)
+   *
+   * @returns Promise resolving to an array of news articles filtered by the specified forex symbols
+   *
+   * @example
+   * ```typescript
+   * // Get news for EUR/USD pair
+   * const eurUsdNews = await fmp.news.getForexNewsBySymbol({
+   *   symbols: ['EURUSD'],
+   *   limit: 10
+   * });
+   *
+   * // Get news for multiple currency pairs
+   * const forexNews = await fmp.news.getForexNewsBySymbol({
+   *   symbols: ['EURUSD', 'GBPUSD', 'USDJPY'],
+   *   from: '2024-01-01',
+   *   limit: 20
+   * });
+   * ```
+   *
+   * @see {@link https://site.financialmodelingprep.com/developer/docs#search-forex-news|Search Forex News Documentation}
+   */
+  async getForexNewsBySymbol(params: {
+    symbols: string[];
+    from?: string;
+    to?: string;
+    page?: number;
+    limit?: number;
+  }): Promise<APIResponse<News[]>> {
+    const { symbols, from, to, page = 1, limit = 100 } = params;
+    const symbolsString = symbols.join(',');
+    const queryParams: { from?: string; to?: string; page: number; limit: number } = {
+      page,
+      limit,
+    };
+    if (from) queryParams.from = from;
+    if (to) queryParams.to = to;
+    return this.client.get(`/news/forex?symbols=${symbolsString}`, 'stable', queryParams);
+  }
+}
diff --git a/packages/api/src/fmp.ts b/packages/api/src/fmp.ts
index 07cea6a..6613417 100644
--- a/packages/api/src/fmp.ts
+++ b/packages/api/src/fmp.ts
@@ -14,6 +14,7 @@ import { InstitutionalEndpoints } from './endpoints/institutional';
 import { ListEndpoints } from './endpoints/list';
 import { MarketEndpoints } from './endpoints/market';
 import { MutualFundEndpoints } from './endpoints/mutual-fund';
+import { NewsEndpoints } from './endpoints/news';
 import { QuoteEndpoints } from './endpoints/quote';
 import { ScreenerEndpoints } from './endpoints/screener';
 import { SECEndpoints } from './endpoints/sec';
@@ -61,6 +62,7 @@ export class FMP {
   public readonly list: ListEndpoints;
   public readonly market: MarketEndpoints;
   public readonly mutualFund: MutualFundEndpoints;
+  public readonly news: NewsEndpoints;
   public readonly quote: QuoteEndpoints;
   public readonly screener: ScreenerEndpoints;
   public readonly sec: SECEndpoints;
@@ -94,6 +96,7 @@ export class FMP {
     this.list = new ListEndpoints(client);
     this.market = new MarketEndpoints(client);
     this.mutualFund = new MutualFundEndpoints(client);
+    this.news = new NewsEndpoints(client);
     this.quote = new QuoteEndpoints(client);
     this.screener = new ScreenerEndpoints(client);
     this.sec = new SECEndpoints(client);
diff --git a/packages/api/src/index.ts b/packages/api/src/index.ts
index c067218..16df88f 100644
--- a/packages/api/src/index.ts
+++ b/packages/api/src/index.ts
@@ -10,19 +10,21 @@ export { FMPClient } from './client';
 export type * from 'fmp-node-types';
 
 // Export endpoint classes for tree-shaking
-export { QuoteEndpoints } from './endpoints/quote';
-export { StockEndpoints } from './endpoints/stock';
-export { FinancialEndpoints } from './endpoints/financial';
+export { CalendarEndpoints } from './endpoints/calendar';
 export { CompanyEndpoints } from './endpoints/company';
-export { ETFEndpoints } from './endpoints/etf';
-export { MutualFundEndpoints } from './endpoints/mutual-fund';
-export { MarketEndpoints } from './endpoints/market';
 export { EconomicEndpoints } from './endpoints/economic';
+export { ETFEndpoints } from './endpoints/etf';
+export { FinancialEndpoints } from './endpoints/financial';
+export { InsiderEndpoints } from './endpoints/insider';
+export { InstitutionalEndpoints } from './endpoints/institutional';
 export { ListEndpoints } from './endpoints/list';
-export { CalendarEndpoints } from './endpoints/calendar';
+export { MarketEndpoints } from './endpoints/market';
+export { MutualFundEndpoints } from './endpoints/mutual-fund';
+export { NewsEndpoints } from './endpoints/news';
+export { QuoteEndpoints } from './endpoints/quote';
+export { ScreenerEndpoints } from './endpoints/screener';
+export { StockEndpoints } from './endpoints/stock';
 export { SenateHouseEndpoints } from './endpoints/senate-house';
-export { InstitutionalEndpoints } from './endpoints/institutional';
-export { InsiderEndpoints } from './endpoints/insider';
 export { SECEndpoints } from './endpoints/sec';
 
 // Export commonly used utilities
diff --git a/packages/tools/CHANGELOG.md b/packages/tools/CHANGELOG.md
index b904b7e..038f866 100644
--- a/packages/tools/CHANGELOG.md
+++ b/packages/tools/CHANGELOG.md
@@ -1,5 +1,13 @@
 # fmp-ai-tools
 
+## 0.0.12
+
+### Patch Changes
+
+- Added news endpoints - fmp-node-api, added shares float and executive compensation to fmp-ai-tools
+- Updated dependencies
+  - fmp-node-api@0.1.9
+
 ## 0.0.11
 
 ### Patch Changes
diff --git a/packages/tools/README.md b/packages/tools/README.md
index 1280d44..4effcb8 100644
--- a/packages/tools/README.md
+++ b/packages/tools/README.md
@@ -30,7 +30,7 @@ yarn add ai zod
 **Required versions:**
 
 - `ai`: ^5.0.0
-- `zod`: ^3.25.76 || ^4.0.0
+- `zod`: ^3.25.76
 
 **⚠️ Common Issue**: If you encounter the error `Invalid schema for function 'getStockQuote': schema must be a JSON Schema of 'type: "object"', got 'type: "None"'`, it means you have a version mismatch between `ai` and `zod`. Make sure you're using compatible versions as listed above.
 
@@ -38,14 +38,10 @@ yarn add ai zod
 
 ### OpenAI Agents Compatibility
 
-**⚠️ Important**: This package requires `@openai/agents` version `^0.0.17` or higher due to breaking changes in the API.
+**⚠️ Important**: This package requires `@openai/agents` version `^0.1.0` or higher due to breaking changes in the API.
 
 If you're using an older version, you'll encounter errors like:
 
-```
-Zod field uses .optional() without .nullable() which is not supported by the API
-```
-
 ## Quick Start
 
 ### Vercel AI SDK (Recommended)
@@ -100,6 +96,8 @@ const result = await agent.run({
 FMP_API_KEY=your_api_key_here
 ```
 
+Get your API key from [Financial Modeling Prep](https://site.financialmodelingprep.com/pricing-plans?couponCode=eroy) and get your API key. This link will get you 10% off.
+
 The tools internally use the `fmp-node-api` library, which reads this environment variable to authenticate with the Financial Modeling Prep API.
 
 ### Debugging and Logging
diff --git a/packages/tools/package.json b/packages/tools/package.json
index 73e45e9..ea72e47 100644
--- a/packages/tools/package.json
+++ b/packages/tools/package.json
@@ -1,6 +1,6 @@
 {
   "name": "fmp-ai-tools",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "AI tools for FMP Node API - compatible with Vercel AI SDK, Langchain, OpenAI, and more",
   "exports": {
     "./vercel-ai": {
diff --git a/packages/tools/src/__tests__/providers/openai/company.test.ts b/packages/tools/src/__tests__/providers/openai/company.test.ts
index 5304c41..96a0104 100644
--- a/packages/tools/src/__tests__/providers/openai/company.test.ts
+++ b/packages/tools/src/__tests__/providers/openai/company.test.ts
@@ -1,7 +1,13 @@
-import { getCompanyProfile } from '@/providers/openai/company';
+import {
+  getCompanyProfile,
+  getCompanySharesFloat,
+  getCompanyExecutiveCompensation,
+} from '@/providers/openai/company';
 
 const mockCompany = {
   getCompanyProfile: jest.fn(),
+  getSharesFloat: jest.fn(),
+  getExecutiveCompensation: jest.fn(),
 };
 
 jest.mock('@/client', () => ({
@@ -23,4 +29,26 @@ describe('OpenAI Company Tools (minimal)', () => {
     expect(mockCompany.getCompanyProfile).toHaveBeenCalledWith('AAPL');
     expect(JSON.parse(result)).toEqual([{ symbol: 'AAPL' }]);
   });
+
+  it('getCompanySharesFloat executes and returns data', async () => {
+    mockCompany.getSharesFloat.mockResolvedValueOnce({
+      data: [{ symbol: 'AAPL', sharesFloat: 1000000 }],
+    });
+
+    const result = await (getCompanySharesFloat as any).execute({ symbol: 'AAPL' });
+
+    expect(mockCompany.getSharesFloat).toHaveBeenCalledWith('AAPL');
+    expect(JSON.parse(result)).toEqual([{ symbol: 'AAPL', sharesFloat: 1000000 }]);
+  });
+
+  it('getCompanyExecutiveCompensation executes and returns data', async () => {
+    mockCompany.getExecutiveCompensation.mockResolvedValueOnce({
+      data: [{ symbol: 'AAPL', compensation: 1000000 }],
+    });
+
+    const result = await (getCompanyExecutiveCompensation as any).execute({ symbol: 'AAPL' });
+
+    expect(mockCompany.getExecutiveCompensation).toHaveBeenCalledWith('AAPL');
+    expect(JSON.parse(result)).toEqual([{ symbol: 'AAPL', compensation: 1000000 }]);
+  });
 });
diff --git a/packages/tools/src/__tests__/providers/openai/index.test.ts b/packages/tools/src/__tests__/providers/openai/index.test.ts
index 17449ac..20ffda5 100644
--- a/packages/tools/src/__tests__/providers/openai/index.test.ts
+++ b/packages/tools/src/__tests__/providers/openai/index.test.ts
@@ -11,6 +11,8 @@ describe('OpenAI providers index exports', () => {
   it('exports individual tools', () => {
     const keys = [
       'getCompanyProfile',
+      'getCompanySharesFloat',
+      'getCompanyExecutiveCompensation',
       'getEarningsCalendar',
       'getEconomicCalendar',
       'getTreasuryRates',
diff --git a/packages/tools/src/__tests__/providers/vercel-ai/company.test.ts b/packages/tools/src/__tests__/providers/vercel-ai/company.test.ts
index 75b590e..0342645 100644
--- a/packages/tools/src/__tests__/providers/vercel-ai/company.test.ts
+++ b/packages/tools/src/__tests__/providers/vercel-ai/company.test.ts
@@ -2,6 +2,8 @@ import { companyTools } from '@/providers/vercel-ai/company';
 
 const mockCompany = {
   getCompanyProfile: jest.fn(),
+  getSharesFloat: jest.fn(),
+  getExecutiveCompensation: jest.fn(),
 };
 
 jest.mock('@/client', () => ({
@@ -23,4 +25,28 @@ describe('Vercel AI Company Tools (minimal)', () => {
     expect(mockCompany.getCompanyProfile).toHaveBeenCalledWith('AAPL');
     expect(JSON.parse(result)).toEqual({ symbol: 'AAPL' });
   });
+
+  it('getCompanySharesFloat executes and returns data', async () => {
+    mockCompany.getSharesFloat.mockResolvedValueOnce({
+      data: { symbol: 'AAPL', sharesFloat: 1000000 },
+    });
+
+    const result = await (companyTools.getCompanySharesFloat.execute as any)({ symbol: 'AAPL' });
+
+    expect(mockCompany.getSharesFloat).toHaveBeenCalledWith('AAPL');
+    expect(JSON.parse(result)).toEqual({ symbol: 'AAPL', sharesFloat: 1000000 });
+  });
+
+  it('getCompanyExecutiveCompensation executes and returns data', async () => {
+    mockCompany.getExecutiveCompensation.mockResolvedValueOnce({
+      data: { symbol: 'AAPL', compensation: 1000000 },
+    });
+
+    const result = await (companyTools.getCompanyExecutiveCompensation.execute as any)({
+      symbol: 'AAPL',
+    });
+
+    expect(mockCompany.getExecutiveCompensation).toHaveBeenCalledWith('AAPL');
+    expect(JSON.parse(result)).toEqual({ symbol: 'AAPL', compensation: 1000000 });
+  });
 });
diff --git a/packages/tools/src/__tests__/providers/vercel-ai/index.test.ts b/packages/tools/src/__tests__/providers/vercel-ai/index.test.ts
index ad6aaac..8edc3b4 100644
--- a/packages/tools/src/__tests__/providers/vercel-ai/index.test.ts
+++ b/packages/tools/src/__tests__/providers/vercel-ai/index.test.ts
@@ -2,7 +2,11 @@ import { fmpTools } from '../../../providers/vercel-ai';
 
 const mockClient = {
   quote: { getQuote: jest.fn().mockResolvedValue({ data: {} }) },
-  company: { getCompanyProfile: jest.fn().mockResolvedValue({ data: {} }) },
+  company: {
+    getCompanyProfile: jest.fn().mockResolvedValue({ data: {} }),
+    getSharesFloat: jest.fn().mockResolvedValue({ data: {} }),
+    getExecutiveCompensation: jest.fn().mockResolvedValue({ data: [] }),
+  },
   financial: {
     getBalanceSheet: jest.fn().mockResolvedValue({ data: [] }),
     getIncomeStatement: jest.fn().mockResolvedValue({ data: [] }),
diff --git a/packages/tools/src/providers/openai/company.ts b/packages/tools/src/providers/openai/company.ts
index be42b88..f37c034 100644
--- a/packages/tools/src/providers/openai/company.ts
+++ b/packages/tools/src/providers/openai/company.ts
@@ -17,3 +17,29 @@ export const getCompanyProfile = createOpenAITool({
     return JSON.stringify(companyProfile.data, null, 2);
   },
 });
+
+export const getCompanySharesFloat = createOpenAITool({
+  name: 'getCompanySharesFloat',
+  description: 'Get the company shares float',
+  inputSchema: z.object({
+    symbol: z.string().describe('The stock symbol (e.g., AAPL, MSFT, GOOGL)'),
+  }),
+  execute: async ({ symbol }) => {
+    const fmp = getFMPClient();
+    const companySharesFloat = await fmp.company.getSharesFloat(symbol);
+    return JSON.stringify(companySharesFloat.data, null, 2);
+  },
+});
+
+export const getCompanyExecutiveCompensation = createOpenAITool({
+  name: 'getCompanyExecutiveCompensation',
+  description: 'Get the company executive compensation',
+  inputSchema: z.object({
+    symbol: z.string().describe('The stock symbol (e.g., AAPL, MSFT, GOOGL)'),
+  }),
+  execute: async ({ symbol }) => {
+    const fmp = getFMPClient();
+    const companyExecutiveCompensation = await fmp.company.getExecutiveCompensation(symbol);
+    return JSON.stringify(companyExecutiveCompensation.data, null, 2);
+  },
+});
diff --git a/packages/tools/src/providers/openai/index.ts b/packages/tools/src/providers/openai/index.ts
index 06c4066..191246e 100644
--- a/packages/tools/src/providers/openai/index.ts
+++ b/packages/tools/src/providers/openai/index.ts
@@ -1,6 +1,10 @@
 import type { Tool } from '@openai/agents';
 import { checkOpenAIAgentsVersion } from '@/utils/version-check';
-import { getCompanyProfile } from './company';
+import {
+  getCompanyProfile,
+  getCompanySharesFloat,
+  getCompanyExecutiveCompensation,
+} from './company';
 import { getEarningsCalendar, getEconomicCalendar } from './calendar';
 import { getTreasuryRates, getEconomicIndicators } from './economic';
 import { getETFHoldings, getETFProfile } from './etf';
@@ -40,6 +44,8 @@ import { getMarketCap, getStockSplits, getDividendHistory } from './stock';
 // Export individual tools for OpenAI agents
 export {
   getCompanyProfile,
+  getCompanySharesFloat,
+  getCompanyExecutiveCompensation,
   getEarningsCalendar,
   getEconomicCalendar,
   getTreasuryRates,
@@ -77,7 +83,11 @@ export {
 };
 
 // Export tool groups as arrays for OpenAI Agents
-export const companyTools = [getCompanyProfile] as Tool<unknown>[];
+export const companyTools = [
+  getCompanyProfile,
+  getCompanySharesFloat,
+  getCompanyExecutiveCompensation,
+] as Tool<unknown>[];
 export const calendarTools = [getEarningsCalendar, getEconomicCalendar] as Tool<unknown>[];
 export const economicTools = [getTreasuryRates, getEconomicIndicators] as Tool<unknown>[];
 export const etfTools = [getETFHoldings, getETFProfile] as Tool<unknown>[];
@@ -117,6 +127,8 @@ export const stockTools = [getMarketCap, getStockSplits, getDividendHistory] as
 // Combine all tools into a single array for convenience
 export const fmpTools: Tool<unknown>[] = [
   getCompanyProfile,
+  getCompanySharesFloat,
+  getCompanyExecutiveCompensation,
   getEarningsCalendar,
   getEconomicCalendar,
   getTreasuryRates,
diff --git a/packages/tools/src/providers/vercel-ai/company.ts b/packages/tools/src/providers/vercel-ai/company.ts
index bb3e6a5..9b6f5d0 100644
--- a/packages/tools/src/providers/vercel-ai/company.ts
+++ b/packages/tools/src/providers/vercel-ai/company.ts
@@ -16,4 +16,31 @@ export const companyTools = {
       return response;
     },
   }),
+  getCompanySharesFloat: createTool({
+    name: 'getCompanySharesFloat',
+    description: 'Get the company shares float',
+    inputSchema: z.object({
+      symbol: z.string().describe('The stock ticker symbol (e.g., AAPL)'),
+    }),
+    execute: async ({ symbol }) => {
+      const fmp = getFMPClient();
+      const companySharesFloat = await fmp.company.getSharesFloat(symbol);
+      const response = JSON.stringify(companySharesFloat.data, null, 2);
+      return response;
+    },
+  }),
+
+  getCompanyExecutiveCompensation: createTool({
+    name: 'getCompanyExecutiveCompensation',
+    description: 'Get the company executive compensation',
+    inputSchema: z.object({
+      symbol: z.string().describe('The stock ticker symbol (e.g., AAPL)'),
+    }),
+    execute: async ({ symbol }) => {
+      const fmp = getFMPClient();
+      const companyExecutiveCompensation = await fmp.company.getExecutiveCompensation(symbol);
+      const response = JSON.stringify(companyExecutiveCompensation.data, null, 2);
+      return response;
+    },
+  }),
 };
diff --git a/packages/tools/src/providers/vercel-ai/index.ts b/packages/tools/src/providers/vercel-ai/index.ts
index 26401f9..ddb83ec 100644
--- a/packages/tools/src/providers/vercel-ai/index.ts
+++ b/packages/tools/src/providers/vercel-ai/index.ts
@@ -12,7 +12,8 @@ import { senateHouseTools } from './senate-house';
 import { stockTools } from './stock';
 
 // Export individual tools for Vercel AI
-export const { getCompanyProfile } = companyTools;
+export const { getCompanyProfile, getCompanySharesFloat, getCompanyExecutiveCompensation } =
+  companyTools;
 
 export const { getEarningsCalendar, getEconomicCalendar } = calendarTools;
 
diff --git a/packages/types/CHANGELOG.md b/packages/types/CHANGELOG.md
index 32b3690..146c55f 100644
--- a/packages/types/CHANGELOG.md
+++ b/packages/types/CHANGELOG.md
@@ -1,5 +1,11 @@
 # fmp-node-types
 
+## 0.1.4
+
+### Patch Changes
+
+- Added news endpoints - fmp-node-api, added shares float and executive compensation to fmp-ai-tools
+
 ## 0.1.3
 
 ### Patch Changes
diff --git a/packages/types/package.json b/packages/types/package.json
index 5a9b7bc..9a191fb 100644
--- a/packages/types/package.json
+++ b/packages/types/package.json
@@ -1,6 +1,6 @@
 {
   "name": "fmp-node-types",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Shared TypeScript types for FMP Node Wrapper ecosystem (internal package)",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
diff --git a/packages/types/src/index.ts b/packages/types/src/index.ts
index 224e92d..6df9abe 100644
--- a/packages/types/src/index.ts
+++ b/packages/types/src/index.ts
@@ -34,6 +34,9 @@ export * from './market';
 // Mutual fund types
 export * from './mutual-fund';
 
+// News types
+export * from './news';
+
 // Quote types
 export * from './quote';
 
diff --git a/packages/types/src/insider.ts b/packages/types/src/insider.ts
index 47c38f2..5f1104d 100644
--- a/packages/types/src/insider.ts
+++ b/packages/types/src/insider.ts
@@ -2,12 +2,22 @@
 
 // RSS Feed Response
 export interface InsiderTradingRSSResponse {
-  title: string;
-  fillingDate: string;
   symbol: string;
-  link: string;
+  filingDate: string;
+  transactionDate: string;
   reportingCik: string;
-  issuerCik: string;
+  companyCik: string;
+  transactionType: string;
+  securitiesOwned: number;
+  reportingName: string;
+  typeOfOwner: string;
+  acquisitionOrDisposition: string;
+  directOrIndirect: string;
+  formType: string;
+  securitiesTransacted: number;
+  price: number;
+  securityName: string;
+  url: string;
 }
 
 // Insider Trading Search Response
@@ -16,21 +26,22 @@ export interface InsiderTradingSearchResponse {
   filingDate: string;
   transactionDate: string;
   reportingCik: string;
+  companyCik: string;
   transactionType: string;
   securitiesOwned: number;
-  securitiesTransacted: number;
-  companyCik: string;
   reportingName: string;
   typeOfOwner: string;
-  link: string;
-  securityName: string;
-  price: number;
+  acquisitionOrDisposition: string;
+  directOrIndirect: string;
   formType: string;
-  acquistionOrDisposition: string;
+  securitiesTransacted: number;
+  price: number;
+  securityName: string;
+  url: string;
 }
 
 // Transaction Types Response
-export type TransactionTypesResponse = string[];
+export type TransactionTypesResponse = { transactionType: string }[];
 
 // Insiders By Symbol Response
 export interface InsidersBySymbolResponse {
@@ -45,15 +56,15 @@ export interface InsiderTradeStatisticsResponse {
   cik: string;
   year: number;
   quarter: number;
-  purchases: number;
-  sales: number;
-  buySellRatio: number;
-  totalBought: number;
-  totalSold: number;
-  averageBought: number;
-  averageSold: number;
-  pPurchases: number;
-  sSales: number;
+  acquiredTransactions: number;
+  disposedTransactions: number;
+  acquiredDisposedRatio: number;
+  totalAcquired: number;
+  totalDisposed: number;
+  averageAcquired: number;
+  averageDisposed: number;
+  totalPurchases: number;
+  totalSales: number;
 }
 
 // CIK Mapper Response
diff --git a/packages/types/src/news.ts b/packages/types/src/news.ts
new file mode 100644
index 0000000..f8bd7af
--- /dev/null
+++ b/packages/types/src/news.ts
@@ -0,0 +1,23 @@
+// News types for FMP API
+
+export interface News {
+  symbol: string;
+  publishedDate: string;
+  publisher: string;
+  title: string;
+  image: string;
+  site: string;
+  text: string;
+  url: string;
+}
+
+export interface Article {
+  title: string;
+  date: string;
+  content: string;
+  tickers: string;
+  image: string;
+  link: string;
+  author: string;
+  site: string;
+}