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
| Setting | Required | Default | Description |
|---|---|---|---|
api_key |
Yes | Adanos API key from adanos.org/register. | |
asset_type |
No | stock |
stock or crypto. Crypto currently uses Reddit data. |
stock_source |
No | reddit |
Stock source: reddit, x, news, or polymarket. |
symbols |
Yes | One or more symbols used by asset_sentiment and asset_comparison. |
|
start_date |
Yes | Inclusive UTC date in YYYY-MM-DD format. |
|
end_date |
No | Current UTC date | Inclusive UTC date in YYYY-MM-DD format. |
page_size |
No | 100 |
Trending page size from 1 to 100. |
base_url |
No | https://api.adanos.org |
API root, primarily useful for tests or private gateways. |
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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tap_adanos-0.1.0.tar.gz.
File metadata
- Download URL: tap_adanos-0.1.0.tar.gz
- Upload date:
- Size: 175.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
605c7d52e424c062ef0c3740daf81c5a6af619045cb396a50e35cf13674104bd
|
|
| MD5 |
037dbd29475871ca97c50102da5b8cb4
|
|
| BLAKE2b-256 |
357bf9bfea95d9bc16797e222f974f299c79b3f6367b49fab029212fcfaa6d7e
|
Provenance
The following attestation bundles were made for tap_adanos-0.1.0.tar.gz:
Publisher:
build.yml on adanos-software/tap-adanos
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tap_adanos-0.1.0.tar.gz -
Subject digest:
605c7d52e424c062ef0c3740daf81c5a6af619045cb396a50e35cf13674104bd - Sigstore transparency entry: 2225704097
- Sigstore integration time:
-
Permalink:
adanos-software/tap-adanos@970c6a95d4548b815c1bd57643e463d910ab752a -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/adanos-software
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
build.yml@970c6a95d4548b815c1bd57643e463d910ab752a -
Trigger Event:
push
-
Statement type:
File details
Details for the file tap_adanos-0.1.0-py3-none-any.whl.
File metadata
- Download URL: tap_adanos-0.1.0-py3-none-any.whl
- Upload date:
- Size: 12.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ae6c3ee3b0c45cac81310d6c36422492c2fb5f6c0d582ec2bf4f4cf837cd8023
|
|
| MD5 |
86b6179590be0cd898faa9d078cd3b47
|
|
| BLAKE2b-256 |
0d1a3115368c27c5aefe0dc4ac97c919d2d1c20b0ca76b737b69d9eec0055d2f
|
Provenance
The following attestation bundles were made for tap_adanos-0.1.0-py3-none-any.whl:
Publisher:
build.yml on adanos-software/tap-adanos
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tap_adanos-0.1.0-py3-none-any.whl -
Subject digest:
ae6c3ee3b0c45cac81310d6c36422492c2fb5f6c0d582ec2bf4f4cf837cd8023 - Sigstore transparency entry: 2225704508
- Sigstore integration time:
-
Permalink:
adanos-software/tap-adanos@970c6a95d4548b815c1bd57643e463d910ab752a -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/adanos-software
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
build.yml@970c6a95d4548b815c1bd57643e463d910ab752a -
Trigger Event:
push
-
Statement type:
