tap-adanos

tap-adanos is a Singer tap for the Adanos Market Sentiment API, built with the Meltano Singer SDK.

It extracts stock sentiment from Reddit, X / FinTwit, financial news, and Polymarket, plus Reddit crypto sentiment. The tap exposes four warehouse-friendly snapshot streams:

• asset_sentiment: one detailed sentiment record per configured symbol.
• trending_assets: paginated assets ordered by current buzz score.
• asset_comparison: normalized rows from the Adanos comparison endpoint.
• market_sentiment: one source-wide market sentiment record.

Raw mention streams are intentionally excluded because those endpoints require the Professional plan. Every core stream works with Free, Hobby, and Professional API keys when its date window is within the plan's lookback.

Installation

Install from PyPI after the first release:

uv tool install tap-adanos

Install from GitHub during development:

uv tool install git+https://github.com/adanos-software/tap-adanos.git@main

Configuration

The API currently permits up to 30 days of lookback for Free accounts, 90 days for Hobby, and 365 days for Professional. Quotas and rate limits remain attached to the supplied Adanos API key.

Example non-secret settings:

{
  "asset_type": "stock",
  "stock_source": "reddit",
  "symbols": ["AAPL", "NVDA"],
  "start_date": "2026-07-01",
  "end_date": "2026-07-07"
}

Provide api_key through Meltano's secret configuration or another secure runtime mechanism rather than storing it in this file.

Discover and run the tap:

tap-adanos --config config.json --discover > catalog.json
tap-adanos --config config.json --catalog catalog.json

Use --select or a Meltano catalog to enable only the streams needed by a pipeline.

Meltano

plugins:
  extractors:
    - name: tap-adanos
      namespace: tap_adanos
      pip_url: tap-adanos
      executable: tap-adanos
      config:
        asset_type: stock
        stock_source: reddit
        symbols: [AAPL, NVDA]
        start_date: "2026-07-01"

Set the key outside source control:

meltano config tap-adanos set api_key "$ADANOS_API_KEY"
meltano run tap-adanos target-jsonl

Development

Requires Python 3.10+ and uv.

uv sync
uv run pytest
uv run ruff check .
uv run mypy tap_adanos tests
uv run tap-adanos --about --format=json

License

Apache-2.0