@clawdvault/sdk 0.3.2 → 0.4.0

package/README.md

@@ -127,6 +127,59 @@ client.setSigner(newSigner);
 const address = client.getWalletAddress(); // returns string | null
 ```
 
+## USD Price Fields
+
+The SDK provides native USD pricing on tokens, trades, and stats:
+
+### Token Fields
+
+```typescript
+const { token } = await client.getToken('MINT_ADDRESS');
+
+// USD Fields
+console.log(token.price_usd);        // Current price in USD
+console.log(token.market_cap_usd);   // Market cap in USD
+
+// SOL Fields (still available)
+console.log(token.price_sol);        // Price in SOL
+console.log(token.market_cap_sol);   // Market cap in SOL
+```
+
+### Trade Fields
+
+```typescript
+const { trades } = await client.getTrades({ mint: 'MINT_ADDRESS' });
+
+for (const trade of trades) {
+  console.log(trade.price_usd);      // Price in USD at time of trade
+  console.log(trade.sol_price_usd);  // SOL/USD price at time of trade
+  console.log(trade.price_sol);      // Price in SOL at time of trade
+}
+```
+
+### Candles with Currency
+
+```typescript
+// Get candles in USD
+const { candles } = await client.getCandles({
+  mint: 'MINT_ADDRESS',
+  interval: '5m',
+  currency: 'usd'  // 'usd' or 'sol'
+});
+
+// candles[0].open, high, low, close are in USD when currency='usd'
+```
+
+### Stats Fields
+
+```typescript
+const stats = await client.getStats('MINT_ADDRESS');
+
+console.log(stats.onChain?.priceUsd);      // Price in USD
+console.log(stats.onChain?.marketCapUsd);  // Market cap in USD
+console.log(stats.onChain?.solPriceUsd);   // SOL/USD rate
+```
+
 ## Browser Usage with Phantom Wallet
 
 ```typescript
@@ -205,21 +258,27 @@ const jupSell = await client.sellJupiter('MINT', 1000000, 50);
 ### Price & Market Data
 
 ```typescript
-// Trade history
+// Trade history (includes USD prices)
 const { trades } = await client.getTrades({
   mint: 'MINT_ADDRESS',
   limit: 50
 });
+// trades[0].price_usd       - Price in USD at trade time
+// trades[0].sol_price_usd   - SOL price at trade time
 
-// OHLCV candles
+// OHLCV candles (SOL or USD)
 const { candles } = await client.getCandles({
   mint: 'MINT_ADDRESS',
-  interval: '1m',  // '1m' | '5m' | '15m' | '1h' | '4h' | '1d'
-  limit: 100
+  interval: '1m',   // '1m' | '5m' | '15m' | '1h' | '4h' | '1d'
+  limit: 100,
+  currency: 'usd'   // 'usd' or 'sol' (default: 'sol')
 });
 
-// On-chain stats
+// On-chain stats (includes USD market cap)
 const stats = await client.getStats('MINT_ADDRESS');
+// stats.onChain.priceUsd      - Price in USD
+// stats.onChain.marketCapUsd  - Market cap in USD
+// stats.onChain.solPriceUsd   - SOL/USD price
 
 // Top holders
 const { holders } = await client.getHolders('MINT_ADDRESS');

package/dist/index.d.mts

@@ -538,6 +538,8 @@ interface paths {
          * Get OHLCV candles
          * @description Returns candlestick data for charting. This is the recommended source
          *     of truth for price display. Use the last candle's `close` for current price.
+         *
+         *     Set `currency=usd` to get USD-denominated candles.
          */
         get: {
             parameters: {
@@ -545,6 +547,8 @@ interface paths {
                     mint: string;
                     interval?: "1m" | "5m" | "15m" | "1h" | "1d";
                     limit?: number;
+                    /** @description Currency for OHLCV values (sol or usd) */
+                    currency?: "sol" | "usd";
                 };
                 header?: never;
                 path?: never;
@@ -561,6 +565,8 @@ interface paths {
                         "application/json": {
                             mint?: string;
                             interval?: string;
+                            /** @enum {string} */
+                            currency?: "sol" | "usd";
                             candles?: {
                                 /** @description Unix timestamp (seconds) */
                                 time?: number;
@@ -593,7 +599,7 @@ interface paths {
         };
         /**
          * Get on-chain stats
-         * @description Returns bonding curve state directly from Solana.
+         * @description Returns bonding curve state directly from Solana with USD values.
          */
         get: {
             parameters: {
@@ -606,7 +612,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description On-chain stats */
+                /** @description On-chain stats with USD values */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -622,8 +628,16 @@ interface paths {
                                 bondingCurveSol?: number;
                                 virtualSolReserves?: number;
                                 virtualTokenReserves?: number;
+                                /** @description Price in SOL */
                                 price?: number;
+                                /** @description Price in USD */
+                                priceUsd?: number;
+                                /** @description Market cap in SOL */
                                 marketCap?: number;
+                                /** @description Market cap in USD */
+                                marketCapUsd?: number;
+                                /** @description SOL price at time of request */
+                                solPriceUsd?: number;
                                 graduated?: boolean;
                             };
                         };
@@ -1368,7 +1382,11 @@ interface components {
             creator?: string;
             creator_name?: string;
             price_sol?: number;
+            /** @description Price in USD */
+            price_usd?: number;
             market_cap_sol?: number;
+            /** @description Market cap in USD */
+            market_cap_usd?: number;
             volume_24h?: number;
             virtual_sol_reserves?: number;
             virtual_token_reserves?: number;
@@ -1388,7 +1406,12 @@ interface components {
             type?: "buy" | "sell";
             sol_amount?: number;
             token_amount?: number;
-            price?: number;
+            /** @description Price in SOL */
+            price_sol?: number;
+            /** @description Price in USD (calculated from sol_price_usd) */
+            price_usd?: number;
+            /** @description SOL price at time of trade */
+            sol_price_usd?: number;
             trader?: string;
             signature?: string;
             /** Format: date-time */

package/dist/index.d.ts

@@ -538,6 +538,8 @@ interface paths {
          * Get OHLCV candles
          * @description Returns candlestick data for charting. This is the recommended source
          *     of truth for price display. Use the last candle's `close` for current price.
+         *
+         *     Set `currency=usd` to get USD-denominated candles.
          */
         get: {
             parameters: {
@@ -545,6 +547,8 @@ interface paths {
                     mint: string;
                     interval?: "1m" | "5m" | "15m" | "1h" | "1d";
                     limit?: number;
+                    /** @description Currency for OHLCV values (sol or usd) */
+                    currency?: "sol" | "usd";
                 };
                 header?: never;
                 path?: never;
@@ -561,6 +565,8 @@ interface paths {
                         "application/json": {
                             mint?: string;
                             interval?: string;
+                            /** @enum {string} */
+                            currency?: "sol" | "usd";
                             candles?: {
                                 /** @description Unix timestamp (seconds) */
                                 time?: number;
@@ -593,7 +599,7 @@ interface paths {
         };
         /**
          * Get on-chain stats
-         * @description Returns bonding curve state directly from Solana.
+         * @description Returns bonding curve state directly from Solana with USD values.
          */
         get: {
             parameters: {
@@ -606,7 +612,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description On-chain stats */
+                /** @description On-chain stats with USD values */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -622,8 +628,16 @@ interface paths {
                                 bondingCurveSol?: number;
                                 virtualSolReserves?: number;
                                 virtualTokenReserves?: number;
+                                /** @description Price in SOL */
                                 price?: number;
+                                /** @description Price in USD */
+                                priceUsd?: number;
+                                /** @description Market cap in SOL */
                                 marketCap?: number;
+                                /** @description Market cap in USD */
+                                marketCapUsd?: number;
+                                /** @description SOL price at time of request */
+                                solPriceUsd?: number;
                                 graduated?: boolean;
                             };
                         };
@@ -1368,7 +1382,11 @@ interface components {
             creator?: string;
             creator_name?: string;
             price_sol?: number;
+            /** @description Price in USD */
+            price_usd?: number;
             market_cap_sol?: number;
+            /** @description Market cap in USD */
+            market_cap_usd?: number;
             volume_24h?: number;
             virtual_sol_reserves?: number;
             virtual_token_reserves?: number;
@@ -1388,7 +1406,12 @@ interface components {
             type?: "buy" | "sell";
             sol_amount?: number;
             token_amount?: number;
-            price?: number;
+            /** @description Price in SOL */
+            price_sol?: number;
+            /** @description Price in USD (calculated from sol_price_usd) */
+            price_usd?: number;
+            /** @description SOL price at time of trade */
+            sol_price_usd?: number;
             trader?: string;
             signature?: string;
             /** Format: date-time */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawdvault/sdk",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "TypeScript SDK for ClawdVault - Solana token launchpad",
   "main": "dist/index.js",
   "module": "dist/index.mjs",