# Intelligence

> Use when the user asks "what's hot", "what's moving", "any alpha", "show me squeeze setups", "what's the setup on ETH", "is SOL coiled", "should I deploy NEAR" or any market-scan / single-pair-drilldown question. Surfaces Superior Trade's live multi-bucket scoring across Hyperliquid alts + HIP-3 (stocks/indices/commodities/FX) — Squeeze fuel, Stealth accumulation, Coiled spring, Basis flipping. T…

- **Type:** Skill
- **Install:** `agentstack add skill-superior-trade-superior-skills-intelligence`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Superior-Trade](https://agentstack.voostack.com/s/superior-trade)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Superior-Trade](https://github.com/Superior-Trade)
- **Source:** https://github.com/Superior-Trade/superior-skills/tree/main/skills/intelligence

## Install

```sh
agentstack add skill-superior-trade-superior-skills-intelligence
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Intelligence

Live ranked alpha scan over Hyperliquid alts + HIP-3 markets. Returns the same data the **Intelligence page** at https://account.superior.trade/intelligence renders — bucket fits, per-pair best timeframes, snapshots, and recommended deploy templates.

## Files in this skill

| File | What it covers |
|---|---|
| [`references/buckets.md`](references/buckets.md) | The 4 buckets: **Squeeze fuel**, **Stealth accumulation**, **Coiled spring**, **Basis flipping**. Setup / Edge / Scoring + AI Critic concerns per bucket. Read this before presenting any scan output to the user. |
| [`references/api.md`](references/api.md) | The two endpoints: `GET /v2/intelligence/scan` (list mode) and `GET /v2/intelligence/setup/{pair}` (single-pair detail). Response schemas + examples. |
| [`references/workflow.md`](references/workflow.md) | Recommended end-to-end recipes: scan → pick → setup → backtest → deploy. How to translate a `best_fit` tuple into a `/v2/backtesting` call. |
| [`references/glossary.md`](references/glossary.md) | Plain-English definitions for the trading terms in scan responses (funding, OI, basis, fees-paid notional, OI turnover, CVD, etc.). Reference this when explaining results to a non-trader. |

## When to call which endpoint

- **List question** ("what's hot", "any squeeze setups", "show me coiled springs in HIP-3") → `GET /v2/intelligence/scan` with optional `bucket` and `category` filters.
- **Single-pair question** ("tell me about ETH", "is NEAR a stealth setup", "should I deploy AVAX") → `GET /v2/intelligence/setup/{pair}`. Always do this BEFORE backtesting / deploying so the choice is grounded in current data.

## Critical: do not improvise rankings

Both endpoints return **live, ranked data**. Never substitute a market scan from training data — prices are stale, the ranking framework is Superior's, and timeframes are picked by the engine. When presenting:

1. Lead with the **specific** `best_fit.bucket_title @ best_fit.timeframe (score)` tuple per pair.
2. Cite the snapshot fields that drove the score (e.g. for squeeze: `pct_change_24h` + `funding_paid_notional_usd_per_yr`).
3. Mention `bucket_fits` only if asked why another bucket wasn't picked.
4. Reference the AI Critic concerns from [`references/buckets.md`](references/buckets.md) before recommending a deploy.

## Caveats

- Majors (BTC / ETH / SOL) are **excluded** by design — this is for alt + HIP-3 alpha discovery. For majors, use the regular price/chart tools.
- Pairs below $100K daily volume are filtered out as too thin for live deployment.
- HIP-3 stocks (`xyz:NVDA`, `xyz:AAPL`, etc.) trade 24/7 but the underlying equities only trade during NYSE hours — see the US Market Closed warning in `references/buckets.md` § Stocks.
- News sentiment is **not** part of the current scan. The buckets are price + positioning + flow; news comes from external context.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Superior-Trade](https://github.com/Superior-Trade)
- **Source:** [Superior-Trade/superior-skills](https://github.com/Superior-Trade/superior-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-superior-trade-superior-skills-intelligence
- Seller: https://agentstack.voostack.com/s/superior-trade
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
