SKILL.md
skills/ito-market-intelligence/SKILL.md
name: ito-market-intelligence
description: Research prediction-market events, venues, underliers, liquidity, and news context for Itô basket workflows. Use for read-only market intelligence, API-gated Itô exploration, and source-grounded prediction-market briefings without investment advice or live trading.Itô Market Intelligence
Use this skill when a user wants prediction-market context, event discovery, venue comparison, basket theme exploration, or an Itô API-backed market brief.
Use public sources by default. Any Itô-backed data call requires the user to explicitly request Itô data and requires a scoped ITO_API_KEY. Never print, persist, or ask the user to paste a key into chat.
Guardrails
- Do not provide investment, legal, tax, or trading advice.
- Do not place, cancel, route, or simulate live orders.
- Do not infer the user's financial situation unless they provide it.
- Treat Polymarket, Kalshi, Itô, X, Exa, GitHub, and web data as source inputs,
not as truth by themselves.
- Separate facts, market-implied signals, and your interpretation.
- Never claim a price, volume, liquidity value, timestamp, venue rule, or news
event that is absent from a cited response or source.
- Treat every remote response as a snapshot. Show its retrieval time, source
URL, and source-provided update time when available. Call data stale or unknown rather than silently treating it as current.
Workflow
- Clarify the market theme, venue, geography, and time horizon.
- Gather public market data from venue docs/APIs or source-grounded research.
Cite the exact source URL next to each material claim and distinguish the publication/update time from the retrieval time.
- If the user explicitly asks for Itô data, run the bundled read-only client:
node scripts/ito-market-intelligence.js --json search-markets --platform all --limit 25
The client reads ITO_API_KEY from the environment, sends it only to the configured Itô HTTPS origin, never logs it, and permits only documented GET endpoints. Do not run it merely because a key exists.
- Normalize event, underlier, liquidity, fee, resolution, and data-latency
differences across venues.
- Produce a decision brief:
- market/event summary
- available venues and underliers
- liquidity and data-quality caveats
- relevant news/source context
- open questions before any user action
Authentication and recovery
- Market-data API keys are separate from the Itô compute CLI's device login.
Do not run ito login, ecc ito login, or open a browser for this skill: those credentials are not a documented substitute for a baskets:read or markets:read API key. Return control to the originating agent after stating the missing scope and operator-driven access requirement.
- On
AUTH_MISSING, request a scoped key through the user's established Itô
access channel without collecting it in chat. On AUTH_REJECTED, say the key may be expired, revoked, or missing the required read scope.
- On
RATE_LIMITED, respectretry_after_seconds; do not loop automatically.
On TIMEOUT or UPSTREAM_ERROR, preserve prior cited facts, label the live snapshot unavailable, and offer a bounded retry. Never replace failed live data with invented values.
ITO_MARKET_API_URLmay override the API origin for deterministic local
tests. In normal use keep the default https://itomarkets.com/api/v1.
Useful Skill Chains
- Use
deep-researchorexa-searchfor source discovery. - Use
x-apifor public social signal discovery when X access is configured. - Use
market-researchfor market sizing, competitors, or business use cases. - Use
prediction-market-risk-reviewbefore any workflow touches user capital,
portfolio data, or execution-capable credentials.
Output Contract
Default to a compact brief containing retrieved_at, source links, source-provided timestamps, freshness caveats, facts, market-implied signals, interpretation, and actionable open questions. End with:
This is market intelligence, not investment or trading advice.
If access is missing, say:
Itô live basket/API data requires gated access. Request an ITO_API_KEY before
using Itô-backed reads.