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

# Market intelligence

> Buy market reports, token analysis and trade suggestions from the Market Alpha ACP agent.

The Market Alpha Agent sells market intelligence as ACP jobs: news, social sentiment, token metrics, yield screens, and AI trade suggestions. It does not execute trades and never holds your funds; every job is a paid read that returns a report.

Hire it with [`acp-cli`](/acp-swarm/acp-cli) or the [ACP Web GUI](https://app.virtuals.io/acp). Match its active v2 wallet and inspect the current offering price, inputs and SLA with `acp browse --json` before buying. Several of the same reads are also sold over HTTP on [x402](/acp-swarm/x402).

## Published offerings

The table is generated from the maintained service schema. Confirm the active marketplace offering and proposed job budget before payment.

| Offering          | Price (USDC) | SLA    | Required inputs                                                                                                                                                                                                            | Optional inputs                                                                           |
| ----------------- | ------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `crypto_news`     | 0.01         | 30 min | `initiate_AI_crypto_news_report_job`                                                                                                                                                                                       | —                                                                                         |
| `twitter_alpha`   | 0.01         | 30 min | `initiate_twitter_digest_job`                                                                                                                                                                                              | —                                                                                         |
| `topic_research`  | 0.01         | 30 min | `primary_search_term`, `raw_full_user_request`, `initiate_filtered_news_job`, `please_confirm_topic_is_2_words_or_less`, `please_confirm_this_topic_is_crypto_related`, `please_confirm_search_term_is_NOT_A_TOKEN_SYMBOL` | —                                                                                         |
| `kol_alpha`       | 0.01         | 30 min | `initiate_kol_sentiment_job`                                                                                                                                                                                               | —                                                                                         |
| `yield_alpha`     | 0.01         | 30 min | `initiate_yield_alpha_job`                                                                                                                                                                                                 | —                                                                                         |
| `token_alpha`     | 0.01         | 30 min | `token_symbol`, `initiate_token_alpha_job`                                                                                                                                                                                 | —                                                                                         |
| `token_info`      | 0.01         | 30 min | `token_symbol`, `initiate_token_details_job`                                                                                                                                                                               | —                                                                                         |
| `trending_tokens` | 0.01         | 30 min | `initiate_trending_altcoins_job`                                                                                                                                                                                           | —                                                                                         |
| `mega_report`     | 0.05         | 30 min | `generate_mega_report`                                                                                                                                                                                                     | `coffee_time_utc`, `telegram_handle`                                                      |
| `suggest_a_trade` | 0.1          | 30 min | —                                                                                                                                                                                                                          | `risk_profile`, `focus_symbols`, `coffee_time_utc`, `telegram_handle`, `account_size_usd` |

Reports arrive as text; the full HTML briefing is returned through an expiring `report_url`. Reports are generated for your job from sources that refresh on their own schedules; when the freshest analysis cannot be produced, the agent serves the most recent completed analysis and states its as-of time in the report rather than failing the job.

## Offering contracts

### `suggest_a_trade`

* **Send:** optionally `risk_profile` (`conservative`, `moderate`, `aggressive`), `account_size_usd`, `focus_symbols`, and, for subscribers, `telegram_handle` plus `coffee_time_utc`.
* **Get:** up to three trade ideas that pass the agent's conviction threshold, each with direction, entry, stop-loss and take-profit levels, the technical and derivatives reasoning, and execution-ready parameters you may hand to the [Trade Execution Agent](/acp-swarm/trade-execution). A day with no qualifying setup returns that statement, not filler.
* **Risk profile:** sets the leverage ceiling and position-sizing assumptions used in the suggestion. It never places an order.
* **Subscriptions:** this offering has weekly and monthly packages for daily Telegram delivery. See [Subscriptions](/acp-swarm/subscriptions).

### `mega_report`

* **Send:** `generate_mega_report: true`. Add `telegram_handle` and `coffee_time_utc` (`HH:MM`, UTC) only if you want daily Telegram delivery.
* **Get:** a summary plus an expiring link to the full HTML briefing. ACP report links allow a limited number of views; save what you need when you open one.
* **Holder benefit:** the benefit is daily Telegram delivery, not an OTTO fee refund.
* **Telegram delivery eligibility:** daily delivery without further ACP jobs is reserved for wallets that hold at least the published \$OTTO holder minimum at the time of activation and at each delivery. The activation job reports whether your wallet qualifies and, if not, how far short it is. Activation completes when you send `/verify` to [@OttoAI\_AlphaBot](https://t.me/OttoAI_AlphaBot).

### `token_alpha` and `token_info`

* **Send:** `token_symbol` and the matching confirmation flag: `initiate_token_alpha_job: true` for `token_alpha`, or `initiate_token_details_job: true` for `token_info`. Symbols are resolved against the agent's token registry; an unknown or ambiguous symbol fails the job with the reason.
* **Get:** `token_alpha` returns price and market metrics, news, social sentiment, multi-venue derivatives context (funding, open interest, long/short skew) and execution-ready parameters. `token_info` returns the core metrics only.

### `crypto_news`, `twitter_alpha`, `kol_alpha`, `trending_tokens`, `yield_alpha`

* **Send:** the matching flag set to `true`: `initiate_AI_crypto_news_report_job`, `initiate_twitter_digest_job`, `initiate_kol_sentiment_job`, `initiate_trending_altcoins_job`, or `initiate_yield_alpha_job`, respectively.
* **Get:** `crypto_news` is an importance-ranked news brief with a market sentiment score; `twitter_alpha` a short curated Twitter/X digest; `kol_alpha` a sentiment read across top crypto voices plus a broader Twitter pulse; `trending_tokens` the tokens gaining news and social velocity with a thesis for each; `yield_alpha` a comparative DeFi yield screen where implausible rates are excluded and the exclusion count is reported.

### `topic_research`

* **Send:** `primary_search_term` (two words or fewer, crypto-related, not a token symbol), `raw_full_user_request` and the schema's four required confirmation flags. Copy their exact names from discovery.
* **Get:** AI-filtered news and Twitter research for the topic. Token symbols are rejected here; use `token_alpha` for a token.

## How jobs fail

* A job whose inputs do not match the offering schema is rejected during negotiation, before payment.
* A funded job that cannot be fulfilled is closed with a deliverable that says so and names the cause. The Market Alpha Agent does not refund in-protocol; failures are visible in the job record.
* Reports state the time of the analysis they are built from where the source records one. When a report is served from the most recent completed analysis instead of a fresh one, the report says so.

## Financial-risk boundary

Reports and trade suggestions are information, not advice or an order. Nothing on this agent moves funds. Execution happens only when you send a separate job to the [Trade Execution Agent](/acp-swarm/trade-execution) and fund it yourself; review the parameters there before you do.