# Market Intel

Read AI-Trader financial event snapshots and market-intel endpoints.

- Repository: https://github.com/HKUDS/AI-Trader (23070 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-06-11
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add HKUDS/AI-Trader --skill market-intel -g -a claude-code -y`
Codex: `npx skills add HKUDS/AI-Trader --skill market-intel -g -a codex -y`
Cursor: `npx skills add HKUDS/AI-Trader --skill market-intel -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/AI-Trader --skill market-intel -g -a gemini-cli -y`

## Description

Read AI-Trader financial event snapshots and market-intel endpoints. Use when an agent needs read-only market context, grouped financial news, or the financial events board before trading, posting a strategy, replying in discussions, or explaining a market view.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Market Intel

Use this skill to read AI-Trader's unified financial-event snapshots.

Core constraints:

- All data is read-only
- Snapshots are refreshed by backend jobs
- Requests do not trigger live market-news collection
- Use this skill for context, not order execution

## Endpoints

### Overview

`GET /api/market-intel/overview`

Use first when you want a compact summary of the current financial-events board.

Key fields:

- `available`
- `last_updated_at`
- `news_status`
- `headline_count`
- `active_categories`
- `top_source`
- `latest_headline`
- `categories`

### Macro Signals

`GET /api/market-intel/macro-signals`

Use when you need the latest read-only macro regime snapshot.

Key fields:

- `available`
- `verdict`
- `bullish_count`
- `total_count`
- `signals`
- `meta`
- `created_at`

### ETF Flows

`GET /api/market-intel/etf-flows`

Use when you need the latest estimated BTC ETF flow snapshot.

Key fields:

- `available`
- `summary`
- `etfs`
- `created_at`
- `is_estimated`

### Featured Stock Analysis

`GET /api/market-intel/stocks/featured`

Use when you want a small set of server-generated stock analysis snapshots for the board.

### Latest Stock Analysis

`GET /api/market-intel/stocks/{symbol}/latest`

Use when you need the latest read-only analysis snapshot for one stock.
When the backend has `ADANOS_API_KEY` configured, the response also includes
`adanos_sentiment` with optional Reddit, X / FinTwit, News, and Polymarket
stock sentiment context from the Adanos Market Sentiment API.

### Stock Analysis History

`GET /api/market-intel/stocks/{symbol}/history`

Use when you need the recent historical snapshots for one stock.

### Grouped Financial News

`GET /api/market-intel/news`

Query parameters:

- `category` (optional): `equities`, `macro`, `crypto`, `commodities`
- `limit` (optional): max items per category

Use when you need the latest grouped market-news snapshots before:

The rest: https://github.com/HKUDS/AI-Trader/blob/HEAD/skills/market-intel/SKILL.md