# PredictorSDK

> One API for prediction markets. It lists the markets of nine venues (Kalshi, Polymarket, Predict, SX Bet, Hyperliquid, AlphaArcade, ProphetX, Limitless and Pred) in one catalog, returns one market with its quotes and the venue's trading fees, and matches the same NBA, WNBA, NHL, MLB and NFL games across venues.

- Base URL: https://api.predictorsdk.com
- Authentication: `Authorization: Bearer <API key>` on every request except `GET /v1/plans`.
- Usual path: list matched games with `GET /v1/matching-markets/sports`, find one by a venue's identifier with `source_id={provider}:{id}`, then read each venue market's quotes with `GET /v1/markets/{market_id}`.
- Every page as one text file: https://docs.predictorsdk.com/llms-full.txt
- OpenAPI document: https://docs.predictorsdk.com/openapi.yaml
- Changelog: https://docs.predictorsdk.com/changelog

## Documentation

- [Overview](https://docs.predictorsdk.com/): Match and aggregate prediction markets across exchanges into canonical events with a single API.
- [Quickstart](https://docs.predictorsdk.com/quickstart): Make your first PredictorSDK API call in under a minute.
- [Authentication](https://docs.predictorsdk.com/authentication): How to get and use your PredictorSDK API key.

- Concepts
  - [Matching Markets](https://docs.predictorsdk.com/concepts/matching-markets): How PredictorSDK matches equivalent markets across prediction market platforms.
  - [Events and Markets](https://docs.predictorsdk.com/concepts/events-and-markets): Understanding events, sub-markets, and how canonical matching works internally.
  - [Sources](https://docs.predictorsdk.com/concepts/sources): The prediction market platforms PredictorSDK aggregates.

- Guides
  - [Filtering](https://docs.predictorsdk.com/guides/filtering): Narrow the list of matched sports events by league, date or participant, and look up specific matches by identifier.
  - [Player-prop matching and settlement rules](https://docs.predictorsdk.com/guides/player-prop-matching): Compare the same player prop without confusing it with an equivalent contract.
  - [Game-line rules - ties, overtime and pushes](https://docs.predictorsdk.com/guides/game-line-rules): How each venue settles a tied game, overtime and a line that lands exactly, summarised on every moneyline, spread and total, with the rows behind it on request.
  - [Pagination](https://docs.predictorsdk.com/guides/pagination): Traverse large result sets with cursor-based pagination.
  - [Trading fees](https://docs.predictorsdk.com/guides/trading-fees): Compute the true cost of a trade on any provider market, and compare venues that quote the same price.
  - [Error Handling](https://docs.predictorsdk.com/guides/error-handling): HTTP status codes and error response format.
  - [Plans & Limits](https://docs.predictorsdk.com/guides/plans): What each plan covers, and which tier each endpoint requires.

- SDK
  - [Installation](https://docs.predictorsdk.com/sdk/installation): Install the PredictorSDK client for TypeScript, Python, or Go.
  - [TypeScript SDK Reference](https://docs.predictorsdk.com/sdk/typescript): Type reference for the PredictorSDK TypeScript client.
  - [Python SDK Reference](https://docs.predictorsdk.com/sdk/python): Type reference for the PredictorSDK Python client.
  - [Go SDK Reference](https://docs.predictorsdk.com/sdk/go): Type reference for the PredictorSDK Go client.

## API Reference

- [List public API plans](https://docs.predictorsdk.com/api-reference/getPlans): Returns the machine-readable public billing catalog used by API consumers and pricing surfaces.
- [List matched sports events](https://docs.predictorsdk.com/api-reference/getSportsMatchingMarkets): Lists the sports events that more than one venue has matched, soonest scheduled start first, with cursor-based pagination (default limit=25, max 100).
- [Look up matched sports events by identifier](https://docs.predictorsdk.com/api-reference/lookupSportsMatchingMarkets): Finds the matched sports events that hold identifiers you already have, in one unpaginated call: a canonical event key as event_id, and any identifier a venue publishes (a market's market_id, market_slug or event_id; on Polymarket, Predict and AlphaArcade an outcome token; on Polymarket also a conditionId) as source_id={provider}:{id}.
- [List markets](https://docs.predictorsdk.com/api-reference/getMarkets): Returns a paginated list of unified markets from all supported prediction market providers.
- [List categories](https://docs.predictorsdk.com/api-reference/getCategories): Returns the canonical top-level categories that can be used to filter unified market discovery with GET /v1/markets?category=....
- [Get market detail](https://docs.predictorsdk.com/api-reference/getMarket): Returns one market from any of the nine supported providers (Kalshi, Polymarket, Predict, SX Bet, Hyperliquid, AlphaArcade, ProphetX, Limitless, Pred).
- [Get event with nested markets](https://docs.predictorsdk.com/api-reference/getEvent): Returns a single event and the markets nested under it on the identified provider.
- [Get Binance crypto prices](https://docs.predictorsdk.com/api-reference/getBinanceCryptoPrices): Returns per-second price data for a Binance trading pair in the paginated envelope every list route uses: data holds the prices and pagination the page.
- [Get Polymarket wallet profile](https://docs.predictorsdk.com/api-reference/getPolymarketWallet): Returns the public profile (image and display name) for a Polymarket wallet.
- [List Polymarket wallet positions](https://docs.predictorsdk.com/api-reference/listPolymarketWalletPositions): Returns the current Polymarket positions for a wallet.