Skip to main content

​
Quickstart

Get started with Predexon in 5 minutes. This guide shows how to find matching markets across Polymarket and Kalshi, and access market data.

​
Prerequisites

  • Predexon API key (contact team@predexon.com)
  • Base REST URL: https://api.predexon.com/v1
  • Environment with curl, Node.js 18+, or Python 3.10+

​
Step 1: Find Matching Markets (Kalshi → Polymarket)

Find equivalent Polymarket markets for a Kalshi market ticker. 
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/matching-markets?kalshi_market_ticker=KXGGGNOMSCORE-25-TES"
Response structure: 
{
  "query": {
    "platform": "kalshi",
    "market_ticker": "KXGGGNOMSCORE-25-TES",
    "market_title": "..."
  },
  "matches": {
    "exact": {
      "active": [...],
      "closed": [...]
    },
    "related": {
      "active": [...],
      "closed": [...]
    }
  },
  "summary": {
    "total_matches": 5,
    "exact_matches": 2,
    "related_matches": 3,
    "platforms": ["polymarket"]
  }
}
See Market Matching for full field reference, array support, and confidence score details.

​
Step 2: Find Matching Markets (Polymarket → Kalshi)

Works the same way - just use polymarket_market_slug instead: 
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/matching-markets?polymarket_market_slug=bitcoin-above-100k-2025"

​
Step 3: List Markets with Filters

Search for markets using the Predexon markets endpoint: 
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/predexon/markets?status=active&min_volume=10000&limit=20"
See List Markets for all available filters.

​
Step 4: Get Historical Candlesticks

Fetch OHLCV candlestick data for price analysis: 
# Get 1-hour candles for the last 24 hours
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/predexon/candlesticks/CONDITION_ID?start_time=1735660800&end_time=1735747200&interval=60"
Interval options:
  • 1 = 1 minute (max 1 week range)
  • 60 = 1 hour (max 1 month range)
  • 1440 = 1 day (max 1 year range)
See Candlesticks for more details.

​
Troubleshooting

  • 400 – Check required parameters and value constraints
  • 401 / 403 – Verify your API key is correct
  • 404 – Market ticker/slug not found in database
  • 429 – Rate limit exceeded, implement backoff
  • 500 – Server error, try again or contact support

​
Next Steps

Market Matching

Find equivalent markets with array support

List Markets

Search and filter Polymarket markets

Orders

Historical order data

Candlesticks

OHLCV price data