Description

Trade prediction markets with natural language via Foreseek. Matches your beliefs to Kalshi contracts and executes trades. Use when user wants to bet on or trade predictions about elections, politics, sports outcomes, economic data (Fed rates, CPI, GDP), crypto prices, weather events, or any real-world event outcomes. Supports viewing positions, parsing predictions, executing market/limit orders, managing orders, and checking account status.

README (SKILL.md)

\r \r

Foreseek - Prediction Market Trading\r

Name: Foreseek AI
Author: hypegamer007

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

Setup\r

\r Get your API key from foreseek.ai/dashboard → API Keys tab.\r \r

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

Usage Guidance

Before installing or using this skill, verify the endpoint and provenance: the SKILL.md instructs sending your FORESEEK_API_KEY to https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli rather than to an obvious foreseek.ai or kalshi.com API. Ask the skill author for: (1) an official homepage or source repository, (2) confirmation that the supabase URL is an official Foreseek endpoint (and documentation showing that), and (3) what that function does with API keys and trade requests (does it proxy to Kalshi, log keys, or store credentials?). Until you can verify, avoid using a production API key or real funds — use a demo/limited-scope key or revoke and rotate keys used for testing. If you require lower risk, prefer a skill that calls documented foreseek.ai or kalshi.com APIs directly or provide source code so the function behavior can be audited. Note that the skill will be able to place trades via the remote service if the key is valid, so ensure you trust the endpoint and the developer before granting access.

Capability Analysis

Type: OpenClaw Skill Name: foreseekai Version: 1.0.0 The OpenClaw AgentSkills skill bundle for 'foreseekai' appears benign. All instructions and code snippets in SKILL.md involve standard `curl` POST requests to a single, specific Supabase function endpoint (`https://jxvtetqmzduvhgiyldgp.supabase.co/functions/v1/foreseek-cli`). The skill requires a `FORESEEK_API_KEY` which is passed as an Authorization header, consistent with legitimate API interaction. There is no evidence of data exfiltration beyond the necessary API key for the service, no malicious execution patterns (e.g., `curl|bash`), no attempts at persistence, and no prompt injection aiming to subvert the agent's intended purpose or access unrelated sensitive data. The functionality described aligns perfectly with trading prediction markets.

Capability Assessment

⚠ Purpose & Capability

The skill claims to let the agent trade prediction markets via Foreseek/Kalshi and only requests a FORESEEK_API_KEY, which is appropriate in principle. However, every example curl POST targets a jxvtetqmzduvhgiyldgp.supabase.co function URL rather than an obvious foreseek.ai or kalshi.com API endpoint; that domain mismatch is unexplained and disproportionate to the stated purpose.

⚠ Instruction Scope

SKILL.md instructs the agent to send the Authorization: Bearer $FORESEEK_API_KEY header and full operation payloads to the supabase.co function for all actions (parse, trade, positions, orders, etc.). This is within the claimed feature set but means the remote function receives your API key and trade commands — the instructions do not document what that service does with keys or trades (proxying to Foreseek/Kalshi, logging, or storing). There are no instructions to verify the endpoint's ownership or TLS certificate, and no local-only operations are required.

✓ Install Mechanism

This is an instruction-only skill with no install spec and no code files, which minimizes on-disk install risk.

⚠ Credentials

Only a single env var (FORESEEK_API_KEY) is required, which is proportionate for a trading integration. The concern is that the key is submitted to an unexpected third-party function (supabase.co) rather than a documented Foreseek API endpoint. That increases risk of credential capture or misuse if the endpoint is not the official Foreseek service.

✓ Persistence & Privilege

The skill does not request always:true and has no install-time persistence. Model invocation is enabled (default), which allows autonomous use — normal for skills — but there is no elevated system privilege requested.

Version History

v1.0.0

Initial release of the Foreseek skill for trading prediction markets via natural language. - Trade, manage, and view Kalshi prediction markets using simple commands. - Parse natural language predictions and match them to relevant markets. - Execute market and limit orders, view open positions, and manage orders (view/cancel). - Search for markets, view account status, balance, and portfolio. - Supports watchlists and detailed operation reference for all endpoints. - Requires a FORESEEK_API_KEY environment variable for authentication.

Metadata

Slug foreseekai

Version 1.0.0

License —

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is Foreseek AI?

Trade prediction markets with natural language via Foreseek. Matches your beliefs to Kalshi contracts and executes trades. Use when user wants to bet on or trade predictions about elections, politics, sports outcomes, economic data (Fed rates, CPI, GDP), crypto prices, weather events, or any real-world event outcomes. Supports viewing positions, parsing predictions, executing market/limit orders, managing orders, and checking account status. It is an AI Agent Skill for Claude Code / OpenClaw, with 1760 downloads so far.

How do I install Foreseek AI?

Run "/install foreseekai" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Foreseek AI free?

Yes, Foreseek AI is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Foreseek AI support?

Foreseek AI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Foreseek AI?

It is built and maintained by HypeGamer007 (@hypegamer007); the current version is v1.0.0.

More Skills

Foreseek AI