# Adanos > Adanos is a market sentiment API for stocks and crypto. It measures how much attention a ticker gets on Reddit, X, financial news and Polymarket and whether that attention is bullish or bearish. One API key works for every source. Adanos Software GmbH in Berlin, Germany builds the API. It answers in JSON at `https://api.adanos.com`. Every data endpoint needs the header `X-API-Key` with a key that starts with `sk_live_`. Only the health endpoints answer without a key. Each source has its own base path. No endpoint merges the sources. Call each source you need and join the answers by ticker. - `/reddit/stocks/v1` reads stock and ETF mentions in posts and comments on WallStreetBets and 60+ subreddits. - `/x/stocks/v1` reads cashtag posts on X and their replies. - `/news/stocks/v1` reads headlines from 100+ financial news sources such as Reuters, Benzinga and Finviz. - `/polymarket/stocks/v1` reads prediction markets on listed companies. It counts trades, traders and liquidity and shows where the odds lean. - `/reddit/crypto/v1` reads coin and token mentions in crypto subreddits. - `POST /sentiment/v1/analyze` scores a text you send from -1 (bearish) to +1 (bullish). It needs the Professional plan. The four stock sources share `/trending`, `/trending/sectors`, `/trending/countries`, `/stock/{ticker}`, `/compare?tickers=`, `/search?q=`, `/market-sentiment` and `/stats`. Reddit, X and News add `/stock/{ticker}/explain`, a short AI-written reading of the last 7 days. Reddit Crypto uses `/token/{symbol}` and `/compare?symbols=` and has no sector or country lists. The answers carry `buzz_score` (attention on one source from 0 to 100), `sentiment_score` (-1 to +1), `bullish_pct` and `bearish_pct` (the share of directional mentions) and `trend` (`rising`, `falling` or `stable`). The trend compares activity in the last 3 days with the 3 days before. The share price plays no part. Set the window with `from` and `to` as UTC dates (`YYYY-MM-DD`). Without them `/trending` and `/market-sentiment` cover today and `/stock/{ticker}` and `/compare` cover the last 7 days. A person has to create the key in an Adanos account. The sign-up has a Cloudflare Turnstile check. The shortest path: 1. The person opens `https://adanos.com/register?signup_plan=free&signup_source=llms_txt` and signs up with Google, Apple or an email. With an email they enter the 6-digit code from the email. It works for 10 minutes and can land in the spam folder. No credit card. 2. The account page `https://adanos.com/account` creates the key and shows it once. The person can rotate or revoke it there at any time. 3. The person hands you the key. Keep it in the environment variable `ADANOS_API_KEY`, never in code or a public repository. 4. Make the first call. It lists the three stocks with the most Reddit attention today. ```bash curl "https://api.adanos.com/reddit/stocks/v1/trending?limit=3" \ -H "X-API-Key: $ADANOS_API_KEY" ``` Each call counts as one request. A window that reaches back further than the plan allows answers 403. Too many requests answer 429 with a `Retry-After` header. An email that already has an account gets a login code instead of a second account. A rotated key replaces the old one at once, and calls with the old key answer 401. Live pages on adanos.com change through the day. Check the page before you quote a value and cite it as Adanos (adanos.com). ## Get an API key - [Free plan](https://adanos.com/register?signup_plan=free&signup_source=llms_txt): $0 and no credit card. 250 requests a month, 100 a minute, 30 days of history and 41 endpoints. Non-commercial use only. The quota resets each month on the day the key was created. - [Hobby plan](https://adanos.com/pricing): $29 a month or $290 a year. 250,000 requests a month, 1,000 a minute, 90 days of history and 41 endpoints. Non-commercial use only. The prices include VAT where it applies. Payment runs through Stripe Checkout and needs no account first. After the payment the key waits in the account on adanos.com. - [Professional plan](https://adanos.com/pricing): $299 a month or $2,990 a year. 2,500,000 requests a month, 1,000 a minute, up to 365 days of history and 47 endpoints. The six extra endpoints are the raw mentions and `/sentiment/v1/analyze`. Commercial use allowed. Only Reddit stocks reach back 365 days so far. - [Pricing](https://adanos.com/pricing): The plans side by side with answers to common questions. Enterprise access with higher limits starts at contact@adanos.com. - [Log in](https://adanos.com/login): The account with the API key, its usage, the plan and billing. Log in with Google, Apple, a password or a code by email. - [Free access for universities and nonprofits](https://adanos.com/nonprofit-and-education-access): Application for free non-commercial access for research and teaching. ## API reference - [API reference for agents](https://api.adanos.com/llms.txt): Every endpoint with its parameters, response fields, error codes and rate-limit headers. Read it before you write code. - [OpenAPI schema](https://api.adanos.com/openapi.json): The machine-readable contract of the API. - [Interactive docs](https://api.adanos.com/docs): Request and response examples to try in the browser. - [Changelog](https://api.adanos.com/changelog): Release notes with migration steps. - [Status](https://status.adanos.com/): The current status of the API. ## Clients - [Finance Sentiment CLI](https://adanos.com/finance-sentiment-cli): A terminal client for every endpoint with JSON output for agents. Install it with `pipx install adanos-cli`. It reads the key from `ADANOS_API_KEY` or stores it with `adanos login --api-key-stdin`. - [Python SDK](https://github.com/adanos-software/adanos-python-sdk): Install it with `pip install adanos`. - [TypeScript SDK](https://github.com/adanos-software/adanos-ts-sdk): Install it with `npm install finance-sentiment`. - [PHP SDK](https://github.com/adanos-software/adanos-php): Install it with `composer require adanos/adanos-php`. - [Go SDK](https://github.com/adanos-software/adanos-go-sdk): Install it with `go get github.com/adanos-software/adanos-go-sdk`. ## API pages - [Reddit Stock Sentiment API](https://adanos.com/reddit-stock-sentiment): What `/reddit/stocks/v1` returns, with sample answers. - [X Stock Sentiment API](https://adanos.com/x-stock-sentiment): What `/x/stocks/v1` returns, with sample answers. - [Stock News Sentiment API](https://adanos.com/stock-news-sentiment): What `/news/stocks/v1` returns, with sample answers. - [Polymarket Stock Sentiment API](https://adanos.com/polymarket-stock-sentiment): What `/polymarket/stocks/v1` returns, with sample answers. - [Reddit Crypto Sentiment API](https://adanos.com/reddit-crypto-sentiment): What `/reddit/crypto/v1` returns, with sample answers. ## Live data without a key - [Reddit Top 100 Stocks](https://adanos.com/reddit-top-100-stocks): The most mentioned stocks on Reddit in the past 24 hours. - [X Top 100 Stocks](https://adanos.com/x-top-100-stocks): The most mentioned stocks on X in the past 24 hours. - [News Top 50 Stocks](https://adanos.com/news-top-50-stocks): The most mentioned stocks in financial news. - [Polymarket Top 50 Stocks](https://adanos.com/polymarket-top-50-stocks): The most active stocks on Polymarket with trades, traders and odds. - [Reddit Top 100 Crypto](https://adanos.com/reddit-top-100-crypto): The most discussed coins on Reddit. - [Stock sentiment tracker](https://adanos.com/stocks/): One page per tracked stock with Reddit, X, news and Polymarket data and a buy, hold or sell signal. - [Market movers](https://adanos.com/market-movers-today): The most active stocks, gainers and losers of the day with the reason for each move. - [Fear & Greed Index](https://adanos.com/stock-market-sentiment-index): Retail sentiment from Reddit and X next to the CNN Fear & Greed Index. Both score from 0 to 100. - [Financial News Sentiment Analyzer](https://adanos.com/finance-sentiment-analyzer): Scores one headline in the browser without sign-up. - [Ticker database](https://adanos.com/ticker-database/): Free lookup of stock and ETF symbols with exchange, country, sector and ISIN. The full list is also a CSV download. - [Widgets](https://adanos.com/widgets): Embeddable ticker tape, top movers table, stock cards and retail sentiment gauge. ## Optional - [Weekly reports](https://adanos.com/insights/reports/): Every Monday the stocks with the strongest and weakest sentiment across Reddit, X, news and Polymarket. - [Insights](https://adanos.com/insights/): Market analysis, comparisons of sentiment APIs and the weekly reports. - [BuzzScore whitepaper](https://adanos.com/buzzscore-whitepaper.pdf): How the buzz score is computed and validated. - [Fear & Greed methodology](https://adanos.com/insights/blog/fear-greed-index-methodology-dumb-money-vs-smart-money/): How the Fear & Greed Index is built. - [Terms of Service](https://adanos.com/terms): Free and Hobby are limited to non-commercial use. - [Privacy Policy](https://adanos.com/privacy): How Adanos handles personal data. - [Contact and imprint](https://adanos.com/contact): Contact form and legal imprint. Support answers at support@adanos.com. - [Sitemap](https://adanos.com/sitemap.xml): The pages, insights and reports of the site. - [Stock pages sitemap](https://adanos.com/stocks-sitemap.xml): Every stock page.