ProphetX — Public Exchange Markets (read-only)
Before writing queries, consult references/api-reference.md for sport codes and command parameters.
Read this first — what this skill can and cannot return:
- ✅ Tournaments (leagues), events (with home/away, schedule, status), market catalog (moneyline/spread/total, alt lines, player props on v2), matched stake (
total_stake), primary-line flag (favourite).
- ✅ Exchange odds (American) with derived implied probability — but ONLY on markets where a public order book is exposed. Check
selections_available per market; availability varies (pre-game core markets usually have books; in-play and low-activity markets often come back [null, null]).
- ❌ Guaranteed odds on every market, or full order-book depth/liquidity. When
selections_available is False, only structure and matched stake exist — never invent odds. Complete odds coverage lives behind the authenticated ProphetX Affiliate API, a separate credentialed Machina connector — never wire tokens into this skill.
Quick Start
Prefer the CLI — it avoids Python import path issues:
sports-skills prophetx get_sports_config
sports-skills prophetx search_markets --sport=nfl --query="Eagles"
sports-skills prophetx get_todays_events --sport=mlb
sports-skills prophetx get_tournaments --sport=soccer
sports-skills prophetx get_markets --event_id=19742 --api_version=v2
Python SDK (alternative):
from sports_skills import prophetx
prophetx.get_sports_config()
prophetx.search_markets(sport="nfl", query="Eagles")
prophetx.get_todays_events(sport="mlb")
prophetx.get_events(109) # tournament_id
prophetx.get_markets(19742, api_version="v2") # event_id
prophetx.get_market(19742, 219) # market id or "19742:219"
CRITICAL: Before Any Query
- Market
id is the market-TYPE id (219 = Moneyline on ANY event) — the stable per-event key is market_key ("<event_id>:<market_id>").
api_version="v2" adds category, subType, alt lines (market_lines) and player props; default v1 is the lean catalog. v2 automatically falls back to v1 on failure.
- Check
selections_available before reading odds fields — odds exist only where a public order book does; never present total_stake (matched volume) as odds or liquidity.
- Sport codes:
soccer, tennis, basketball, baseball, ice-hockey, american-football + aliases (nfl, nba, mlb, nhl, epl, mls, worldcup, ...).
Workflows
Market discovery for a game
search_markets --sport=nfl --query="Eagles" — soonest matching events with their markets.
- Present market names/types/lines; quote odds only from markets with
selections_available: true, and say explicitly when a market's public book is empty.
Today's slate
get_todays_events --sport=mlb — today's events (UTC) with home/away and schedule.
- Follow with
get_markets --event_id=<id> --api_version=v2 for the full catalog (player props, alt lines).
Explore the exchange
get_sports_config — sports and live tournaments.
get_tournaments --sport=soccer → get_events --tournament_id=<id>.
Important Notes
- Read-only by design: no login, no cookies, no browser automation, only GETs; conservative throttling + caching + retries with backoff; fails closed on 403/WAF and on schema drift.
- Event
status values observed: not_started, live.
_raw preserves the full provider payload on every normalized record.
- Unified cross-venue discovery:
sports-skills markets search_entity --query="Yankees" includes a prophetx section (top-of-book odds per outcome when a public book exists; events without any exposed book are flagged with a note).
1---2name: prophetx3description: |4 ProphetX betting exchange — public tournaments, events, markets, and exchange odds. No API key, read-only. Covers soccer, tennis, basketball, baseball (MLB), NFL, NHL. IMPORTANT: odds are per-market optional — they appear only when a public order book exists (check `selections_available`); empty/suspended books return market structure and matched stake only. Full guaranteed odds coverage requires the authenticated ProphetX Affiliate API (separate Machina connector).56 Use when: user asks what markets/lines ProphetX offers for a game, ProphetX exchange odds and order-book prices (when exposed), event/tournament discovery, market structure (spreads, totals, alt lines, player props), or matched-stake activity.7 Don't use when: user needs guaranteed odds on every market or in-play liquidity — that requires the authenticated Affiliate connector (Machina platform). For prediction-market prices use polymarket or kalshi. For scores/stats use the sport-specific skill (nfl-data, mlb-data, football-data, ...). For news use sports-news.8license: MIT9metadata:10 source: https://skillmd.com/skills/machina-sports/prophetx11 author: machina-sports12 version: "0.1.0"13---1415# ProphetX — Public Exchange Markets (read-only)1617Before writing queries, consult `references/api-reference.md` for sport codes and command parameters.1819**Read this first — what this skill can and cannot return:**20- ✅ Tournaments (leagues), events (with home/away, schedule, status), market catalog (moneyline/spread/total, alt lines, player props on v2), matched stake (`total_stake`), primary-line flag (`favourite`).21- ✅ Exchange odds (American) with derived implied probability — but ONLY on markets where a public order book is exposed. Check `selections_available` per market; availability varies (pre-game core markets usually have books; in-play and low-activity markets often come back `[null, null]`).22- ❌ Guaranteed odds on every market, or full order-book depth/liquidity. When `selections_available` is `False`, only structure and matched stake exist — never invent odds. Complete odds coverage lives behind the authenticated ProphetX Affiliate API, a separate credentialed Machina connector — never wire tokens into this skill.2324## Quick Start2526Prefer the CLI — it avoids Python import path issues:27```bash28sports-skills prophetx get_sports_config29sports-skills prophetx search_markets --sport=nfl --query="Eagles"30sports-skills prophetx get_todays_events --sport=mlb31sports-skills prophetx get_tournaments --sport=soccer32sports-skills prophetx get_markets --event_id=19742 --api_version=v233```3435Python SDK (alternative):36```python37from sports_skills import prophetx3839prophetx.get_sports_config()40prophetx.search_markets(sport="nfl", query="Eagles")41prophetx.get_todays_events(sport="mlb")42prophetx.get_events(109) # tournament_id43prophetx.get_markets(19742, api_version="v2") # event_id44prophetx.get_market(19742, 219) # market id or "19742:219"45```4647## CRITICAL: Before Any Query4849- Market `id` is the market-TYPE id (219 = Moneyline on ANY event) — the stable per-event key is `market_key` (`"<event_id>:<market_id>"`).50- `api_version="v2"` adds category, subType, alt lines (`market_lines`) and player props; default v1 is the lean catalog. v2 automatically falls back to v1 on failure.51- Check `selections_available` before reading odds fields — odds exist only where a public order book does; never present `total_stake` (matched volume) as odds or liquidity.52- Sport codes: `soccer`, `tennis`, `basketball`, `baseball`, `ice-hockey`, `american-football` + aliases (`nfl`, `nba`, `mlb`, `nhl`, `epl`, `mls`, `worldcup`, ...).5354## Workflows5556### Market discovery for a game571. `search_markets --sport=nfl --query="Eagles"` — soonest matching events with their markets.582. Present market names/types/lines; quote odds only from markets with `selections_available: true`, and say explicitly when a market's public book is empty.5960### Today's slate611. `get_todays_events --sport=mlb` — today's events (UTC) with home/away and schedule.622. Follow with `get_markets --event_id=<id> --api_version=v2` for the full catalog (player props, alt lines).6364### Explore the exchange651. `get_sports_config` — sports and live tournaments.662. `get_tournaments --sport=soccer` → `get_events --tournament_id=<id>`.6768## Important Notes6970- **Read-only by design**: no login, no cookies, no browser automation, only GETs; conservative throttling + caching + retries with backoff; fails closed on 403/WAF and on schema drift.71- Event `status` values observed: `not_started`, `live`.72- `_raw` preserves the full provider payload on every normalized record.73- Unified cross-venue discovery: `sports-skills markets search_entity --query="Yankees"` includes a `prophetx` section (top-of-book odds per outcome when a public book exists; events without any exposed book are flagged with a `note`).