@rlajous/sdk-trading 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Webacy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,160 @@
+# @rlajous/sdk-trading
+
+Token trading analysis SDK for the Webacy Risk Score API. Analyze token holder distribution, detect snipers and bundlers, and identify trading patterns.
+
+## Installation
+
+```bash
+npm install @rlajous/sdk-trading
+```
+
+Or install the full SDK:
+
+```bash
+npm install @rlajous/sdk
+```
+
+## Quick Start
+
+```typescript
+import { TradingClient } from '@rlajous/sdk-trading';
+
+const client = new TradingClient({
+  apiKey: process.env.WEBACY_API_KEY!,
+});
+
+// Analyze token holder distribution
+const holders = await client.holderAnalysis.get('token_address', {
+  chain: 'sol',
+});
+
+console.log(`Sniper count: ${holders.sniper_analysis?.sniper_count}`);
+console.log(`Bundled buyers: ${holders.first_buyers_analysis.bundled_buyers_count}`);
+```
+
+## Features
+
+### Holder Analysis
+
+Comprehensive token holder distribution analysis with sniper and bundler detection.
+
+```typescript
+const holders = await client.holderAnalysis.get('token_address', {
+  chain: 'sol',
+});
+
+// First buyers analysis
+const fba = holders.first_buyers_analysis;
+console.log(`Initially acquired: ${fba.initially_acquired_percentage}%`);
+console.log(`Top 10 buyers bought: ${fba.top_10_buyers_bought_percentage}%`);
+console.log(`Bundled buyers: ${fba.bundled_buyers_count}`);
+console.log(`Still holding: ${fba.buyers_still_holding_count}`);
+
+// Sniper analysis
+const sa = holders.sniper_analysis;
+console.log(`Sniper count: ${sa?.sniper_count}`);
+console.log(`Sniper percentage: ${sa?.sniper_total_percentage}%`);
+console.log(`Confidence score: ${sa?.sniper_confidence_score}/100`);
+
+// Top holders
+const top10 = holders.top_10_holders_analysis;
+console.log(`Top 10 hold: ${top10?.percentageHeldByTop10}%`);
+```
+
+### Trading Lite (Solana)
+
+Simplified trading analysis optimized for Solana tokens.
+
+```typescript
+const analysis = await client.tradingLite.analyze('pump_token_address');
+
+console.log(`Sniper % on Launch: ${analysis.SniperPercentageOnLaunch}%`);
+console.log(`Bundler % on Launch: ${analysis.BundlerPercentageOnLaunch}%`);
+console.log(`Sniper % Holding: ${analysis.SniperPercentageHolding}%`);
+console.log(`Bundler % Holding: ${analysis.BundlerPercentageHolding}%`);
+console.log(`Dev Holding: ${analysis.DevHoldingPercentage}%`);
+console.log(`Top 10 Holding: ${analysis.Top10HoldingPercentage}%`);
+```
+
+### Trending Tokens
+
+Discover trending tokens with risk data.
+
+```typescript
+const trending = await client.tokens.getTrending({ chain: 'sol' });
+
+for (const token of trending.tokens) {
+  console.log(`${token.name} (${token.symbol})`);
+  console.log(`  Price: $${token.price}`);
+  console.log(`  Volume: $${token.volume_24h}`);
+}
+```
+
+### Token Pools
+
+Get liquidity pool data for tokens.
+
+```typescript
+const pools = await client.tokens.getPools('token_address', { chain: 'sol' });
+
+for (const pool of pools.pools) {
+  console.log(`${pool.name} on ${pool.dex}`);
+  console.log(`  Liquidity: $${pool.liquidity}`);
+}
+
+// Get trending pools
+const trendingPools = await client.tokens.getTrendingPools({ chain: 'sol' });
+```
+
+## API Reference
+
+### TradingClient
+
+```typescript
+const client = new TradingClient({
+  apiKey: string;           // Required: Your Webacy API key
+  baseUrl?: string;         // Optional: Custom API URL
+  timeout?: number;         // Optional: Request timeout (ms)
+  retry?: RetryConfig;      // Optional: Retry configuration
+});
+```
+
+### Resources
+
+| Resource | Method | Description |
+|----------|--------|-------------|
+| `holderAnalysis` | `get(address, options)` | Get holder distribution analysis |
+| `tradingLite` | `analyze(address, options?)` | Get simplified trading analysis |
+| `tokens` | `getTrending(options)` | Get trending tokens |
+| `tokens` | `getPools(address, options)` | Get liquidity pools for token |
+| `tokens` | `getTrendingPools(options)` | Get trending liquidity pools |
+
+## Supported Chains
+
+- Solana (`sol`) - Full support including Trading Lite
+- Ethereum (`eth`) - Holder analysis
+- Base (`base`) - Holder analysis
+- BSC (`bsc`) - Holder analysis
+- Polygon (`pol`) - Holder analysis
+- Arbitrum (`arb`) - Holder analysis
+- Optimism (`opt`) - Holder analysis
+
+## Error Handling
+
+```typescript
+import { TradingClient, RateLimitError, NotFoundError } from '@rlajous/sdk-trading';
+
+try {
+  const holders = await client.holderAnalysis.get('token', { chain: 'sol' });
+} catch (error) {
+  if (error instanceof RateLimitError) {
+    console.log(`Rate limited. Retry after ${error.retryAfter}s`);
+  } else if (error instanceof NotFoundError) {
+    console.log('Token not found');
+  }
+}
+```
+
+## License
+
+MIT

package/dist/cjs/client.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TradingClient = void 0;
+const sdk_core_1 = require("@rlajous/sdk-core");
+const holder_analysis_1 = require("./resources/holder-analysis");
+const trading_lite_1 = require("./resources/trading-lite");
+const tokens_1 = require("./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' });
+ * ```
+ */
+class TradingClient extends sdk_core_1.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 holder_analysis_1.HolderAnalysisResource(this.httpClient, this.defaultChain);
+        this.tradingLite = new trading_lite_1.TradingLiteResource(this.httpClient, this.defaultChain);
+        this.tokens = new tokens_1.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);
+    }
+}
+exports.TradingClient = TradingClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;;AAAA,gDAM2B;AAC3B,iEAAqE;AACrE,2DAA+D;AAC/D,+CAAoD;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,aAAc,SAAQ,qBAAU;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,wCAAsB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACrF,IAAI,CAAC,WAAW,GAAG,IAAI,kCAAmB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/E,IAAI,CAAC,MAAM,GAAG,IAAI,uBAAc,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;AA9GD,sCA8GC"}

package/dist/cjs/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.NotFoundError = exports.ValidationError = exports.RateLimitError = exports.AuthenticationError = exports.WebacyError = exports.CHAIN_NAMES = exports.isEvmChain = exports.ChainCompatibility = exports.Chain = exports.TokensResource = exports.TradingLiteResource = exports.HolderAnalysisResource = exports.TradingClient = void 0;
+// Client
+var client_1 = require("./client");
+Object.defineProperty(exports, "TradingClient", { enumerable: true, get: function () { return client_1.TradingClient; } });
+// Resources
+var resources_1 = require("./resources");
+Object.defineProperty(exports, "HolderAnalysisResource", { enumerable: true, get: function () { return resources_1.HolderAnalysisResource; } });
+Object.defineProperty(exports, "TradingLiteResource", { enumerable: true, get: function () { return resources_1.TradingLiteResource; } });
+Object.defineProperty(exports, "TokensResource", { enumerable: true, get: function () { return resources_1.TokensResource; } });
+// Re-export commonly used types from core
+var sdk_core_1 = require("@rlajous/sdk-core");
+Object.defineProperty(exports, "Chain", { enumerable: true, get: function () { return sdk_core_1.Chain; } });
+Object.defineProperty(exports, "ChainCompatibility", { enumerable: true, get: function () { return sdk_core_1.ChainCompatibility; } });
+Object.defineProperty(exports, "isEvmChain", { enumerable: true, get: function () { return sdk_core_1.isEvmChain; } });
+Object.defineProperty(exports, "CHAIN_NAMES", { enumerable: true, get: function () { return sdk_core_1.CHAIN_NAMES; } });
+Object.defineProperty(exports, "WebacyError", { enumerable: true, get: function () { return sdk_core_1.WebacyError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return sdk_core_1.AuthenticationError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return sdk_core_1.RateLimitError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return sdk_core_1.ValidationError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return sdk_core_1.NotFoundError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return sdk_core_1.NetworkError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,SAAS;AACT,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AAEtB,YAAY;AACZ,yCAA0F;AAAjF,mHAAA,sBAAsB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAAE,2GAAA,cAAc,OAAA;AAgCpE,0CAA0C;AAC1C,8CAe2B;AAdzB,iGAAA,KAAK,OAAA;AACL,8GAAA,kBAAkB,OAAA;AAClB,sGAAA,UAAU,OAAA;AACV,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,+GAAA,mBAAmB,OAAA;AACnB,0GAAA,cAAc,OAAA;AACd,2GAAA,eAAe,OAAA;AACf,yGAAA,aAAa,OAAA;AACb,wGAAA,YAAY,OAAA"}

package/dist/cjs/package.json

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

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

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HolderAnalysisResource = void 0;
+const sdk_core_1 = require("@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
+ * ```
+ */
+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 sdk_core_1.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 (!(0, sdk_core_1.isValidAddress)(address, chain)) {
+            const chainName = sdk_core_1.CHAIN_NAMES[chain] || chain;
+            throw new sdk_core_1.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;
+    }
+}
+exports.HolderAnalysisResource = HolderAnalysisResource;
+//# sourceMappingURL=holder-analysis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"holder-analysis.js","sourceRoot":"","sources":["../../../src/resources/holder-analysis.ts"],"names":[],"mappings":";;;AAAA,gDAO2B;AAG3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,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,0BAAe,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,IAAA,yBAAc,EAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,sBAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;YAC9C,MAAM,IAAI,0BAAe,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;AArFD,wDAqFC"}

package/dist/cjs/resources/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokensResource = exports.TradingLiteResource = exports.HolderAnalysisResource = void 0;
+var holder_analysis_1 = require("./holder-analysis");
+Object.defineProperty(exports, "HolderAnalysisResource", { enumerable: true, get: function () { return holder_analysis_1.HolderAnalysisResource; } });
+var trading_lite_1 = require("./trading-lite");
+Object.defineProperty(exports, "TradingLiteResource", { enumerable: true, get: function () { return trading_lite_1.TradingLiteResource; } });
+var tokens_1 = require("./tokens");
+Object.defineProperty(exports, "TokensResource", { enumerable: true, get: function () { return tokens_1.TokensResource; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2D;AAAlD,yHAAA,sBAAsB,OAAA;AAC/B,+CAAqD;AAA5C,mHAAA,mBAAmB,OAAA;AAC5B,mCAA0C;AAAjC,wGAAA,cAAc,OAAA"}

package/dist/cjs/resources/tokens.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokensResource = void 0;
+const sdk_core_1 = require("@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
+ * ```
+ */
+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 sdk_core_1.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 (!(0, sdk_core_1.isValidAddress)(address, chain)) {
+            const chainName = sdk_core_1.CHAIN_NAMES[chain] || chain;
+            throw new sdk_core_1.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;
+    }
+}
+exports.TokensResource = TokensResource;
+//# sourceMappingURL=tokens.js.map

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

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