#!/usr/bin/env python3 """ Cross-Platform Prediction Market Data - AIsa API Client Prediction market data from Polymarket and Kalshi for autonomous agents. Powered by AIsa. ID Lookup: Most endpoints require an ID that comes from the /markets response. Always query markets first, then pass the relevant ID to downstream endpoints. - Polymarket token_id: from side_a.id or side_b.id in /polymarket/markets response - Polymarket condition_id: from condition_id in /polymarket/markets response - Kalshi market_ticker: from market_ticker in /kalshi/markets response Usage: # Polymarket python scripts/prediction_market_client.py polymarket markets [--search ] [--status open|closed] [--min-volume ] [--limit ] python scripts/prediction_market_client.py polymarket price [--at-time ] python scripts/prediction_market_client.py polymarket activity --user [--market-slug ] [--limit ] python scripts/prediction_market_client.py polymarket orders [--market-slug ] [--token-id ] [--user ] [--limit ] python scripts/prediction_market_client.py polymarket orderbooks --token-id [--start ] [--end ] [--limit ] python scripts/prediction_market_client.py polymarket candlesticks --start --end [--interval 1|60|1440] python scripts/prediction_market_client.py polymarket positions [--limit ] python scripts/prediction_market_client.py polymarket wallet (--eoa | --proxy ) [--with-metrics] [--start ] [--end ] python scripts/prediction_market_client.py polymarket pnl --granularity [--start ] [--end ] # Kalshi python scripts/prediction_market_client.py kalshi markets [--search ] [--status open|closed] [--min-volume ] [--limit ] python scripts/prediction_market_client.py kalshi price [--at-time ] python scripts/prediction_market_client.py kalshi trades [--ticker ] [--start ] [--end ] [--limit ] python scripts/prediction_market_client.py kalshi orderbooks --ticker [--start ] [--end ] [--limit ] # Cross-platform sports python scripts/prediction_market_client.py sports matching (--polymarket-slug | --kalshi-ticker ) python scripts/prediction_market_client.py sports by-date --date """ import argparse import json import os import sys import urllib.request import urllib.parse import urllib.error from typing import Any, Dict, List, Optional def api_result_ok(result: Dict[str, Any]) -> bool: if result.get("success") is False: return False if result.get("ok") is False: return False if result.get("error"): return False return True def decode_json_body(body: bytes) -> Dict[str, Any]: text = body.decode("utf-8", errors="replace") try: payload = json.loads(text) except json.JSONDecodeError: preview = " ".join(text.strip().split())[:500] return { "success": False, "error": { "code": "UPSTREAM_NON_JSON", "message": f"Upstream returned a non-JSON response: {preview}", }, } return payload if isinstance(payload, dict) else {"success": True, "data": payload} class PredictionMarketClient: """Cross-Platform Prediction Market Data - AIsa API Client.""" BASE_URL = "https://api.aisa.one/apis/v1" def __init__(self, api_key: Optional[str] = None): self.api_key = api_key or os.environ.get("AISA_API_KEY") if not self.api_key: raise ValueError( "AISA_API_KEY is required. Set it via environment variable or pass to constructor." ) def _request( self, endpoint: str, params: Optional[Dict[str, Any]] = None, ) -> Dict[str, Any]: url = f"{self.BASE_URL}{endpoint}" if params: query_string = urllib.parse.urlencode( {k: v for k, v in params.items() if v is not None} ) url = f"{url}?{query_string}" headers = { "Authorization": f"Bearer {self.api_key}", "Content-Type": "application/json", "User-Agent": "AIsa-PredictionMarket/1.0", } req = urllib.request.Request(url, headers=headers, method="GET") try: with urllib.request.urlopen(req, timeout=60) as response: return decode_json_body(response.read()) except urllib.error.HTTPError as e: error_body = e.read().decode("utf-8") try: return json.loads(error_body) except json.JSONDecodeError: return {"success": False, "error": {"code": str(e.code), "message": error_body}} except urllib.error.URLError as e: return {"success": False, "error": {"code": "NETWORK_ERROR", "message": str(e.reason)}} except TimeoutError as e: return {"success": False, "error": {"code": "NETWORK_ERROR", "message": str(e)}} except OSError as e: return {"success": False, "error": {"code": "NETWORK_ERROR", "message": str(e)}} # ==================== Polymarket ==================== def polymarket_markets( self, search: Optional[str] = None, market_slug: Optional[List[str]] = None, event_slug: Optional[List[str]] = None, condition_id: Optional[List[str]] = None, tags: Optional[List[str]] = None, status: Optional[str] = None, min_volume: Optional[float] = None, limit: int = 10, offset: int = 0, start_time: Optional[int] = None, end_time: Optional[int] = None, ) -> Dict[str, Any]: """Search/filter Polymarket markets. Use this endpoint first to obtain IDs needed by other endpoints: - token_id: from side_a.id or side_b.id in the response - condition_id: from condition_id in the response """ params: Dict[str, Any] = {"limit": limit, "offset": offset} if search: params["search"] = search if status: params["status"] = status if min_volume is not None: params["min_volume"] = min_volume if start_time: params["start_time"] = start_time if end_time: params["end_time"] = end_time url = f"{self.BASE_URL}/polymarket/markets" parts = [] for k, v in params.items(): if v is not None: parts.append(f"{urllib.parse.quote(str(k))}={urllib.parse.quote(str(v))}") for slug in (market_slug or []): parts.append(f"market_slug={urllib.parse.quote(slug)}") for slug in (event_slug or []): parts.append(f"event_slug={urllib.parse.quote(slug)}") for cid in (condition_id or []): parts.append(f"condition_id={urllib.parse.quote(cid)}") for tag in (tags or []): parts.append(f"tags={urllib.parse.quote(tag)}") if parts: url = f"{url}?{'&'.join(parts)}" return self._raw_get(url) def polymarket_price(self, token_id: str, at_time: Optional[int] = None) -> Dict[str, Any]: """Get current (or historical) price for a Polymarket token. token_id comes from side_a.id or side_b.id in /polymarket/markets response. """ return self._request(f"/polymarket/market-price/{token_id}", params={"at_time": at_time}) def polymarket_activity(self, user: str, market_slug: Optional[str] = None, condition_id: Optional[str] = None, start_time: Optional[int] = None, end_time: Optional[int] = None, limit: int = 100, offset: int = 0) -> Dict[str, Any]: """Get activity for a Polymarket wallet address.""" return self._request("/polymarket/activity", params={ "user": user, "market_slug": market_slug, "condition_id": condition_id, "start_time": start_time, "end_time": end_time, "limit": limit, "offset": offset, }) def polymarket_orders(self, market_slug: Optional[str] = None, condition_id: Optional[str] = None, token_id: Optional[str] = None, user: Optional[str] = None, start_time: Optional[int] = None, end_time: Optional[int] = None, limit: int = 100, offset: int = 0) -> Dict[str, Any]: """Get Polymarket trade history.""" return self._request("/polymarket/orders", params={ "market_slug": market_slug, "condition_id": condition_id, "token_id": token_id, "user": user, "start_time": start_time, "end_time": end_time, "limit": limit, "offset": offset, }) def polymarket_orderbooks(self, token_id: str, start_time: Optional[int] = None, end_time: Optional[int] = None, limit: int = 100, pagination_key: Optional[str] = None) -> Dict[str, Any]: """Get Polymarket orderbook snapshots for a token. token_id comes from side_a.id or side_b.id in /polymarket/markets response. """ return self._request("/polymarket/orderbooks", params={ "token_id": token_id, "start_time": start_time, "end_time": end_time, "limit": limit, "pagination_key": pagination_key, }) def polymarket_candlesticks(self, condition_id: str, start_time: int, end_time: int, interval: int = 1) -> Dict[str, Any]: """Get Polymarket candlestick data. interval: 1=1m, 60=1h, 1440=1d. condition_id comes from /polymarket/markets response. """ return self._request(f"/polymarket/candlesticks/{condition_id}", params={ "start_time": start_time, "end_time": end_time, "interval": interval, }) def polymarket_positions(self, wallet_address: str, limit: int = 100, pagination_key: Optional[str] = None) -> Dict[str, Any]: """Get Polymarket positions for a proxy wallet.""" return self._request(f"/polymarket/positions/wallet/{wallet_address}", params={ "limit": limit, "pagination_key": pagination_key, }) def polymarket_wallet(self, eoa: Optional[str] = None, proxy: Optional[str] = None, with_metrics: bool = False, start_time: Optional[int] = None, end_time: Optional[int] = None) -> Dict[str, Any]: """Get Polymarket wallet info. Provide either eoa or proxy.""" return self._request("/polymarket/wallet", params={ "eoa": eoa, "proxy": proxy, "with_metrics": "true" if with_metrics else None, "start_time": start_time, "end_time": end_time, }) def polymarket_pnl(self, wallet_address: str, granularity: str, start_time: Optional[int] = None, end_time: Optional[int] = None) -> Dict[str, Any]: """Get realized P&L for a Polymarket wallet.""" return self._request(f"/polymarket/wallet/pnl/{wallet_address}", params={ "granularity": granularity, "start_time": start_time, "end_time": end_time, }) # ==================== Kalshi ==================== def kalshi_markets(self, search: Optional[str] = None, market_ticker: Optional[List[str]] = None, event_ticker: Optional[List[str]] = None, status: Optional[str] = None, min_volume: Optional[float] = None, limit: int = 10, offset: int = 0) -> Dict[str, Any]: """Search/filter Kalshi markets. Use this endpoint first to obtain IDs needed by other endpoints: - market_ticker: from market_ticker in the response """ url = f"{self.BASE_URL}/kalshi/markets" parts = [] if search: parts.append(f"search={urllib.parse.quote(search)}") if status: parts.append(f"status={urllib.parse.quote(status)}") if min_volume is not None: parts.append(f"min_volume={min_volume}") parts.append(f"limit={limit}") parts.append(f"offset={offset}") for t in (market_ticker or []): parts.append(f"market_ticker={urllib.parse.quote(t)}") for t in (event_ticker or []): parts.append(f"event_ticker={urllib.parse.quote(t)}") if parts: url = f"{url}?{'&'.join(parts)}" return self._raw_get(url) def kalshi_price(self, market_ticker: str, at_time: Optional[int] = None) -> Dict[str, Any]: """Get current (or historical) price for a Kalshi market. market_ticker comes from /kalshi/markets response. """ return self._request(f"/kalshi/market-price/{market_ticker}", params={"at_time": at_time}) def kalshi_trades(self, ticker: Optional[str] = None, start_time: Optional[int] = None, end_time: Optional[int] = None, limit: int = 100, offset: int = 0) -> Dict[str, Any]: """Get Kalshi trade history. ticker (market_ticker) comes from /kalshi/markets response. """ return self._request("/kalshi/trades", params={ "ticker": ticker, "start_time": start_time, "end_time": end_time, "limit": limit, "offset": offset, }) def kalshi_orderbooks(self, ticker: str, start_time: Optional[int] = None, end_time: Optional[int] = None, limit: int = 100) -> Dict[str, Any]: """Get Kalshi orderbook snapshots. ticker (market_ticker) comes from /kalshi/markets response. """ return self._request("/kalshi/orderbooks", params={ "ticker": ticker, "start_time": start_time, "end_time": end_time, "limit": limit, }) # ==================== Cross-Platform ==================== def sports_matching(self, polymarket_slugs: Optional[List[str]] = None, kalshi_tickers: Optional[List[str]] = None) -> Dict[str, Any]: """Find equivalent sports markets across Polymarket and Kalshi. Provide either polymarket_market_slug(s) or kalshi_event_ticker(s) to find the matching market on the other platform. """ url = f"{self.BASE_URL}/matching-markets/sports" parts = [] for slug in (polymarket_slugs or []): parts.append(f"polymarket_market_slug={urllib.parse.quote(slug)}") for ticker in (kalshi_tickers or []): parts.append(f"kalshi_event_ticker={urllib.parse.quote(ticker)}") if parts: url = f"{url}?{'&'.join(parts)}" return self._raw_get(url) def sports_by_date(self, sport: str, date: str) -> Dict[str, Any]: """Find matching sports markets across platforms by sport and date (YYYY-MM-DD). Supported sports: nfl, mlb, cfb, nba, nhl, cbb, pga, tennis. """ return self._request(f"/matching-markets/sports/{sport}", params={"date": date}) def _raw_get(self, url: str) -> Dict[str, Any]: """Make a GET request to a fully constructed URL.""" headers = { "Authorization": f"Bearer {self.api_key}", "Content-Type": "application/json", "User-Agent": "AIsa-PredictionMarket/1.0", } req = urllib.request.Request(url, headers=headers, method="GET") try: with urllib.request.urlopen(req, timeout=60) as response: return decode_json_body(response.read()) except urllib.error.HTTPError as e: error_body = e.read().decode("utf-8") try: return json.loads(error_body) except json.JSONDecodeError: return {"success": False, "error": {"code": str(e.code), "message": error_body}} except urllib.error.URLError as e: return {"success": False, "error": {"code": "NETWORK_ERROR", "message": str(e.reason)}} except TimeoutError as e: return {"success": False, "error": {"code": "NETWORK_ERROR", "message": str(e)}} except OSError as e: return {"success": False, "error": {"code": "NETWORK_ERROR", "message": str(e)}} def main(): parser = argparse.ArgumentParser( description="Cross-Platform Prediction Market Data - Polymarket & Kalshi via AIsa API", formatter_class=argparse.RawDescriptionHelpFormatter, epilog=""" ID Lookup: Most endpoints require an ID from the /markets response. Query markets first. Polymarket token_id: side_a.id or side_b.id from /polymarket/markets Polymarket condition_id: condition_id from /polymarket/markets Kalshi market_ticker: market_ticker from /kalshi/markets Examples: %(prog)s polymarket markets --search "election" --status open %(prog)s polymarket price %(prog)s polymarket activity --user %(prog)s polymarket orders --market-slug --limit 50 %(prog)s polymarket orderbooks --token-id %(prog)s polymarket candlesticks --start 1700000000 --end 1700086400 --interval 60 %(prog)s polymarket positions %(prog)s polymarket wallet --eoa --with-metrics %(prog)s polymarket pnl --granularity day %(prog)s kalshi markets --search "fed rate" --status open %(prog)s kalshi price %(prog)s kalshi trades --ticker %(prog)s kalshi orderbooks --ticker %(prog)s sports matching --polymarket-slug %(prog)s sports by-date nba --date 2025-03-01 """ ) subparsers = parser.add_subparsers(dest="platform", help="Platform") # Polymarket pm = subparsers.add_parser("polymarket", help="Polymarket commands") pm_sub = pm.add_subparsers(dest="command", help="Command") pm_markets = pm_sub.add_parser("markets", help="Search/filter Polymarket markets") pm_markets.add_argument("--search") pm_markets.add_argument("--market-slug", nargs="+") pm_markets.add_argument("--event-slug", nargs="+") pm_markets.add_argument("--condition-id", nargs="+") pm_markets.add_argument("--tags", nargs="+") pm_markets.add_argument("--status", choices=["open", "closed"]) pm_markets.add_argument("--min-volume", type=float) pm_markets.add_argument("--limit", type=int, default=10) pm_markets.add_argument("--offset", type=int, default=0) pm_markets.add_argument("--start-time", type=int) pm_markets.add_argument("--end-time", type=int) pm_price = pm_sub.add_parser("price", help="Get price for a Polymarket token") pm_price.add_argument("token_id", help="token_id from side_a.id or side_b.id in /polymarket/markets") pm_price.add_argument("--at-time", type=int, help="Unix timestamp for historical price") pm_activity = pm_sub.add_parser("activity", help="Get activity for a Polymarket wallet") pm_activity.add_argument("--user", required=True, help="Wallet address") pm_activity.add_argument("--market-slug") pm_activity.add_argument("--condition-id") pm_activity.add_argument("--start-time", type=int) pm_activity.add_argument("--end-time", type=int) pm_activity.add_argument("--limit", type=int, default=100) pm_activity.add_argument("--offset", type=int, default=0) pm_orders = pm_sub.add_parser("orders", help="Get Polymarket trade history") pm_orders.add_argument("--market-slug") pm_orders.add_argument("--condition-id") pm_orders.add_argument("--token-id") pm_orders.add_argument("--user") pm_orders.add_argument("--start-time", type=int) pm_orders.add_argument("--end-time", type=int) pm_orders.add_argument("--limit", type=int, default=100) pm_orders.add_argument("--offset", type=int, default=0) pm_ob = pm_sub.add_parser("orderbooks", help="Get Polymarket orderbook snapshots") pm_ob.add_argument("--token-id", required=True, help="token_id from side_a.id or side_b.id in /polymarket/markets") pm_ob.add_argument("--start", type=int, dest="start_time") pm_ob.add_argument("--end", type=int, dest="end_time") pm_ob.add_argument("--limit", type=int, default=100) pm_ob.add_argument("--pagination-key") pm_candles = pm_sub.add_parser("candlesticks", help="Get Polymarket candlestick data") pm_candles.add_argument("condition_id", help="condition_id from /polymarket/markets") pm_candles.add_argument("--start", type=int, required=True, dest="start_time") pm_candles.add_argument("--end", type=int, required=True, dest="end_time") pm_candles.add_argument("--interval", type=int, default=1, choices=[1, 60, 1440], help="1=1min, 60=1hr, 1440=1day") pm_pos = pm_sub.add_parser("positions", help="Get Polymarket positions for a wallet") pm_pos.add_argument("wallet_address", help="Proxy wallet address") pm_pos.add_argument("--limit", type=int, default=100) pm_pos.add_argument("--pagination-key") pm_wallet = pm_sub.add_parser("wallet", help="Get Polymarket wallet info") pm_wallet_group = pm_wallet.add_mutually_exclusive_group(required=True) pm_wallet_group.add_argument("--eoa", help="EOA wallet address") pm_wallet_group.add_argument("--proxy", help="Proxy wallet address") pm_wallet.add_argument("--with-metrics", action="store_true") pm_wallet.add_argument("--start-time", type=int) pm_wallet.add_argument("--end-time", type=int) pm_pnl = pm_sub.add_parser("pnl", help="Get Polymarket wallet P&L") pm_pnl.add_argument("wallet_address", help="Wallet address") pm_pnl.add_argument("--granularity", required=True, choices=["day", "week", "month"]) pm_pnl.add_argument("--start-time", type=int) pm_pnl.add_argument("--end-time", type=int) # Kalshi ks = subparsers.add_parser("kalshi", help="Kalshi commands") ks_sub = ks.add_subparsers(dest="command", help="Command") ks_markets = ks_sub.add_parser("markets", help="Search/filter Kalshi markets") ks_markets.add_argument("--search") ks_markets.add_argument("--market-ticker", nargs="+") ks_markets.add_argument("--event-ticker", nargs="+") ks_markets.add_argument("--status", choices=["open", "closed"]) ks_markets.add_argument("--min-volume", type=float) ks_markets.add_argument("--limit", type=int, default=10) ks_markets.add_argument("--offset", type=int, default=0) ks_price = ks_sub.add_parser("price", help="Get price for a Kalshi market") ks_price.add_argument("market_ticker", help="market_ticker from /kalshi/markets") ks_price.add_argument("--at-time", type=int, help="Unix timestamp for historical price") ks_trades = ks_sub.add_parser("trades", help="Get Kalshi trade history") ks_trades.add_argument("--ticker", help="market_ticker from /kalshi/markets") ks_trades.add_argument("--start-time", type=int) ks_trades.add_argument("--end-time", type=int) ks_trades.add_argument("--limit", type=int, default=100) ks_trades.add_argument("--offset", type=int, default=0) ks_ob = ks_sub.add_parser("orderbooks", help="Get Kalshi orderbook snapshots") ks_ob.add_argument("--ticker", required=True, help="market_ticker from /kalshi/markets") ks_ob.add_argument("--start", type=int, dest="start_time") ks_ob.add_argument("--end", type=int, dest="end_time") ks_ob.add_argument("--limit", type=int, default=100) # Sports (Cross-Platform) sp = subparsers.add_parser("sports", help="Cross-platform sports market commands") sp_sub = sp.add_subparsers(dest="command", help="Command") sp_match = sp_sub.add_parser("matching", help="Find equivalent markets across platforms") sp_match_group = sp_match.add_mutually_exclusive_group(required=True) sp_match_group.add_argument("--polymarket-slug", nargs="+", help="Polymarket market slug(s)") sp_match_group.add_argument("--kalshi-ticker", nargs="+", help="Kalshi event ticker(s)") sp_date = sp_sub.add_parser("by-date", help="Find matching sports markets by date") sp_date.add_argument("sport", choices=["nfl", "mlb", "cfb", "nba", "nhl", "cbb", "pga", "tennis"]) sp_date.add_argument("--date", required=True, help="Date in YYYY-MM-DD format") args = parser.parse_args() if not args.platform: parser.print_help() sys.exit(1) if not args.command: if args.platform == "polymarket": pm.print_help() elif args.platform == "kalshi": ks.print_help() elif args.platform == "sports": sp.print_help() sys.exit(1) try: client = PredictionMarketClient() except ValueError as e: print(json.dumps({"success": False, "error": {"code": "AUTH_ERROR", "message": str(e)}})) sys.exit(1) result = None if args.platform == "polymarket": if args.command == "markets": result = client.polymarket_markets( search=args.search, market_slug=args.market_slug, event_slug=args.event_slug, condition_id=args.condition_id, tags=args.tags, status=args.status, min_volume=args.min_volume, limit=args.limit, offset=args.offset, start_time=args.start_time, end_time=args.end_time, ) elif args.command == "price": result = client.polymarket_price(args.token_id, at_time=args.at_time) elif args.command == "activity": result = client.polymarket_activity( user=args.user, market_slug=args.market_slug, condition_id=args.condition_id, start_time=args.start_time, end_time=args.end_time, limit=args.limit, offset=args.offset, ) elif args.command == "orders": result = client.polymarket_orders( market_slug=args.market_slug, condition_id=args.condition_id, token_id=args.token_id, user=args.user, start_time=args.start_time, end_time=args.end_time, limit=args.limit, offset=args.offset, ) elif args.command == "orderbooks": result = client.polymarket_orderbooks( token_id=args.token_id, start_time=args.start_time, end_time=args.end_time, limit=args.limit, pagination_key=args.pagination_key, ) elif args.command == "candlesticks": result = client.polymarket_candlesticks( condition_id=args.condition_id, start_time=args.start_time, end_time=args.end_time, interval=args.interval, ) elif args.command == "positions": result = client.polymarket_positions( wallet_address=args.wallet_address, limit=args.limit, pagination_key=args.pagination_key, ) elif args.command == "wallet": result = client.polymarket_wallet( eoa=args.eoa, proxy=args.proxy, with_metrics=args.with_metrics, start_time=args.start_time, end_time=args.end_time, ) elif args.command == "pnl": result = client.polymarket_pnl( wallet_address=args.wallet_address, granularity=args.granularity, start_time=args.start_time, end_time=args.end_time, ) elif args.platform == "kalshi": if args.command == "markets": result = client.kalshi_markets( search=args.search, market_ticker=args.market_ticker, event_ticker=args.event_ticker, status=args.status, min_volume=args.min_volume, limit=args.limit, offset=args.offset, ) elif args.command == "price": result = client.kalshi_price(args.market_ticker, at_time=args.at_time) elif args.command == "trades": result = client.kalshi_trades( ticker=args.ticker, start_time=args.start_time, end_time=args.end_time, limit=args.limit, offset=args.offset, ) elif args.command == "orderbooks": result = client.kalshi_orderbooks( ticker=args.ticker, start_time=args.start_time, end_time=args.end_time, limit=args.limit, ) elif args.platform == "sports": if args.command == "matching": result = client.sports_matching( polymarket_slugs=args.polymarket_slug, kalshi_tickers=args.kalshi_ticker, ) elif args.command == "by-date": result = client.sports_by_date(sport=args.sport, date=args.date) if result is not None: output = json.dumps(result, indent=2, ensure_ascii=False) try: print(output) except UnicodeEncodeError: print(json.dumps(result, indent=2, ensure_ascii=True)) sys.exit(0 if api_result_ok(result) else 1) if __name__ == "__main__": main()

prediction-market

Install this skill

Comments