import {z} from 'zod' export type TimeWindow = '1d' | '7d' | '30d' | 'all_time'; export type LeaderboardSortBy = 'realized_pnl' | 'total_pnl' | 'volume' | 'roi' | 'profit_factor' | 'win_rate' | 'trades'; export type OrderDirection = 'asc' | 'desc'; export type GetApiV2PolymarketLeaderboardMarketConditionIdArgs = {condition_id: string, window?: TimeWindow | undefined, sort_by?: LeaderboardSortBy | undefined, order?: OrderDirection | undefined, min_total_pnl?: (number | null) | undefined, max_total_pnl?: (number | null) | undefined, min_trades?: (number | null) | undefined, max_trades?: (number | null) | undefined, min_volume?: (number | null) | undefined, max_volume?: (number | null) | undefined, min_avg_buy_price?: (number | null) | undefined, max_avg_buy_price?: (number | null) | undefined, min_avg_sell_price?: (number | null) | undefined, max_avg_sell_price?: (number | null) | undefined, min_entry_edge?: (number | null) | undefined, max_entry_edge?: (number | null) | undefined, limit?: number | undefined, pagination_key?: (string | null) | undefined}; export type GetApiV2PolymarketLeaderboardMarketConditionIdOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const timeWindow = z.enum(["1d", "7d", "30d", "all_time"]); export const leaderboardSortBy = z.enum(["realized_pnl", "total_pnl", "volume", "roi", "profit_factor", "win_rate", "trades"]); export const windowMetrics = z.object({realized_pnl: z.number(), total_pnl: z.number().nullable().optional(), volume: z.number(), roi: z.number(), trades: z.number().int(), wins: z.number().int(), losses: z.number().int(), win_rate: z.number(), profit_factor: z.number(), positions_closed: z.number().int(), avg_buy_price: z.number().nullable().optional(), avg_sell_price: z.number().nullable().optional(), fees_paid: z.number().optional(), fees_refunded: z.number().optional()}); export const tradingStyleFlags = z.object({is_whale: z.boolean(), is_market_maker: z.boolean(), is_active_trader: z.boolean(), is_buy_and_hold: z.boolean(), is_degen: z.boolean(), is_high_conviction: z.boolean(), is_contrarian: z.boolean(), is_value_hunter: z.boolean(), primary_style: z.string()}); export const leaderboardEntry = z.object({rank: z.number().int(), user: z.string(), metrics: windowMetrics, trading_styles: tradingStyleFlags, entry_edge: z.number().nullable().optional(), first_trade_at: z.number().int().nullable().optional()}); export const cursorPagination = z.object({limit: z.number().int(), count: z.number().int(), pagination_key: z.string().nullable().optional(), has_more: z.boolean()}); export const marketLeaderboardResponse = z.object({condition_id: z.string(), window: timeWindow, sort_by: leaderboardSortBy, entries: z.array(leaderboardEntry), pagination: cursorPagination}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Get Market Leaderboard * * GET /v2/polymarket/leaderboard/market/{condition_id} */ export const getApiV2PolymarketLeaderboardMarketConditionId = async (args: GetApiV2PolymarketLeaderboardMarketConditionIdArgs, options?: GetApiV2PolymarketLeaderboardMarketConditionIdOptions) => { const {baseUrl = "https://api.predexon.com", fetch: fetchFn = fetch, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.window != null) query.append("window", String(args.window)) if (args.sort_by != null) query.append("sort_by", String(args.sort_by)) if (args.order != null) query.append("order", String(args.order)) if (args.min_total_pnl != null) query.append("min_total_pnl", String(args.min_total_pnl)) if (args.max_total_pnl != null) query.append("max_total_pnl", String(args.max_total_pnl)) if (args.min_trades != null) query.append("min_trades", String(args.min_trades)) if (args.max_trades != null) query.append("max_trades", String(args.max_trades)) if (args.min_volume != null) query.append("min_volume", String(args.min_volume)) if (args.max_volume != null) query.append("max_volume", String(args.max_volume)) if (args.min_avg_buy_price != null) query.append("min_avg_buy_price", String(args.min_avg_buy_price)) if (args.max_avg_buy_price != null) query.append("max_avg_buy_price", String(args.max_avg_buy_price)) if (args.min_avg_sell_price != null) query.append("min_avg_sell_price", String(args.min_avg_sell_price)) if (args.max_avg_sell_price != null) query.append("max_avg_sell_price", String(args.max_avg_sell_price)) if (args.min_entry_edge != null) query.append("min_entry_edge", String(args.min_entry_edge)) if (args.max_entry_edge != null) query.append("max_entry_edge", String(args.max_entry_edge)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.pagination_key != null) query.append("pagination_key", String(args.pagination_key)) if (apiKey !== undefined) headers.set("x-api-key", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/v2/polymarket/leaderboard/market/${encodeURIComponent(String(args.condition_id))}${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(marketLeaderboardResponse, await res.json()) };