prophetx

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ProphetX — Public Exchange Markets (read-only)

ProphetX — 公开交易所市场（只读）

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.

编写查询前，请查阅

references/api-reference.md

获取运动项目代码和命令参数。

请先阅读本部分——本技能可返回与不可返回内容：

✅ 锦标赛（联赛）、赛事（包含主客场、赛程、状态）、市场目录（胜负盘/让分盘/总分盘、替代盘口、v2版本的球员道具）、已匹配投注额（
```
total_stake
```
）、主盘标记（
```
favourite
```
）。
✅ 美式交易所赔率及推导的隐含概率——但仅在公开订单簿可用的市场中提供。请检查每个市场的
```
selections_available
```
字段；可用性因情况而异（赛前核心市场通常有订单簿；实时赛事和低活跃度市场通常返回
```
[null, null]
```
）。
❌ 每个市场的保底赔率，或完整的订单簿深度/流动性。当
```
selections_available
```
为
```
False
```
时，仅存在市场结构和已匹配投注额——切勿编造赔率。完整的赔率覆盖需通过经过认证的ProphetX联盟API（独立的带凭证Machina连接器）获取——切勿将令牌接入本技能。

Quick Start

快速开始

Prefer the CLI — it avoids Python import path issues:

bash

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):

python

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"

推荐使用CLI——可避免Python导入路径问题：

bash

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（替代方案）：

python

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

, ...).

市场
```
id
```
是市场类型ID（219 = 任意赛事的胜负盘）——每个赛事的稳定标识是
```
market_key
```
（格式为
```
"<event_id>:<market_id>"
```
）。
```
api_version="v2"
```
新增分类、子类型、替代盘口（
```
market_lines
```
）和球员道具；默认v1版本为精简目录。v2版本在调用失败时会自动回退到v1。
读取赔率字段前请检查
```
selections_available
```
——仅当存在公开订单簿时才有赔率；切勿将
```
total_stake
```
（已匹配交易量）当作赔率或流动性展示。

运动项目代码：

soccer

、

tennis

、

basketball

、

baseball

、

ice-hockey

、

american-football

及别名（

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.

执行
```
search_markets --sport=nfl --query="Eagles"
```
——获取最近的匹配赛事及其市场。
展示市场名称/类型/盘口；仅从
```
selections_available: true
```
的市场中引用赔率，并明确说明某市场的公开订单簿为空的情况。

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).

执行
```
get_todays_events --sport=mlb
```
——获取今日（UTC时区）的赛事，包含主客场和赛程信息。
后续执行
```
get_markets --event_id=<id> --api_version=v2
```
获取完整目录（球员道具、替代盘口）。

Explore the exchange

探索交易所

```
get_sports_config
```
— sports and live tournaments.

get_tournaments --sport=soccer

→

get_events --tournament_id=<id>

执行
```
get_sports_config
```
——获取支持的运动项目和实时锦标赛。

执行

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
```
).

设计为只读模式：无需登录、无需Cookie、无需浏览器自动化，仅使用GET请求；采用保守的限流+缓存+退避重试机制；遇到403/WAF拦截或schema漂移时会终止操作。
已观测到的赛事
```
status
```
值：
```
not_started
```
、
```
live
```
。
```
_raw
```
字段会在每条标准化记录中保留完整的提供商 payload。
跨平台统一发现：
```
sports-skills markets search_entity --query="Yankees"
```
包含
```
prophetx
```
板块（当存在公开订单簿时，显示每个结果的最优盘口赔率；无任何公开订单簿的赛事会通过
```
note
```
字段标记）。