@rlajous/sdk-trading 1.0.0

package/dist/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/esm/types/tokens.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tokens.js.map

package/dist/esm/types/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/types/tokens.ts"],"names":[],"mappings":""}

package/dist/esm/types/trading-lite.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trading-lite.js.map

package/dist/esm/types/trading-lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-lite.js","sourceRoot":"","sources":["../../../src/types/trading-lite.ts"],"names":[],"mappings":""}

package/dist/types/client.d.ts

@@ -0,0 +1,123 @@
+import { BaseClient, WebacyClientConfig, RequestInterceptor, ResponseInterceptor, ErrorInterceptor } from '@rlajous/sdk-core';
+import { HolderAnalysisResource } from './resources/holder-analysis';
+import { TradingLiteResource } from './resources/trading-lite';
+import { TokensResource } from './resources/tokens';
+/**
+ * Webacy Trading SDK Client
+ *
+ * Provides access to token trading analysis including holder analysis,
+ * sniper/bundler detection, and trending tokens.
+ *
+ * @example
+ * ```typescript
+ * import { TradingClient, Chain } from '@rlajous/sdk-trading';
+ *
+ * const client = new TradingClient({
+ *   apiKey: process.env.WEBACY_API_KEY!,
+ * });
+ *
+ * // Comprehensive holder analysis
+ * const holders = await client.holderAnalysis.get('token_address', {
+ *   chain: 'sol',
+ * });
+ *
+ * // Quick trading analysis (Solana)
+ * const trading = await client.tradingLite.analyze('pump_token');
+ *
+ * // Token pools and trending
+ * const pools = await client.tokens.getPools('token_address', { chain: 'eth' });
+ * ```
+ */
+export declare class TradingClient extends BaseClient {
+    /**
+     * Holder analysis resource
+     *
+     * Provides comprehensive analysis of token holder distribution including:
+     * - Top holders and concentration metrics
+     * - First buyers analysis
+     * - Sniper detection with confidence scoring
+     * - Bundler detection
+     * - Developer wallet tracking
+     */
+    readonly holderAnalysis: HolderAnalysisResource;
+    /**
+     * Trading lite resource
+     *
+     * Provides quick, simplified token analysis optimized for trading decisions.
+     * Currently supports Solana only.
+     */
+    readonly tradingLite: TradingLiteResource;
+    /**
+     * Tokens resource
+     *
+     * Provides access to token pools and trending data.
+     */
+    readonly tokens: TokensResource;
+    /**
+     * Create a new TradingClient instance
+     *
+     * @param config - Client configuration
+     * @throws AuthenticationError if API key is not provided
+     *
+     * @example
+     * ```typescript
+     * // Basic setup
+     * const client = new TradingClient({
+     *   apiKey: 'your-api-key',
+     * });
+     *
+     * // With default chain (omit chain in API calls)
+     * const client = new TradingClient({
+     *   apiKey: 'your-api-key',
+     *   defaultChain: Chain.SOL,
+     * });
+     *
+     * // With custom configuration
+     * const client = new TradingClient({
+     *   apiKey: 'your-api-key',
+     *   timeout: 60000,
+     *   retry: {
+     *     maxRetries: 5,
+     *   },
+     * });
+     * ```
+     */
+    constructor(config: WebacyClientConfig);
+    /**
+     * Add a request interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addRequestInterceptor((url, config) => {
+     *   console.log(`Making request to ${url}`);
+     *   return config;
+     * });
+     * ```
+     */
+    addRequestInterceptor(interceptor: RequestInterceptor): void;
+    /**
+     * Add a response interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addResponseInterceptor((response) => {
+     *   console.log(`Received ${response.status} response`);
+     *   return response;
+     * });
+     * ```
+     */
+    addResponseInterceptor(interceptor: ResponseInterceptor): void;
+    /**
+     * Add an error interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addErrorInterceptor((error) => {
+     *   console.error(`Request failed: ${error.message}`);
+     *   return error;
+     * });
+     * ```
+     */
+    addErrorInterceptor(interceptor: ErrorInterceptor): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C;;;;;;;;;OASG;IACH,SAAgB,cAAc,EAAE,sBAAsB,CAAC;IAEvD;;;;;OAKG;IACH,SAAgB,WAAW,EAAE,mBAAmB,CAAC;IAEjD;;;;OAIG;IACH,SAAgB,MAAM,EAAE,cAAc,CAAC;IAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;gBACS,MAAM,EAAE,kBAAkB;IAStC;;;;;;;;;;OAUG;IACM,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAIrE;;;;;;;;;;OAUG;IACM,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAIvE;;;;;;;;;;OAUG;IACM,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI;CAGlE"}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export { TradingClient } from './client';
+export { HolderAnalysisResource, TradingLiteResource, TokensResource } from './resources';
+export type { TokenHolder, TokenHolderActivity, BuyerHolding, FirstBuyersAnalysis, BlockRangeAnalysis, TimeSinceMintAnalysis, SniperAnalysis, ActivityPatterns, HolderAnalysisResult, HolderAnalysisOptions, AddressHolding, TradingLiteAnalysis, TradingLiteOptions, VolumeData, PoolData, TokenWithRisk, TokenRiskSummary, PoolsResponse, TrendingToken, TrendingTokensResponse, TrendingPoolsResponse, TokenPoolsOptions, TrendingOptions, } from './types';
+export { Chain, ChainCompatibility, isEvmChain, CHAIN_NAMES, WebacyError, AuthenticationError, RateLimitError, ValidationError, NotFoundError, NetworkError, type WebacyClientConfig, type TokenMetadata, type OwnershipDistribution, type TopHolder, } from '@rlajous/sdk-core';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG1F,YAAY,EAEV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EAErB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAElB,UAAU,EACV,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAC"}

package/dist/types/resources/holder-analysis.d.ts

@@ -0,0 +1,73 @@
+import { HttpClient, Chain } from '@rlajous/sdk-core';
+import { HolderAnalysisResult, HolderAnalysisOptions } from '../types';
+/**
+ * Resource for token holder analysis
+ *
+ * Provides comprehensive analysis of token holder distribution including:
+ * - Top holders and concentration metrics
+ * - First buyers analysis
+ * - Sniper detection with confidence scoring
+ * - Bundler detection
+ * - Developer wallet tracking
+ *
+ * @example
+ * ```typescript
+ * const analysis = await client.holderAnalysis.get('token_address', {
+ *   chain: Chain.SOL,
+ * });
+ * console.log(`Sniper count: ${analysis.sniper_analysis?.sniper_count}`);
+ *
+ * // With default chain configured, chain can be omitted
+ * const client = new TradingClient({ apiKey: '...', defaultChain: Chain.SOL });
+ * const analysis = await client.holderAnalysis.get('token_address'); // Uses SOL
+ * ```
+ */
+export declare class HolderAnalysisResource {
+    private readonly httpClient;
+    private readonly defaultChain?;
+    constructor(httpClient: HttpClient, defaultChain?: Chain | undefined);
+    /**
+     * Resolve the chain to use for a request
+     * @throws ValidationError if no chain is specified and no default is set
+     */
+    private resolveChain;
+    /**
+     * Get comprehensive holder analysis for a token
+     *
+     * Returns detailed analysis including:
+     * - Token holder distribution
+     * - First buyers analysis with bundler detection
+     * - Sniper detection with confidence scoring
+     * - Top 10 holders concentration
+     * - Developer activity metrics
+     *
+     * @param address - Token address to analyze
+     * @param options - Request options (chain is optional if defaultChain is set)
+     * @returns Complete holder analysis result
+     *
+     * @example
+     * ```typescript
+     * // Solana token analysis
+     * const result = await client.holderAnalysis.get('pump_token_address', {
+     *   chain: Chain.SOL,
+     * });
+     *
+     * // With default chain configured
+     * const result = await client.holderAnalysis.get('pump_token_address');
+     *
+     * // Check sniper activity
+     * if (result.sniper_analysis?.sniper_count > 0) {
+     *   console.log(`Found ${result.sniper_analysis.sniper_count} snipers`);
+     *   console.log(`Sniper confidence: ${result.sniper_analysis.sniper_confidence_score}`);
+     * }
+     *
+     * // Check bundler activity
+     * const bundledBuyers = result.first_buyers_analysis.bundled_buyers_count;
+     * if (bundledBuyers && bundledBuyers > 0) {
+     *   console.log(`Found ${bundledBuyers} bundled buyers`);
+     * }
+     * ```
+     */
+    get(address: string, options?: HolderAnalysisOptions): Promise<HolderAnalysisResult>;
+}
+//# sourceMappingURL=holder-analysis.d.ts.map

package/dist/types/resources/holder-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"holder-analysis.d.ts","sourceRoot":"","sources":["../../../src/resources/holder-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAKV,KAAK,EACN,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBADb,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,KAAK,YAAA;IAGvC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA4B/F"}

package/dist/types/resources/index.d.ts

@@ -0,0 +1,4 @@
+export { HolderAnalysisResource } from './holder-analysis';
+export { TradingLiteResource } from './trading-lite';
+export { TokensResource } from './tokens';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/resources/tokens.d.ts

@@ -0,0 +1,117 @@
+import { HttpClient, Chain } from '@rlajous/sdk-core';
+import { PoolsResponse, TrendingTokensResponse, TrendingPoolsResponse, TokenPoolsOptions, TrendingOptions } from '../types';
+/**
+ * Resource for token pools and trending data
+ *
+ * Provides access to:
+ * - Token liquidity pools with risk analysis
+ * - Trending tokens across chains
+ * - Trending liquidity pools
+ *
+ * @example
+ * ```typescript
+ * // Get trending tokens
+ * const trending = await client.tokens.getTrending({ chain: Chain.SOL });
+ *
+ * // Get pools for a specific token
+ * const pools = await client.tokens.getPools('token_address', { chain: Chain.ETH });
+ *
+ * // With default chain configured, chain can be omitted
+ * const client = new TradingClient({ apiKey: '...', defaultChain: Chain.SOL });
+ * const pools = await client.tokens.getPools('token_address'); // Uses SOL
+ * ```
+ */
+export declare class TokensResource {
+    private readonly httpClient;
+    private readonly defaultChain?;
+    constructor(httpClient: HttpClient, defaultChain?: Chain | undefined);
+    /**
+     * Resolve the chain to use for a request
+     * @throws ValidationError if no chain is specified and no default is set
+     */
+    private resolveChain;
+    /**
+     * Get liquidity pools for a token with risk analysis
+     *
+     * Returns all liquidity pools where the token is traded,
+     * along with risk analysis for the tokens in each pool.
+     *
+     * @param address - Token address
+     * @param options - Request options (chain is optional if defaultChain is set)
+     * @returns Pools with token risk analysis
+     *
+     * @example
+     * ```typescript
+     * const result = await client.tokens.getPools('0x...', { chain: Chain.ETH });
+     *
+     * // With default chain configured
+     * const result = await client.tokens.getPools('0x...');
+     *
+     * for (const pool of result.pools) {
+     *   console.log(`Pool: ${pool.name}`);
+     *   console.log(`Liquidity: ${pool.reserve}`);
+     *   console.log(`24h Volume: ${pool.volume.h24}`);
+     * }
+     *
+     * // Check risk for tokens in pools
+     * for (const token of result.tokens) {
+     *   if (token.risk.overallRisk && token.risk.overallRisk > 70) {
+     *     console.warn(`High risk token: ${token.address}`);
+     *   }
+     * }
+     * ```
+     */
+    getPools(address: string, options?: TokenPoolsOptions): Promise<PoolsResponse>;
+    /**
+     * Get trending tokens
+     *
+     * Returns currently trending tokens based on trading activity
+     * and community interest.
+     *
+     * @param options - Request options (chain is optional)
+     * @returns List of trending tokens with risk analysis
+     *
+     * @example
+     * ```typescript
+     * const trending = await client.tokens.getTrending({ chain: Chain.SOL, limit: 20 });
+     *
+     * // Or with default chain configured
+     * const trending = await client.tokens.getTrending();
+     *
+     * for (const token of trending.tokens) {
+     *   console.log(`${token.symbol}: $${token.price_usd}`);
+     *   console.log(`24h change: ${token.price_change_24h}%`);
+     *
+     *   if (token.risk?.overallRisk && token.risk.overallRisk > 50) {
+     *     console.warn('  Warning: Elevated risk');
+     *   }
+     * }
+     * ```
+     */
+    getTrending(options?: TrendingOptions): Promise<TrendingTokensResponse>;
+    /**
+     * Get trending liquidity pools
+     *
+     * Returns currently trending liquidity pools based on
+     * trading volume and activity.
+     *
+     * @param options - Request options (chain is optional)
+     * @returns List of trending pools
+     *
+     * @example
+     * ```typescript
+     * const trending = await client.tokens.getTrendingPools({ chain: Chain.ETH });
+     *
+     * // Or with default chain configured
+     * const trending = await client.tokens.getTrendingPools();
+     *
+     * for (const pool of trending.pools) {
+     *   console.log(`${pool.name}`);
+     *   console.log(`FDV: ${pool.fdv}`);
+     *   console.log(`24h Volume: ${pool.volume.h24}`);
+     * }
+     * ```
+     */
+    getTrendingPools(options?: TrendingOptions): Promise<TrendingPoolsResponse>;
+}
+//# sourceMappingURL=tokens.d.ts.map

package/dist/types/resources/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/resources/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAKV,KAAK,EACN,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBADb,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,KAAK,YAAA;IAGvC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBxF;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,WAAW,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAsBjF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,gBAAgB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAqBtF"}

package/dist/types/resources/trading-lite.d.ts

@@ -0,0 +1,64 @@
+import { HttpClient, Chain } from '@rlajous/sdk-core';
+import { TradingLiteAnalysis, TradingLiteOptions } from '../types';
+/**
+ * Resource for simplified trading analysis
+ *
+ * Provides quick, simplified token analysis optimized for trading decisions.
+ * Returns only the most critical fields needed to assess token safety.
+ *
+ * Currently supports Solana only.
+ *
+ * @example
+ * ```typescript
+ * const analysis = await client.tradingLite.analyze('token_address');
+ * console.log(`Sniper % on launch: ${analysis.SniperPercentageOnLaunch}`);
+ * console.log(`Bundler % holding: ${analysis.BundlerPercentageHolding}`);
+ * ```
+ */
+export declare class TradingLiteResource {
+    private readonly httpClient;
+    constructor(httpClient: HttpClient, _defaultChain?: Chain);
+    /**
+     * Get simplified bundling and sniper analysis for a token
+     *
+     * Returns critical trading metrics including:
+     * - Sniper and bundler detection with percentages
+     * - Top 10 holder concentration
+     * - Developer activity (holdings, 24h launches)
+     * - Token security flags (mintable, freezable)
+     * - DexScreener paid status
+     *
+     * Optimized for performance with caching:
+     * - First call: Runs full analysis and persists data
+     * - Subsequent calls: Returns cached static data with real-time holdings
+     *
+     * @param address - Token address to analyze (Solana only)
+     * @param options - Request options
+     * @returns Simplified bundling analysis
+     *
+     * @example
+     * ```typescript
+     * const analysis = await client.tradingLite.analyze('pump_token_address');
+     *
+     * // Quick safety check
+     * const isRisky =
+     *   analysis.SniperPercentageOnLaunch > 20 ||
+     *   analysis.BundlerPercentageOnLaunch > 30 ||
+     *   analysis.DevLaunched24Hours > 5;
+     *
+     * if (isRisky) {
+     *   console.warn('Token shows high-risk indicators');
+     * }
+     *
+     * // Check token permissions
+     * if (analysis.mintable) {
+     *   console.warn('Token supply can still be increased');
+     * }
+     * if (analysis.freezable) {
+     *   console.warn('Token accounts can be frozen');
+     * }
+     * ```
+     */
+    analyze(address: string, options?: TradingLiteOptions): Promise<TradingLiteAnalysis>;
+}
+//# sourceMappingURL=trading-lite.d.ts.map

package/dist/types/resources/trading-lite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-lite.d.ts","sourceRoot":"","sources":["../../../src/resources/trading-lite.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAIV,KAAK,EACN,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU,EACvC,aAAa,CAAC,EAAE,KAAK;IAGvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAwB/F"}

package/dist/types/types/holder-analysis.d.ts

@@ -0,0 +1,214 @@
+import { Chain, OwnershipDistribution, TokenMetadata } from '@rlajous/sdk-core';
+/**
+ * Token holder information
+ */
+export interface TokenHolder {
+    /** Holder wallet address */
+    address: string;
+    /** Token balance */
+    balance: number;
+    /** Percentage of total supply */
+    supply_percentage: number;
+    /** Raw balance as string for large numbers */
+    rawBalance?: string;
+    /** Enhanced activity data (EVM chains) */
+    activity?: TokenHolderActivity;
+}
+/**
+ * Enhanced holder activity data (available for EVM chains)
+ */
+export interface TokenHolderActivity {
+    firstTransactionDate?: Date;
+    lastTransactionDate?: Date;
+    totalIncomingTransactions?: number;
+    totalIncomingAmount?: number;
+    totalOutgoingTransactions?: number;
+    totalOutgoingAmount?: number;
+    netFlow?: number;
+    tradingFrequency?: number;
+    isActiveTrader?: boolean;
+    retentionDays?: number;
+    avgIncomingSize?: number;
+    avgOutgoingSize?: number;
+    daysSinceLastActivity?: number;
+    holderClassification?: string;
+    balanceDiscrepancy?: boolean;
+    reportedBalance?: number;
+    calculatedBalance?: number;
+}
+/**
+ * Current holding information for a buyer
+ */
+export interface BuyerHolding {
+    /** Wallet address */
+    address: string;
+    /** Current token balance */
+    balance: number;
+    /** Current percentage of total supply */
+    supply_percentage: number;
+    /** Whether this buyer is a bundler */
+    is_bundler?: boolean;
+    /** Whether this buyer is a sniper */
+    is_sniper?: boolean;
+    /** Whether this is a developer wallet */
+    is_developer?: boolean;
+}
+/**
+ * First buyers analysis result
+ */
+export interface FirstBuyersAnalysis {
+    /** Percentage of supply initially acquired by first buyers */
+    initially_acquired_percentage: number;
+    /** Total number of first traders analyzed */
+    buyers_analyzed_count: number;
+    /** Actual number of unique buyers */
+    unique_buyers_count?: number;
+    /** True when unique_buyers_count < 20 */
+    buyer_segmentation_limited?: boolean;
+    /** Percentage bought by top 10 buyers */
+    top_10_buyers_bought_percentage: number;
+    /** Percentage bought by top 5 buyers */
+    top_5_buyers_bought_percentage: number;
+    /** Percentage bought by top 20 buyers */
+    top_20_buyers_bought_percentage: number;
+    /** Percentage bought in the same block */
+    bundled_percentage_supply_bought?: number;
+    /** Number of buys in the same block */
+    buys_in_same_block_count?: number;
+    /** Current holding percentage of first buyers */
+    current_holding_percentage: number | null;
+    /** Current holding percentage of bundled buyers */
+    bundled_current_holding_percentage?: number | null;
+    /** Number of first buyers still holding */
+    buyers_still_holding_count: number | null;
+    /** Number of bundled buyers still holding */
+    bundled_buyers_still_holding_count: number | null;
+    /** Average percentage held by bundler buyers */
+    average_percentage_bundler_buyer: number | null;
+    /** Count of first buyers who transferred out */
+    buyers_transferred_out_count: number | null;
+    /** Distinct addresses that received supply */
+    distributed_to_distinct_addresses_count: number;
+    /** Percentage transferred out by first buyers */
+    transferred_out_from_initially_acquired_percentage: number | null;
+    /** Number of buyers in the same block */
+    bundled_buyers_count: number | null;
+    /** Complete list of ALL bundled addresses (including sold out) */
+    all_bundled_addresses: string[];
+    /** Timestamp of analysis */
+    timestamp: string;
+    /** Current percentage per initial buyer */
+    current_percentage_per_buyer: BuyerHolding[];
+    /** Percentage currently held by snipers */
+    snipers_current_holding_percentage: number | null;
+    /** Number of snipers still holding */
+    snipers_still_holding_count: number | null;
+    /** Percentage held by snipers still holding */
+    snipers_still_holding_percentage: number | null;
+    /** Percentage held by development team */
+    dev_holdings_percentage?: number | null;
+}
+/**
+ * Block range analysis for sniper detection
+ */
+export interface BlockRangeAnalysis {
+    block_hash: string;
+    timestamp: string;
+    buy_count: number;
+    block_number: number;
+    addresses: string[];
+    supply_percentage: number;
+}
+/**
+ * Time since mint analysis
+ */
+export interface TimeSinceMintAnalysis {
+    time_range_seconds: number;
+    buy_count: number;
+    addresses: string[];
+    supply_percentage: number;
+}
+/**
+ * Sniper detection analysis result
+ */
+export interface SniperAnalysis {
+    /** List of identified sniper addresses */
+    sniper_addresses: string[];
+    /** Total number of snipers detected */
+    sniper_count: number;
+    /** Total percentage held by snipers */
+    sniper_total_percentage: number;
+    /** Analysis by block range */
+    block_range_analysis: BlockRangeAnalysis[];
+    /** Analysis by time since mint */
+    time_since_mint_analysis: TimeSinceMintAnalysis[];
+    /** Average time since mint in seconds */
+    average_time_since_mint: number;
+    /** Median time since mint in seconds */
+    median_time_since_mint: number;
+    /** Whether frontrunning was detected */
+    potential_frontrunning_detected: boolean;
+    /** Confidence score (0-100) */
+    sniper_confidence_score: number;
+}
+/**
+ * Activity patterns analysis (EVM chains)
+ */
+export interface ActivityPatterns {
+    earlyAdopters: TokenHolder[];
+    activeTraders: TokenHolder[];
+    longTermHolders: TokenHolder[];
+    recentBuyers: TokenHolder[];
+    suspiciousPatterns: {
+        highFrequencyTraders: TokenHolder[];
+        sameTimeBuyers: TokenHolder[];
+        unusualFlow: TokenHolder[];
+    };
+}
+/**
+ * Complete holder analysis result
+ */
+export interface HolderAnalysisResult {
+    /** Token address */
+    token_address: string;
+    /** Total number of holders */
+    total_holders_count?: number;
+    /** Token mint transaction hash */
+    token_mint_tx?: string;
+    /** Token mint timestamp */
+    token_mint_time?: string;
+    /** Minter/deployer address */
+    minter?: string;
+    /** Total supply used for calculations */
+    total_supply?: number;
+    /** Token metadata */
+    metadata?: TokenMetadata;
+    /** First buyers analysis */
+    first_buyers_analysis: FirstBuyersAnalysis;
+    /** Top 10 holders analysis */
+    top_10_holders_analysis?: OwnershipDistribution;
+    /** Tokens launched by developer in 24h */
+    dev_launched_tokens_in_24_hours?: number | null;
+    /** Sniper detection analysis */
+    sniper_analysis?: SniperAnalysis;
+    /** Activity patterns (EVM chains) */
+    activity_patterns?: ActivityPatterns;
+}
+/**
+ * Options for holder analysis requests
+ */
+export interface HolderAnalysisOptions {
+    /**
+     * Target blockchain
+     *
+     * Optional if `defaultChain` was set in the client configuration.
+     */
+    chain?: Chain;
+    /** Skip cache and force fresh fetch */
+    disableRefetch?: boolean;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Abort signal */
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=holder-analysis.d.ts.map

package/dist/types/types/holder-analysis.d.ts.map

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

package/dist/types/types/index.d.ts

@@ -0,0 +1,4 @@
+export type { TokenHolder, TokenHolderActivity, BuyerHolding, FirstBuyersAnalysis, BlockRangeAnalysis, TimeSinceMintAnalysis, SniperAnalysis, ActivityPatterns, HolderAnalysisResult, HolderAnalysisOptions, } from './holder-analysis';
+export type { AddressHolding, TradingLiteAnalysis, TradingLiteOptions } from './trading-lite';
+export type { VolumeData, PoolData, TokenWithRisk, TokenRiskSummary, PoolsResponse, TrendingToken, TrendingTokensResponse, TrendingPoolsResponse, TokenPoolsOptions, TrendingOptions, } from './tokens';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE9F,YAAY,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,UAAU,CAAC"}