Demerzels-lab 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 → API Keys tab.
export FORESEEK_API_KEY="fsk_your_api_key_here"
Quick Commands
Parse a Prediction (Find Matching Markets)
Converts natural language to matched Kalshi contracts.
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:
{
"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.
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:
{
"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.
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
-H "Authorization: Bearer $FORESEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation": "positions"}'
Response:
{
"count": 2,
"positions": [
{
"ticker": "KXBTC-120K-JAN",
"title": "Bitcoin above $120,000",
"side": "yes",
"contracts": 25,
"avg_price": 42,
"current_price": 48,
"pnl": 150
}
],
"is_demo": false
}
Search Markets
Browse available markets by keyword or category.
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
-H "Authorization: Bearer $FORESEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation": "markets", "query": "bitcoin", "limit": 5}'
View Pending Orders
Shows your pending and recent orders on Kalshi.
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
-H "Authorization: Bearer $FORESEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation": "orders"}'
Response:
{
"count": 3,
"orders": [
{
"order_id": "abc123",
"ticker": "KXBTC-120K",
"side": "yes",
"action": "buy",
"status": "pending",
"count": 10,
"filled": 5,
"price": 42,
"created_at": "2026-01-31T10:00:00Z"
}
],
"is_demo": false
}
Cancel an Order
Cancels a pending order by order ID.
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
-H "Authorization: Bearer $FORESEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation": "cancel", "order_id": "abc123"}'
Response:
{
"success": true,
"order_id": "abc123",
"message": "Order abc123 cancelled successfully"
}
Check Account Status
View your subscription tier, usage limits, and connection status.
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
-H "Authorization: Bearer $FORESEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation": "status"}'
Response:
{
"tier": "pro",
"daily_used": 5000,
"daily_limit": 150000,
"daily_percent": 3.3,
"monthly_used": 25000,
"monthly_limit": 3000000,
"monthly_percent": 0.8,
"predictions_used": 2,
"predictions_limit": 75,
"is_limited": false,
"kalshi_connected": true,
"is_demo": false
}
Check Account Balance
View your Kalshi account balance and portfolio value.
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
-H "Authorization: Bearer $FORESEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation": "balance"}'
Response:
{
"balance": 1000.00,
"available": 850.00,
"portfolio_value": 150.00,
"is_demo": false
}
View Watchlist
View your saved markets with current prices.
curl -X POST https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli \
-H "Authorization: Bearer $FORESEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation": "watchlist"}'
Response:
{
"count": 2,
"watchlist": [
{
"ticker": "KXBTC-120K-JAN",
"title": "Bitcoin above $120,000",
"price": 48,
"volume": 125000,
"status": "open",
"added_at": "2026-01-15T08:00:00Z"
}
]
}
Prediction Examples
| What You Say | Matched Market |
|---|---|
| "Trump wins 2028" | KXPRES-2028-REP |
| "Bitcoin above $100k by month end" | KXBTC-100K-JAN |
| "Eagles win Super Bowl" | KXNFLSB-PHI |
| "Fed cuts rates in March" | KXFED-25MAR-T475 |
| "CPI above 3% next month" | KXCPI-FEB-3PCT |
| "Nvidia hits $200" | KXNVDA-200 |
Operations Reference
| Operation | Description | Scope | Consumes Budget |
|---|---|---|---|
| parse | AI prediction matching | parse | Yes |
| trade | Execute Kalshi orders | trade | No |
| positions | View open positions | positions | No |
| markets | Search available markets | markets | No |
| orders | View pending orders | orders | No |
| cancel | Cancel pending order | cancel | No |
| status | Check tier & usage | status | No |
| balance | Get account balance | balance | No |
| watchlist | View saved markets | watchlist | No |
Trade Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| operation | string | Yes | One of: parse, trade, positions, markets, orders, cancel, status, balance, watchlist |
| prediction | string | For parse | Natural language prediction |
| ticker | string | For trade | Market ticker (e.g., KXBTC-120K-JAN) |
| side | string | For trade | "yes" or "no" |
| action | string | For trade | "buy" or "sell" (default: buy) |
| count | number | For trade | Number of contracts |
| type | string | For trade | "market" or "limit" (default: market) |
| yes_price | number | For limit | Limit price in cents (for YES side) |
| no_price | number | For limit | Limit price in cents (for NO side) |
| query | string | For markets | Search term |
| category | string | For markets | Filter by category |
| limit | number | For markets | Max results (default: 10, max: 50) |
| order_id | string | For cancel | Order ID to cancel |
Error Handling
401 - Unauthorized
{"error": "Invalid or revoked API key"}
→ Check your API key is correct and not revoked
403 - Forbidden
{"error": "API key does not have permission for 'trade' operation"}
→ API key scopes don't include this operation
429 - Rate Limited
{
"error": "rate_limited",
"tier": "free",
"daily_used": 10000,
"daily_limit": 10000,
"message": "Daily limit reached. Resets at midnight UTC.",
"upgrade_url": "https://foreseek.ai/pricing"
}
→ Daily token limit reached. Upgrade for higher limits:
- Free: ~5 predictions/day
- Pro ($29/mo): ~75 predictions/day
- Ultra ($79/mo): ~200 predictions/day
400 - Bad Request
{"error": "Kalshi not connected", "message": "Connect your Kalshi account at https://foreseek.ai/dashboard"}
→ Connect your Kalshi API credentials in the dashboard
Categories
Available market categories for filtering:
- Politics (elections, legislation)
- Economics (Fed rates, CPI, GDP, unemployment)
- Crypto (Bitcoin, Ethereum prices)
- Sports (NFL, NBA, MLB, soccer)
- Entertainment (Oscars, streaming)
- Weather (temperature, hurricanes)
- Tech (product launches, earnings)
Requirements
- Foreseek Account: Sign up at foreseek.ai
- Kalshi Connection: Connect your Kalshi API keys in the dashboard
- API Key: Generate one from Dashboard → API Keys
Links
- Website: https://foreseek.ai
- Dashboard: https://foreseek.ai/dashboard
- Documentation: https://foreseek.ai/docs