@rlajous/sdk-trading 1.0.0

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

@@ -0,0 +1,148 @@
+import { Chain, TokenMetadata } from '@rlajous/sdk-core';
+/**
+ * Volume data across different time periods
+ */
+export interface VolumeData {
+    /** 5 minute volume */
+    m5: string;
+    /** 15 minute volume */
+    m15: string;
+    /** 30 minute volume */
+    m30: string;
+    /** 1 hour volume */
+    h1: string;
+    /** 6 hour volume */
+    h6: string;
+    /** 24 hour volume */
+    h24: string;
+}
+/**
+ * Normalized pool data
+ */
+export interface PoolData {
+    /** Pool address */
+    address: string;
+    /** Pool name */
+    name: string;
+    /** Fully diluted valuation */
+    fdv: string;
+    /** Base token address */
+    base_token?: string;
+    /** Quote token address */
+    quote_token?: string;
+    /** Market cap */
+    market_cap: string | null;
+    /** Total reserve value */
+    reserve: string;
+    /** Pool creation timestamp */
+    created_at: string;
+    /** Token price */
+    token_price: string;
+    /** Base token price */
+    base_token_price: string;
+    /** Quote token price */
+    quote_token_price: string;
+    /** Volume across time periods */
+    volume: VolumeData;
+}
+/**
+ * Token with risk analysis
+ */
+export interface TokenWithRisk {
+    /** Token address */
+    address: string;
+    /** Risk analysis result */
+    risk: TokenRiskSummary;
+    /** Token metadata */
+    metadata?: TokenMetadata;
+}
+/**
+ * Summary of token risk
+ */
+export interface TokenRiskSummary {
+    /** Number of issues found */
+    count: number;
+    /** Medium severity issues */
+    medium: number;
+    /** High severity issues */
+    high: number;
+    /** Overall risk score (0-100) */
+    overallRisk?: number;
+}
+/**
+ * Pools response with token risks
+ */
+export interface PoolsResponse {
+    /** List of pools */
+    pools: PoolData[];
+    /** Tokens with risk analysis */
+    tokens: TokenWithRisk[];
+}
+/**
+ * Trending token data
+ */
+export interface TrendingToken {
+    /** Token address */
+    address: string;
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+    /** Current price in USD */
+    price_usd?: number;
+    /** 24h price change percentage */
+    price_change_24h?: number;
+    /** 24h trading volume */
+    volume_24h?: number;
+    /** Market cap */
+    market_cap?: number;
+    /** Risk analysis */
+    risk?: TokenRiskSummary;
+}
+/**
+ * Trending tokens response
+ */
+export interface TrendingTokensResponse {
+    /** List of trending tokens */
+    tokens: TrendingToken[];
+}
+/**
+ * Trending pools response
+ */
+export interface TrendingPoolsResponse {
+    /** List of trending pools */
+    pools: PoolData[];
+}
+/**
+ * Options for token pool requests
+ */
+export interface TokenPoolsOptions {
+    /**
+     * Target blockchain
+     *
+     * Optional if `defaultChain` was set in the client configuration.
+     */
+    chain?: Chain;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Abort signal */
+    signal?: AbortSignal;
+}
+/**
+ * Options for trending requests
+ */
+export interface TrendingOptions {
+    /**
+     * Target blockchain
+     *
+     * Optional if `defaultChain` was set in the client configuration.
+     */
+    chain?: Chain;
+    /** Number of results to return */
+    limit?: number;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Abort signal */
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=tokens.d.ts.map

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

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

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

@@ -0,0 +1,72 @@
+import { Chain } from '@rlajous/sdk-core';
+/**
+ * Address holding details with initial and current amounts
+ */
+export interface AddressHolding {
+    /** Wallet address */
+    address: string;
+    /** Percentage of total supply initially acquired at launch */
+    initiallyAcquiredPercentage: number;
+    /** Amount initially acquired (raw token amount) */
+    initiallyAcquiredAmount: number;
+    /** Percentage of total supply currently held */
+    currentHoldingPercentage: number;
+    /** Amount currently held (raw token amount) */
+    currentHoldingAmount: number;
+}
+/**
+ * Simplified bundling and sniper analysis result
+ *
+ * This is optimized for quick trading decisions with only the most
+ * critical fields for assessing token safety.
+ */
+export interface TradingLiteAnalysis {
+    /** CA: Contract/Token Address (mint address) */
+    CA: string;
+    /** DA: Deployer Address (developer/minter address) */
+    DA: string;
+    /** Percentage of total supply held by top 10 holders (current) */
+    Top10Holders: number;
+    /** Percentage of supply initially acquired by snipers at launch */
+    SniperPercentageOnLaunch: number;
+    /** Detailed list of sniper addresses with holdings */
+    SniperAddresses: AddressHolding[];
+    /** Detailed list of bundler addresses with holdings */
+    BundlerAddresses: AddressHolding[];
+    /** Percentage currently held by snipers */
+    SniperPercentageHolding: number;
+    /** Confidence score for sniper detection (0-100) */
+    SniperConfidence: number | null;
+    /** Percentage of supply initially acquired by bundlers at launch */
+    BundlerPercentageOnLaunch: number;
+    /** Percentage currently held by bundlers */
+    BundlerPercentageHolding: number;
+    /** Total number of unique holders */
+    TotalHolders: number;
+    /** Whether token has paid DexScreener features */
+    DexScreenerPaid: boolean;
+    /** Percentage currently held by developer */
+    DevHoldingPercentage: number;
+    /** Tokens launched by developer in last 24 hours */
+    DevLaunched24Hours: number;
+    /** Whether token can still be minted */
+    mintable: boolean;
+    /** Whether token accounts can be frozen */
+    freezable: boolean;
+    /** Last analyzed slot number */
+    lastAnalyzedSlot?: number;
+    /** Analysis timestamp */
+    analysisTimestamp?: number;
+}
+/**
+ * Options for trading lite requests
+ */
+export interface TradingLiteOptions {
+    /** Target blockchain (currently only Solana supported) */
+    chain?: Chain.SOL;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Abort signal */
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=trading-lite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trading-lite.d.ts","sourceRoot":"","sources":["../../../src/types/trading-lite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,2BAA2B,EAAE,MAAM,CAAC;IACpC,mDAAmD;IACnD,uBAAuB,EAAE,MAAM,CAAC;IAChC,gDAAgD;IAChD,wBAAwB,EAAE,MAAM,CAAC;IACjC,+CAA+C;IAC/C,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,wBAAwB,EAAE,MAAM,CAAC;IACjC,sDAAsD;IACtD,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,uDAAuD;IACvD,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,2CAA2C;IAC3C,uBAAuB,EAAE,MAAM,CAAC;IAChC,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oEAAoE;IACpE,yBAAyB,EAAE,MAAM,CAAC;IAClC,4CAA4C;IAC5C,wBAAwB,EAAE,MAAM,CAAC;IACjC,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,eAAe,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC;IAClB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@rlajous/sdk-trading",
+  "version": "1.0.0",
+  "description": "Webacy SDK for token trading analysis - holder analysis, sniper detection, bundler detection",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@rlajous/sdk-core": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": [
+    "webacy",
+    "sdk",
+    "trading",
+    "token",
+    "holder-analysis",
+    "sniper-detection",
+    "bundler-detection",
+    "blockchain",
+    "crypto",
+    "defi"
+  ],
+  "author": "Webacy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Webacy-Prod/sdk.git",
+    "directory": "packages/trading"
+  },
+  "bugs": {
+    "url": "https://github.com/Webacy-Prod/sdk/issues"
+  },
+  "homepage": "https://github.com/Webacy-Prod/sdk/tree/main/packages/trading#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types && npm run postbuild",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "postbuild": "echo '{\"type\":\"module\"}' > dist/esm/package.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run",
+    "test:watch": "vitest watch"
+  }
+}