--- name: prediction-market-data-1f76daecaa13 description: Access prediction market data from Polymarket and Kalshi, including markets, prices, trades, orderbooks, positions, and cross-platform market matching. Use when you need current odds, historical market data, or wallet-level prediction market analysis. license: MIT compatibility: Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries curl, python, environment variables AISA_API_KEY and internet access to api.aisa.one. metadata: author: AIsa version: 1.0.0 homepage: https://aisa.one repository: https://github.com/baofeng-tech/agent-skills tags: market,prediction platforms: agentskills.io,agentskill.sh,github primary_env: AISA_API_KEY allowed-tools: Read Bash Grep --- # Prediction Market Data 📈 Access Polymarket and Kalshi market data through AIsa. Use this skill when you need to: - check current implied odds for an event - search open or resolved markets - inspect trade history, orderbooks, or candlesticks - review wallet activity, positions, or P&L - compare equivalent sports markets across platforms ## Compatibility Works with any [agentskills.io](https://agentskills.io)-compatible harness, including: - **Claude Code** and **Claude** - **OpenAI Codex** - **Cursor** - **Gemini CLI** - **OpenCode**, **Goose**, **OpenClaw**, **Hermes** - and other harnesses that implement the [Agent Skills specification](https://agentskills.io/specification) Requires Python 3, a POSIX shell, and `AISA_API_KEY` (available from [aisa.one](https://aisa.one)). ## Quick Start ```bash export AISA_API_KEY="your-key" ``` ## Common Requests ### Probability Checks ```text "What are the odds of [event] happening?" ``` ### Market Sentiment ```text "Research the current market sentiment on the upcoming election." ``` ### Trading Analysis ```text "Analyze historical prices and orderbooks for this market." ``` ### Portfolio Tracking ```text "Track portfolio positions and P&L for wallet address X." ``` ### Arbitrage Detection ```text "Find arbitrage opportunities across Polymarket and Kalshi." ``` ## How to Look Up IDs Most downstream endpoints require an ID returned by a market search. In practice, start with `/markets`, inspect the response, then pass the relevant identifier to the next endpoint. 1. **Polymarket `token_id`**: Query `/polymarket/markets`, then use `side_a.id` or `side_b.id` with `/polymarket/market-price/{token_id}`. 2. **Polymarket `condition_id`**: Query `/polymarket/markets`, then use `condition_id` with `/polymarket/candlesticks/{condition_id}`. 3. **Kalshi `market_ticker`**: Query `/kalshi/markets`, then use `market_ticker` with `/kalshi/market-price/{market_ticker}`. ## End-to-End Examples ### Get the current price of a Polymarket market Prices require a `token_id`, which comes from the `/markets` response. Always query markets first. **Step 1: Find a market and extract the token_id:** ```bash # Search for open election markets and grab a token_id python scripts/prediction_market_client.py polymarket markets --search "election" --status open --limit 5 ``` The response includes a `side_a.id` and `side_b.id` for each market; these are the token IDs for the Yes and No sides respectively: ```json { "markets": [ { "title": "Will Trump nationalize elections?", "market_slug": "will-trump-nationalize-elections", "condition_id": "0xe6522d64f35a6843ebdbccab2e3d4a1385350be6d40a3de766330e207b71a8ba", "side_a": { "id": "44482086252598348208660011972852804909957485351743405768768577675743702971026", "label": "Yes" }, "side_b": { "id": "68987475491741167427045844503509447338405188188495224371188027929166363674438", "label": "No" } } ] } ``` **Step 2: Fetch the current price using the token_id:** ```bash # Use side_a.id (Yes) or side_b.id (No) from Step 1 python scripts/prediction_market_client.py polymarket price 44482086252598348208660011972852804909957485351743405768768577675743702971026 ``` The price is a decimal between 0 and 1 representing probability (for example, `0.20` means a 20% chance of Yes). --- ### Get the current price of a Kalshi market **Step 1: Find a market and extract the market_ticker:** ```bash python scripts/prediction_market_client.py kalshi markets --search "fed rate" --status open --limit 5 ``` ```json { "markets": [ { "title": "Will the federal funds rate be above 3.75% after the Mar 2026 meeting?", "market_ticker": "KXFED-26MAR-T3.75", "last_price": 6 } ] } ``` **Step 2: Fetch the price using the market_ticker:** ```bash python scripts/prediction_market_client.py kalshi price KXFED-26MAR-T3.75 ``` --- ## Core Capabilities ### Polymarket #### Markets ```bash # Find markets on Polymarket curl -X GET "https://api.aisa.one/apis/v1/polymarket/markets?search=election&status=open" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Market Price ```bash # Step 1: query /polymarket/markets to get a token_id from side_a.id or side_b.id # Step 2: pass that token_id here to get the current price curl -X GET "https://api.aisa.one/apis/v1/polymarket/market-price/{token_id}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Activity ```bash # Fetch activity data for a specific user curl -X GET "https://api.aisa.one/apis/v1/polymarket/activity?user={wallet_address}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Trade History ```bash # Fetch historical trade data curl -X GET "https://api.aisa.one/apis/v1/polymarket/orders?market_slug={market_slug}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Orderbook History ```bash # Fetch historical orderbook snapshots for a specific asset # token_id comes from side_a.id or side_b.id in /polymarket/markets response curl -X GET "https://api.aisa.one/apis/v1/polymarket/orderbooks?token_id={token_id}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Candlesticks ```bash # Fetch historical candlestick data for a market # condition_id comes from /polymarket/markets response curl -X GET "https://api.aisa.one/apis/v1/polymarket/candlesticks/{condition_id}?interval=60" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Positions ```bash # Fetch all Polymarket positions for a proxy wallet address curl -X GET "https://api.aisa.one/apis/v1/polymarket/positions/wallet/{wallet_address}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Wallet ```bash # Fetch wallet information curl -X GET "https://api.aisa.one/apis/v1/polymarket/wallet?eoa={wallet_address}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Wallet Profit-and-Loss ```bash # Fetch realized profit and loss (PnL) for a specific wallet address curl -X GET "https://api.aisa.one/apis/v1/polymarket/wallet/pnl/{wallet_address}?granularity=day" \ -H "Authorization: Bearer $AISA_API_KEY" ``` ### Kalshi #### Markets ```bash # Find markets on Kalshi curl -X GET "https://api.aisa.one/apis/v1/kalshi/markets?search=fed%20rate" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Market Price ```bash # Fetch the current market price for a Kalshi market # market_ticker comes from /kalshi/markets response curl -X GET "https://api.aisa.one/apis/v1/kalshi/market-price/{market_ticker}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Trade History ```bash # Fetch historical trade data for Kalshi markets # ticker (market_ticker) comes from /kalshi/markets response curl -X GET "https://api.aisa.one/apis/v1/kalshi/trades?ticker={ticker}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Orderbook History ```bash # Fetch historical orderbook snapshots for a specific Kalshi market # ticker (market_ticker) comes from /kalshi/markets response curl -X GET "https://api.aisa.one/apis/v1/kalshi/orderbooks?ticker={ticker}" \ -H "Authorization: Bearer $AISA_API_KEY" ``` ### Cross-Platform #### Sports Markets ```bash # Find equivalent markets across platforms for sports events curl -X GET "https://api.aisa.one/apis/v1/matching-markets/sports" \ -H "Authorization: Bearer $AISA_API_KEY" ``` #### Sports Markets by Date ```bash # Find equivalent markets across platforms for a sport on a given date # sport options: nfl, mlb, cfb, nba, nhl, cbb, pga, tennis # date format: YYYY-MM-DD curl -X GET "https://api.aisa.one/apis/v1/matching-markets/sports/nba?date=2025-08-16" \ -H "Authorization: Bearer $AISA_API_KEY" ``` Sport abbreviations: | Abbreviation | Sport | |---|---| | `nfl` | Football | | `mlb` | Baseball | | `cfb` | College Football | | `nba` | Basketball | | `nhl` | Hockey | | `cbb` | College Basketball | | `pga` | Golf | | `tennis` | Tennis | ## API Endpoints Reference ### Polymarket Endpoints (GET) | Endpoint | Description | Key Params | |----------|-------------|------------| | `/polymarket/markets` | Find markets | `search`, `status`, `market_slug`, `limit` | | `/polymarket/market-price/{token_id}` | Get market price | `token_id`, `at_time` | | `/polymarket/activity` | Get user activity | `user`, `start_time`, `end_time` | | `/polymarket/orders` | Get trade history | `market_slug`, `token_id`, `user` | | `/polymarket/orderbooks` | Get orderbook history | `token_id`, `start_time`, `end_time` | | `/polymarket/candlesticks/{condition_id}` | Get candlestick data | `condition_id`, `start_time`, `end_time`, `interval` | | `/polymarket/positions/wallet/{wallet_address}` | Get wallet positions | `wallet_address`, `limit` | | `/polymarket/wallet` | Get wallet info | `eoa` or `proxy`, `with_metrics` | | `/polymarket/wallet/pnl/{wallet_address}` | Get wallet PnL | `wallet_address`, `granularity` | ### Kalshi Endpoints (GET) | Endpoint | Description | Key Params | |----------|-------------|------------| | `/kalshi/markets` | Find markets | `search`, `status`, `market_ticker` | | `/kalshi/market-price/{market_ticker}` | Get market price | `market_ticker`, `at_time` | | `/kalshi/trades` | Get trade history | `ticker`, `start_time`, `end_time` | | `/kalshi/orderbooks` | Get orderbook history | `ticker`, `start_time`, `end_time` | ### Cross-Platform Endpoints (GET) | Endpoint | Description | Key Params | |----------|-------------|------------| | `/matching-markets/sports` | Find matching sports markets | `polymarket_market_slug` or `kalshi_event_ticker` | | `/matching-markets/sports/{sport}` | Find sports markets by date | `sport` (nfl\|mlb\|cfb\|nba\|nhl\|cbb\|pga\|tennis), `date` (YYYY-MM-DD) | ## Response Schemas ### Markets Response Returns markets array: - `title` (string) - Market question (e.g., "Will Trump nationalize elections?") - `market_slug` (string) - URL-friendly identifier - `condition_id` (string) - Blockchain condition ID - `start_time` / `end_time` (integer) - Unix timestamps - `completed_time` (integer|null) - Null if still open - `tags` (array) - Category tags (e.g., ["politics", "us election"]) - `volume_1_week` / `volume_1_month` / `volume_1_year` / `volume_total` (number) - Trading volume in USD - `side_a` / `side_b` (object) - id and label (typically "Yes"/"No") - `winning_side` (object|null) - Null if unresolved - `image` (string) - Market thumbnail URL ### Activity Response Returns activities array: - `title` (string) - Market title - `market_slug` (string) - Market identifier - `side` (string) - Trade side: BUY, SELL, or MERGE - `shares` (integer) - Raw share amount - `shares_normalized` (number) - Human-readable share amount - `price` (number) - Trade price (0-1, represents probability) - `timestamp` (integer) - Unix timestamp of the trade - `user` (string) - Wallet address of the trader - `tx_hash` (string) - Blockchain transaction hash ## Understanding Odds - Prices are shown as decimals (`0.65` = 65% probability) - "Yes" price represents the market-implied probability that the event happens - Higher volume can indicate deeper liquidity and stronger participation - Prices change as traders buy and sell shares ## Pricing | API | Cost | |-----|------| | Prediction market read query | $0.01 | ## Get Started 1. Sign up at [aisa.one](https://aisa.one) 2. Get your API key 3. Add credits (pay-as-you-go) 4. Set environment variable: `export AISA_API_KEY="your-key"` ## Full API Reference See [API Reference](https://aisa.one/docs/api-reference/) for complete endpoint documentation. --- Source attribution: baofeng-tech Original project: https://github.com/baofeng-tech/agent-skills/blob/6da0a55a3aa88f283251abe4392be1217ccb7b52/prediction-market-data/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: baofeng-tech Original project: https://github.com/baofeng-tech/agent-skills/blob/6da0a55a3aa88f283251abe4392be1217ccb7b52/prediction-market-data/SKILL.md Attribution basis: Source repository record Fields of work: Marketing Roles: Growth Marketer, Marketing Analyst, Product Marketer Specialties: API, Backend, Design, Word Documents, Frontend, Git, Playwright Tools: Aisa Api Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: a51ddf381632d0d5431c18175282b81d460ab8c117bcb4b4105a994345465c15