Prediction Market Data

Unified access to Polymarket and Kalshi for autonomous agents — market discovery, implied-probability pricing, orderbooks, trade history, wallet positions, and P&L. Plus cross-platform sports market matching.

View on GitHub →

Unified prediction-market data for autonomous agents. One AISA_API_KEY reads markets and prices across Polymarket and Kalshi — search events, track implied probabilities, inspect orderbooks, and analyze wallet positions.

Install

aisa skills install prediction-market-data

What can agents do with it?

Probability queries

“What are the current odds of a Fed rate cut in June across markets?”

Sentiment tracking

“Monitor election-related markets and flag price swings >5%.”

Trading analysis

“Pull historical trades and OHLC for this market over the last 30 days.”

Portfolio tracking

“What’s the P&L on this Polymarket wallet across granularities?”

Orderbook depth

“Check the top-of-book liquidity before placing a trade.”

Cross-platform match

“Find the Kalshi and Polymarket markets for the same NFL game.”

Core capabilities

• Market discovery — search Polymarket and Kalshi by keyword, status, category
• Price tracking — current “Yes”/“No” prices (implied probabilities)
• Historical data — trade history, orderbook snapshots, candlesticks
• Wallet analytics — positions and P&L by granularity (Polymarket)
• Event index — Polymarket event lookup
• Sports matching — find equivalent markets across platforms (NFL, MLB, NBA, etc.)

Workflow pattern

Most endpoints require IDs pulled from the search responses:

1. Search for markets

   Call /polymarket/markets or /kalshi/markets with a keyword.

2. Extract the identifier

   Polymarket → token_id. Kalshi → market_ticker.

3. Pass to downstream endpoints

   Use that identifier for price, orderbook, trades, or candlestick queries.

Quick start

export AISA_API_KEY="your-key"

Polymarket

# Market discovery
curl "https://api.aisa.one/apis/v1/polymarket/markets?search=election&status=active" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Events
curl "https://api.aisa.one/apis/v1/polymarket/events" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Market price (implied probability) for a token_id
curl "https://api.aisa.one/apis/v1/polymarket/market-price/TOKEN_ID" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Orderbook snapshot
curl "https://api.aisa.one/apis/v1/polymarket/orderbooks?token_id=TOKEN_ID" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Candlesticks
curl "https://api.aisa.one/apis/v1/polymarket/candlesticks?token_id=TOKEN_ID" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Activity / orders / positions
curl "https://api.aisa.one/apis/v1/polymarket/activity?wallet=WALLET_ADDRESS" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Wallet P&L by granularity
curl "https://api.aisa.one/apis/v1/polymarket/wallet-pnl?wallet=WALLET_ADDRESS&granularity=day" \
  -H "Authorization: Bearer $AISA_API_KEY"

Kalshi

# Market discovery
curl "https://api.aisa.one/apis/v1/kalshi/markets?search=rates" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Market price
curl "https://api.aisa.one/apis/v1/kalshi/market-price/KX-123" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Trades & orderbook
curl "https://api.aisa.one/apis/v1/kalshi/trades?ticker=KX-123" \
  -H "Authorization: Bearer $AISA_API_KEY"
curl "https://api.aisa.one/apis/v1/kalshi/orderbooks?ticker=KX-123" \
  -H "Authorization: Bearer $AISA_API_KEY"

Cross-platform sports matching

# All sports
curl "https://api.aisa.one/apis/v1/matching-markets/sports" \
  -H "Authorization: Bearer $AISA_API_KEY"

# By sport (nfl, mlb, nba, etc.)
curl "https://api.aisa.one/apis/v1/matching-markets/sports/nba?date=2025-08-16" \
  -H "Authorization: Bearer $AISA_API_KEY"

Python client

# Polymarket
python3 scripts/prediction_market_client.py poly markets --search "recession"
python3 scripts/prediction_market_client.py poly events
python3 scripts/prediction_market_client.py poly market-price --token-id TOKEN_ID
python3 scripts/prediction_market_client.py poly orderbook --token-id TOKEN_ID
python3 scripts/prediction_market_client.py poly candlesticks --token-id TOKEN_ID
python3 scripts/prediction_market_client.py poly wallet --address WALLET
python3 scripts/prediction_market_client.py poly wallet-pnl --address WALLET --granularity day

# Kalshi
python3 scripts/prediction_market_client.py kalshi markets --search "interest rates"
python3 scripts/prediction_market_client.py kalshi market-price --ticker KX-123
python3 scripts/prediction_market_client.py kalshi trades --ticker KX-123
python3 scripts/prediction_market_client.py kalshi orderbook --ticker KX-123

# Matching
python3 scripts/prediction_market_client.py matching sports --sport nba --date 2025-08-16

Endpoint reference

Endpoint	Method	Purpose
/polymarket/markets	GET	Polymarket markets
/polymarket/events	GET	Polymarket events
/polymarket/market-price/{id}	GET	Market price
/polymarket/orderbooks	GET	Orderbook
/polymarket/candlesticks	GET	Candlesticks
/polymarket/activity	GET	Activity
/polymarket/orders	GET	Orders
/polymarket/positions	GET	Positions
/polymarket/wallet	GET	Wallet
/polymarket/wallet-pnl	GET	Wallet P&L
/kalshi/markets	GET	Kalshi markets
/kalshi/market-price/{ticker}	GET	Kalshi price
/kalshi/trades	GET	Kalshi trades
/kalshi/orderbooks	GET	Kalshi orderbook
/matching-markets/sports	GET	All sports
/matching-markets/sports/{sport}	GET	By sport

Get started

1. Sign up at aisa.one (new accounts start with $2 free credit).
2. Generate an API key from the console.
3. export AISA_API_KEY="your-key" and install the skill:
   aisa skills install prediction-market-data
   

Related

Prediction Market API reference

Every Polymarket, Kalshi, and matching-markets endpoint.

Arbitrage skill

Cross-platform arb detection built on the same data.

Error Codes

Handling upstream exchange errors.