foreseek

# Foreseek - Prediction Market Trading

Trade prediction markets through natural language. Say what you believe, 
get matched to the right contract on Kalshi.

## Setup

Get your API key from [foreseek.ai/dashboard](https://foreseek.ai/dashboard) → API Keys tab.

```bash
export FORESEEK_API_KEY="fsk_your_api_key_here"
```

## Quick Commands

### Parse a Prediction (Find Matching Markets)

Converts natural language to matched Kalshi contracts.

```bash
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
  -H "Authorization: Bearer $FORESEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation": "parse", "prediction": "Fed will cut rates in March"}'
```

**Response:**
```json
{
  "matched": true,
  "confidence": 0.92,
  "direction": "yes",
  "market": {
    "ticker": "KXFED-25MAR-T475",
    "title": "Fed funds rate below 4.75% on March 19",
    "price": 0.35,
    "event_ticker": "KXFED-25MAR",
    "kalshi_url": "https://kalshi.com/markets/kxfed/fed-funds-rate-below-475-on-march-19/kxfed-25mar#market=KXFED-25MAR-T475"
  },
  "insight": "Currently trading at 35¢, implying 35% probability"
}
```

### Execute a Trade

Places an order on Kalshi through your connected account.

```bash
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
  -H "Authorization: Bearer $FORESEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "trade",
    "ticker": "KXFED-25MAR-T475",
    "side": "yes",
    "action": "buy",
    "count": 10,
    "type": "market"
  }'
```

**Response:**
```json
{
  "success": true,
  "order": {
    "order_id": "abc123",
    "status": "filled",
    "filled_count": 10,
    "avg_price": 35
  },
  "message": "BUY 10 YES contracts on KXFED-25MAR-T475"
}
```

### View Positions

Shows your current open positions on Kalshi.

```bash
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/func...