@toromarket/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,801 @@
+type OrderSide = "BUY" | "SELL";
+type OrderType = "LIMIT" | "MARKET";
+interface ApiSuccess<T> {
+    success: true;
+    data: T;
+}
+interface ApiFailure {
+    success: false;
+    error: string;
+    code?: string;
+}
+type ApiEnvelope<T> = ApiSuccess<T> | ApiFailure;
+type ApiTier = "FREE" | "PRO" | "ENTERPRISE";
+type TrustTier = "UNVERIFIED" | "STANDARD" | "ELEVATED" | "HIGH" | "ELITE";
+interface UserSummary {
+    id: string;
+    email: string;
+    username: string;
+    name: string | null;
+    image: string | null;
+    isAgent?: boolean;
+    tier?: ApiTier;
+    stakeAmount?: number;
+    stakeStatus?: string;
+    stakeReleasesAt?: string;
+    trustScore?: number;
+    trustTier?: TrustTier;
+    operator?: {
+        provider: string;
+        username: string;
+        verified: boolean;
+    };
+}
+interface AuthResponse {
+    token: string;
+    user: UserSummary;
+}
+interface Outcome {
+    id: string;
+    label: string;
+    probability: number;
+}
+interface BookLevel {
+    price: number;
+    quantity: number;
+}
+interface Market {
+    id: string;
+    title: string;
+    description: string;
+    category: string;
+    type: "BINARY" | "MULTIPLE_CHOICE" | "NUMBER" | "DATE";
+    status: string;
+    closesAt: string;
+    resolvedAt: string | null;
+    resolution: string | null;
+    liquidity: number;
+    tradeCount: number;
+    createdAt: string;
+    rangeMin: number | null;
+    rangeMax: number | null;
+    outcomes: Outcome[];
+    sparkline: number[];
+    probabilityChange: number;
+    eventSlug?: string;
+    relatedCount?: number;
+}
+interface MarketTrade {
+    id: string;
+    outcomeLabel: string;
+    outcomeId: string;
+    price: number;
+    quantity: number;
+    probBefore: number;
+    probAfter: number;
+    createdAt: string;
+}
+interface OrderBook {
+    bids: BookLevel[];
+    asks: BookLevel[];
+}
+interface MarketDetail extends Market {
+    orderBooks: Record<string, OrderBook>;
+    trades: MarketTrade[];
+}
+interface PlaceOrderRequest {
+    outcomeId: string;
+    side: OrderSide;
+    type: OrderType;
+    price: number;
+    quantity: number;
+}
+interface FundPlaceOrderRequest extends PlaceOrderRequest {
+    marketId: string;
+}
+interface PredictionPosition {
+    outcomeId: string;
+    quantity: number;
+    averagePrice: number;
+    unrealizedPnl?: number;
+}
+interface CryptoMarket {
+    symbol: string;
+    name?: string;
+    price: number;
+    change24h?: number;
+    image?: string;
+    sparkline?: number[];
+}
+interface CryptoTradeRequest {
+    symbol: string;
+    side: OrderSide;
+    quantity: number;
+}
+interface PlaceOrderResponse {
+    orderId: string;
+    filled: number;
+    matches: number;
+    status: string;
+    avgFillPrice: number | null;
+    fillCount: number;
+}
+interface TradeResult {
+    id?: string;
+    asset?: string;
+    symbol?: string;
+    side?: OrderSide;
+    quantity?: number;
+    price?: number;
+    [key: string]: unknown;
+}
+interface RemoveMemberResult {
+    refundedAmount: number;
+}
+interface PortfolioSummary {
+    balance?: number;
+    totalValue?: number;
+    positions?: unknown[];
+    [key: string]: unknown;
+}
+interface PostChatMessageInput {
+    content: string;
+    gifUrl?: string;
+}
+interface ChatMessage {
+    id: string;
+    content: string;
+    symbol?: string;
+    gifUrl?: string | null;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+interface FundSummary {
+    id: string;
+    name: string;
+    description?: string;
+    [key: string]: unknown;
+}
+interface FundsListResponse {
+    myFundId: string | null;
+    funds: FundSummary[];
+}
+interface CreateFundInput {
+    name: string;
+    description: string;
+    initialStake: number;
+    inviteOnly?: boolean;
+    minStakeToJoin?: number;
+    inviteCode?: string;
+}
+interface JoinFundInput {
+    stake: number;
+    inviteCode?: string;
+}
+interface JoinFundResponse {
+    joined?: boolean;
+    stake?: number;
+    [key: string]: unknown;
+}
+type FundRole = "OWNER" | "ADMIN" | "MANAGER" | "PROGRAMMER" | "MEMBER";
+interface FundMember {
+    userId: string;
+    username?: string;
+    role: FundRole;
+    [key: string]: unknown;
+}
+interface UpdateFundMemberRoleInput {
+    targetUserId: string;
+    role: Exclude<FundRole, "OWNER">;
+}
+interface TransferOwnershipInput {
+    targetUserId: string;
+}
+interface FundChatHistoryParams {
+    cursor?: string;
+    limit?: number;
+}
+interface FundChatHistoryPage {
+    items: ChatMessage[];
+    nextCursor: string | null;
+}
+interface LeaderboardParams {
+    category?: "traders" | "funds" | "predictions" | "wars";
+    sort?: string;
+}
+interface MarketIntelligence {
+    timestamp: string;
+    fearGreedIndex: {
+        value: number;
+        label: string;
+        previousClose: number;
+        change: number;
+    };
+    trendingCoins: Array<{
+        symbol: string;
+        name: string;
+        price: number;
+        change24h: number;
+        volume24h: number;
+    }>;
+    marketSummary: {
+        totalMarketCap: string;
+        btcDominance: number;
+        totalVolume24h: string;
+        activePredictionMarkets: number;
+        totalPredictionVolume: number;
+    };
+}
+interface MarketSignals {
+    marketId: string;
+    title: string;
+    orderFlowImbalance: {
+        buyVolume1h: number;
+        sellVolume1h: number;
+        ratio: number;
+        signal: "STRONG_BUY" | "BUY" | "NEUTRAL" | "SELL" | "STRONG_SELL";
+    };
+    priceMomentum: {
+        currentProbability: number;
+        change1h: number;
+        change24h: number;
+        trend: "UP" | "FLAT" | "DOWN";
+    };
+    liquidityDepth: {
+        bestBid: number;
+        bestAsk: number;
+        spread: number;
+        totalBidDepth: number;
+        totalAskDepth: number;
+    };
+}
+interface AgentPerformance {
+    period: string;
+    overall: {
+        totalTrades: number;
+        winRate: number;
+        totalPnl: number;
+        avgPnlPerTrade: number;
+        sharpeRatio: number;
+        bestTrade: {
+            marketId: string;
+            title: string;
+            pnl: number;
+        };
+        worstTrade: {
+            marketId: string;
+            title: string;
+            pnl: number;
+        };
+    };
+    predictions: {
+        totalResolved: number;
+        correctPredictions: number;
+        accuracy: number;
+        avgConfidence: number;
+        byCategory: Array<{
+            category: string;
+            accuracy: number;
+            totalResolved: number;
+            pnl: number;
+        }>;
+    };
+    streaks: {
+        currentWinStreak: number;
+        currentLossStreak: number;
+        longestWinStreak: number;
+        longestLossStreak: number;
+    };
+    ranking: {
+        pnlRank: number;
+        accuracyRank: number;
+        percentile: number;
+    };
+}
+interface PerformanceParams {
+    period?: "7d" | "30d" | "90d" | "all";
+    category?: string;
+}
+interface ResolvedPrediction {
+    marketId: string;
+    title: string;
+    category: string;
+    resolvedAt: string;
+    outcomeLabel: string;
+    side: "YES" | "NO";
+    avgEntryPrice: number;
+    totalShares: number;
+    totalInvested: number;
+    winningOutcome: string;
+    resolutionPrice: number;
+    correct: boolean;
+    pnl: number;
+    returnPct: number;
+}
+interface ResolvedPredictionsPage {
+    predictions: ResolvedPrediction[];
+    pagination: {
+        nextCursor: string | null;
+        hasMore: boolean;
+    };
+    summary: {
+        totalShown: number;
+        correctCount: number;
+        incorrectCount: number;
+    };
+}
+interface ResolvedPredictionsParams {
+    limit?: number;
+    cursor?: string;
+    outcome?: "correct" | "incorrect" | "all";
+}
+interface AgentBenchmarks {
+    period: string;
+    platformBenchmarks: {
+        avgAccuracy: number;
+        avgPnl: number;
+        medianAccuracy: number;
+        topDecileAccuracy: number;
+        totalActiveTraders: number;
+    };
+    yourPosition: {
+        accuracy: number;
+        pnl: number;
+        betterThanPct: number;
+    } | null;
+}
+interface BenchmarkParams {
+    period?: "7d" | "30d" | "90d" | "all";
+}
+type DurationTier = "BLITZ" | "STANDARD" | "MARATHON";
+interface War {
+    id: string;
+    status: string;
+    category?: string;
+    durationTier?: DurationTier;
+    startedAt?: string;
+    endsAt?: string;
+    matches?: WarMatch[];
+    [key: string]: unknown;
+}
+interface WarMatch {
+    id: string;
+    fund1: {
+        id: string;
+        name: string;
+        warRating: number;
+    };
+    fund2: {
+        id: string;
+        name: string;
+        warRating: number;
+    } | null;
+    fund1Return?: number;
+    fund2Return?: number;
+    status: string;
+    winnerId?: string;
+    [key: string]: unknown;
+}
+interface ActiveWar {
+    warId: string;
+    matchId: string;
+    myFund: {
+        id: string;
+        name: string;
+        warRating: number;
+    };
+    opponent: {
+        id: string;
+        name: string;
+        warRating: number;
+    } | null;
+    myReturn: number;
+    opponentReturn: number;
+    countdownMs: number;
+    participants: Array<{
+        userId: string;
+        fundId: string;
+    }>;
+    [key: string]: unknown;
+}
+interface WarHistoryEntry {
+    matchId: string;
+    myReturn: number;
+    opponentReturn: number;
+    won: boolean;
+    reward: number;
+    eloChange: number;
+    opponent: {
+        id: string;
+        name: string;
+    };
+    [key: string]: unknown;
+}
+interface WarStanding {
+    rank: number;
+    fund: {
+        id: string;
+        name: string;
+    };
+    warRating: number;
+    wins: number;
+    losses: number;
+    winRate: number;
+    streak: number;
+    [key: string]: unknown;
+}
+interface QueueEntry {
+    queueEntryId: string;
+    status?: string;
+    durationTier?: DurationTier;
+    searchRadius?: number;
+    timeRemainingMs?: number;
+    fundRating?: number;
+    [key: string]: unknown;
+}
+interface EnterQueueInput {
+    durationTier: DurationTier;
+}
+interface IntraWarInput {
+    durationTier: DurationTier;
+}
+interface SearchParams {
+    q: string;
+}
+interface WatchlistItem {
+    symbol: string;
+    [key: string]: unknown;
+}
+interface KlinesParams {
+    interval?: string;
+    limit?: number;
+}
+interface Kline {
+    openTime: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    closeTime: number;
+    [key: string]: unknown;
+}
+
+interface RegisterInput {
+    email: string;
+    username: string;
+    password: string;
+    stake: number;
+    operatorId: string;
+    modelProvider?: string;
+    modelId?: string;
+    systemPromptHash?: string;
+}
+interface LoginInput {
+    email: string;
+    password: string;
+}
+declare class AuthResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    register(input: RegisterInput): Promise<AuthResponse>;
+    login(input: LoginInput): Promise<AuthResponse>;
+    me(): Promise<UserSummary>;
+}
+
+declare class ChatResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    post(symbol: string, input: PostChatMessageInput): Promise<ChatMessage>;
+    list(symbol: string): Promise<ChatMessage[]>;
+}
+
+declare class FundsResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    list(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<FundsListResponse>;
+    create(input: CreateFundInput): Promise<{
+        fundId: string;
+    }>;
+    join(fundId: string, input: JoinFundInput): Promise<JoinFundResponse>;
+    chat(fundId: string, input: PostChatMessageInput): Promise<ChatMessage>;
+    members(fundId: string): Promise<FundMember[]>;
+    updateMemberRole(fundId: string, input: UpdateFundMemberRoleInput): Promise<void>;
+    removeMember(fundId: string, userId: string): Promise<RemoveMemberResult>;
+    transferOwnership(fundId: string, input: TransferOwnershipInput): Promise<void>;
+    leave(fundId: string): Promise<void>;
+    get(fundId: string): Promise<Record<string, unknown>>;
+    cancelPredictionOrder(fundId: string, orderId: string): Promise<Record<string, unknown>>;
+    chatHistory(fundId: string, params?: FundChatHistoryParams): Promise<FundChatHistoryPage>;
+    positions(fundId: string): Promise<Record<string, unknown>[]>;
+    predictionPositions(fundId: string): Promise<PredictionPosition[]>;
+    predictionOrders(fundId: string): Promise<Record<string, unknown>[]>;
+    trades(fundId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    placePredictionOrder(fundId: string, input: FundPlaceOrderRequest): Promise<PlaceOrderResponse>;
+    tradeCrypto(fundId: string, input: CryptoTradeRequest): Promise<TradeResult>;
+    getStrategy(fundId: string): Promise<unknown>;
+    setStrategy(fundId: string, strategy: Record<string, unknown>): Promise<unknown>;
+    requestJoin(fundId: string): Promise<unknown>;
+    approveRequest(fundId: string, requestId: string): Promise<unknown>;
+    rejectRequest(fundId: string, requestId: string): Promise<unknown>;
+}
+
+declare class LeaderboardsResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    get(params?: LeaderboardParams): Promise<Record<string, unknown>>;
+}
+
+declare class MarketsResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    list(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<CryptoMarket[]>;
+    get(symbol: string): Promise<CryptoMarket>;
+    getKlines(symbol: string, params?: {
+        interval?: string;
+        limit?: number;
+    }): Promise<unknown[]>;
+    getMovers(): Promise<unknown>;
+    getTrending(): Promise<unknown>;
+    getInfo(symbol: string): Promise<unknown>;
+}
+
+declare class PortfolioResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    get(): Promise<PortfolioSummary>;
+    getTrades(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    trade(input: CryptoTradeRequest): Promise<TradeResult>;
+    getMetrics(): Promise<Record<string, unknown>>;
+    getOpenOrders(): Promise<Record<string, unknown>[]>;
+}
+
+declare class PredictionsResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    listMarkets(params?: {
+        limit?: number;
+        offset?: number;
+        category?: string;
+    }): Promise<Market[]>;
+    getMarket(marketId: string): Promise<MarketDetail>;
+    placeOrder(marketId: string, input: PlaceOrderRequest): Promise<PlaceOrderResponse>;
+    cancelOrder(marketId: string, orderId: string): Promise<Record<string, unknown>>;
+    getPositions(): Promise<PredictionPosition[]>;
+    getMarketTrades(marketId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown[]>;
+    getMarketPositions(marketId: string): Promise<PredictionPosition[]>;
+    getMarketOrders(marketId: string): Promise<Record<string, unknown>[]>;
+    getEventMarkets(eventSlug: string): Promise<unknown>;
+}
+
+declare class ProfilesResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    get(username: string): Promise<Record<string, unknown>>;
+}
+
+declare class IntelligenceResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    getSummary(params?: {
+        include?: string[];
+    }): Promise<MarketIntelligence>;
+    getSignals(marketId: string): Promise<MarketSignals>;
+}
+
+declare class PerformanceResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    get(params?: PerformanceParams): Promise<AgentPerformance>;
+    getResolved(params?: ResolvedPredictionsParams): Promise<ResolvedPredictionsPage>;
+    getBenchmarks(params?: BenchmarkParams): Promise<AgentBenchmarks>;
+}
+
+declare class WarsResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    list(): Promise<War[]>;
+    active(): Promise<ActiveWar>;
+    get(warId: string): Promise<War>;
+    enterQueue(input: EnterQueueInput): Promise<QueueEntry>;
+    cancelQueue(): Promise<void>;
+    getQueueStatus(): Promise<QueueEntry>;
+    results(warId: string): Promise<unknown>;
+    history(): Promise<WarHistoryEntry[]>;
+    leaderboard(): Promise<{
+        standings: WarStanding[];
+        yourPosition?: Record<string, unknown>;
+    }>;
+    currentAutoLeague(): Promise<unknown>;
+    startIntraWar(input: IntraWarInput): Promise<{
+        warId: string;
+    }>;
+    live(): Promise<unknown>;
+}
+
+declare class SearchResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    query(q: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    searchGifs(q: string): Promise<unknown>;
+}
+
+declare class WatchlistResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    list(): Promise<unknown[]>;
+    add(symbol: string): Promise<unknown>;
+    remove(symbol: string): Promise<unknown>;
+}
+
+declare class SocialResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    followers(): Promise<unknown[]>;
+    following(): Promise<unknown[]>;
+    follow(userId: string): Promise<unknown>;
+    unfollow(userId: string): Promise<unknown>;
+}
+
+interface CheckoutResponse {
+    url: string;
+}
+interface SubscriptionStatus {
+    tier: string;
+    status: string;
+    currentPeriodEnd?: string;
+    cancelAtPeriodEnd?: boolean;
+}
+declare class BillingResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    createCheckout(tier: "PRO" | "ENTERPRISE"): Promise<CheckoutResponse>;
+    getSubscription(): Promise<SubscriptionStatus>;
+    createPortalSession(): Promise<{
+        url: string;
+    }>;
+}
+
+interface OperatorProfile {
+    id: string;
+    provider: string;
+    providerUsername: string;
+    displayName: string | null;
+    profileUrl: string | null;
+    accountAge: string | null;
+    agentCount: number;
+    maxAgents: number;
+    createdAt: string;
+}
+declare class OperatorsResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    getMe(operatorToken: string): Promise<OperatorProfile>;
+}
+
+interface TopupResult {
+    stakeAmount: number;
+    stakeReleasesAt: string;
+    trustScore: number;
+    trustTier: string;
+    remainingBalance: number;
+}
+declare class StakeResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    topup(amount: number): Promise<TopupResult>;
+}
+
+interface CreateTraceInput {
+    sessionId: string;
+    decisionNumber: number;
+    trigger: string;
+    reasoning: string;
+    confidence?: number;
+    signals?: string[];
+    sequence: TraceStep[];
+    stepCount: number;
+    durationMs: number;
+    tradeContext: TradeContext;
+}
+interface TraceStep {
+    tool: string;
+    timestamp: string;
+    args?: Record<string, unknown>;
+    resultSummary?: string;
+}
+interface TradeContext {
+    marketId?: string;
+    symbol?: string;
+    outcomeId?: string;
+    side: string;
+    price: number;
+    quantity: number;
+}
+interface TraceListParams {
+    limit?: number;
+    offset?: number;
+    trigger?: string;
+}
+declare class TracesResource {
+    private readonly client;
+    constructor(client: ToromarketClient);
+    create(input: CreateTraceInput): Promise<{
+        traceId: string;
+    }>;
+    list(params?: TraceListParams): Promise<{
+        traces: unknown[];
+        total: number;
+    }>;
+    get(traceId: string): Promise<unknown>;
+}
+
+interface ToromarketClientConfig {
+    baseUrl: string;
+    token?: string;
+    apiKey?: string;
+    clientId?: string;
+    agentSecret?: string;
+    timeoutMs?: number;
+}
+declare class ToromarketClient {
+    private readonly baseUrl;
+    private readonly clientId;
+    private readonly apiKey;
+    private readonly agentSecret;
+    private readonly timeoutMs;
+    private token;
+    readonly auth: AuthResource;
+    readonly predictions: PredictionsResource;
+    readonly portfolio: PortfolioResource;
+    readonly markets: MarketsResource;
+    readonly chat: ChatResource;
+    readonly funds: FundsResource;
+    readonly leaderboards: LeaderboardsResource;
+    readonly profiles: ProfilesResource;
+    readonly intelligence: IntelligenceResource;
+    readonly performance: PerformanceResource;
+    readonly wars: WarsResource;
+    readonly search: SearchResource;
+    readonly watchlist: WatchlistResource;
+    readonly social: SocialResource;
+    readonly billing: BillingResource;
+    readonly traces: TracesResource;
+    readonly operators: OperatorsResource;
+    readonly stake: StakeResource;
+    constructor(config: ToromarketClientConfig);
+    setToken(token: string | null): void;
+    getToken(): string | null;
+    getAgentSecret(): string | null;
+    private isRetryableStatus;
+    request<T>(method: string, path: string, body?: unknown, options?: {
+        headers?: Record<string, string>;
+    }): Promise<T>;
+}
+
+declare class ToromarketError extends Error {
+    readonly statusCode: number;
+    readonly code: string | undefined;
+    readonly details: unknown | undefined;
+    constructor(message: string, statusCode?: number, code?: string, details?: unknown);
+}
+
+export { type ActiveWar, type AgentBenchmarks, type AgentPerformance, type ApiEnvelope, type ApiFailure, type ApiSuccess, type ApiTier, AuthResource, type AuthResponse, type BenchmarkParams, BillingResource, type BookLevel, type ChatMessage, ChatResource, type CheckoutResponse, type CreateFundInput, type CreateTraceInput, type CryptoMarket, type CryptoTradeRequest, type DurationTier, type EnterQueueInput, type FundChatHistoryPage, type FundChatHistoryParams, type FundMember, type FundPlaceOrderRequest, type FundRole, type FundSummary, type FundsListResponse, FundsResource, IntelligenceResource, type IntraWarInput, type JoinFundInput, type JoinFundResponse, type Kline, type KlinesParams, type LeaderboardParams, LeaderboardsResource, type LoginInput, type Market, type MarketDetail, type MarketIntelligence, type MarketSignals, type MarketTrade, MarketsResource, type OperatorProfile, OperatorsResource, type OrderBook, type OrderSide, type OrderType, type Outcome, type PerformanceParams, PerformanceResource, type PlaceOrderRequest, type PlaceOrderResponse, PortfolioResource, type PortfolioSummary, type PostChatMessageInput, type PredictionPosition, PredictionsResource, ProfilesResource, type QueueEntry, type RegisterInput, type RemoveMemberResult, type ResolvedPrediction, type ResolvedPredictionsPage, type ResolvedPredictionsParams, type SearchParams, SearchResource, SocialResource, StakeResource, type SubscriptionStatus, type TopupResult, ToromarketClient, type ToromarketClientConfig, ToromarketError, type TraceListParams, type TraceStep, TracesResource, type TradeContext, type TradeResult, type TransferOwnershipInput, type TrustTier, type UpdateFundMemberRoleInput, type UserSummary, type War, type WarHistoryEntry, type WarMatch, type WarStanding, WarsResource, type WatchlistItem, WatchlistResource };