solanatracker-api Checked

First buyers with PnL

GET /first-buyers/{token}

Optional params: showHistoricPnL=true (1d/7d/30d), holdingCheck=true

**PnL response summary fields**: `realized`, `unrealized`, `total`, `totalInvested`, `averageBuyAmount`, `totalWins`, `totalLosses`, `winPercentage`, `lossPercentage`

### Wallet Data

All tokens held by wallet

GET /wallet/{owner}

Paginated wallet tokens

GET /wallet/{owner}/paginated

Trade history

GET /wallet/{owner}/trades

Portfolio chart over time

GET /wallet/{owner}/chart

### Holder Analysis

Paginated holder list

GET /tokens/{token}/holders?page=1

Top 100 holders

GET /tokens/{token}/holders/top

Top 20 holders (lighter)

GET /tokens/{token}/holders/top20

Bundler detection

GET /tokens/{token}/bundlers

### Top Traders

Global top traders

GET /top-traders/all

GET /top-traders/all/paginated?page=1

Token-specific top traders

GET /top-traders/{token}

Optional: expandPnl=true, sortBy=total|winPercentage

### Risk Assessment

Risk is included in the `/tokens/{token}` response:

{

"risk": {

"score": 7, // 1-10 (10 = safest)

"rugged": false,

"jupiterVerified": true,

"risks": [

{ "name": "Top 10 holders own 45%", "level": "warn" },

{ "name": "Freeze authority enabled", "level": "danger" }

]

}

}

**Risk factors**: sniper/insider concentration, developer holdings, bundler activity, top 10 holder %, mint/freeze authority, social presence, metadata completeness, liquidity.

### Search (30+ filters)

GET /search?query=BONK&minLiquidity=10000&minRiskScore=5&market=raydium&sortBy=volume&limit=50

Key filters: query, symbol, minLiquidity, maxLiquidity, minMarketCap, maxMarketCap,

minVolume, maxVolume, hasImage, hasSocials, minHolders, maxHolders, minRiskScore,

freezeAuthority, mintAuthority, deployer, market, sortBy, sortOrder, limit (max 500), page

## Raptor — Self-Hosted DEX Aggregator

> **See the dedicated `raptor-dex` skill** for complete Raptor documentation including setup, API reference, deployment guides, WebSocket streaming, and execution scripts.

Raptor is SolanaTracker's self-hosted DEX aggregator: 25+ DEXes, no rate limits, no API key, Yellowstone Jet TPU submission. [GitHub](https://github.com/solanatracker/raptor-binary) | [Docs](https://docs.solanatracker.io/raptor/overview)

## DataStream WebSocket

Real-time streaming via WebSocket for 30+ event types:

import websockets, json

async def stream():

uri = f"wss://datastream.solanatracker.io/{DATASTREAM_KEY}"

async with websockets.connect(uri) as ws:

Subscribe to token trades

await ws.send(json.dumps({"type": "join", "room": f"transaction:{token_addr}"}))

Also: price:{token}, holders:{token}, latest_tokens, graduated, etc.

async for msg in ws:

data = json.loads(msg)

if data.get("type") != "joined":

print(data)

**Key channels**: `transaction:{token}`, `price:{token}`, `holders:{token}`, `latest_tokens`, `graduated`, `graduating`, `bundlers:{token}`, `insiders:{token}`, `snipers:{token}`, `wallet_transaction:{wallet}`

## When to Use SolanaTracker vs Alternatives

| Need | Use |
|------|-----|
| 1-second OHLCV candles | **SolanaTracker** |
| Wallet PnL tracking | **SolanaTracker** |
| Token risk scoring | **SolanaTracker** |
| Bundler/sniper detection | **SolanaTracker** |
| Self-hosted swap execution | **Raptor** |
| Free no-auth quick lookup | DexScreener |
| Real-time gRPC streaming | Yellowstone |
| Parsed transaction history | Helius |
| Cross-chain data | DexScreener or CoinGecko |

## Files

### References
- `references/data_api_endpoints.md` — Complete Data API endpoint reference with parameters and response schemas
- `references/raptor_setup.md` — Raptor quick-start reference (full docs in the `raptor-dex` skill)
- `references/risk_and_pnl.md` — Risk scoring methodology and PnL calculation details
- [docs.solanatracker.io/llms-full.txt](https://docs.solanatracker.io/llms-full.txt) — Complete SolanaTracker documentation (13K+ lines, LLM-optimized) covering Data API, Swap API, Datastream WebSocket, Solana RPC, Yellowstone gRPC, SDK libraries, and all endpoint schemas. Fetch on demand rather than embedding.

### Scripts
- `scripts/token_analysis.py` — Fetch token data, risk score, holders, and trades
- `scripts/wallet_pnl.py` — Wallet PnL analysis with win rate and trade breakdown