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
• Reddit crypto token sentiment

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({ limit: 10 });
const tsla = await client.reddit.stock("TSLA");
const explanation = await client.reddit.explain("TSLA");
const health = await client.health();

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

What You Can Do

• Rank trending stocks across Reddit, News, X, and Polymarket
• Track Reddit crypto token sentiment and raw mention rows
• Pull service-level market sentiment snapshots across every stock namespace
• Check aggregate API health and per-service health/statistics
• 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
• client.crypto.* for Reddit Crypto
• client.redditCrypto.* is an alias for client.crypto.*
• client.health() for aggregate API health

Examples

Reddit Stocks

import { AdanosClient } from "finance-sentiment";

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

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

News

import { AdanosClient } from "finance-sentiment";

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

const trending = await client.news.trending({ source: "reuters" });
const sectors = await client.news.trendingSectors({ source: "reuters" });
const countries = await client.news.trendingCountries({ source: "reuters" });
const nvda = await client.news.stock("NVDA");
const explanation = await client.news.explain("NVDA");
const results = await client.news.search("Nvidia", { limit: 10 });
const comparison = await client.news.compare(["NVDA", "AAPL"]);
const market = await client.news.marketSentiment();
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({ limit: 20 });
const sectors = await client.x.trendingSectors({ limit: 10 });
const countries = await client.x.trendingCountries({ limit: 10 });
const nvda = await client.x.stock("NVDA");
const explanation = await client.x.explain("NVDA");
const results = await client.x.search("Nvidia", { limit: 10 });
const comparison = await client.x.compare(["NVDA", "AMD"]);
const market = await client.x.marketSentiment();
const stats = await client.x.stats();
const health = await client.x.health();

Polymarket

import { AdanosClient } from "finance-sentiment";

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

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

Reddit Crypto

import { AdanosClient } from "finance-sentiment";

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

const trending = await client.crypto.trending({ limit: 20 });
const btc = await client.crypto.token("BTC");
const mentions = await client.crypto.mentions("BTC", { from: "2026-05-01", to: "2026-05-07", limit: 10, offset: 10 });
const results = await client.crypto.search("bitcoin", { limit: 10 });
const comparison = await client.crypto.compare(["BTC", "ETH"]);
const market = await client.crypto.marketSentiment();
const stats = await client.crypto.stats();
const health = await client.crypto.health();

Polymarket semantics:

• buzz_score is activity-first and optimized for current market attention
• total_liquidity is a windowed signal over the selected period
• current_market_count is the live-only active-market breadth; market_count remains the selected-window breadth
• top_mentions on stock() are relevance-sorted by trading activity first

Available Methods

client

Method	Description
health()	Aggregate API health across all public market sentiment services

client.reddit.*

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

Period options: use from and to as YYYY-MM-DD inclusive UTC dates for reproducible windows. days remains available as a legacy shorthand for v1 compatibility. The API returns 422 if from, to, and days are all sent together. Responses keep period_days; retain requested dates client-side if you need them later. Search endpoints are the exception: they accept only limit and use the API-managed recent summary window.

client.news.*

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

client.x.*

Method	Description
trending({ from, to, days, limit, offset, type })	Trending stocks on X/Twitter
trendingSectors({ from, to, days, limit, offset })	Trending sectors
trendingCountries({ from, to, days, limit, offset })	Trending countries
stock(ticker, { from, to, days })	Detailed X/Twitter sentiment
mentions(ticker, { from, to, days, limit, offset })	Raw X/Twitter mention rows
explain(ticker)	AI-generated explanation from X/Twitter context
search(query, { limit })	Search stocks with API-managed recent summaries
compare(tickers, { from, to, days })	Compare stocks
marketSentiment({ from, to, days })	Service-level X/Twitter market sentiment snapshot
stats()	Dataset statistics
health()	Public service health

client.polymarket.*

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

client.crypto.*

Method	Description
trending({ from, to, days, limit, offset })	Trending Reddit crypto tokens
token(symbol, { from, to, days })	Detailed token sentiment and buzz
mentions(symbol, { from, to, days, limit, offset, includeInherited })	Raw Reddit crypto mention rows
search(query, { limit })	Search tokens by symbol or name with API-managed recent summaries and market cap metadata
compare(symbols, { from, to, days })	Compare multiple tokens
marketSentiment({ from, to, days })	Service-level Reddit Crypto 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