Use when an OpenClaw user needs fast NBA opportunity scanning, NBA-only /fair pricing, or deep analysis of one specific Polymarket market or event in any domain, including politics, via prompts like /analyze, analyze this market, or direct PM URLs, without making the final trading decision.
Use this skill as a decision-support tool, not an autonomous trading brain. Its job is to surface promising markets, organize them by priority, and explain the pricing context so the user or higher-level system can make the final decision.
This skill assumes a read-only backend exists under /api/v1/agent. It does not place orders, cancel orders, manage wallets, or finalize trade decisions.
Before using the API, ensure these variables are available through the user's own OpenClaw-local configuration, secret store, or env file:
OPENCLAW_AGENT_API_BASE_URLOPENCLAW_AGENT_API_KEYExample values:
OPENCLAW_AGENT_API_BASE_URL=http://your-host:8080/api/v1/agent
OPENCLAW_AGENT_API_KEY=your-own-bearer-token
These variables must be configured by the OpenClaw user in their own environment. This skill only defines the required variable names and expected format. It does not manage, provision, or store user credentials.
Use this routing rule before doing anything else:
/fair and the target is NBA, use the NBA fair shortcut./analyze, or gives one concrete PM URL / market_id / event_id, use deep analysis mode./fair on any non-NBA domain, say /fair is NBA-only and continue with deep analysis mode.This skill has one public purpose but three operating paths:
NBA Opportunity ScanNBA Fair ShortcutUniversal Deep AnalysisThe current local sports coverage exposed by this skill includes:
nbasoccer5 for basic soccer marketsSoccer note:
/markets layer as market_domain=soccer5market_id, event_id, slug, or PM URL/analyze, analyze, 分析, 分析这个市场, 分析这个事件/fair requests for NBA markets onlyDo not use this skill for:
Choose mode from the input:
scan nbafind nba opportunitiestoday's nba marketslook for nba tradesmarket_id, event_id, event slug, or a Polymarket URL/analyze, analyze, 分析, analyze this, 分析这个市场, or equivalent phrasingTreat the following as a request for analysis capability, not just discovery:
/analyze <pm_url>analyze <pm_url>analyze this market分析这个市场分析这个 eventdeep dive this polymarketWhen the user provides one concrete PM URL, market_id, event_id, or event slug alongside an analyze-style request, skip discovery mode and go straight to deep analysis mode.
If the user says only /analyze with no market reference, ask for one of:
market_idevent_idTreat /fair as a narrower shortcut than /analyze.
/fair is supported only for NBA markets or NBA events/fair may return the compact fair-price view/analyze behavior insteadPractical rule:
NBA + /fair -> use fair-price-first handlingnon-NBA + /fair -> respond that /fair is only supported for NBA and continue with /analyze style deep analysis/analyze remains valid for every supported domainIf discovery mode finds a strong but uncertain candidate, it may automatically deepen at most 1-2 markets. Do not deepen the whole candidate set.
NBA Opportunity Scanmarket_domain=soccer5/fair on NBA:
NBA Fair Shortcut/fair on non-NBA:
/fair is NBA-onlyUniversal Deep Analysismarket_id, event_id, or event slug:
Universal Deep AnalysisUniversal Deep AnalysisFor a newly spawned agent, default to these behaviors:
soccer5 discovery unless they gave one specific market./fair./fair outside NBA.Read references/agent-api.md before using the API.
GET /api/v1/agent/markets with NBA scope and an explicit time window.GET /api/v1/agent/markets/{market_id}/fairGET /api/v1/agent/markets/{market_id}/checkbest_ask_yesbest_ask_nodata_status = tradable1-2 borderline but interesting markets with orderbook if needed.market_id.GET /api/v1/agent/markets/{market_id}/fairGET /api/v1/agent/markets/{market_id}/orderbookGET /api/v1/agent/markets/{market_id}/checkGET /api/v1/agent/eventsGET /api/v1/agent/events/{event_id}GET /api/v1/agent/events/{event_id}/marketshigh_priority_reviewwatchlow_priorityWhen the user explicitly asks for /fair on an NBA market:
market_id.GET /api/v1/agent/markets/{market_id}/fair.GET /api/v1/agent/markets/{market_id}/orderbookDo not use this shortcut for non-NBA markets.
Use this only when the user asked to scan a broad non-NBA scope.
For soccer basic markets:
GET /api/v1/agent/markets?market_domain=soccer5.fair + check on the shortlist.For other non-NBA domains:
GET /api/v1/agent/events.Universal Deep Analysis.Evaluate both sides from executable ask:
fair_yes - best_ask_yesfair_no - best_ask_noOnly surface the stronger side for each binary market. Do not present both sides of the same binary market unless the user explicitly asks for a symmetric comparison.
Auto-deepen only if a candidate is near the top and one of these is true:
data_status = watchDo not auto-deepen more than 2 markets per scan.
This skill is designed for repeated OpenClaw reuse. Enforce these defaults unless the caller overrides them:
5m15mlow_priority: 10mhigh_priority_review: 15mTreat a market as changed enough to revisit only if one of these is materially different since the last pass:
fair_yes or fair_nobest_ask_yes or best_ask_nodata_statusIf no material change occurred, do not repeat the same output.
When possible, compare against the previous scan and classify each market as:
newupgradeddowngradedremovedunchangedStop immediately when any of these is true:
high_priority_review, watch, or low_priorityDo not drift into open-ended commentary.
Read references/decision-contract.md for exact field sets.
/fair is NBA-only./fair must be handled through /analyze logic instead of failing or pretending fair-only support exists.soccer5 basic-market universe.today, tomorrow, or next 24h into explicit dates and a named timezone before scanning.watch or unpriced, do not force a strong conclusion.low_priority, not a recommendation.When responding in natural language, keep sections short:
Opportunity ScanPriority Markets or Market AnalysisPricing ViewRisk NotesNext CheckThe point of this skill is to help OpenClaw users discover and analyze opportunities quickly without replacing final judgment.