@thirdfy/agent-cli 0.2.53 → 0.2.54

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.54] - 2026-08-28
+
+### Added
+
+- `nansen` provider hints and `docs/providers/nansen.md` for nine read-only `get_nansen_*` actions (HL/TGM reads + premium research agent). Pairs with Thirdfy API **3.14.14** and `thirdfy-mcp` **0.0.101**.
+
 ## [0.2.53] - 2026-08-25
 
 ### Added

package/README.md

@@ -40,9 +40,10 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.53
+## What's new in v0.2.54
 
-- Polymarket CLOB discovery includes `get_polymarket_balance_allowance` so agents can read collateral balance and allowance before placing orders.
+- Nansen provider hints for nine read-only `get_nansen_*` actions (Hyperliquid screener, TGM intel, address profiler, and premium research agent).
+- See [`docs/providers/nansen.md`](./docs/providers/nansen.md) for discovery examples and credit tiers.
 - See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thirdfy/agent-cli",
-  "version": "0.2.53",
+  "version": "0.2.54",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

package/src/runtime/providerHints.mjs

@@ -594,6 +594,29 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'thirdfy-agent run --action get_gmgn_kol_trades --params \'{"chain":"sol","limit":5}\' --provider gmgn --json',
       };
     }
+    if (provider === 'nansen') {
+      return {
+        provider,
+        category: 'research_intel',
+        canonicalReadAction: 'get_nansen_perp_screener',
+        readActions: [
+          'get_nansen_perp_screener',
+          'get_nansen_position_intelligence',
+          'get_nansen_address_perp_positions',
+          'get_nansen_address_perp_trades',
+          'get_nansen_address_balances',
+          'get_nansen_address_pnl_summary',
+          'get_nansen_flow_intelligence',
+          'get_nansen_agent_fast',
+          'get_nansen_agent_expert',
+        ],
+        supportedChains: [],
+        laneCompatibility:
+          'Nansen HL/TGM reads and premium research agent via Thirdfy API. JSON body params for screener/profiler calls. Fast agent ~100 Thirdfy credits; expert ~375. Pace outbound starts (~1 req/s).',
+        example:
+          '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',
+      };
+    }
     if (provider === 'market-data') {
       return {
         provider,
@@ -646,6 +669,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       'yield-xyz': 'get_yield_xyz_opportunities',
       'market-data': 'get_trending_tokens',
       gmgn: 'get_gmgn_kol_trades',
+      nansen: 'get_nansen_perp_screener',
       prediction: 'get_prediction_markets',
     };
     return {