nansen-cli 1.17.0 → 1.19.0

package/skills/nansen-wallet-deep-dive/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: nansen-wallet-deep-dive
+description: "Who is this wallet and what have they been doing? Identity labels, balance, PnL summary, recent transactions, perp positions, and counterparties."
+metadata:
+  openclaw:
+    requires:
+      env:
+        - NANSEN_API_KEY
+      bins:
+        - nansen
+    primaryEnv: NANSEN_API_KEY
+    install:
+      - kind: node
+        package: nansen-cli
+        bins: [nansen]
+allowed-tools: Bash(nansen:*)
+---
+
+# Wallet Analysis
+
+**Answers:** "Who is this wallet and what have they been doing?"
+
+```bash
+ADDR=<address> CHAIN=ethereum
+
+nansen research profiler labels --address $ADDR --chain $CHAIN
+# → label, category (e.g. "Smart Trader", "Fund", "Public Figure", ENS names)
+
+nansen research profiler balance --address $ADDR --chain $CHAIN
+# → token_symbol, token_name, token_amount, price_usd, value_usd per holding
+
+nansen research profiler pnl-summary --address $ADDR --chain $CHAIN --days 30
+# → realized_pnl_usd, realized_pnl_percent, win_rate, traded_token_count, traded_times, top5_tokens
+
+nansen research profiler transactions --address $ADDR --chain $CHAIN --limit 20
+# → block_timestamp, method, tokens_sent, tokens_received, volume_usd, source_type
+
+nansen research profiler perp-positions --address $ADDR
+# → asset_positions, margin_summary_account_value_usd, margin_summary_total_margin_used_usd
+
+nansen research profiler counterparties --address $ADDR --chain $CHAIN --days 30
+# → counterparty_address, counterparty_address_label, interaction_count, total_volume_usd, volume_in/out_usd
+```
+
+perp-positions returns Hyperliquid data — returns empty if the wallet has no open perps.

package/skills/nansen-wallet-keychain-migration/SKILL.md

@@ -0,0 +1,183 @@
+---
+name: nansen-wallet-keychain-migration
+description: Migrate an existing nansen-cli wallet from insecure password storage (env files, .credentials) to the new secure keychain-backed flow.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - NANSEN_API_KEY
+      bins:
+        - nansen
+    primaryEnv: NANSEN_API_KEY
+    install:
+      - kind: node
+        package: nansen-cli
+        bins: [nansen]
+allowed-tools: Bash(nansen:*)
+---
+
+# Wallet Migration — Old Flow to Secure Keychain
+
+Use this skill when a user already has a nansen-cli wallet set up with the
+**old** password storage method and wants to migrate to the new secure flow.
+
+## When to use
+
+- User mentions they stored their password in `~/.nansen/.env`, a `.env` file, or `memory.md`
+- User gets the stderr warning: `⚠ Password loaded from insecure .credentials file`
+- User asks to "secure my wallet" or "migrate to keychain"
+- User created a wallet before the keychain update was released
+
+## Detect current state
+
+`wallet show` only displays addresses and does NOT load or check the password.
+To detect the actual password situation, check for stored password sources:
+
+```bash
+# 1. Check if a wallet exists at all
+nansen wallet list 2>&1
+
+# 2. Check for insecure password stores
+ls -la ~/.nansen/.env 2>/dev/null && echo "FOUND: ~/.nansen/.env (insecure)"
+ls -la ~/.nansen/wallets/.credentials 2>/dev/null && echo "FOUND: .credentials file (insecure)"
+
+# 3. Try an operation that requires the password (without setting env var)
+nansen wallet export default 2>&1
+```
+
+Interpret the `export` output:
+- `⚠ Password loaded from ~/.nansen/wallets/.credentials` on stderr → needs migration (Path B)
+- Export succeeds silently → password is in keychain, no migration needed
+- `PASSWORD_REQUIRED` JSON error → password not persisted anywhere (Path C or D)
+
+## Migration paths
+
+### Path A: Password in `~/.nansen/.env` (old skill pattern)
+
+The previous wallet skill told agents to write the password to `~/.nansen/.env`.
+
+**Step 1 — Ask the human for their password:**
+
+> "Your wallet password is currently stored in ~/.nansen/.env, which is insecure.
+> I can migrate it to your OS keychain. Please confirm the password you used when
+> creating the wallet, or I can read it from ~/.nansen/.env if you authorize it."
+
+**Step 2 — Migrate:**
+
+The `source` and `nansen wallet secure` MUST run in the same shell so the env
+var is available to the node process:
+
+```bash
+source ~/.nansen/.env 2>/dev/null && nansen wallet secure
+```
+
+**Step 3 — Verify the password actually decrypts the wallet:**
+
+```bash
+# Unset env var to prove keychain works, then export to verify decryption
+unset NANSEN_WALLET_PASSWORD
+nansen wallet export default 2>&1
+```
+
+If export succeeds (shows private keys), the migration worked. If it shows
+`Incorrect password`, the wrong password was migrated — run `nansen wallet
+forget-password` and retry with the correct password.
+
+**Step 4 — Clean up the insecure file:**
+
+```bash
+rm -f ~/.nansen/.env
+```
+
+### Path B: Password in `.credentials` file (auto-saved fallback)
+
+This happens when `wallet create` couldn't access the OS keychain (containers, CI).
+
+```bash
+nansen wallet secure
+```
+
+If the keychain is still unavailable (e.g. containerized Linux without D-Bus),
+`nansen wallet secure` will explain the situation and suggest alternatives.
+
+After migrating, verify decryption works:
+
+```bash
+nansen wallet export default 2>&1
+```
+
+### Path C: Password only in `NANSEN_WALLET_PASSWORD` env var
+
+```bash
+# Persist the env var password to keychain
+nansen wallet secure
+```
+
+Then verify without the env var:
+
+```bash
+unset NANSEN_WALLET_PASSWORD
+nansen wallet export default 2>&1
+```
+
+### Path D: Password lost entirely
+
+The password cannot be recovered. The wallet's private keys are encrypted with
+AES-256-GCM and the password is not stored anywhere recoverable.
+
+**Tell the human:**
+
+> "Your wallet password cannot be recovered. If you have funds in this wallet,
+> they may be inaccessible. You can create a new wallet and transfer any remaining
+> accessible funds."
+
+```bash
+# Create a fresh wallet (human must provide a new password)
+NANSEN_WALLET_PASSWORD="<new_password_from_user>" nansen wallet create --name new-wallet
+```
+
+## Post-migration verification
+
+After any migration, confirm the password was migrated correctly by proving
+the keychain password can actually decrypt the wallet:
+
+```bash
+# Unset env var to prove keychain works
+unset NANSEN_WALLET_PASSWORD
+
+# This MUST succeed — it proves the keychain password decrypts the wallet
+nansen wallet export default 2>&1
+```
+
+If export shows `Incorrect password`, the wrong password was saved to the
+keychain. Fix with:
+
+```bash
+nansen wallet forget-password
+NANSEN_WALLET_PASSWORD="<correct_password>" nansen wallet secure
+```
+
+If `stderr` still shows the `.credentials` warning, the keychain migration did
+not succeed — check if the OS keychain service is running (`secret-tool` on Linux,
+`security` on macOS).
+
+## Forget password (all stores)
+
+If the user wants to remove their persisted password entirely:
+
+```bash
+nansen wallet forget-password
+```
+
+This clears the password from both OS keychain and `.credentials` file. Future
+wallet operations will require `NANSEN_WALLET_PASSWORD` env var or re-running
+`nansen wallet secure`.
+
+## Critical rules for agents
+
+- **NEVER generate a password** — always ask the human
+- **NEVER store the password** in files, memory, logs, or conversation history
+- **NEVER use `--human` flag** — interactive prompts break agents
+- If the human authorizes reading `~/.nansen/.env`, read it in the same command
+  (`source ~/.nansen/.env && nansen wallet secure`) — do not echo or log the value
+- **ALWAYS verify after migration** with `nansen wallet export default` — `wallet show` does NOT prove the password works (it never loads the password)

package/skills/nansen-wallet-manager/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: nansen-wallet-manager
+description: Wallet management — create, list, show, export, send, delete. Use when creating wallets, checking balances, or sending tokens.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - NANSEN_API_KEY
+      bins:
+        - nansen
+    primaryEnv: NANSEN_API_KEY
+    install:
+      - kind: node
+        package: nansen-cli
+        bins: [nansen]
+allowed-tools: Bash(nansen:*)
+---
+
+# Wallet
+
+## Auth Setup
+
+```bash
+# Save API key (non-interactive)
+nansen login --api-key <key>
+# Or via env var:
+NANSEN_API_KEY=<key> nansen login
+
+# Verify
+nansen research profiler labels --address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum
+```
+
+## Wallet Creation (Two-Step Agent Flow)
+
+Wallet creation requires a password from the **human user**. The agent must NOT generate or store the password itself.
+
+> **Step 1 (Agent → Human):** Ask the user to provide a wallet password (minimum 12 characters).
+>
+> **Step 2 (Agent executes):** Run the create command with the password the user gave you.
+
+```bash
+NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create
+```
+
+After creation, the CLI automatically saves the password:
+- **OS keychain** (macOS Keychain, Linux secret-tool, Windows Credential Manager) — secure, preferred
+- **~/.nansen/wallets/.credentials file** — insecure fallback when no keychain is available (e.g. containers, CI)
+
+**All future wallet operations retrieve the password automatically** — no env var or human input needed.
+
+If the `.credentials` file fallback is used, the CLI prints a warning on every operation. To migrate to secure storage later, run `nansen wallet secure`.
+
+### Password resolution order (automatic)
+
+1. `NANSEN_WALLET_PASSWORD` env var (if set)
+2. OS keychain (saved automatically on wallet create)
+3. `~/.nansen/wallets/.credentials` file (insecure fallback, with warning)
+4. Structured JSON error with instructions (if none available)
+
+### Critical rules for agents
+
+- **NEVER generate a password yourself** — always ask the human user
+- **NEVER store the password** in files, memory, logs, or conversation history
+- **NEVER use `--human` flag** — that enables interactive prompts which agents cannot handle
+- After wallet creation, you do NOT need the password for future operations — the keychain handles it
+- If you get a `PASSWORD_REQUIRED` error, ask the user to provide their password again
+
+## Create
+
+```bash
+# Ask the user for a password first, then:
+NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create
+# Or with a custom name:
+NANSEN_WALLET_PASSWORD="<password_from_user>" nansen wallet create --name trading
+```
+
+## List & Show
+
+```bash
+nansen wallet list
+nansen wallet show <name>
+nansen wallet default <name>
+```
+
+## Send
+
+```bash
+# Send native token (SOL, ETH) — password auto-resolved from keychain
+nansen wallet send --to <addr> --amount 1.5 --chain solana
+
+# Send entire balance
+nansen wallet send --to <addr> --chain evm --max
+
+# Dry run (preview, no broadcast)
+nansen wallet send --to <addr> --amount 1.0 --chain evm --dry-run
+```
+
+## Export & Delete
+
+```bash
+# Password auto-resolved from keychain
+nansen wallet export <name>
+nansen wallet delete <name>
+```
+
+## Forget Password
+
+```bash
+# Remove saved password from all stores (keychain + .credentials file)
+nansen wallet forget-password
+```
+
+## Migrate to Secure Storage
+
+```bash
+nansen wallet secure
+```
+
+For detailed migration steps (from `~/.nansen/.env`, `.credentials`, or env-var-only setups), see the **nansen-wallet-migration** skill.
+
+## Flags
+
+| Flag | Purpose |
+|------|---------|
+| `--to` | Recipient address |
+| `--amount` | Amount to send |
+| `--chain` | `evm` or `solana` |
+| `--max` | Send entire balance |
+| `--dry-run` | Preview without broadcasting |
+| `--human` | Enable interactive prompts (human terminal use only — agents must NOT use this) |
+| `--unsafe-no-password` | Skip encryption (keys stored in plaintext — NOT recommended) |
+
+## Environment Variables
+
+| Var | Purpose |
+|-----|---------|
+| `NANSEN_WALLET_PASSWORD` | Wallet encryption password — only needed for initial `wallet create`. After that, the OS keychain handles it. |
+| `NANSEN_API_KEY` | API key (also set via `nansen login --api-key <key>`) |
+| `NANSEN_EVM_RPC` | Custom EVM RPC endpoint |
+| `NANSEN_SOLANA_RPC` | Custom Solana RPC endpoint |

package/skills/nansen-wallet-profiler/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: nansen-wallet-profiler
+description: Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Use when analysing a specific wallet address or comparing wallets.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - NANSEN_API_KEY
+      bins:
+        - nansen
+    primaryEnv: NANSEN_API_KEY
+    install:
+      - kind: node
+        package: nansen-cli
+        bins: [nansen]
+allowed-tools: Bash(nansen:*)
+---
+
+# Wallet Profiler
+
+All commands: `nansen research profiler <sub> [options]`
+
+`--address` and `--chain` required for most commands.
+
+## Balance & Identity
+
+```bash
+nansen research profiler balance --address <addr> --chain ethereum
+nansen research profiler labels --address <addr> --chain ethereum
+nansen research profiler search --query "Vitalik"
+```
+
+## PnL
+
+```bash
+nansen research profiler pnl --address <addr> --chain ethereum --days 30
+nansen research profiler pnl-summary --address <addr> --chain ethereum
+```
+
+## Transactions & History
+
+```bash
+nansen research profiler transactions --address <addr> --chain ethereum --limit 20
+nansen research profiler historical-balances --address <addr> --chain solana --days 30
+```
+
+## Relationships
+
+```bash
+nansen research profiler related-wallets --address <addr> --chain ethereum
+nansen research profiler counterparties --address <addr> --chain ethereum --days 30
+```
+
+## Perps (no --chain)
+
+```bash
+nansen research profiler perp-positions --address <addr>
+nansen research profiler perp-trades --address <addr> --days 7
+```
+
+## Batch, Trace & Compare
+
+```bash
+# Batch — profile multiple wallets at once
+nansen research profiler batch \
+  --addresses "0xabc,0xdef" --chain ethereum \
+  --include labels,balance,pnl
+
+# Trace — BFS multi-hop counterparty trace (makes N*width API calls)
+nansen research profiler trace --address <addr> --chain ethereum --depth 2 --width 5
+
+# Compare — shared counterparties and tokens between two wallets
+nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum
+```
+
+## Flags
+
+| Flag | Purpose |
+|------|---------|
+| `--address` | Wallet address (required) |
+| `--chain` | Required except for perps and search |
+| `--days` | Lookback period (default 30) |
+| `--limit` | Number of results |
+| `--include` | Batch fields: `labels,balance,pnl` |
+| `--depth` | Trace depth 1-5 (default 2) |
+| `--width` | Trace width — keep low to save credits |
+| `--fields` | Select specific fields |
+| `--table` | Human-readable table output |
+| `--format csv` | CSV export |
+
+## Notes
+
+- `pnl-summary` has no pagination support (returns aggregate stats, not a list).
+- `perp-positions` has no pagination support.
+- `labels` has no pagination support — the API ignores `per_page` and always returns all labels for the address. `--limit` is not available for this sub-command.
+- `transactions` caps at per_page=100 (API limit).
+- `trace` makes many API calls — use `--width` conservatively.
+- `batch` accepts `--file <path>` with one address per line as alternative to `--addresses`.

package/skills/nansen-web-fetcher/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: nansen-web-fetcher
+description: Fetch and analyze content from one or more URLs using AI (Gemini 2.5 Flash). Use when you have specific URLs and need to extract or summarize their content. Pairs well with `nansen web search` results.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - NANSEN_API_KEY
+      bins:
+        - nansen
+    primaryEnv: NANSEN_API_KEY
+    install:
+      - kind: node
+        package: nansen-cli
+        bins: [nansen]
+allowed-tools: Bash(nansen:*)
+---
+
+# Web Fetch
+
+Fetch and analyze content from one or more URLs using Gemini 2.5 Flash with URL context.
+
+```bash
+nansen web fetch https://nansen.ai --question "What products does Nansen offer?"
+nansen web fetch --url https://example.com --url https://other.com --question "Compare these two sites"
+nansen web fetch https://docs.uniswap.org/contracts/v4/overview --question "What changed in v4?"
+```
+
+Positional args and `--url` flags can be combined — all become URLs to fetch.
+
+| Flag | Values | Default | Purpose |
+|------|--------|---------|---------|
+| `--url` | URL | — | URL to fetch (repeatable for multiple URLs, up to 20) |
+| `--question` | string | **required** | Question to answer about the URL content |
+| `--pretty` | flag | off | Human-readable JSON |
+
+Returns:
+- `analysis` — AI-generated answer to your question
+- `retrieved_urls` — URLs successfully fetched
+- `failed_urls` — URLs that could not be retrieved
+
+**Tip:** Combine with `web search` — search first to find relevant URLs, then fetch to get full content.
+
+```bash
+# Find and analyze in two steps
+nansen web search "uniswap v4 launch" --num-results 3 --fields link
+nansen web fetch https://blog.uniswap.org/... --question "What are the key changes?"
+```
+
+**Note:** 30s timeout. Paywalled or bot-blocked pages may appear in `failed_urls`.

package/skills/nansen-web-searcher/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: nansen-web-searcher
+description: Search the web for one or more queries in parallel. Use when you need current information, news, prices, or any web content to complement on-chain Nansen data.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - NANSEN_API_KEY
+      bins:
+        - nansen
+    primaryEnv: NANSEN_API_KEY
+    install:
+      - kind: node
+        package: nansen-cli
+        bins: [nansen]
+allowed-tools: Bash(nansen:*)
+---
+
+# Web Search
+
+Search the web for one or more queries in parallel via the Serper API.
+
+```bash
+nansen web search "bitcoin price"
+nansen web search "solana ecosystem news" --num-results 5
+nansen web search --query "ethereum ETF" --query "bitcoin ETF" --num-results 3
+```
+
+Positional args and `--query` flags can be combined — all become queries.
+
+| Flag | Values | Default | Purpose |
+|------|--------|---------|---------|
+| `--query` | string | — | Query string (repeatable for multiple queries) |
+| `--num-results` | 1–20 | 10 | Results per query |
+| `--pretty` | flag | off | Human-readable JSON |
+
+Returns `results[]` — one entry per query, each with `organic[]` (title, link, snippet, date) and optional `knowledge_graph`.
+
+**Note:** Some domains are excluded from results (paywalled/unfetchable sites like bloomberg.com, twitter.com). Use `nansen web fetch` to retrieve content from specific URLs.

package/src/api.js

@@ -7,9 +7,15 @@ import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { EVM_CHAINS } from './chain-ids.js';
+import { getAnonymousId, TELEMETRY_DISABLED } from './telemetry.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
+function telemetryHeaders() {
+  if (TELEMETRY_DISABLED) return {};
+  return { 'X-Anonymous-Id': getAnonymousId() };
+}
+
 const { version: packageVersion } = JSON.parse(
   fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8')
 );
@@ -442,6 +448,7 @@ export class NansenAPI {
         'Content-Type': 'application/json',
         'X-Client-Type': 'nansen-cli',
         'X-Client-Version': packageVersion,
+        ...telemetryHeaders(),
         'Payment-Signature': signature,
         ...this.defaultHeaders,
         ...options.headers,
@@ -493,11 +500,12 @@ export class NansenAPI {
             ...(!isGet && { 'Content-Type': 'application/json' }),
             'X-Client-Type': 'nansen-cli',
             'X-Client-Version': packageVersion,
+            ...telemetryHeaders(),
             ...(this.apiKey ? { 'apikey': this.apiKey } : {}),
             ...this.defaultHeaders,
             ...options.headers
           },
-          ...(!isGet && { body: JSON.stringify(NansenAPI.cleanBody(body)) })
+          ...(!isGet && method !== 'DELETE' && { body: JSON.stringify(NansenAPI.cleanBody(body)) })
         });
       } catch (err) {
         // Network-level errors - retry these too
@@ -538,12 +546,20 @@ export class NansenAPI {
       }
 
       if (!response.ok) {
-        let message = data.message || data.error || `API error: ${response.status}`;
+        let message = data.message || data.error
+          || (typeof data.detail === 'string' ? data.detail : data.detail?.message)
+          || `API error: ${response.status}`;
+        // nansen-api proxy stringifies nested error dicts via Python str(), producing
+        // "{'message': 'actual error', ...}". Extract the inner message if present.
+        const nestedMatch = typeof message === 'string' && message.match(/['"]message['"]\s*:\s*['"](.*?)['"]/);
+        if (nestedMatch) message = nestedMatch[1];
         const code = statusToErrorCode(response.status, data);
         const retryAfterMs = parseRetryAfter(response.headers.get('retry-after'));
 
         // Enhance messages for specific error codes
-        if (code === ErrorCode.UNSUPPORTED_FILTER) {
+        if (code === ErrorCode.UNAUTHORIZED) {
+          message = this.apiKey ? message : 'Not logged in. Run: nansen login';
+        } else if (code === ErrorCode.UNSUPPORTED_FILTER) {
           message = message.replace(/\.+$/, '') + '. This filter is not supported for this token/chain combination. Do not retry.';
         } else if (code === ErrorCode.CREDITS_EXHAUSTED) {
           message = message.replace(/\.+$/, '') + '. No retry will help. Check your Nansen dashboard for credit balance.';
@@ -819,6 +835,31 @@ export class NansenAPI {
     return this.request('/api/v1/search/general', body);
   }
 
+  async webSearch(params = {}) {
+    const { queries, numResults = 10 } = params;
+    if (!queries || queries.length === 0) {
+      throw new NansenError('At least one query is required', ErrorCode.MISSING_PARAM);
+    }
+    return this.request('/api/v1/search/web-search', {
+      queries,
+      num_results: numResults,
+    }, { cache: false });
+  }
+
+  async webFetch(params = {}) {
+    const { urls, question } = params;
+    if (!urls || urls.length === 0) {
+      throw new NansenError('At least one URL is required', ErrorCode.MISSING_PARAM);
+    }
+    if (!question) {
+      throw new NansenError('A question is required', ErrorCode.MISSING_PARAM);
+    }
+    return this.request('/api/v1/search/web-fetch', {
+      urls,
+      question,
+    }, { cache: false });
+  }
+
   async addressHistoricalBalances(params = {}) {
     const { address, chain = 'ethereum', filters = {}, orderBy, pagination, days = 30 } = params;
     if (address) {
@@ -1264,6 +1305,38 @@ export class NansenAPI {
       wallet_address: walletAddress
     });
   }
+
+  // ============= Smart Alert Endpoints =============
+
+  async alertsList(params = {}) {
+    const defined = Object.fromEntries(Object.entries(params).filter(([, v]) => v !== undefined));
+    const qs = Object.keys(defined).length > 0 ? '?' + new URLSearchParams(defined).toString() : '';
+    return this.request(`/api/v1/smart-alert/list${qs}`, {}, { method: 'GET' });
+  }
+
+  async alertsCreate(params = {}) {
+    return this.request('/api/v1/smart-alert', params);
+  }
+
+  async alertsUpdate(params = {}) {
+    return this.request('/api/v1/smart-alert', params, { method: 'PATCH' });
+  }
+
+  async alertsToggle(params = {}) {
+    return this.request('/api/v1/smart-alert/toggle', params, { method: 'PATCH' });
+  }
+
+  async alertsGet(id) {
+    // TODO: replace with GET /api/v1/smart-alert/{id} once a get-by-id endpoint exists.
+    // Fetching the full list does not scale for users with many alerts.
+    const result = await this.alertsList();
+    const alerts = Array.isArray(result) ? result : result?.alerts ?? result?.data ?? [];
+    return alerts.find(a => a.id === id) ?? null;
+  }
+
+  async alertsDelete(alertId) {
+    return this.request(`/api/v1/smart-alert/${encodeURIComponent(alertId)}`, {}, { method: 'DELETE' });
+  }
 }
 
 export default NansenAPI;