shipp-sports-data
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseShipp — Real-Time Sports Data + MoonPay Trading
Shipp — 实时体育数据 + MoonPay 交易
Overview
概述
Shipp gives AI agents live, authoritative sports data — schedules, scores, and events as they happen. Pair it with a MoonPay-managed wallet to pipe live scores directly into Polymarket or Kalshi trading logic.
Supported sports: NBA, NFL, NCAA Football (NCAAF), MLB, Soccer
Shipp为AI Agent提供实时、权威的体育数据——包括赛程、实时比分及赛事动态。搭配MoonPay托管钱包,可将实时比分直接接入Polymarket或Kalshi的交易逻辑中。
支持的赛事类型: NBA、NFL、NCAAF(大学橄榄球)、MLB、足球
Prerequisites
前置条件
- Shipp API key — register at https://platform.shipp.ai
- MoonPay CLI —
npm install -g @moonpay/cli - Funded wallet — USDC.e on Polygon for Polymarket trades
bash
export SHIPP_API_KEY="sk_..."- Shipp API密钥 — 前往https://platform.shipp.ai注册获取
- MoonPay CLI —
npm install -g @moonpay/cli - 已充值钱包 — 用于Polymarket交易的Polygon链上USDC.e
bash
export SHIPP_API_KEY="sk_..."Setup Workflow
设置流程
bash
undefinedbash
undefined1. Create a MoonPay wallet for your sports agent
1. 为你的体育Agent创建MoonPay钱包
mp wallet create --name "shipp-sports-agent"
mp wallet list # note your Polygon address
mp wallet create --name "shipp-sports-agent"
mp wallet list # 记录你的Polygon地址
2. Fund with USDC.e (for trading) and POL (for gas)
2. 充值USDC.e(用于交易)和POL(用于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>
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)
3. 将钱包注册到Polymarket(仅需一次)
mp prediction-market user create --provider polymarket --wallet <polygon-address>
mp prediction-market user create --provider polymarket --wallet <polygon-address>
4. Create a Shipp connection for your target market
4. 为目标市场创建Shipp连接
(see Shipp API section below)
(详见下方Shipp API章节)
undefinedundefinedShipp API
Shipp API
Create a Connection (one-time per query type)
创建连接(每种查询类型仅需一次)
bash
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"}'bash
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_..." }
→ 返回 { "connection_id": "conn_..." }
undefinedundefinedPoll for Live Updates
轮询获取实时更新
bash
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>"}'bash
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>"}'Get Sport Schedule (±7 days)
获取赛事赛程(±7天)
bash
curl "https://api.shipp.ai/api/v1/sports/nba/schedule?api_key=$SHIPP_API_KEY"bash
curl "https://api.shipp.ai/api/v1/sports/nba/schedule?api_key=$SHIPP_API_KEY"sports: nba | nfl | ncaaf | mlb | soccer
支持的赛事类型: nba | nfl | ncaaf | mlb | soccer
undefinedundefinedList Saved Connections (free)
查看已保存的连接(免费)
bash
curl "https://api.shipp.ai/api/v1/connections?api_key=$SHIPP_API_KEY"bash
curl "https://api.shipp.ai/api/v1/connections?api_key=$SHIPP_API_KEY"Live Data → Trade Loop
实时数据→交易循环
Create a connection once, then poll every 15 seconds for live events:
bash
undefined先创建一次连接,之后每15秒轮询一次获取实时赛事动态:
bash
undefined1. Create connection (run once — save the connection_id)
1. 创建连接(仅需运行一次 — 保存返回的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"}'
-H "Authorization: Bearer $SHIPP_API_KEY"
-H "Content-Type: application/json"
-d '{"filter_instructions": "NBA games with final scores from the last 24 hours"}'
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"}'
-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_..." }
→ { "connection_id": "conn_..." }
2. Poll for updates (run every 15s, passing last seen event_id)
2. 轮询获取更新(每15秒运行一次,传入上次获取的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>"}'
-H "Authorization: Bearer $SHIPP_API_KEY"
-H "Content-Type: application/json"
-d '{"limit": 20, "since_event_id": "<last_event_id>"}'
On signal (final score, lead change, key event), execute the Polymarket trade:
```bash
mp prediction-market position buy \
--wallet shipp-sports-agent \
--provider polymarket \
--tokenId <outcome-token-id> \
--price 0.85 \
--size 50curl -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>"}'
-H "Authorization: Bearer $SHIPP_API_KEY"
-H "Content-Type: application/json"
-d '{"limit": 20, "since_event_id": "<last_event_id>"}'
当收到触发信号(如最终比分、领先方变化、关键赛事节点)时,执行Polymarket交易:
```bash
mp prediction-market position buy \
--wallet shipp-sports-agent \
--provider polymarket \
--tokenId <outcome-token-id> \
--price 0.85 \
--size 50Wallet Operations
钱包操作
bash
undefinedbash
undefinedCheck balance
查看余额
mp token balance list --wallet <polygon-address> --chain polygon
mp token balance list --wallet <polygon-address> --chain polygon
Sign a message (EIP-191)
签署消息(EIP-191标准)
mp message sign --wallet shipp-sports-agent --chain polygon --message "I own this wallet"
mp message sign --wallet shipp-sports-agent --chain polygon --message "I own this wallet"
Withdraw winnings to bank
将盈利提现至银行账户
mp virtual-account offramp create
--amount 500 --chain polygon --wallet <polygon-address>
--amount 500 --chain polygon --wallet <polygon-address>
mp virtual-account offramp create
--amount 500 --chain polygon --wallet <polygon-address>
--amount 500 --chain polygon --wallet <polygon-address>
Hardware wallet (high security)
硬件钱包(高安全级别)
mp wallet add-ledger --name "shipp-sports-ledger"
undefinedmp wallet add-ledger --name "shipp-sports-ledger"
undefinedFunding Options
充值方式
| Method | Command | Best for |
|---|---|---|
| Buy with fiat | | Getting started |
| Bridge crypto | | Existing crypto holders |
| Bank transfer | | Large amounts |
| Deposit link | | Permissionless funding from anyone |
Key token addresses on Polygon:
- USDC.e:
0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 - POL (gas): native
| 方式 | 命令 | 适用场景 |
|---|---|---|
| 法币购买 | | 新手入门 |
| 跨链桥接加密货币 | | 已有加密货币持有者 |
| 银行转账 | | 大额资金充值 |
| 充值链接 | | 无需授权,支持任何人充值 |
Polygon链上核心代币地址:
- USDC.e:
0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 - POL(Gas费): 原生代币
End-to-End Workflow
端到端流程
- Get Shipp API key → https://platform.shipp.ai
mp wallet create --name "shipp-sports-agent"mp buy --token usdc_polygon --amount 100 --wallet <address> --email <email>mp buy --token pol_polygon --amount 5 --wallet <address> --email <email>- Create Shipp connection for target sport/market
- Poll Shipp every 15–30s for live game events
- On signal (final score, lead change, key event): execute Polymarket trade
- to withdraw winnings
mp virtual-account offramp create
- 获取Shipp API密钥 → https://platform.shipp.ai
- 执行创建钱包
mp wallet create --name "shipp-sports-agent" - 执行充值USDC.e
mp buy --token usdc_polygon --amount 100 --wallet <address> --email <email> - 执行充值POL用于Gas费
mp buy --token pol_polygon --amount 5 --wallet <address> --email <email> - 为目标赛事/市场创建Shipp连接
- 每15-30秒轮询Shipp获取实时赛事动态
- 收到触发信号(如最终比分、领先方变化、关键赛事节点)时,执行Polymarket交易
- 执行将盈利提现
mp virtual-account offramp create
Error Codes
错误代码
| Code | Meaning |
|---|---|
| 400 | Bad request |
| 401 | Auth failed — check |
| 402 | Billing — top up your Shipp account |
| 429 | Rate limited — back off and retry |
| 5xx | Shipp server error — retry with exponential backoff |
| 代码 | 含义 |
|---|---|
| 400 | 请求参数错误 |
| 401 | 认证失败 — 检查 |
| 402 | 账单问题 — 为你的Shipp账户充值 |
| 429 | 请求频率超限 — 降低请求频率后重试 |
| 5xx | Shipp服务器错误 — 使用指数退避策略重试 |
Resources
相关资源
- Shipp API docs: https://docs.shipp.ai
- Platform & API keys: https://platform.shipp.ai
- Platform guides: https://docs.shipp.ai/platform-guides
- MoonPay CLI: https://www.npmjs.com/package/@moonpay/cli
- 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
Related Skills
相关技能
- moonpay-prediction-market — Search markets, buy/sell positions, track PnL
- moonpay-fund-polymarket — Fund wallet with USDC.e and POL for gas
- moonpay-check-wallet — Verify balances before trading
- moonpay-trading-automation — Automate recurring trading strategies
- moonpay-prediction-market — 搜索市场、买卖头寸、追踪盈亏
- moonpay-fund-polymarket — 为钱包充值USDC.e和POL用于Gas费
- moonpay-check-wallet — 交易前验证钱包余额
- moonpay-trading-automation — 自动化执行周期性交易策略