solanatracker-api

SolanaTracker API — 代币数据、分析与 Raptor DEX 聚合器

SolanaTracker 提供全面的 Solana 代币数据，并具备独特功能：1 秒 OHLCV 分辨率、钱包 PnL 追踪、风险评分、捆绑交易/狙击交易检测，以及支持 25+ 个 DEX、无速率限制的可自托管 DEX 聚合器（Raptor）。

快速开始

import httpx

API_KEY = os.getenv("SOLANATRACKER_API_KEY", "")
BASE = "https://data.solanatracker.io"
HEADERS = {"x-api-key": API_KEY}

# Token info with risk score, pools, holders
resp = httpx.get(f"{BASE}/tokens/{mint}", headers=HEADERS)
token = resp.json()
print(f"Risk: {token['risk']['score']}/10, Pools: {len(token['pools'])}")

# Wallet PnL
resp = httpx.get(f"{BASE}/pnl/{wallet}", headers=HEADERS)
pnl = resp.json()
print(f"Win rate: {pnl['summary']['winPercentage']}%")

身份验证与定价

• API Key：从 SolanaTracker 控制面板获取，通过 x-api-key 请求头传递
• 套餐：起价约 €50/月（200K 次请求），€200/月（更高请求量），企业版价格定制
• Raptor：公开测试期间免费（可自托管，无速率限制）

核心数据端点

代币数据

# Full token info (metadata, pools, risk, events, holders summary)
GET /tokens/{tokenAddress}

# New tokens (paginated, pages 1-10)
GET /tokens/latest?page=1

# Trending by volume (default: past hour)
GET /tokens/trending
GET /tokens/trending/{timeframe}  # 5m, 15m, 30m, 1h, 4h, 12h, 24h

# Top performers
GET /tokens/top

# Graduated from bonding curves (pump.fun → Raydium)
GET /tokens/graduated
GET /tokens/graduating

# Multiple tokens in one request
GET /tokens/multi?tokens=ADDR1,ADDR2

# Deployer's tokens
GET /tokens/deployer/{deployerAddress}

# Token by pool address
GET /tokens/pool/{poolAddress}

# All-time high
GET /tokens/{token}/ath

价格数据

# Current price with liquidity and market cap
GET /price?token={address}

# Price with change percentages
GET /price?token={address}&priceChanges=true

# Historic prices (3d, 5d, 7d, 14d, 30d snapshots)
GET /price/history?token={address}

# Multiple token prices
GET /price/multi?tokens=ADDR1,ADDR2

OHLCV 图表（1 秒分辨率）

# Candle data — supports 1s resolution (unique to SolanaTracker)
GET /chart/{token}?type=1s&time_from=UNIX&time_to=UNIX

# Timeframes: 1s, 5s, 15s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mn
# Optional: currency=usd|sol|eur, removeOutliers=true, marketCap=true

# Specialized charts
GET /chart/{token}/bundlers   # Bundler activity overlay
GET /chart/{token}/holders    # Holder count overlay
GET /chart/{token}/insiders   # Insider activity overlay
GET /chart/{token}/snipers    # Sniper activity overlay

钱包 PnL

# Full wallet PnL across all tokens
GET /pnl/{wallet}

# Token-specific PnL
GET /pnl/{wallet}/{token}

# First buyers with PnL
GET /first-buyers/{token}

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

PnL 响应摘要字段：realized、unrealized、total、totalInvested、averageBuyAmount、totalWins、totalLosses、winPercentage、lossPercentage

钱包数据

# 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

持有者分析

# 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

顶级交易者

# 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

风险评估

风险信息包含在 /tokens/{token} 响应中：

{
  "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" }
    ]
  }
}

风险因素：狙击交易者/内部人士持仓集中度、开发者持仓、捆绑交易活动、前 10 大持有者占比、铸造/冻结权限、社交媒体影响力、元数据完整度、流动性。

搜索（30+ 个筛选条件）

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 — 可自托管 DEX 聚合器

完整的 Raptor 文档请参阅专用的 raptor-dex 技能，其中包括设置、API 参考、部署指南、WebSocket 流和执行脚本。

Raptor 是 SolanaTracker 的可自托管 DEX 聚合器：支持 25+ 个 DEX，无速率限制，无需 API Key，并支持通过 Yellowstone Jet TPU 提交交易。GitHub | 文档

DataStream WebSocket

通过 WebSocket 实时流式传输 30+ 种事件：

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)

主要频道：transaction:{token}、price:{token}、holders:{token}、latest_tokens、graduated、graduating、bundlers:{token}、insiders:{token}、snipers:{token}、wallet_transaction:{wallet}

何时选择 SolanaTracker 或其他方案

需求	使用
1 秒 OHLCV 蜡烛图	SolanaTracker
钱包 PnL 追踪	SolanaTracker
代币风险评分	SolanaTracker
捆绑交易/狙击交易检测	SolanaTracker
可自托管的兑换执行	Raptor
免费、无需身份验证的快速查询	DexScreener
实时 gRPC 流	Yellowstone
已解析的交易历史	Helius
跨链数据	DexScreener 或 CoinGecko

文件

参考资料

• references/data_api_endpoints.md — 完整的 Data API 端点参考，包含参数和响应架构
• references/raptor_setup.md — Raptor 快速入门参考（完整文档见 raptor-dex 技能）
• references/risk_and_pnl.md — 风险评分方法和 PnL 计算详情
• docs.solanatracker.io/llms-full.txt — 完整的 SolanaTracker 文档（13K+ 行，针对 LLM 优化），涵盖 Data API、Swap API、Datastream WebSocket、Solana RPC、Yellowstone gRPC、SDK 库和所有端点架构。按需获取，而不要嵌入。

脚本

• scripts/token_analysis.py — 获取代币数据、风险评分、持有者和交易信息
• scripts/wallet_pnl.py — 分析钱包 PnL，包含胜率和交易明细