@rlajous/sdk-trading 1.0.0

package/dist/cjs/resources/trading-lite.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TradingLiteResource = void 0;
+const sdk_core_1 = require("@rlajous/sdk-core");
+/**
+ * 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}`);
+ * ```
+ */
+class TradingLiteResource {
+    httpClient;
+    // Note: defaultChain parameter accepted for consistency but not used
+    // since trading-lite only supports Solana
+    constructor(httpClient, _defaultChain) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * 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');
+     * }
+     * ```
+     */
+    async analyze(address, options = {}) {
+        // Trading lite only supports Solana - always use Chain.SOL
+        const chain = options.chain ?? sdk_core_1.Chain.SOL;
+        // Trading lite only supports Solana - validate address format
+        if (!(0, sdk_core_1.isValidSolanaAddress)(address)) {
+            throw new sdk_core_1.ValidationError(`Invalid Solana token address: "${address}". Trading Lite only supports Solana tokens. Please provide a valid base58 Solana address.`);
+        }
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        const response = await this.httpClient.get(`/trading-lite/${encodeURIComponent(address)}?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+}
+exports.TradingLiteResource = TradingLiteResource;
+//# sourceMappingURL=trading-lite.js.map

package/dist/cjs/resources/trading-lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-lite.js","sourceRoot":"","sources":["../../../src/resources/trading-lite.ts"],"names":[],"mappings":";;;AAAA,gDAM2B;AAG3B;;;;;;;;;;;;;;GAcG;AACH,MAAa,mBAAmB;IAIX;IAHnB,qEAAqE;IACrE,0CAA0C;IAC1C,YACmB,UAAsB,EACvC,aAAqB;QADJ,eAAU,GAAV,UAAU,CAAY;IAEtC,CAAC;IAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,UAA8B,EAAE;QAC7D,2DAA2D;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,gBAAK,CAAC,GAAG,CAAC;QAEzC,8DAA8D;QAC9D,IAAI,CAAC,IAAA,+BAAoB,EAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,0BAAe,CACvB,kCAAkC,OAAO,4FAA4F,CACtI,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAsC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAC3E,iBAAiB,kBAAkB,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,EACxE;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAzED,kDAyEC"}

package/dist/cjs/types/holder-analysis.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=holder-analysis.js.map

package/dist/cjs/types/holder-analysis.js.map

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

package/dist/cjs/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

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

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

package/dist/cjs/types/tokens.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tokens.js.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=trading-lite.js.map

package/dist/cjs/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/esm/client.js

@@ -0,0 +1,135 @@
+import { BaseClient, } 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 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
+     */
+    holderAnalysis;
+    /**
+     * Trading lite resource
+     *
+     * Provides quick, simplified token analysis optimized for trading decisions.
+     * Currently supports Solana only.
+     */
+    tradingLite;
+    /**
+     * Tokens resource
+     *
+     * Provides access to token pools and trending data.
+     */
+    tokens;
+    /**
+     * 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) {
+        super(config);
+        // Initialize resources with the HTTP client and default chain
+        this.holderAnalysis = new HolderAnalysisResource(this.httpClient, this.defaultChain);
+        this.tradingLite = new TradingLiteResource(this.httpClient, this.defaultChain);
+        this.tokens = new TokensResource(this.httpClient, this.defaultChain);
+    }
+    /**
+     * Add a request interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addRequestInterceptor((url, config) => {
+     *   console.log(`Making request to ${url}`);
+     *   return config;
+     * });
+     * ```
+     */
+    addRequestInterceptor(interceptor) {
+        super.addRequestInterceptor(interceptor);
+    }
+    /**
+     * Add a response interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addResponseInterceptor((response) => {
+     *   console.log(`Received ${response.status} response`);
+     *   return response;
+     * });
+     * ```
+     */
+    addResponseInterceptor(interceptor) {
+        super.addResponseInterceptor(interceptor);
+    }
+    /**
+     * Add an error interceptor
+     *
+     * @example
+     * ```typescript
+     * client.addErrorInterceptor((error) => {
+     *   console.error(`Request failed: ${error.message}`);
+     *   return error;
+     * });
+     * ```
+     */
+    addErrorInterceptor(interceptor) {
+        super.addErrorInterceptor(interceptor);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAKX,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,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C;;;;;;;;;OASG;IACa,cAAc,CAAyB;IAEvD;;;;;OAKG;IACa,WAAW,CAAsB;IAEjD;;;;OAIG;IACa,MAAM,CAAiB;IAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,YAAY,MAA0B;QACpC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,8DAA8D;QAC9D,IAAI,CAAC,cAAc,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACrF,IAAI,CAAC,WAAW,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/E,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;OAUG;IACM,qBAAqB,CAAC,WAA+B;QAC5D,KAAK,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;OAUG;IACM,sBAAsB,CAAC,WAAgC;QAC9D,KAAK,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;OAUG;IACM,mBAAmB,CAAC,WAA6B;QACxD,KAAK,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+// Client
+export { TradingClient } from './client';
+// Resources
+export { HolderAnalysisResource, TradingLiteResource, TokensResource } from './resources';
+// Re-export commonly used types from core
+export { Chain, ChainCompatibility, isEvmChain, CHAIN_NAMES, WebacyError, AuthenticationError, RateLimitError, ValidationError, NotFoundError, NetworkError, } from '@rlajous/sdk-core';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,YAAY;AACZ,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgC1F,0CAA0C;AAC1C,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,GAKb,MAAM,mBAAmB,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/esm/resources/holder-analysis.js

@@ -0,0 +1,98 @@
+import { ValidationError, isValidAddress, CHAIN_NAMES, } from '@rlajous/sdk-core';
+/**
+ * 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 class HolderAnalysisResource {
+    httpClient;
+    defaultChain;
+    constructor(httpClient, defaultChain) {
+        this.httpClient = httpClient;
+        this.defaultChain = defaultChain;
+    }
+    /**
+     * Resolve the chain to use for a request
+     * @throws ValidationError if no chain is specified and no default is set
+     */
+    resolveChain(options) {
+        const chain = options?.chain ?? this.defaultChain;
+        if (!chain) {
+            throw new ValidationError('Chain is required. Either specify chain in options or set defaultChain in client configuration.');
+        }
+        return chain;
+    }
+    /**
+     * 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`);
+     * }
+     * ```
+     */
+    async get(address, options = {}) {
+        const chain = this.resolveChain(options);
+        // Validate token address format before making API call
+        if (!isValidAddress(address, chain)) {
+            const chainName = CHAIN_NAMES[chain] || chain;
+            throw new ValidationError(`Invalid ${chainName} token address: "${address}". Please provide a valid token address format for the ${chainName} blockchain.`);
+        }
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        if (options.disableRefetch !== undefined) {
+            queryParams.append('disableRefetch', String(options.disableRefetch));
+        }
+        const response = await this.httpClient.get(`/holder-analysis/${encodeURIComponent(address)}?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=holder-analysis.js.map

package/dist/esm/resources/holder-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"holder-analysis.js","sourceRoot":"","sources":["../../../src/resources/holder-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EACf,cAAc,EACd,WAAW,GAEZ,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,sBAAsB;IAEd;IACA;IAFnB,YACmB,UAAsB,EACtB,YAAoB;QADpB,eAAU,GAAV,UAAU,CAAY;QACtB,iBAAY,GAAZ,YAAY,CAAQ;IACpC,CAAC;IAEJ;;;OAGG;IACK,YAAY,CAAC,OAA2B;QAC9C,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAClD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,eAAe,CACvB,iGAAiG,CAClG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,UAAiC,EAAE;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,uDAAuD;QACvD,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;YAC9C,MAAM,IAAI,eAAe,CACvB,WAAW,SAAS,oBAAoB,OAAO,0DAA0D,SAAS,cAAc,CACjI,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnC,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACzC,WAAW,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,QAAQ,GAAuC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAC5E,oBAAoB,kBAAkB,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,EAC3E;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/esm/resources/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/esm/resources/tokens.js

@@ -0,0 +1,171 @@
+import { ValidationError, isValidAddress, CHAIN_NAMES, } from '@rlajous/sdk-core';
+/**
+ * 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 class TokensResource {
+    httpClient;
+    defaultChain;
+    constructor(httpClient, defaultChain) {
+        this.httpClient = httpClient;
+        this.defaultChain = defaultChain;
+    }
+    /**
+     * Resolve the chain to use for a request
+     * @throws ValidationError if no chain is specified and no default is set
+     */
+    resolveChain(options) {
+        const chain = options?.chain ?? this.defaultChain;
+        if (!chain) {
+            throw new ValidationError('Chain is required. Either specify chain in options or set defaultChain in client configuration.');
+        }
+        return chain;
+    }
+    /**
+     * 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}`);
+     *   }
+     * }
+     * ```
+     */
+    async getPools(address, options = {}) {
+        const chain = this.resolveChain(options);
+        // Validate token address format before making API call
+        if (!isValidAddress(address, chain)) {
+            const chainName = CHAIN_NAMES[chain] || chain;
+            throw new ValidationError(`Invalid ${chainName} token address: "${address}". Please provide a valid token address format for the ${chainName} blockchain.`);
+        }
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        const response = await this.httpClient.get(`/tokens/${encodeURIComponent(address)}/pools?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+    /**
+     * 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');
+     *   }
+     * }
+     * ```
+     */
+    async getTrending(options = {}) {
+        const queryParams = new URLSearchParams();
+        const chain = options.chain ?? this.defaultChain;
+        if (chain) {
+            queryParams.append('chain', chain);
+        }
+        if (options.limit !== undefined) {
+            queryParams.append('limit', String(options.limit));
+        }
+        const queryString = queryParams.toString();
+        const path = queryString ? `/tokens/trending?${queryString}` : '/tokens/trending';
+        const response = await this.httpClient.get(path, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+    /**
+     * 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}`);
+     * }
+     * ```
+     */
+    async getTrendingPools(options = {}) {
+        const queryParams = new URLSearchParams();
+        const chain = options.chain ?? this.defaultChain;
+        if (chain) {
+            queryParams.append('chain', chain);
+        }
+        if (options.limit !== undefined) {
+            queryParams.append('limit', String(options.limit));
+        }
+        const queryString = queryParams.toString();
+        const path = queryString ? `/tokens/pools/trending?${queryString}` : '/tokens/pools/trending';
+        const response = await this.httpClient.get(path, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=tokens.js.map

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

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

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

@@ -0,0 +1,81 @@
+import { ValidationError, isValidSolanaAddress, Chain, } from '@rlajous/sdk-core';
+/**
+ * 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 class TradingLiteResource {
+    httpClient;
+    // Note: defaultChain parameter accepted for consistency but not used
+    // since trading-lite only supports Solana
+    constructor(httpClient, _defaultChain) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * 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');
+     * }
+     * ```
+     */
+    async analyze(address, options = {}) {
+        // Trading lite only supports Solana - always use Chain.SOL
+        const chain = options.chain ?? Chain.SOL;
+        // Trading lite only supports Solana - validate address format
+        if (!isValidSolanaAddress(address)) {
+            throw new ValidationError(`Invalid Solana token address: "${address}". Trading Lite only supports Solana tokens. Please provide a valid base58 Solana address.`);
+        }
+        const queryParams = new URLSearchParams();
+        queryParams.append('chain', chain);
+        const response = await this.httpClient.get(`/trading-lite/${encodeURIComponent(address)}?${queryParams.toString()}`, {
+            timeout: options.timeout,
+            signal: options.signal,
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=trading-lite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trading-lite.js","sourceRoot":"","sources":["../../../src/resources/trading-lite.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EACf,oBAAoB,EACpB,KAAK,GACN,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,mBAAmB;IAIX;IAHnB,qEAAqE;IACrE,0CAA0C;IAC1C,YACmB,UAAsB,EACvC,aAAqB;QADJ,eAAU,GAAV,UAAU,CAAY;IAEtC,CAAC;IAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,UAA8B,EAAE;QAC7D,2DAA2D;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC;QAEzC,8DAA8D;QAC9D,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,eAAe,CACvB,kCAAkC,OAAO,4FAA4F,CACtI,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAsC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAC3E,iBAAiB,kBAAkB,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,EACxE;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/esm/types/holder-analysis.js

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

package/dist/esm/types/holder-analysis.js.map

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

package/dist/esm/types/index.js

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