finance-sentiment

finance-sentiment is the public TypeScript SDK for the Adanos Market Sentiment API.

It gives you typed access to:

• Reddit stock sentiment
• News sentiment and source-filtered rankings
• X/Twitter stock sentiment
• Polymarket stock activity and market attention

Links:

• Source: https://github.com/adanos-software/adanos-ts-sdk
• npm: https://www.npmjs.com/package/finance-sentiment
• API docs: https://api.adanos.org/docs
• Homepage: https://adanos.org

Package and import:

• npm package: finance-sentiment
• Primary client: AdanosClient
• Compatibility alias: StockSentimentClient

Install

npm install finance-sentiment

Quick Start

import { AdanosClient } from "finance-sentiment";

const client = new AdanosClient({ apiKey: "adanos_api_key_here" });

const trending = await client.reddit.trending({ days: 7, limit: 10 });
const tsla = await client.reddit.stock("TSLA", { days: 14 });
const explanation = await client.reddit.explain("TSLA");

console.log(trending[0].ticker);
console.log(tsla.buzz_score);
console.log(explanation.explanation);

What You Can Do

• Rank trending stocks across Reddit, News, X, and Polymarket
• Pull service-level market sentiment snapshots across every stock namespace
• Pull detailed ticker reports for a configurable lookback window
• Search and compare tickers across datasets
• Generate AI-written explanations for Reddit and News stock trends
• Use the same client shape across all supported stock datasets

Namespaces

• client.reddit.* for Reddit Stocks
• client.news.* for News Stocks
• client.x.* for X/Twitter Stocks
• client.polymarket.* for Polymarket Stocks

Examples

Reddit Stocks

import { AdanosClient } from "finance-sentiment";

const client = new AdanosClient({ apiKey: "adanos_api_key_here" });

const trending = await client.reddit.trending({ days: 7, limit: 10 });
const sectors = await client.reddit.trendingSectors({ days: 7, limit: 10 });
const countries = await client.reddit.trendingCountries({ days: 7, limit: 10 });
const tsla = await client.reddit.stock("TSLA", { days: 14 });
const explanation = await client.reddit.explain("TSLA");
const results = await client.reddit.search("Tesla", { days: 7, limit: 10 });
const comparison = await client.reddit.compare(["TSLA", "AAPL", "MSFT"], { days: 7 });
const market = await client.reddit.marketSentiment({ days: 7 });

News

import { AdanosClient } from "finance-sentiment";

const client = new AdanosClient({ apiKey: "adanos_api_key_here" });

const trending = await client.news.trending({ days: 7, source: "reuters" });
const sectors = await client.news.trendingSectors({ days: 7, source: "reuters" });
const countries = await client.news.trendingCountries({ days: 7, source: "reuters" });
const nvda = await client.news.stock("NVDA", { days: 7 });
const explanation = await client.news.explain("NVDA");
const results = await client.news.search("Nvidia", { days: 7, limit: 10 });
const comparison = await client.news.compare(["NVDA", "AAPL"], { days: 7 });
const market = await client.news.marketSentiment({ days: 7 });
const stats = await client.news.stats();
const health = await client.news.health();

X/Twitter

import { AdanosClient } from "finance-sentiment";

const client = new AdanosClient({ apiKey: "adanos_api_key_here" });

const trending = await client.x.trending({ days: 1, limit: 20 });
const sectors = await client.x.trendingSectors({ days: 1, limit: 10 });
const countries = await client.x.trendingCountries({ days: 1, limit: 10 });
const nvda = await client.x.stock("NVDA");
const results = await client.x.search("Nvidia", { days: 7, limit: 10 });
const comparison = await client.x.compare(["NVDA", "AMD"], { days: 7 });
const market = await client.x.marketSentiment({ days: 7 });

Polymarket

import { AdanosClient } from "finance-sentiment";

const client = new AdanosClient({ apiKey: "adanos_api_key_here" });

const trending = await client.polymarket.trending({ days: 7, limit: 20, type: "stock" });
const sectors = await client.polymarket.trendingSectors({ days: 7, limit: 10 });
const countries = await client.polymarket.trendingCountries({ days: 7, limit: 10 });
const aapl = await client.polymarket.stock("AAPL");
const results = await client.polymarket.search("Apple", { days: 7, limit: 10 });
const comparison = await client.polymarket.compare(["AAPL", "TSLA"], { days: 7 });
const market = await client.polymarket.marketSentiment({ days: 7 });

Polymarket semantics:

• buzz_score is activity-first and optimized for current market attention
• total_liquidity is a windowed signal over the selected days
• top_mentions on stock() are relevance-sorted by trading activity first

Available Methods

client.reddit.*

| Method | Description | |--------|-------------| | trending({ days, limit, offset, type }) | Trending stocks by buzz score | | trendingSectors({ days, limit, offset }) | Trending sectors | | trendingCountries({ days, limit, offset }) | Trending countries | | stock(ticker, { days }) | Detailed sentiment for a ticker | | explain(ticker) | AI-generated trend explanation | | search(query, { days, limit }) | Search stocks by name or ticker with recent-period summaries | | compare(tickers, { days }) | Compare up to 10 stocks | | marketSentiment({ days }) | Service-level Reddit market sentiment snapshot | | stats() | Dataset statistics | | health() | Public service health |

client.news.*

| Method | Description | |--------|-------------| | trending({ days, limit, offset, type, source }) | Trending stocks from news | | trendingSectors({ days, limit, offset, source }) | Trending sectors from news | | trendingCountries({ days, limit, offset, source }) | Trending countries from news | | stock(ticker, { days }) | Detailed news sentiment for a ticker | | explain(ticker) | AI-generated explanation from news context | | search(query, { days, limit }) | Search stocks in the news dataset with recent-period summaries | | compare(tickers, { days }) | Compare up to 10 stocks in news | | marketSentiment({ days }) | Service-level News market sentiment snapshot | | stats() | News dataset statistics | | health() | Public news service health |

client.x.*

| Method | Description | |--------|-------------| | trending({ days, limit, offset, type }) | Trending stocks on X/Twitter | | trendingSectors({ days, limit, offset }) | Trending sectors | | trendingCountries({ days, limit, offset }) | Trending countries | | stock(ticker, { days }) | Detailed X/Twitter sentiment | | search(query, { days, limit }) | Search stocks with recent-period summaries | | compare(tickers, { days }) | Compare stocks | | marketSentiment({ days }) | Service-level X/Twitter market sentiment snapshot | | stats() | Dataset statistics | | health() | Public service health |

client.polymarket.*

| Method | Description | |--------|-------------| | trending({ days, limit, offset, type }) | Trending stocks on Polymarket with activity-first buzz and windowed liquidity | | trendingSectors({ days, limit, offset }) | Trending sectors | | trendingCountries({ days, limit, offset }) | Trending countries | | stock(ticker, { days }) | Detailed Polymarket activity, sentiment, and relevance-sorted market questions | | search(query, { days, limit }) | Search stocks with recent-period summaries | | compare(tickers, { days }) | Compare stocks with windowed Polymarket activity signals | | marketSentiment({ days }) | Service-level Polymarket market sentiment snapshot | | stats() | Dataset statistics | | health() | Public service health |

Error Handling

All non-2xx responses throw an ApiError:

import { AdanosClient, ApiError } from "finance-sentiment";

const client = new AdanosClient({ apiKey: "adanos_api_key_here" });

try {
  await client.reddit.trending();
} catch (error) {
  if (error instanceof ApiError) {
    console.error(`API error ${error.status}: ${error.detail}`);
  }
}

Authentication and Configuration

Get your API key at adanos.org.

import { AdanosClient } from "finance-sentiment";

const client = new AdanosClient({
  apiKey: "adanos_api_key_here",
  baseUrl: "https://api.adanos.org",
  timeout: 60_000,
});

Rate Limits

| Tier | Monthly Requests | Burst Limit | |------|------------------|-------------| | Free | 250 | 100/min | | Paid | Unlimited | 1000/min |

Successful protected responses include rate-limit headers.

Requirements

• Node.js >=18
• ESM and CJS consumers supported
• Works in Bun and modern runtimes with fetch

Migration from social-stock-sentiment

Version 1.0.0 starts the new finance-sentiment package line and promotes AdanosClient as the primary public client name.

Old:

npm install social-stock-sentiment

import { StockSentimentClient } from "social-stock-sentiment";

New:

npm install finance-sentiment

import { AdanosClient } from "finance-sentiment";

StockSentimentClient remains available as a compatibility alias.

License

MIT

MIT