# Pumpfun Analytics

> Quick Pump.fun analytics shortcut for bonding curve state, graduation progress, price impact, token pricing, fee tiers, and buy/sell quote checks. Use for lightweight read-only token analysis.

- Skill: `solizardking/pumpfun-analytics` (Agent Skill)
- Install (CLI): `npx skillmds add solizardking/pumpfun-analytics`
- Raw SKILL.md: https://api.skillmd.com/api/skills/solizardking/pumpfun-analytics/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: Solizardking (https://skillmd.com/u/solizardking)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/solizardking/pumpfun-analytics

---


# Pump.fun Analytics

Monitor bonding curve state, calculate price impact, track graduation progress, and analyze token economics on the Pump.fun protocol.

## Prerequisites

- `HELIUS_RPC_URL` or `SOLANA_RPC_URL` configured
- `@coral-xyz/anchor` and `@solana/web3.js` available

## Capabilities

### 1. Bonding Curve State

Fetch the current state of any token's bonding curve:

```typescript
import { OnlinePumpSdk } from "@nirholas/pump-sdk";

const sdk = new OnlinePumpSdk(connection);
const summary = await sdk.fetchBondingCurveSummary(mint);

console.log("Market Cap:", summary.marketCap.toString());
console.log("Graduated:", summary.isGraduated);
console.log("Token Supply Remaining:", summary.tokensRemaining.toString());
```

### 2. Graduation Progress

Track how close a token is to graduating from the bonding curve to the AMM:

```typescript
import { getGraduationProgress } from "@nirholas/pump-sdk";

const progress = getGraduationProgress(bondingCurve, global);
console.log(`Progress: ${progress.progressBps / 100}%`);
console.log(`SOL accumulated: ${progress.solAccumulated.toString()}`);
console.log(`Tokens remaining: ${progress.tokensRemaining.toString()}`);
```

### 3. Price Impact Analysis

Calculate the price impact of a trade before executing:

```typescript
import { calculateBuyPriceImpact, calculateSellPriceImpact } from "@nirholas/pump-sdk";

const buyImpact = calculateBuyPriceImpact(bondingCurve, global, feeConfig, buyAmountLamports);
console.log(`Price impact: ${buyImpact.priceImpactBps / 100}%`);
console.log(`Effective price: ${buyImpact.effectivePrice.toString()}`);

const sellImpact = calculateSellPriceImpact(bondingCurve, global, feeConfig, sellTokenAmount);
console.log(`Price impact: ${sellImpact.priceImpactBps / 100}%`);
```

### 4. Token Price

Get the current buy and sell price per token:

```typescript
import { getTokenPrice } from "@nirholas/pump-sdk";

const price = getTokenPrice(bondingCurve, global, feeConfig);
console.log(`Buy price: ${price.buyPricePerToken.toString()} lamports`);
console.log(`Sell price: ${price.sellPricePerToken.toString()} lamports`);
```

### 5. Fee Tier Calculation

Calculate the current fee tier based on market cap:

```typescript
import { computeFeesBps, calculateFeeTier } from "@nirholas/pump-sdk";

const fees = computeFeesBps(global, feeConfig);
console.log(`Protocol fee: ${fees.protocolFeeBps} bps`);
console.log(`Creator fee: ${fees.creatorFeeBps} bps`);
```

### 6. Buy/Sell Quote

Calculate expected tokens for a given SOL amount:

```typescript
import { getBuyTokenAmountFromSolAmount, getSellSolAmountFromTokenAmount } from "@nirholas/pump-sdk";

const tokens = getBuyTokenAmountFromSolAmount({
  global, feeConfig,
  mintSupply: bondingCurve.tokenTotalSupply,
  bondingCurve,
  amount: solAmountLamports,
});

const sol = getSellSolAmountFromTokenAmount({
  global, feeConfig,
  mintSupply: bondingCurve.tokenTotalSupply,
  bondingCurve,
  amount: tokenAmount,
});
```

## Agent Integration

The OODA trading loop uses these analytics automatically during the **Observe** phase to pull bonding curve data into ClawVault KNOWN memory.

