> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adanos Market Sentiment

> AdanosTools gives agents multi-source stock sentiment and Reddit cryptocurrency sentiment.

**AdanosTools** gives an Agent access to multi-source stock sentiment and Reddit cryptocurrency sentiment from [Adanos](https://adanos.org/).

## Prerequisites

Create an API key through the [Adanos registration page](https://adanos.org/register).

```shell theme={null}
uv pip install -U agno openai
```

Set the API key as an environment variable:

```shell theme={null}
export ADANOS_API_KEY="***"
```

## Example

```python cookbook/91_tools/adanos_tools.py theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.adanos import AdanosTools

agent = Agent(
    name="Market Sentiment Research Agent",
    model=OpenAIResponses(id="gpt-5.5"),
    tools=[AdanosTools()],
    instructions=[
        "Compare sentiment across available sources before drawing conclusions.",
        "Treat sentiment as research context, not as trading advice.",
    ],
    markdown=True,
)

agent.print_response(
    "Compare AAPL sentiment on Reddit, X, financial news, and Polymarket over the last seven UTC days."
)
```

## Supported Data

| Asset type     | Sources                                   |
| -------------- | ----------------------------------------- |
| Stocks         | Reddit, X, financial news, and Polymarket |
| Cryptocurrency | Reddit                                    |

All functions accept optional inclusive UTC date windows through `start_date` and `end_date` in `YYYY-MM-DD` format.

## Toolkit Params

| Parameter                 | Type            | Default                    | Description                                          |
| ------------------------- | --------------- | -------------------------- | ---------------------------------------------------- |
| `api_key`                 | `Optional[str]` | `None`                     | Adanos API key. Uses `ADANOS_API_KEY` when omitted.  |
| `base_url`                | `str`           | `"https://api.adanos.org"` | Adanos API base URL.                                 |
| `timeout`                 | `float`         | `20.0`                     | Per-request timeout in seconds.                      |
| `enable_stock_sentiment`  | `bool`          | `True`                     | Enable the stock sentiment function.                 |
| `enable_crypto_sentiment` | `bool`          | `True`                     | Enable the cryptocurrency sentiment function.        |
| `enable_trending`         | `bool`          | `True`                     | Enable the trending assets function.                 |
| `enable_market_sentiment` | `bool`          | `True`                     | Enable the aggregate market sentiment function.      |
| `all`                     | `bool`          | `False`                    | Enable all functions regardless of individual flags. |

## Toolkit Functions

| Function               | Description                                                                       |
| ---------------------- | --------------------------------------------------------------------------------- |
| `get_stock_sentiment`  | Get sentiment for a stock from Reddit, X, financial news, or Polymarket.          |
| `get_crypto_sentiment` | Get Reddit sentiment for a cryptocurrency.                                        |
| `get_trending`         | Get trending stocks or cryptocurrencies ranked by buzz score with sentiment data. |
| `get_market_sentiment` | Get aggregate market sentiment for stocks or cryptocurrencies.                    |

The toolkit maps these functions to asynchronous implementations when used by an asynchronous Agent.

## Developer Resources

* [Adanos API documentation](https://api.adanos.org/docs)
* [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/adanos.py)
* [Cookbook example](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/adanos_tools.py)
