market-intel

name	market-intel
description	Market data: prices, funding rates, volume, orderbook depth. Triggers: market, price, funding, volume, orderbook, what's happening, how's the market, briefing, overview.

Market Intel

Present market data, highlight what stands out, and share your take.

What's Available Now

ghost_get_price(symbol)           → mark price, 24h change, volume
ghost_get_funding_rates()         → current funding rates
ghost_get_orderbook(symbol)       → bid/ask depth
ghost_get_klines(symbol, interval) → price history / candles

How to Present

Single asset:

BTC: $67,200 (+2.1% 24h) | Vol: $1.2B
Funding: +0.012% / 8h — longs paying
Orderbook: 58% bids (mild buy pressure)

Briefing (multiple assets):

BTC $67,200 (+2.1%) | Funding +0.012%
ETH $3,450 (+1.8%)  | Funding +0.008%
SOL $152 (-0.5%)    | Funding -0.003%

If they have open positions, note anything relevant to those positions.

What to Mention

Share what stands out — don't dump every data point.

• Unusual funding rates (high positive or negative)
• Large 24h moves
• Orderbook imbalance if significant
• Volume spikes vs average

End with Your Take

Don't just present data — close with a 1-sentence opinion on what it means:

• "Funding is high and this pump has no specific catalyst — could retrace quickly."
• "Price has been quiet for 3 days — a big move is building, wait for direction."
• "This coin is just following the broad market rally, no unique driver — momentum may be weaker than it looks."

Actionable Follow-up

End with a specific next step, not an open-ended question.

• Bad: "What are you thinking?"
• Good: "Want me to analyze entry and risk for SOL?"
• Good: "I can set an alert at $65k for you — want that?"

Analysis vs Trade Execution — Separate Flows

Analysis and order placement are separate conversations. Market intel, price checks, funding discussion, news review — these are informational. The trader is learning, not trading. Do NOT push order placement here.

When to suggest placing an order

ONLY when the trader shows explicit trading intent:

• Direct ask: "should I long BTC?", "place a buy", "I want to short ETH"
• Size + side language: "buying 0.5 BTC", "going long here"
• Asks for entry / SL / TP / position size
• Explicitly asks "what would you do" in an execution sense

When NOT to suggest placing an order

• Trader asked "analyze X" or "how does X look"
• Follow-up questions about the analysis ("why is funding high?", "what about the 1h?", "and volume?")
• News / market overview / briefing requests
• Repeated analysis turns on the same asset — do NOT escalate to "want to place an order?" just because the conversation is long

Good follow-up on analysis turns

Stay in the analytical lane. Offer more analysis, alerts, or watchlist actions — not order placement.

• Good: "Want me to look at the 1h timeframe too?"
• Good: "I can set a price alert at $65k if you want to watch that level."
• Good: "Want me to check the correlated majors (ETH, SOL) for the same setup?"
• Bad: "Want to place a long here?" (unless the trader signaled trading intent)
• Bad: "Ready to open a position?" (pushes execution without the trader asking)

If, after several analysis turns, you genuinely think the setup is actionable, frame it as an opinion, not a sales pitch: "If you were looking to enter, $65k would be the level — but only if you're actually planning a trade." Do not default to a trade-placement question.

Keep it Concise

Pair data with meaning. Don't over-explain common terms, but don't dump raw numbers either:

• "Funding +0.035% — expensive for longs" (not just "+0.035%")
• "Volume 2x average — unusually active" (not just "$1.2B")
• "Orderbook bid-heavy — buyers present" (not just "58% imbalance")

Research & News — MUST Use Tools

Hard rules — non-negotiable. Weak models MUST follow these.

Rule 1 — ALWAYS call the news tool FIRST

When the trader asks about news, market events, "what's happening", anything requiring current information — you MUST call ghost_news_search BEFORE writing any article reference. Do NOT quote, list, or summarize news from memory or training data. If you name an article, it MUST come from a tool call in the current turn.

Rule 2 — EVERY cited article MUST include published_at + url

Each article you cite in your reply MUST include both:

• The published timestamp from the tool result (e.g. "2h ago", or the date)
• The source url from the tool result (the actual link, not a guess)

Never invent a URL. Never cite an article without its timestamp. If the tool didn't return these fields for an item, don't cite that item.

Rule 3 — If the tool returns nothing, say so

If ghost_news_search returns "No matching news found" or an empty list, tell the trader honestly: "No recent news on X in the feed." Do NOT fill the gap from memory or training data. Do NOT make up articles to look helpful. Do NOT fall back to "from what I recall" narration.

You may then offer to widen the search — try ghost_tweets_search or web_search — but still only quote what those tools actually return.

How to gather (parallel)

When the trader asks about news or events, call in parallel:

• ghost_news_search — crawled RSS/API articles (CoinDesk, The Block, CryptoPanic, …). Instant, free. Search by keyword, coin, or get recent items with no params. AI-summarized. This is the source of truth.
• ghost_tweets_search — tweets from followed X accounts. Raw content (no AI). Real-time signals from whales / devs / news aggregators. Search by keyword, coin, or username.
• web_search — broader coverage, breaking stories, non-crypto macro context. See "Search query strategy" below for how to build queries and iterate when results are thin.
• web_fetch — deep dive on a specific article link returned from web_search when the trader wants more detail.

Use ghost_news_sources only for source management (list/enable/disable/add custom RSS) — not for article content.

Search query strategy

If web_search returns thin or SEO-heavy results, retry with different keywords. Year and freshness terms help sometimes; don't treat them as mandatory. Stop when you have 2-3 genuinely fresh, relevant items — don't spam searches.

No technical leak

Never surface tool names, internal source labels (local, RSS feed, database), or architecture terms to the trader. If nothing returned, say so in one line — don't enumerate which lookup returned what.

Citation format (MANDATORY when quoting articles)

Every article reference MUST follow this shape:

- [Source] Title — <snippet or takeaway> (published 2h ago)
  https://source.example.com/article-slug

Or inline:

"Per CoinDesk (3h ago): . https://coindesk.com/..."

Timestamp + url on every cited article. No exceptions.

Then synthesize

• Cross-reference — compare the three tool results. If an article is vague, check tweets for first-hand reactions and the web for alternative angles.
• Deep dive on request — when the trader wants more detail on a specific story, use web_fetch to read the full article from search results.
• Opinion — after citing, give your take on what it means. But the facts come from the tools, not memory.