sports--markets
|
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 13
- Forks
- 2
01 前言 Front Matter
- name
- sports--markets
- origin
- github.com/machina-sports/sports-skills (skill: markets)
- license
- MIT
- version
- 1.0.0
- description
- |
- compatibility
- yana-ai >= 0.14.0
03 SKILL.md 正文
Markets Orchestration
Bridges ESPN live schedules (NBA, NFL, MLB, NHL, WNBA, CFB, CBB) with Kalshi and Polymarket prediction markets. Before writing queries, consult references/api-reference.md for supported sport codes, command parameters, and price normalization formats.
Quick Start
sports-skills markets get_todays_markets --sport=nba
sports-skills markets search_entity --query="Lakers" --sport=nba
sports-skills markets compare_odds --sport=nba --event_id=401234567
sports-skills markets get_sport_markets --sport=nfl
sports-skills markets get_sport_schedule --sport=nba
sports-skills markets normalize_price --price=0.65 --source=polymarket
sports-skills markets evaluate_market --sport=nba --event_id=401234567
Python SDK:
from sports_skills import markets
markets.get_todays_markets(sport="nba")
markets.search_entity(query="Lakers", sport="nba")
markets.compare_odds(sport="nba", event_id="401234567")
markets.get_sport_markets(sport="nfl")
markets.get_sport_schedule(sport="nba", date="2025-02-26")
markets.normalize_price(price=0.65, source="polymarket")
markets.evaluate_market(sport="nba", event_id="401234567")
CRITICAL: Before Any Query
CRITICAL: Before calling any orchestration command, verify:
- A
sportcode is provided for sport-aware commands (get_todays_markets,compare_odds,get_sport_markets,evaluate_market). - Price sources are identified correctly before normalization:
espn= American odds,polymarket= 0-1 probability,kalshi= 0-100 integer.
Important Notes
- Sport context is passed through.
--sport=nbamaps automatically to the correct Polymarket sport code and Kalshi series ticker. - Both platforms use sport-aware search. Polymarket uses
sport→ series_id; Kalshi usesKXNBA,KXNFL, etc. - Prices are normalized. Everything is converted to implied probability for comparison.
Workflows
Today's NBA Dashboard
sports-skills markets get_todays_markets --sport=nba
Returns each game with ESPN info, DraftKings odds, matching Kalshi markets, and matching Polymarket markets.
Find Arb on a Specific Game
- Get the ESPN event ID:
get_sport_schedule --sport=nba - Compare odds:
compare_odds --sport=nba --event_id=<id> - If arbitrage detected, response includes allocation percentages and guaranteed ROI.
Full Bet Evaluation
evaluate_market --sport=nba --event_id=<id>- Fetches ESPN odds and matching prediction market price
- Pipes through
betting.evaluate_bet: devig → edge → Kelly - Returns fair probability, edge, EV, Kelly fraction, and recommendation
Examples
Example 1: Today's games with prediction market odds User says: "What NBA games are on today and what are the prediction market odds?" Actions:
- Call
get_todays_markets(sport="nba")Result: Unified dashboard with each game's ESPN info and Kalshi/Polymarket prices
Example 2: Cross-platform team search User says: "Find me Lakers markets on Kalshi and Polymarket" Actions:
- Call
search_entity(query="Lakers", sport="nba")Result: All Lakers markets across both exchanges with prices and volume
Example 3: Odds comparison for a specific game User says: "Compare the odds for this Celtics game across ESPN and Polymarket" Actions:
- Get event_id from
get_sport_schedule(sport="nba") - Call
compare_odds(sport="nba", event_id="<id>")Result: Normalized side-by-side comparison with automatic arbitrage check
Example 4: Full market evaluation User says: "Is there edge on the Chiefs game?" Actions:
- Get event_id from
get_sport_schedule(sport="nfl") - Call
evaluate_market(sport="nfl", event_id="<id>")Result: Fair probability, edge percentage, EV, Kelly fraction, and bet recommendation
Example 5: Browse all markets for a sport User says: "Show me all NFL prediction markets" Actions:
- Call
get_sport_markets(sport="nfl")Result: All open NFL markets across Kalshi and Polymarket
Example 6: Price conversion User says: "Convert a Polymarket price of 65 cents to American odds" Actions:
- Call
normalize_price(price=0.65, source="polymarket")Result: Common structure with implied probability (0.65), American odds (-185.7), and decimal (1.54)
Commands that DO NOT exist — never call these
— does not exist. Useget_oddscompare_oddsto see odds across sources.— does not exist on the markets module. Usesearch_marketssearch_entityinstead.— does not exist. Useget_scheduleget_sport_scheduleinstead.
If a command is not listed in references/api-reference.md, it does not exist.
Troubleshooting
Error: No markets returned for a sport
Cause: Sport code may be missing or incorrect
Solution: Check references/api-reference.md for valid sport codes. Use the exact code (e.g., nba, epl, laliga)
Error: compare_odds returns no data for an event
Cause: The event_id is incorrect or the game has not been indexed yet
Solution: Call get_sport_schedule(sport=...) to retrieve the correct event_id first
Error: One source shows warnings in the response Cause: Kalshi or Polymarket is temporarily unavailable Solution: The module returns partial results — use what is available. Retry the unavailable source separately using the kalshi or polymarket skill directly
Error: normalize_price returns unexpected American odds value
Cause: Wrong source parameter — Kalshi uses 0-100 integers, Polymarket uses 0-1 decimals
Solution: Verify the source. Kalshi price of 65 requires source="kalshi", Polymarket price of 0.65 requires source="polymarket"
04 同仓库更多 Skills
openai--sentry--sentry
Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script and require `SENTRY_AUTH_TOKEN`.
ito-basket-compare
Compare Itô prediction-market baskets against a user's knowledge base, portfolio notes, financial context, watchlist, or research thesis. Use for read-only basket comparison and gap analysis without investment advice or live trading.
implementing-network-traffic-baselining
Build network traffic baselines from NetFlow/IPFIX data using Python pandas for statistical analysis, z-score anomaly detection, and hourly/daily traffic pattern profiling
detecting-evasion-techniques-in-endpoint-logs
Detects defense evasion techniques used by adversaries in endpoint logs including log tampering, timestomping, process injection, and security tool disabling. Use when investigating suspicious endpoint behavior, building detection rules for evasion tactics, or conducting threat hunting for stealthy adversary activity. Activates for requests involving evasion detection, defense evasion analysis, log tampering detection, or MITRE ATT&CK TA0005.
implementing-microsegmentation-with-guardicore
Implementing microsegmentation using Akamai Guardicore Segmentation to map application dependencies, create granular network policies, visualize east-west traffic flows, and enforce least-privilege communication between workloads across data centers and cloud.
ramdisk-tmpfs-patterns
暂无简介