nansenlisted

# Nansen API Skill Reference files: - `references/endpoints.md` — full catalog with credit cost per endpoint, Solana support flags - `references/credits.md` — pricing, budget rules, x402 pay-per-call, labels cost explosion - `references/filters.md` — chains enum, smart money labels, filter schemas - `references/examples/` — working Python scripts --- ## 🚨 Rule #1: credit budget awareness Endpoint credit cost varies **150×** between cheap and expensive endpoints: | Tier | Cost (Pro) | Examples | |------|-----------|----------| | Cheap | **1 credit** | All Profiler (balances, tx, PnL), most TGM, Portfolio, Prediction Markets | | Standard | **5 credits** | **ALL Smart Money endpoints**, TGM indicators, counterparties | | Premium labels | **150 credits** | tgm/holders, tgm/pnl-leaderboard, tgm/perp-* when `premium_labels: true` | | Labels | **100 / 500** | profiler/address/labels (common / premium) | | Agent | **200 / 750** | agent/fast / agent/expert | **Free tier multiplier:** ×10. A 150-credit call on Free costs 1500. ### Budget rules (like Dune — independent per operation): - **< 50 credits** → proceed - **50–200 credits** → tell the user your plan and expected cost before calling (e.g. "running 30× Smart Money dex-trades = 150 credits") - **> 200 credits** → STOP, propose alternative (narrower filter, smaller page, different endpoint), ask for approval ### Common credit traps: 1. **`premium_labels: true`** silently 30×s the cost (5 → 150). Default is `null`/omitted