social-stock-sentiment

Legacy package notice:

• social-stock-sentiment is the old package line.
• New installs should use adanos-python-sdk.
• New repo: https://github.com/adanos-software/adanos-python-sdk
• New PyPI package: https://pypi.org/project/adanos-python-sdk/

Migration:

pip install adanos-python-sdk

from adanos_python_sdk import AdanosClient

Python SDK for the Finance Sentiment API — analyze stock sentiment (News, Reddit, X/Twitter, Polymarket) and crypto sentiment (Reddit).

Installation

pip install social-stock-sentiment

Quick Start

from stocksentiment import StockSentimentClient

client = StockSentimentClient(api_key="sk_live_...")

# Get trending stocks on Reddit
trending = client.reddit.trending(days=7, limit=10)
for stock in trending:
    print(f"{stock.ticker}: buzz={stock.buzz_score}, sentiment={stock.sentiment_score}")

# Get detailed sentiment for a stock
tsla = client.reddit.stock("TSLA", days=14)
print(f"TSLA buzz: {tsla.buzz_score}, trend: {tsla.trend}")

# AI-generated trend explanation
explanation = client.reddit.explain("TSLA")
print(explanation.explanation)

# Search for stocks
results = client.reddit.search("Tesla")

# Compare multiple stocks
comparison = client.reddit.compare(["TSLA", "AAPL", "MSFT"], days=7)

# News trending endpoints support an optional source filter
news_trending = client.news.trending(days=7, source="reuters")

News Data

news_trending = client.news.trending(days=7, source="reuters")
nvda = client.news.stock("NVDA", days=7)
news_compare = client.news.compare(["NVDA", "AAPL"], days=7)

X/Twitter Data

# Same interface, different data source
x_trending = client.x.trending(days=1, limit=20)
nvda = client.x.stock("NVDA")

Polymarket Data

# Prediction-market sentiment and activity
pm_trending = client.polymarket.trending(days=7, limit=20, type="stock")
aapl = client.polymarket.stock("AAPL")

Polymarket semantics:

• buzz_score is activity-first and optimized for current market attention, not raw depth alone.
• total_liquidity is a windowed signal over the requested days, not a live snapshot.
• top_mentions on stock() are relevance-sorted: traded markets first, then trade_count, volume_24h, and liquidity.

Async Usage

Every method has an _async variant:

import asyncio
from stocksentiment import StockSentimentClient

async def main():
    async with StockSentimentClient(api_key="sk_live_...") as client:
        trending = await client.reddit.trending_async(days=7)
        tsla = await client.reddit.stock_async("TSLA")

asyncio.run(main())

Available Methods

client.reddit.*

client.news.*

client.x.*

client.polymarket.*

Authentication

Get your API key at api.adanos.org. Free tier includes 250 requests/month.

# Custom base URL (e.g. for self-hosted instances)
client = StockSentimentClient(
    api_key="sk_live_...",
    base_url="https://your-instance.com",
    timeout=60.0,
)

Rate Limits

Rate limit headers are included in every response.

License

MIT