HivemindOS manual
Nansen Intelligence
Nansen gives your agents read-only onchain research before a wallet, token, or Hyperliquid decision. Research calls never sign, swap, send, or trade; any later action still goes through the normal preview and confirmation.
What agents can ask for
- Token brief: profile, flows, buyers and sellers, price history, and optional DEX trades or indicators.
- Wallet brief: balances, PnL, counterparties, related wallets, and DeFi holdings (needs a Nansen API key).
- Hyperliquid brief: address positions and trades, token perp context, and market screens.
- Market scout: token and perp screens across chains, for watchlists and daily briefs.
- Templates: ready-made simple and complex workflows (below).
- Nansen Agent research: fast or expert mode for broader questions.
Set up
Add your own Nansen API key (recommended):
hive-env-add NANSEN_API_KEY
The status check reports only whether the key is present, never its value.
Without a key, HivemindOS uses your hosted HivemindOS credits through the HivemindOS-managed Nansen broker. The hosted service holds the Nansen key, charges your credits, records a receipt, and returns a derived brief.
Guardrails
- Nansen data is one signal. Agents should combine it with wallet state, market data, news, and your limits.
- HivemindOS returns derived briefs, not raw Smart Money dashboards, raw wallet rankings, near-real-time feeds, or copy-trading signals.
- Nansen-derived data shows attribution where required.
- Copytrade-named templates are watch-only research. They never open, close, rebalance, or copy trades.
Simple templates
| Template | Use |
|---|---|
defi-positions |
Wallet DeFi holdings, rewards, protocol exposure, and debt. |
smart-money-holdings |
Smart Money token holdings across selected chains. |
token-top-holders |
Holder concentration and optional holder labels for a token. |
token-screener-discovery |
Multi-chain screener candidates for new-token discovery and watchlists. |
Complex templates
| Template | Use |
|---|---|
token-tracking-smart-money |
Token screener, Smart Money netflow, and optional token PnL leaderboard. |
hyperliquid-wallet-discovery |
Hyperliquid trader discovery plus optional positions and trades. |
related-wallets-scale |
Address labels, related wallets, counterparties, and balance and transaction patterns. |
top-wallet-copytrade-research |
Token flows, PnL leaderboard, Smart Money DEX trades, and holders. |
cex-health-monitor |
Exchange balance snapshot and recent counterparty flows. |
API reference
Agents discover the capability as nansen_intelligence. The local dashboard API exposes the same read-only calls:
| Route | Use |
|---|---|
GET /api/nansen/status |
Check API key presence, managed-credit readiness, and available endpoints. |
POST /api/nansen/token-brief |
Token brief from an address or symbol. |
POST /api/nansen/wallet-brief |
Wallet portfolio and profile brief. |
POST /api/nansen/hyperliquid-brief |
Hyperliquid market, token, or address context. |
POST /api/nansen/market-scout |
Multi-chain token and perp scout brief. |
POST /api/nansen/simple-template |
Run a simple template. |
POST /api/nansen/complex-template |
Run a complex template. |
POST /api/nansen/agent |
Ask Nansen Agent in fast or expert mode. |
Managed-credit responses include billing details in the brief, so you can see the debit and receipt id.
Use Nansen to answer “what should we know before acting?” Then use the Trade tab or an agent to preview and confirm a concrete action.