Package Exports

finance-sentiment

Readme

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 explanation = await client.x.explain("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
`explain(ticker)`	AI-generated explanation from X/Twitter context
`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

finance-sentiment

Package Exports

Readme

finance-sentiment

Install

Quick Start

What You Can Do

Namespaces

Examples

Reddit Stocks

News

X/Twitter

Polymarket

Available Methods

client.reddit.*

client.news.*

client.x.*

client.polymarket.*

Error Handling

Authentication and Configuration

Rate Limits

Requirements

Migration from social-stock-sentiment

License

`client.reddit.*`

`client.news.*`

`client.x.*`

`client.polymarket.*`

Migration from `social-stock-sentiment`