Sports Matching
Query matched game markets by sport and date. Returns all matched pairs for each game across all available platforms.
/v2/matching-markets/sportsQuery Parameters
Sport code: nba, nhl, mlb, nfl, cfb, cbb, epl, ucl, and more.
Date in YYYY-MM-DD format. Defaults to today.
Comma-separated list of platforms. Only return groups matching all listed platforms.
Response Schema
The sport code that was queried.
The date that was queried (YYYY-MM-DD).
Matched games for the given sport and date.
Internal match group ID.
Game title (e.g. "Lakers vs Celtics").
Date of the game (YYYY-MM-DD).
Markets from each platform for this game.
Platform name (polymarket, kalshi, etc.).
Platform-native market ID.
Direct link to the market on the platform.
Current best bid price for YES.
Current best ask price for YES.
Last traded price.
Authentication
API Key
To secure your requests, we strongly recommend passing your API key via the X-API-Key header. This prevents sensitive keys from being exposed in access logs or browser history.
X-API-Key: pmx_test_5e8f...Rate Limits
API rate limits are enforced based on the tier associated with your API key. Limits are tracked on two dimensions: requests per second and requests per month. Only successful responses (where success is true) count toward your monthly quota.
Current usage is returned in every API response via the following headers:
X-RateLimit-Limit-Second: 10X-RateLimit-Remaining-Second: 9X-RateLimit-Limit-Month: 1000X-RateLimit-Remaining-Month: 842If you exceed a rate limit, the API returns a 429 status with a Retry-After header indicating when you can resume.
Request
Live API Key
Sports Parameters
Response
Enter an API key and click "Try it now" to see the live response data.