Nansen
Read-only Nansen Hyperliquid research through Thirdfy provider nansen. Perp screener, TGM intel, profiler reads, and premium research agent.
Category: Market data · signals
Nansen exposes read-only Hyperliquid cohort and market-structure intel through Thirdfy provider nansen. Agents call get_nansen_* on the Thirdfy catalog. These actions do not place perps orders.
Pair Nansen evidence with Hyperliquid for execution.
Actions
| Action | Purpose |
|---|---|
get_nansen_perp_screener | Hyperliquid perp screener (open interest and related fields) |
get_nansen_position_intelligence | TGM position intelligence for a perp ticker |
get_nansen_flow_intelligence | TGM flow intelligence for a token |
get_nansen_address_perp_positions | Profiler perp positions for an address |
get_nansen_address_perp_trades | Profiler perp trades for an address |
get_nansen_address_balances | Profiler current balances |
get_nansen_address_pnl_summary | Profiler PnL summary |
get_nansen_agent_fast | Premium research agent (buffered JSON) |
get_nansen_agent_expert | Heavier premium research agent (buffered JSON) |
Params use JSON bodies. Screener and profiler calls are not EVM chainId filters. Profiler PnL uses date.from / date.to as YYYY-MM-DD.
Premium research costs more than screener and profiler reads. Command shows the USD charge after the turn. See Credits and balance.
The public catalog does not include smart-money tape, leaderboards, or address labels. Synthesized answers include Powered by Nansen API where Nansen requires attribution.
Credential model
Nansen reads use the same Thirdfy session as other catalog actions. CLI and MCP do not take a Nansen key. Thirdfy credits pay the catalog action.
| Layer | Model |
|---|---|
| CLI / MCP | Thirdfy auth (email OTP or agent API key). |
| Credits | Thirdfy credits on the agent wallet. |
| Execution | None from Nansen. Use Hyperliquid for perps writes. |
Discovery
| Surface | Example |
|---|---|
| MCP | getProviderActions { provider: "nansen" } |
| CLI | thirdfy-agent run --action get_nansen_perp_screener --params '{"date":{"from":"2026-08-27T00:00:00.000Z","to":"2026-08-28T00:00:00.000Z"},"pagination":{"page":1,"per_page":5}}' --provider nansen --json |
| CLI (premium) | thirdfy-agent run --action get_nansen_agent_fast --params '{"text":"Summarize top Hyperliquid perp themes today."}' --provider nansen --json |
Readiness checklist
- Agent authenticated for discovery and run (email OTP
agent_walletor agent API key per lane). - Strategy treats Nansen output as advisory evidence.
- For live perps, run Hyperliquid setup, funding, and preflight before any order.
Execution lanes
Nansen actions are read-only and fanoutSafe. They do not require delegation binding for research reads. Any execute-intent on Hyperliquid still requires normal preflight and delegation rules.