investing 0.1.0 → 0.1.2

package/dist/prediction/api/leaderboard.d.ts

@@ -0,0 +1,113 @@
+import { PolymarketCategory } from '../constants';
+/**
+ * Fetches the Polymarket leaderboard with top traders ranked by volume or PnL.
+ * @param options - Configuration options for the leaderboard query
+ * @param options.timePeriod - Time period filter: "all", "1d", "7d", or "30d" (default: "all")
+ * @param options.orderBy - Sort order: "VOL" for volume or "PNL" for profit/loss (default: "VOL")
+ * @param options.limit - Maximum number of entries to retrieve (default: 20)
+ * @param options.offset - Number of entries to skip for pagination (default: 0)
+ * @param options.category - Category filter (default: "overall")
+ * @returns Array of leaderboard entries
+ * @throws Error if the API request fails
+ */
+export declare function fetchLeaderboard(options?: {
+    timePeriod?: "all" | "1d" | "7d" | "30d";
+    orderBy?: "VOL" | "PNL";
+    limit?: number;
+    offset?: number;
+    category?: PolymarketCategory | Lowercase<PolymarketCategory>;
+}): Promise<unknown>;
+/**
+ * Fetches top traders from Polymarket Analytics API sorted by overall gain.
+ * @param limit - Maximum number of traders to retrieve (default: 50)
+ * @returns Array of trader objects with performance metrics
+ * @throws Error if the API request fails
+ */
+export declare function fetchTopTraders(limit?: number): Promise<any[]>;
+/**
+ * Fetches all positions for a specific trader from Polymarket Analytics API.
+ * @param traderId - The unique identifier of the trader
+ * @returns Array of position objects for the trader
+ * @throws Error if the API request fails
+ */
+export declare function fetchTraderPositions(traderId: string): Promise<unknown>;
+export interface TraderProfile {
+    address: string;
+    userName?: string;
+    profileImage?: string;
+    overallGain: number;
+    winRate: number;
+    totalProfit: number;
+    totalLoss: number;
+    totalPositions: number;
+    activePositions: number;
+    currentValue: number;
+}
+/**
+ * Fetches profile stats for multiple traders from Polymarket Analytics API.
+ * Uses the traders-tag-performance API to get bulk trader data.
+ * @param addresses - Array of trader wallet addresses
+ * @returns Map of address to trader profile data
+ */
+export declare function fetchTraderProfiles(addresses: string[]): Promise<Map<string, TraderProfile>>;
+/**
+ * Activity types available from Polymarket Data API
+ */
+export type ActivityType = "TRADE" | "SPLIT" | "MERGE" | "REDEEM" | "REWARD" | "CONVERSION" | "MAKER_REBATE";
+/**
+ * Options for fetching trader activity
+ */
+export interface FetchActivityOptions {
+    user: string;
+    limit?: number;
+    offset?: number;
+    market?: string[];
+    type?: ActivityType[];
+    start?: number;
+    end?: number;
+    sortBy?: "TIMESTAMP" | "TOKENS" | "CASH";
+    sortDirection?: "ASC" | "DESC";
+    side?: "BUY" | "SELL";
+}
+/**
+ * Activity record from Polymarket Data API
+ */
+export interface TraderActivity {
+    proxyWallet: string;
+    timestamp: number;
+    conditionId: string;
+    type: ActivityType;
+    size: string;
+    usdcSize: string;
+    transactionHash: string;
+    price?: string;
+    asset?: string;
+    side?: "BUY" | "SELL";
+    outcomeIndex?: number;
+    title?: string;
+    slug?: string;
+    icon?: string;
+    eventSlug?: string;
+    outcome?: string;
+    name?: string;
+    pseudonym?: string;
+    bio?: string;
+    profileImage?: string;
+    profileImageOptimized?: string;
+}
+/**
+ * Fetches on-chain activity for a specific trader from Polymarket Data API.
+ * @param options - Configuration options for the activity query
+ * @returns Array of activity objects for the trader
+ * @throws Error if the API request fails
+ */
+export declare function fetchTraderActivity(options: FetchActivityOptions): Promise<TraderActivity[]>;
+/**
+ * Fetches all activity for a trader by paginating through all pages.
+ * @param user - Trader wallet address
+ * @param options - Additional fetch options
+ * @param onProgress - Optional callback for progress updates
+ * @returns Array of all activity objects for the trader
+ */
+export declare function fetchAllTraderActivity(user: string, options?: Omit<FetchActivityOptions, "user" | "offset">, onProgress?: (fetched: number, total: number | null) => void): Promise<TraderActivity[]>;
+//# sourceMappingURL=leaderboard.d.ts.map

package/dist/prediction/api/leaderboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.d.ts","sourceRoot":"","sources":["../../../src/prediction/api/leaderboard.ts"],"names":[],"mappings":"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"}

package/dist/prediction/api/markets.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Fetches active prediction markets from the Polymarket Gamma API.
+ * @param limit - Maximum number of markets to retrieve (default: 50)
+ * @param sortBy - Field to sort results by (default: "volume24hr")
+ * @param offset - Number of markets to skip for pagination (default: 0)
+ * @returns Array of market objects from Polymarket
+ * @throws Error if the API request fails
+ */
+export declare function fetchMarkets(limit?: number, sortBy?: string, offset?: number): Promise<unknown>;
+/**
+ * Fetches all active prediction markets from the Polymarket Gamma API using pagination.
+ * @param sortBy - Field to sort results by (default: "volume24hr")
+ * @param maxMarkets - Maximum total number of markets to retrieve (default: 1000, set to 0 for unlimited)
+ * @returns Array of all market objects from Polymarket
+ * @throws Error if the API request fails
+ */
+export declare function fetchAllMarkets(sortBy?: string, maxMarkets?: number): Promise<any[]>;
+/**
+ * Searches for active markets matching a query string.
+ * @param query - The search query string
+ * @param limit - Maximum number of results to return (default: 100)
+ * @returns Array of market objects matching the search query
+ * @throws Error if the API request fails
+ */
+export declare function searchMarkets(query: string, limit?: number): Promise<any>;
+/**
+ * Performs a public search across Polymarket events, markets, and profiles.
+ * @param options - Search configuration options
+ * @param options.q - The search query string (required)
+ * @param options.cache - Whether to use cached results
+ * @param options.events_status - Filter by event status
+ * @param options.limit_per_type - Maximum results per type
+ * @param options.page - Page number for pagination
+ * @param options.events_tag - Array of tags to filter events
+ * @param options.keep_closed_markets - Include closed markets (0 or 1)
+ * @param options.sort - Sort field
+ * @param options.ascending - Sort direction
+ * @param options.search_tags - Include tags in search
+ * @param options.search_profiles - Include profiles in search
+ * @param options.recurrence - Recurrence filter
+ * @param options.exclude_tag_id - Array of tag IDs to exclude
+ * @param options.optimized - Use optimized search
+ * @returns Search results object
+ * @throws Error if the API request fails
+ */
+export declare function searchPublic(options: {
+    q: string;
+    cache?: boolean;
+    events_status?: string;
+    limit_per_type?: number;
+    page?: number;
+    events_tag?: string[];
+    keep_closed_markets?: number;
+    sort?: string;
+    ascending?: boolean;
+    search_tags?: boolean;
+    search_profiles?: boolean;
+    recurrence?: string;
+    exclude_tag_id?: number[];
+    optimized?: boolean;
+}): Promise<unknown>;
+//# sourceMappingURL=markets.d.ts.map

package/dist/prediction/api/markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../../src/prediction/api/markets.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,KAAK,SAAK,EACV,MAAM,SAAe,EACrB,MAAM,SAAI,oBAiCX;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,SAAe,EACrB,UAAU,SAAO,kBAyDlB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM,gBAkB7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,oBAqDA"}

package/dist/prediction/api/prices.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Fetches historical price data for a specific token/market.
+ * @param options - Configuration options for the price history query
+ * @param options.market - The token ID of the market outcome
+ * @param options.interval - Time interval for data points (e.g., "1h", "1d", "max")
+ * @param options.startTs - Optional start timestamp (Unix timestamp in seconds)
+ * @param options.endTs - Optional end timestamp (Unix timestamp in seconds)
+ * @param options.abs - Optional flag to return absolute prices instead of 0-1 probability scale
+ * @returns Object containing history array with { t: timestamp, p: price } entries
+ * @throws Error if the API request fails
+ *
+ * @example
+ * // Get entire 1-hour interval history for a token
+ * const history = await fetchPriceHistory({ market: "token_id", interval: "1h" });
+ *
+ * @example
+ * // Get history for a specific time range
+ * const history = await fetchPriceHistory({
+ *   market: "token_id",
+ *   interval: "1h",
+ *   startTs: 1700000000,
+ *   endTs: 1700086400
+ * });
+ */
+export declare function fetchPriceHistory(options: {
+    market: string;
+    interval?: string;
+    startTs?: number;
+    endTs?: number;
+    abs?: boolean;
+}): Promise<unknown>;
+//# sourceMappingURL=prices.d.ts.map

package/dist/prediction/api/prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices.d.ts","sourceRoot":"","sources":["../../../src/prediction/api/prices.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,oBA2CA"}

package/dist/prediction/constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Polymarket prediction market categories
+ * Separated from main polymarket.ts to avoid importing database client in client components
+ */
+export declare const POLYMARKET_CATEGORIES: readonly ["Overall", "Politics", "Sports", "Crypto", "Culture", "Mentions", "Weather", "Economics", "Tech", "Finance"];
+export type PolymarketCategory = typeof POLYMARKET_CATEGORIES[number];
+//# sourceMappingURL=constants.d.ts.map

package/dist/prediction/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/prediction/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,wHAWxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC"}

package/dist/prediction/db/debates.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Saves or updates AI-generated debate analysis for a market.
+ * @param marketId - The unique identifier of the market
+ * @param debateData - Debate analysis data object
+ */
+export declare function saveDebate(marketId: string, debateData: {
+    question: string;
+    yesArguments: string[];
+    noArguments: string[];
+    yesSummary: string;
+    noSummary: string;
+    keyFactors: string[];
+    uncertainties: string[];
+    currentYesPrice: number;
+    currentNoPrice: number;
+    llmProvider?: string;
+    model?: string;
+}): Promise<void>;
+/**
+ * Retrieves the debate analysis for a specific market from the database.
+ * @param marketId - The unique identifier of the market
+ * @returns Debate record if found, or null if no debate exists for the market
+ */
+export declare function getMarketDebate(marketId: string): Promise<{
+    id: string;
+    marketId: string;
+    question: string;
+    yesArguments: string;
+    noArguments: string;
+    yesSummary: string;
+    noSummary: string;
+    keyFactors: string;
+    uncertainties: string;
+    currentYesPrice: number | null;
+    currentNoPrice: number | null;
+    llmProvider: string | null;
+    model: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+} | null>;
+//# sourceMappingURL=debates.d.ts.map

package/dist/prediction/db/debates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debates.d.ts","sourceRoot":"","sources":["../../../src/prediction/db/debates.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,iBAyCF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;;;;;;;;UAQrD"}

package/dist/prediction/db/leaderboard.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Saves or updates leader data in the database.
+ * Uses upsert to update existing records or insert new ones.
+ * @param leadersData - Array of leader objects from the API
+ */
+export declare function saveLeaders(leadersData: any[]): Promise<void>;
+/**
+ * Saves or updates leaderboard data in the database.
+ * Includes user profile information like username and verification status.
+ * @param leaderboardData - Array of leaderboard entries from the API
+ */
+export declare function saveLeaderboardData(leaderboardData: any[]): Promise<void>;
+/**
+ * Retrieves leaders from the database sorted by specified metric.
+ * @param orderBy - Sort metric: "vol" for volume, "pnl" for profit/loss, or "overallGain" (default: "vol")
+ * @param limit - Maximum number of leaders to retrieve (default: 50)
+ * @returns Array of leader records from the database
+ */
+export declare function getLeaders(orderBy?: "vol" | "pnl" | "overallGain", limit?: number): Promise<{
+    trader: string;
+    rank: number | null;
+    userName: string | null;
+    xUsername: string | null;
+    verifiedBadge: boolean | null;
+    profileImage: string | null;
+    vol: number | null;
+    pnl: number | null;
+    overallGain: number | null;
+    winRate: number | null;
+    activePositions: number | null;
+    totalPositions: number | null;
+    currentValue: number | null;
+    winAmount: number | null;
+    lossAmount: number | null;
+    updatedAt: Date | null;
+}[]>;
+//# sourceMappingURL=leaderboard.d.ts.map

package/dist/prediction/db/leaderboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.d.ts","sourceRoot":"","sources":["../../../src/prediction/db/leaderboard.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,iBAiCnD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,eAAe,EAAE,GAAG,EAAE,iBA+B/D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE,KAAK,GAAG,KAAK,GAAG,aAAqB,EAC9C,KAAK,SAAK;;;;;;;;;;;;;;;;;KAcX"}

package/dist/prediction/db/markets.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Saves or updates market data in the database.
+ * Handles outcomes, prices, tags, and other market metadata.
+ * @param marketsData - Array of market objects from the API
+ */
+export declare function saveMarkets(marketsData: any[]): Promise<void>;
+/**
+ * Retrieves markets from the database with filtering and sorting options.
+ * @param options - Query configuration options
+ * @param options.limit - Maximum number of markets to retrieve (default: 50)
+ * @param options.sortBy - Sort field: "volume24hr", "volumeTotal", or "createdAt" (default: "volume24hr")
+ * @param options.category - Optional category tag to filter by
+ * @param options.activeOnly - Only include active markets (default: true)
+ * @returns Array of market records matching the criteria
+ */
+export declare function getMarkets(options?: {
+    limit?: number;
+    offset?: number;
+    sortBy?: "volume24hr" | "volumeTotal" | "createdAt";
+    category?: string;
+    activeOnly?: boolean;
+}): Promise<{
+    id: string;
+    conditionId: string | null;
+    question: string;
+    slug: string;
+    eventSlug: string | null;
+    description: string | null;
+    image: string | null;
+    volume24hr: number | null;
+    volumeTotal: number | null;
+    active: boolean | null;
+    closed: boolean | null;
+    outcomes: string;
+    outcomePrices: string;
+    clobTokenIds: string | null;
+    tags: string | null;
+    category: string | null;
+    subcategory: string | null;
+    endDate: string | null;
+    groupItemTitle: string | null;
+    enableOrderBook: boolean | null;
+    createdAt: Date;
+    updatedAt: Date;
+}[]>;
+/**
+ * Searches markets in the database by question text.
+ * @param searchTerm - The search term to match against market questions
+ * @param options - Query configuration options
+ * @param options.limit - Maximum number of markets to retrieve (default: 50)
+ * @param options.sortBy - Sort field: "volume24hr", "volumeTotal", or "createdAt" (default: "volume24hr")
+ * @param options.category - Optional category tag to filter by
+ * @param options.activeOnly - Only include active markets (default: true)
+ * @returns Array of market records matching the search term
+ */
+export declare function searchMarketsInDB(searchTerm: string, options?: {
+    limit?: number;
+    offset?: number;
+    sortBy?: "volume24hr" | "volumeTotal" | "createdAt";
+    category?: string;
+    activeOnly?: boolean;
+}): Promise<{
+    id: string;
+    conditionId: string | null;
+    question: string;
+    slug: string;
+    eventSlug: string | null;
+    description: string | null;
+    image: string | null;
+    volume24hr: number | null;
+    volumeTotal: number | null;
+    active: boolean | null;
+    closed: boolean | null;
+    outcomes: string;
+    outcomePrices: string;
+    clobTokenIds: string | null;
+    tags: string | null;
+    category: string | null;
+    subcategory: string | null;
+    endDate: string | null;
+    groupItemTitle: string | null;
+    enableOrderBook: boolean | null;
+    createdAt: Date;
+    updatedAt: Date;
+}[]>;
+/**
+ * Retrieves active markets grouped by their category tags.
+ * @returns Object with category tags as keys and arrays of market records as values
+ */
+export declare function getMarketsByCategory(): Promise<Record<string, any[]>>;
+//# sourceMappingURL=markets.d.ts.map

package/dist/prediction/db/markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../../src/prediction/db/markets.ts"],"names":[],"mappings":"AAoCA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,iBAwFnD;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB;;;;;;;;;;;;;;;;;;;;;;;KA0CP;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB;;;;;;;;;;;;;;;;;;;;;;;KA4CP;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,mCAyBzC"}

package/dist/prediction/db/positions.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Saves or updates position data for a specific trader in the database.
+ * @param traderId - The unique identifier of the trader
+ * @param positionsData - Array of position objects from the API
+ */
+export declare function savePositions(traderId: string, positionsData: any[]): Promise<void>;
+/**
+ * Saves order book positions for a specific market.
+ * Clears existing positions and saves new bids and asks.
+ * @param marketId - The unique identifier of the market
+ * @param orderBookData - Order book object containing bids and asks arrays
+ */
+export declare function saveMarketPositions(marketId: string, orderBookData: any): Promise<void>;
+/**
+ * Saves top holders for a specific market.
+ * @param marketId - The unique identifier of the market
+ * @param holdersData - Array of holder objects
+ */
+export declare function saveHolders(marketId: string, holdersData: any[]): Promise<void>;
+/**
+ * Retrieves all positions for a specific trader from the database.
+ * @param traderId - The unique identifier of the trader
+ * @returns Array of position records for the trader
+ */
+export declare function getTraderPositions(traderId: string): Promise<{
+    id: string;
+    traderId: string;
+    marketId: string | null;
+    marketTitle: string | null;
+    cashPnl: number | null;
+    realizedPnl: number | null;
+    tags: string | null;
+    createdAt: Date | null;
+}[]>;
+/**
+ * Retrieves order book positions for a specific market from the database.
+ * @param marketId - The unique identifier of the market
+ * @returns Array of position records sorted by total value descending
+ */
+export declare function getMarketPositions(marketId: string): Promise<{
+    id: string;
+    marketId: string;
+    outcome: string;
+    price: number;
+    size: number;
+    side: string;
+    totalValue: number;
+    createdAt: Date;
+}[]>;
+/**
+ * Retrieves top holders for a specific market from the database.
+ * @param marketId - The unique identifier of the market
+ * @param limit - Maximum number of holders to retrieve (default: 10)
+ * @returns Array of holder records sorted by rank
+ */
+export declare function getMarketHolders(marketId: string, limit?: number): Promise<{
+    id: string;
+    marketId: string;
+    address: string;
+    userName: string | null;
+    profileImage: string | null;
+    rank: number;
+    outcome: string | null;
+    balance: number;
+    value: number;
+    overallGain: number | null;
+    winRate: number | null;
+    totalProfit: number | null;
+    totalLoss: number | null;
+    totalPositions: number | null;
+    updatedAt: Date;
+}[]>;
+//# sourceMappingURL=positions.d.ts.map

package/dist/prediction/db/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../../src/prediction/db/positions.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,iBA4BzE;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,GAAG,iBA4CnB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,iBA8BrE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;KAKxD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;KAMxD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK;;;;;;;;;;;;;;;;KAOlE"}

package/dist/prediction/db/prices.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Saves historical price data for a specific token/market.
+ * Stores each price point as a separate record.
+ * @param tokenId - The unique identifier of the market token
+ * @param priceHistory - Price history object containing history array with { t: timestamp, p: price } entries
+ * @param interval - The interval used for the price data (e.g., "1h", "1d")
+ */
+export declare function savePriceHistory(tokenId: string, priceHistory: {
+    history: Array<{
+        t: number;
+        p: number;
+    }>;
+}, interval?: string): Promise<void>;
+/**
+ * Retrieves historical price data for a specific token from the database.
+ * @param tokenId - The unique identifier of the market token
+ * @param options - Query configuration options
+ * @param options.interval - Optional interval filter (e.g., "1h", "1d")
+ * @param options.startTimestamp - Optional start timestamp to filter from
+ * @param options.endTimestamp - Optional end timestamp to filter to
+ * @param options.limit - Maximum number of records to retrieve
+ * @returns Array of price history records sorted by timestamp ascending
+ */
+export declare function getPriceHistory(tokenId: string, options?: {
+    interval?: string;
+    startTimestamp?: number;
+    endTimestamp?: number;
+    limit?: number;
+}): Promise<{
+    id: string;
+    tokenId: string;
+    timestamp: number;
+    price: number;
+    interval: string;
+    createdAt: Date;
+}[]>;
+//# sourceMappingURL=prices.d.ts.map

package/dist/prediction/db/prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices.d.ts","sourceRoot":"","sources":["../../../src/prediction/db/prices.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EAC1D,QAAQ,GAAE,MAAa,iBA8CxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX;;;;;;;KAuCP"}

package/dist/prediction/db/trade-history.d.ts

@@ -0,0 +1,108 @@
+import { TraderActivity } from '../api/leaderboard';
+/**
+ * Saves trade activity records to the database.
+ * Uses upsert to handle duplicates.
+ * @param traderId - The trader wallet address
+ * @param activities - Array of activity records from the API
+ * @returns Number of trades saved
+ */
+export declare function saveTradeHistory(traderId: string, activities: TraderActivity[]): Promise<number>;
+/**
+ * Updates the sync status for a trader.
+ * @param traderId - The trader wallet address
+ * @param status - Status update fields
+ */
+export declare function updateTradeSyncStatus(traderId: string, status: {
+    syncStatus?: "pending" | "in_progress" | "completed" | "error";
+    lastSyncedTimestamp?: Date;
+    totalTradesSynced?: number;
+    errorMessage?: string | null;
+}): Promise<void>;
+/**
+ * Gets the sync status for a trader.
+ * @param traderId - The trader wallet address
+ * @returns Sync status record or null if not found
+ */
+export declare function getTradeSyncStatus(traderId: string): Promise<{
+    traderId: string;
+    lastSyncedTimestamp: Date | null;
+    totalTradesSynced: number | null;
+    syncStatus: string;
+    errorMessage: string | null;
+    lastSyncAttempt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}>;
+/**
+ * Gets all traders that need syncing (pending or error status).
+ * @param limit - Maximum number of traders to return
+ * @returns Array of trader IDs
+ */
+export declare function getTradersNeedingSync(limit?: number): Promise<string[]>;
+/**
+ * Gets trade history for a specific trader.
+ * @param traderId - The trader wallet address
+ * @param options - Query options
+ * @returns Array of trade history records
+ */
+export declare function getTraderTradeHistory(traderId: string, options?: {
+    limit?: number;
+    offset?: number;
+    type?: string;
+    startDate?: Date;
+    endDate?: Date;
+}): Promise<{
+    id: string;
+    traderId: string;
+    transactionHash: string;
+    conditionId: string;
+    marketTitle: string | null;
+    marketSlug: string | null;
+    eventSlug: string | null;
+    type: string;
+    side: string | null;
+    outcome: string | null;
+    outcomeIndex: number | null;
+    size: number;
+    usdcSize: number;
+    price: number | null;
+    traderName: string | null;
+    traderBio: string | null;
+    traderProfileImage: string | null;
+    timestamp: Date;
+    syncedAt: Date;
+    createdAt: Date;
+}[]>;
+/**
+ * Gets trade statistics for a trader.
+ * @param traderId - The trader wallet address
+ * @returns Trade statistics object
+ */
+export declare function getTraderTradeStats(traderId: string): Promise<{
+    totalTrades: number;
+    totalVolume: number;
+    buyCount: number;
+    sellCount: number;
+    firstTradeDate: Date;
+    lastTradeDate: Date;
+    uniqueMarkets: number;
+}>;
+/**
+ * Gets the most recent trade timestamp for a trader.
+ * Used for incremental syncing.
+ * @param traderId - The trader wallet address
+ * @returns Unix timestamp of most recent trade or null
+ */
+export declare function getLatestTradeTimestamp(traderId: string): Promise<number | null>;
+/**
+ * Gets aggregate sync status statistics.
+ * @returns Object with sync progress counts
+ */
+export declare function getSyncStatusStats(): Promise<{
+    pending: number;
+    in_progress: number;
+    completed: number;
+    error: number;
+    total: number;
+}>;
+//# sourceMappingURL=trade-history.d.ts.map

package/dist/prediction/db/trade-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-history.d.ts","sourceRoot":"","sources":["../../../src/prediction/db/trade-history.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,cAAc,EAAE,GAC3B,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC;IAC/D,mBAAmB,CAAC,EAAE,IAAI,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GACA,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;GAQxD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU1E;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;CACX;;;;;;;;;;;;;;;;;;;;;KAuBP;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM;;;;;;;;GAezD;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB;;;;;;GAuBvC"}