How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Surf Prediction Market API

Track prediction markets on Polymarket and Kalshi. Browse events and markets, view live prices and odds, analyze trading volume and open interest history, inspect individual trades, and discover top-ranked markets by activity.

Surf Prediction Market API is one of 16 APIs that Surf publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Prediction Market. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 23 operations across 23 paths, and defines 59 schemas. It is described by OpenAPI 3.2.0, at version sha-80d3407.

Requests are made against a single base URL, /.

23 operations 23 paths 59 schemas 23 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
sha-80d3407
Base URL
https://api.asksurf.ai/gateway/v1
Authentication
HTTP Bearer, API Key, API Key
Contact
Resource Areas
1

Authentication & Security 3

Surf Prediction Market API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (AccessToken). An API key is passed in the header as X-Admin-Token (AdminToken). An API key is passed in the header as X-Internal-Key (InternalKey).

Paths & Operations 23

Across 23 paths, the API surfaces 23 operations — 23 GET. Each is listed below with its method, path, parameters, and response codes.

Prediction Market 23

Track prediction markets on Polymarket and Kalshi. Browse events and markets, view live prices and odds, analyze trading volume and open interest history, inspect individual trade…

GET
/gateway/v1/prediction-market/analytics
Prediction Market Analytics
prediction-market-analytics 8 params → 200default
GET
/gateway/v1/prediction-market/correlations
Market Correlations
prediction-market-correlations 5 params → 200default
GET
/gateway/v1/prediction-market/kalshi/events
Kalshi Events
kalshi-events 3 params → 200default
GET
/gateway/v1/prediction-market/kalshi/markets
Kalshi Markets
kalshi-markets 3 params → 200default
GET
/gateway/v1/prediction-market/kalshi/open-interest
Kalshi Open Interest History
kalshi-open-interest 2 params → 200default
GET
/gateway/v1/prediction-market/kalshi/orderbooks
Kalshi Orderbook History
kalshi-orderbooks 5 params → 200default
GET
/gateway/v1/prediction-market/kalshi/prices
Kalshi Price History
kalshi-prices 3 params → 200default
GET
/gateway/v1/prediction-market/kalshi/trades
Kalshi Trades
kalshi-trades 9 params → 200default
GET
/gateway/v1/prediction-market/kalshi/volumes
Kalshi Volume History
kalshi-volumes 2 params → 200default
GET
/gateway/v1/prediction-market/matching/daily
Cross-Platform Daily Comparison (Polymarket < Kalshi)
matching-market-daily 5 params → 200default
GET
/gateway/v1/prediction-market/matching/pairs
Cross-Platform Prediction Market Matcher (Polymarket < Kalshi)
matching-market-pairs 10 params → 200default
GET
/gateway/v1/prediction-market/polymarket/events
Polymarket Events
polymarket-events 3 params → 200default
GET
/gateway/v1/prediction-market/polymarket/leaderboard
Polymarket Leaderboard
polymarket-leaderboard 4 params → 200default
GET
/gateway/v1/prediction-market/polymarket/markets
Polymarket Markets
polymarket-markets 3 params → 200default
GET
/gateway/v1/prediction-market/polymarket/open-interest
Polymarket Open Interest History
polymarket-open-interest 2 params → 200default
GET
/gateway/v1/prediction-market/polymarket/orderbooks
Polymarket Orderbook History
polymarket-orderbooks 5 params → 200default
GET
/gateway/v1/prediction-market/polymarket/positions
Polymarket Wallet Positions
polymarket-positions 3 params → 200default
GET
/gateway/v1/prediction-market/polymarket/price-ohlcv/{condition_id}
Polymarket OHLCV Candlesticks
polymarket-price-ohlcv 4 params → 200default
GET
/gateway/v1/prediction-market/polymarket/prices
Polymarket Price History
polymarket-prices 3 params → 200default
GET
/gateway/v1/prediction-market/polymarket/smart-money
Polymarket Smart Money
polymarket-smart-money 11 params → 200default
GET
/gateway/v1/prediction-market/polymarket/trades
Polymarket Trades
polymarket-trades 10 params → 200default
GET
/gateway/v1/prediction-market/polymarket/volume-split/{condition_id}
Polymarket Volume Split (YES/NO)
polymarket-volume-split 4 params → 200default
GET
/gateway/v1/prediction-market/polymarket/volumes
Polymarket Volume History
polymarket-volumes 7 params → 200default

Schemas 59

The contract defines 59 schemas that model the data the API accepts and returns. The most detailed are PolymarketMarketItem (25 properties), DiscoverMarketItem (24 properties), KalshiMarketItem (16 properties), MomentumItem (14 properties). Each schema is shown below with its type and property counts.

MomentumSummary
object
8 properties 8 required
KalshiPricePoint
object
6 properties 5 required
V2VolumeChartPoint
object
5 properties 5 required
DataResponsePolymarketMarketItem
object
3 properties 2 required
DataAPIErrorDetail
object
2 properties 2 required
DataResponsePolymarketEvent
object
3 properties 2 required
OffsetMeta
object
8 properties 4 required
PolymarketVolumePoint
object
5 properties 3 required
CategoryDailyPoint
object
5 properties 5 required
V2CandlestickData
object
8 properties 8 required
KalshiVolumePoint
object
2 properties 2 required
DataResponsePolymarketPosition
object
3 properties 2 required
V2CandlestickResponse
object
4 properties 3 required
PolymarketMarketSide
object
2 properties 2 required
V2VolumeChartResponse
object
6 properties 5 required
DataResponseKalshiMarketItem
object
3 properties 2 required
PolymarketEvent
object
14 properties 6 required
DataResponseInterface
object
3 properties 2 required
DataResponseKalshiEvent
object
3 properties 2 required
DataResponseKalshiOIPoint
object
3 properties 2 required
KalshiOIPoint
object
2 properties 2 required
MomentumItem
object
14 properties 13 required
KalshiMarketItem
object
16 properties 9 required
DataResponsePolymarketPricePoint
object
3 properties 2 required
DataResponsePolymarketOIPoint
object
3 properties 2 required
ObjectResponseMeta
object
3 properties 2 required
KalshiPriceSide
object
2 properties 2 required
MatchedMarketDailyItem
object
5 properties 5 required
CorrelationItem
object
7 properties 5 required
DataResponseMatchedMarketDailyItem
object
3 properties 2 required
AnalyticsBody
object
4 properties 4 required
MatchedMarketPolymarket
object
7 properties 5 required
DataAPIError
object
2 properties 1 required
V2KalshiOrderbookSnapshot
object
9 properties 9 required
KalshiTrade
object
7 properties 7 required
KalshiEvent
object
5 properties 4 required
DataResponsePolymarketVolumePoint
object
3 properties 2 required
DataResponseKalshiTrade
object
3 properties 2 required
MatchedMarketKalshi
object
6 properties 6 required
DataResponseMatchedMarketPair
object
3 properties 2 required
DataResponseCorrelationItem
object
3 properties 2 required
DataResponseKalshiPricePoint
object
3 properties 2 required
V2OrderbookSnapshot
object
8 properties 8 required
PolymarketPriceSide
object
3 properties 3 required
PolymarketMarketItem
object
25 properties 8 required
MatchedMarketPair
object
8 properties 5 required
V2OrderbookLevel
object
2 properties 2 required
DataResponseKalshiVolumePoint
object
3 properties 2 required
PolymarketPosition
object
10 properties 10 required
DataResponseLeaderboardItem
object
3 properties 2 required
V2OrderbooksResponse
object
3 properties 2 required
V2KalshiOrderbookLevel
object
2 properties 2 required
DataObjectResponseAnalyticsBody
object
3 properties 2 required
PolymarketPricePoint
object
3 properties 1 required
V2CursorPagination
object
4 properties 3 required
V2KalshiOrderbooksResponse
object
3 properties 2 required
LeaderboardItem
object
8 properties 8 required
DiscoverMarketItem
object
24 properties 9 required
PolymarketOIPoint
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

surf-prediction-market-api-openapi.yml Raw ↑

Other APIs Surf publishes across the network.

Surf Chat API
Surf DEX API
Surf Exchange API
Surf Fund API
Surf Hyperliquid API
Surf Market API
Surf News API
Surf Onchain API
Surf Project API
Surf Search API
Surf Signal API
Surf Social API
Where this information came from

This is an independent, third-party profile of Surf Prediction Market API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.