shipp-sports-data

Files (1)

• SKILL.md

SKILL.md (first lines)

# Shipp — Real-Time Sports Data + MoonPay Trading

## 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

## Prerequisites

1. **Shipp API key** — register at https://platform.shipp.ai
2. **MoonPay CLI** — `npm install -g @moonpay/cli`
3. **Funded wallet** — USDC.e on Polygon for Polymarket trades

```bash
export SHIPP_API_KEY="sk_..."
```

## Setup Workflow

```bash
# 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

### 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"}'
# → returns { "connection_id": "conn_..." }
```

### Poll 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>"}'
```

### Get Sport Schedule (±7 days)

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

### List Saved Connections (free)

```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
# 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>"}'
```

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 50
```


## Wallet Operations

```bash
# 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"

From moonpay/skills, MIT.

More from moonpay/skills