Markets API
Access prediction market data, prices, and outcome mints
Markets API
The Markets API provides access to prediction market data including prices, volumes, outcome token mints, and batch queries.
Access
Methods
getMarket
Get a single market by ticker.
getMarketByMint
Get a market by outcome token mint address.
getMarkets
List markets with optional filters.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
status | MarketStatus | No | Filter by status: 'active', 'closed', 'determined', 'finalized' |
isInitialized | boolean | No | Filter markets that are initialized |
sort | SortField | No | Sort field: 'volume', 'volume_24h', 'liquidity', 'open_interest' |
tickers | string | No | Filter by specific market tickers (comma-separated) |
eventTicker | string | No | Filter by event ticker |
seriesTicker | string | No | Filter by series ticker |
maxCloseTs | number | No | Filter markets closing before this timestamp |
minCloseTs | number | No | Filter markets closing after this timestamp |
limit | number | No | Maximum number of markets to return |
cursor | number | No | Pagination cursor (number of markets to skip) |
getMarketsBatch
Retrieve multiple markets in a single request.
Maximum 100 items total (tickers + mints) per batch request.
getOutcomeMints
Get all outcome token mint addresses.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
minCloseTs | number | No | Minimum close timestamp (Unix seconds). Only markets with close_time >= minCloseTs will be included. |
filterOutcomeMints
Filter a list of addresses to find which ones are outcome token mints.
Maximum 200 addresses per filter request. Use this to identify prediction market tokens in a wallet.
getMarketCandlesticks
Get OHLCV candlestick data for a market.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
ticker | string | Yes | The market ticker |
params.startTs | number | Yes | Start timestamp (Unix seconds) |
params.endTs | number | Yes | End timestamp (Unix seconds) |
params.periodInterval | number | Yes | Candle period in minutes (1, 60, or 1440) |
getMarketCandlesticksByMint
Get candlestick data by mint address.