shipp-sports-data

Shipp — 实时体育数据 + MoonPay 交易

概述

Shipp 为 AI Agent 提供实时、权威的体育数据，包括赛程、比分和实时赛事动态。搭配 MoonPay 管理的钱包，即可将实时比分直接接入 Polymarket 或 Kalshi 的交易逻辑。

支持的运动项目： NBA、NFL、NCAA Football（NCAAF）、MLB、足球

前提条件

1. Shipp API 密钥 — 在 https://platform.shipp.ai 注册
2. MoonPay CLI — npm install -g @moonpay/cli
3. 已注资的钱包 — 在 Polygon 上持有 USDC.e，用于 Polymarket 交易

export SHIPP_API_KEY="sk_..."

设置工作流

# 1. Create a MoonPay wallet for your sports agent
mp wallet create --name "shipp-sports-agent"
mp wallet list  # note your Polygon address

# 2. Fund with USDC.e (for trading) and POL (for gas)
mp buy --token usdc_polygon --amount 100 --wallet <polygon-address> --email <email>
mp buy --token pol_polygon --amount 5 --wallet <polygon-address> --email <email>

# 3. Register wallet with Polymarket (one-time)
mp prediction-market user create --provider polymarket --wallet <polygon-address>

# 4. Create a Shipp connection for your target market
# (see Shipp API section below)

Shipp API

创建连接（每种查询类型仅需一次）

curl -X POST https://api.shipp.ai/api/v1/connections/create \
  -H "Authorization: Bearer $SHIPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter_instructions": "NBA games with final scores from the last 24 hours"}'
# → returns { "connection_id": "conn_..." }

轮询实时更新

curl -X POST https://api.shipp.ai/api/v1/connections/{connection_id} \
  -H "Authorization: Bearer $SHIPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 20, "since_event_id": "<last_seen_id>"}'

获取体育项目赛程（±7 天）

curl "https://api.shipp.ai/api/v1/sports/nba/schedule?api_key=$SHIPP_API_KEY"
# sports: nba | nfl | ncaaf | mlb | soccer

列出已保存的连接（免费）

curl "https://api.shipp.ai/api/v1/connections?api_key=$SHIPP_API_KEY"

实时数据 → 交易循环

创建一次连接，然后每隔 15 秒轮询实时赛事动态：

# 1. Create connection (run once — save the connection_id)
curl -X POST https://api.shipp.ai/api/v1/connections/create \
  -H "Authorization: Bearer $SHIPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter_instructions": "NBA games with final scores from the last 24 hours"}'
# → { "connection_id": "conn_..." }

# 2. Poll for updates (run every 15s, passing last seen event_id)
curl -X POST https://api.shipp.ai/api/v1/connections/{connection_id} \
  -H "Authorization: Bearer $SHIPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 20, "since_event_id": "<last_event_id>"}'

收到信号（最终比分、领先方变化、关键赛事动态）时，执行 Polymarket 交易：

mp prediction-market position buy \
  --wallet shipp-sports-agent \
  --provider polymarket \
  --tokenId <outcome-token-id> \
  --price 0.85 \
  --size 50

钱包操作

# Check balance
mp token balance list --wallet <polygon-address> --chain polygon

# Sign a message (EIP-191)
mp message sign --wallet shipp-sports-agent --chain polygon --message "I own this wallet"

# Withdraw winnings to bank
mp virtual-account offramp create \
  --name "Offramp" \
  --bankAccountId <bank-account-id> \
  --stablecoin usdc \
  --chain polygon

# Hardware wallet (high security)
mp wallet hardware add --name "shipp-sports-ledger"

注资方式

方式	命令	适用场景
使用法币购买	mp buy --token usdc_polygon ...	开始使用
跨链转移加密货币	mp token bridge --from-chain ethereum ...	已持有加密货币
银行转账	mp virtual-account onramp create ...	大额资金
存款链接	mp deposit create ...	任何人均可无需许可地注资

Polygon 上的主要代币地址：

• USDC.e：0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
• POL（Gas）：原生代币

端到端工作流

1. 获取 Shipp API 密钥 → https://platform.shipp.ai
2. mp wallet create --name "shipp-sports-agent"
3. mp buy --token usdc_polygon --amount 100 --wallet <address> --email <email>
4. mp buy --token pol_polygon --amount 5 --wallet <address> --email <email>
5. 为目标体育项目／市场创建 Shipp 连接
6. 每隔 15–30 秒轮询 Shipp，获取实时赛事动态
7. 收到信号（最终比分、领先方变化、关键赛事动态）时：执行 Polymarket 交易
8. 使用 mp virtual-account offramp create 提取收益

错误代码

代码	含义
400	请求无效
401	身份验证失败 — 检查 SHIPP_API_KEY
402	账单问题 — 为 Shipp 账户充值
429	请求过于频繁 — 等待一段时间后重试
5xx	Shipp 服务端错误 — 使用指数退避策略重试

资源

• Shipp API 文档： https://docs.shipp.ai
• 平台和 API 密钥： https://platform.shipp.ai
• 平台指南： https://docs.shipp.ai/platform-guides
• MoonPay CLI： https://www.npmjs.com/package/@moonpay/cli

相关技能

• moonpay-prediction-market — 搜索市场、买入／卖出头寸、跟踪盈亏
• moonpay-fund-polymarket — 为钱包注入 USDC.e 和 POL 作为 Gas
• moonpay-check-wallet — 交易前确认余额
• moonpay-trading-automation — 自动执行定期交易策略