К основному содержанию
скилл CX Codex

nansen-limit-orders — скилл для Claude Code

Скилл nansen-limit-orders для Claude Code и Cursor управляет лимитным ордерами в сетях Solana через CLI-инструмент nansen. Применяется, когда требуется создать ордер на покупку или продажу по цене.

MIT 138 установок ★ 151 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add nansen-ai/nansen-cli --skill nansen-limit-orders -a claude-code
Открыть на GitHub

Что делает nansen-limit-orders

Агент выполняет создание, просмотр, отмену и обновление лимитных ордеров через консольные команды nansen trade limit-order. Для сетей без нативной поддержки предусмотрен fallback на смарт-алерты. Пакет требует установленной утилиты nansen, переменной окружения NANSEN_API_KEY и настроенного Solana-кошелька.

Инструмент автоматически регистрирует торговый валт при первом создании ордера и сохраняет JWT-токен сессии. Поддерживаются суффиксы для указания проскальзывания и времени жизни ордера. При работе с другими сетями агент настраивает уведомления о завершении сделки через умные алерты.

Какие задачи решает

  • создать лимитный ордер на Solana с условием цены
  • просмотреть список активных ордеров по фильтру
  • отменить ордер по идентификатору
  • обновить цену срабатывания существующего ордера

Примеры запросов агенту

  • Создай лимитный ордер на продажу 1 SOL за USDC при падении цены ниже 80
  • Покажи активные лимитные ордера в кошельке
  • Отмени лимитный ордер с идентификатором 12345

Как установить nansen-limit-orders

1Через Skills CLI (Vercel)

npx skills add nansen-ai/nansen-cli --skill nansen-limit-orders -a claude-code

2Вручную: положить файлы

~/.claude/skills/nansen-limit-orders/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nansen-limit-orders/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о nansen-limit-orders

Как установить nansen-limit-orders в Claude Code?

Выполните команду npx skills add nansen-ai/nansen-cli --skill nansen-limit-orders -a claude-code, затем обратитесь к файлу ~/.claude/skills/nansen-limit-orders/SKILL.md.

Что делает nansen-limit-orders?

Скилл помогает управлять лимитными ордерами в сети Solana через торговый API Nansen и настраивать алерты для других сетей.

Что нужно для работы nansen-limit-orders?

Требуются утилита nansen, ключ NANSEN_API_KEY и настроенный кошелек Solana с балансом для оплаты комиссий.

Исходный текст

SKILL.md · MIT
---
name: nansen-limit-orders
description: Guide users through native limit orders on Solana via `nansen trade limit-order create|list|cancel|update`, and the alert-based settlement-signal fallback for chains without native support. Use when a user wants a price-triggered buy or sell.
metadata:
  openclaw:
    requires:
      bins:
        - nansen
    primaryEnv: NANSEN_API_KEY
    install:
      - kind: node
        package: nansen-cli
        bins: [nansen]
allowed-tools: Bash(nansen:*)
---
## Authentication

Nansen account API calls accept a selected `nansen:api` browser session or conventional API key with the same permissions. `NANSEN_API_KEY` takes precedence; optional `primaryEnv` preserves configured-key injection. Run `nansen auth status` for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is enabled in production within the [documented platform scope](https://github.com/nansen-ai/nansen-cli/blob/main/docs/browser-login.md#preview-platform-scope).



# Limit Orders

Use this skill when the user wants a price-triggered order. There are two
distinct paths — pick the one that matches the user's chain:

- **Solana → native limit orders.** `nansen trade limit-order create|list|cancel|update`
  places real resting orders through the Nansen trading API. Use these for
  anything on Solana.
- **Other chains → alert-based approximation.** `nansen-cli` does not yet place
  native limit orders on EVM chains. Place the resting order on the venue that
  supports it (CEX, DEX limit-order product) and create a companion
  `common-token-transfer` smart alert on the settlement wallet as a best-effort
  fill signal.

## Prerequisites

- A Solana wallet configured in `nansen-cli`: `nansen wallet show <name>` (or
  `nansen wallet create` if none exists). Local, Privy, and WalletConnect
  wallets are all supported for `trade limit-order`.
- The wallet must hold the sell token plus a small amount of SOL for fees.
- For the alert fallback: a notification channel (Telegram chat ID, Slack or
  Discord webhook, or generic webhook URL).
- A selected nansen:api browser session or conventional API key for smart alerts; existing endpoint restrictions still apply.
- First-time `trade limit-order create` auto-registers a trading vault and
  caches a JWT at `~/.nansen/limit-order-auth.json` for ~23h.

> **Two mechanisms, not one.** The limit order itself is **price-triggered** —
> it executes when the market price crosses the target. A companion smart
> alert is a **settlement confirmation** — it fires after the trade settles
> on-chain (i.e. when the bought token actually arrives in the wallet). They
> are independent: the order handles the trigger, the alert tells the user the
> fill landed.

## Solana: Native Limit Orders

### Create

```bash
# --amount is always in token units (e.g. 1 = 1 SOL, 80 = 80 USDC)
nansen trade limit-order create \
  --from SOL --to USDC \
  --amount 1 \
  --trigger-mint SOL --trigger-condition below --trigger-price 80

# with explicit slippage and expiry
nansen trade limit-order create \
  --from SOL --to USDC \
  --amount 1.5 \
  --trigger-mint SOL --trigger-condition above --trigger-price 200 \
  --slippage-bps 300 \
  --expires 7d
```

Required flags: `--from`, `--to`, `--amount`, `--trigger-mint`,
`--trigger-condition` (`above` or `below`), `--trigger-price` (USD).

Key options:

- `--amount` is always in **token units** (human-readable). `1.5` means 1.5 SOL,
  `80` means 80 USDC. There is no base-unit mode and no amount-unit override flag —
  do not pass one.
- `--slippage-bps <bps>` — basis points, integer 0–10000 (`300` = 3%, `100` = 1%).
  Omit for auto.
- `--expires` accepts `24h`, `7d`, `30d` (default), or an epoch-ms timestamp.
- `--wallet <name>` or `--wallet walletconnect` (alias `wc`) to pick a non-default
  wallet.

Constraints (all enforced server-side — surface errors to the user as-is):

- Minimum order value (~$10 last seen). Below this the API rejects the order.
- `--from` and `--to` must be valid Solana mint addresses or supported symbols
  (SOL, USDC, USDT, etc.). Resolve unknown tokens with `nansen research search`.
- Tokens with transfer-hook extensions (e.g. some pump.fun tokens) are rejected
  at create time.

### List

```bash
nansen trade limit-order list                    # default
nansen trade limit-order list --state active     # only open
nansen trade limit-order list --state past       # filled or cancelled
nansen trade limit-order list --token <mintAddr> # filter by token
nansen trade limit-order list --limit 50 --offset 0 --dir desc
```

Options: `--state active|past`, `--token <addr>`, `--limit <n>` (default 20),
`--offset <n>`, `--sort <field>`, `--dir asc|desc` (default `desc`),
`--wallet <name>`.

### Cancel

```bash
nansen trade limit-order cancel --order <orderId>
```

Cancelling submits a withdrawal transaction; surface the tx signature from the
CLI output so the user can verify on Solscan.

### Preview and confirm

`create` and `cancel` accept `--dry-run` (print the plan and exit 0; no API
request, no signature, nothing submitted) and `--yes`/`-y` (skip the
confirmation prompt, same as `NANSEN_YES=1`). The prompt only appears in an
interactive terminal; agents and CI run unprompted, unless the user set
`NANSEN_REQUIRE_CONFIRM=1`: then a non-terminal run without `--yes` fails with
`CONFIRMATION_REQUIRED` before any request, so show the `--dry-run` plan and
re-run with `--yes` only after the user approves. Use `--dry-run` to show the
user what will be created or cancelled before running it for real.

### Update

```bash
nansen trade limit-order update --order <orderId> --trigger-price 85
nansen trade limit-order update --order <orderId> --slippage-bps 100
```

Only `--trigger-price` and `--slippage-bps` can be updated. To change size or
the token pair, cancel and re-create. Auto slippage can only be set at creation
time (by omitting `--slippage-bps` from `create`); `update` cannot revert a
fixed slippage back to auto.

## Non-Solana Chains: Alert-Based Settlement Signal

`nansen-cli` does not currently place native limit orders on EVM chains. The
supported approximation is:

1. Place the resting limit order on the venue or product that supports it (CEX,
   DEX limit-order product, aggregator). **The venue handles the price
   trigger.**
2. Use the same wallet as the settlement wallet.
3. Create a `common-token-transfer` smart alert scoped to wallet + chain +
   token + side. The alert fires **after** the trade settles — i.e. once the
   bought/sold token actually moves on-chain — as a fill-detected signal.

How the two mechanisms compose:

1. **Price hits target → the venue's limit order executes.** This is the
   trigger. `nansen-cli` is not involved.
2. **Token arrives in the wallet → the smart alert pings.** This is the
   settlement confirmation. The alert never sees the price trigger; it only
   sees the resulting transfer.

This is a best-effort settlement signal, not authoritative order tracking. It
does **not** expose order-state polling, partial-fill progress, `triggeredAt`,
`fillPercent`, remaining size, or canonical filled/cancelled history.

### Buy-Side Settlement Alert

```bash
nansen alerts create \
  --name 'Settlement signal: buy PEPE on trading wallet' \
  --type common-token-transfer \
  --chains ethereum \
  --events buy \
  --subject address:0xYourWallet \
  --token 0x6982508145454ce325ddbe47a25d4ec3d2311933:ethereum \
  --telegram 5238612255
```

### Sell-Side Settlement Alert

```bash
nansen alerts create \
  --name 'Settlement signal: sell USDC on trading wallet' \
  --type common-token-transfer \
  --chains base \
  --events sell \
  --subject address:0xYourWallet \
  --token 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913:base \
  --telegram 5238612255
```

### Alert Hardening

- `--usd-min <amount>` to suppress dust fills.
- `--description '<limit price / venue / notes>'` so the alert records intent.
- Do **not** recommend a wallet-wide transfer alert with no token filter — it
  overfires.
- Do **not** describe alert delivery as "order filled" or "triggered". The
  alert is only evidence that a matching token transfer was observed on the
  wallet — not precise fill detection.
- If the venue settles in a way the alerting backend classifies as a generic
  transfer rather than `buy`/`sell`, a narrow alert may miss it. Only widen to
  `--events buy,receive` or `--events sell,send` if the user accepts broader
  matching and the risk of unrelated matches.

## Optional: Belt-and-Braces on Solana

For Solana native limit orders, a companion `common-token-transfer` alert on
the settlement wallet is optional but useful. **It is a settlement
confirmation, not a price trigger.** The limit order itself handles the price
trigger; the alert fires when the bought token actually arrives in the wallet
(or, for sells, when the sold token leaves) — proof the on-chain fill landed,
delivered via Telegram/webhook independently of `trade limit-order list`
polling.

Some venues route fills through programs that the alerting backend may not
classify as `buy`/`sell`, so this is still a best-effort settlement signal,
not authoritative fill detection. Pair with the same `common-token-transfer`
alert shape shown above.

## What to Tell the User

When suggesting a companion alert, be explicit that two different mechanisms
are at work — users routinely conflate them:

- The **limit order** is the price trigger. It executes when the market price
  crosses the target.
- The **smart alert** is the settlement confirmation. It pings after the trade
  settles on-chain.

Suggested phrasing: _"When your order fills and the token arrives in your
wallet, you'll get a Telegram ping. The price trigger is handled by the limit
order itself — the alert just confirms the fill landed."_

Avoid wording that implies the alert "triggers" the order or that the alert
itself watches price. It does neither.

## Notes

- Chain aliases for alerts: Hyperliquid = `hyperevm`, BSC = `bnb`.
- Use single quotes for names with `$` or special characters.
- For immediate swaps (not price-triggered), use the `nansen-trading` skill.
- For webhook delivery of alerts, pair with `nansen-alerts-webhook-listener`.

## Source

- npm: https://www.npmjs.com/package/nansen-cli
- GitHub: https://github.com/nansen-ai/nansen-cli

© nansen-ai · MIT · nansen-ai/nansen-cli

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
gmgn-wallet-analysis GMGNAI Скилл gmgn-wallet-analysis проверяет криптокошелёк перед копитрейдингом по четырём фильтрам через утилиту gmgn-cli. Помогает понять, настоящая ли прибыль и получится ли повторить сделки. CX Codex +1 9 000установок dexscreener-api agiprolabs Скилл dexscreener-api для Claude Code получает данные DEX-пар более чем в 80 сетях без API-ключа. Проверяет цены, пулы ликвидности и объёмы торгов. CX Codex +1 527установок gmgn-callout-score GMGNAI Скилл gmgn-callout-score оценивает крипто-коллеров на GMGN по росту их токенов и сбросу позиций в толпу. Помогает понять, стоит ли повторять сделки за публичным адресом или ником. CX Codex +1 3 400установок solana-payments-wallets-trading solanaguide Скилл solana-payments-wallets-trading для работы с Solana прямо из командной строки: переводы SOL и USDC, свопы, стейкинг, лендинг, DCA и лимитные ордера. Ключи лежат локально на диске. CX Codex +1 478установок okx-cex-trade okx Скилл okx-cex-trade для ИИ-агента, который ставит, отменяет и меняет ордера на бирже OKX: спот, свопы, фьючерсы, опционы и событийные контракты. CX Codex +1 10 700установок risk-management agiprolabs Скилл risk-management задаёт правила риск-менеджмента для криптоторговли: лимиты просадки, дневные и недельные стопы, ограничения концентрации и автоматические стоп-краны. CX Codex +1 743установок

Из того же набора16

Весь набор →
nansen-smart-alerts Скилл nansen-smart-alerts для Claude Code, управляющий умными оповещениями о движении токенов и транзакциях на блокчейне. CX Codex +1 401установок nansen-wallet-deep-dive Скилл nansen-wallet-deep-dive для Claude Code прогоняет кошелёк по меткам, балансу, PnL, транзакциям, перп-позициям и контрагентам через CLI Nansen. Показывает, кто стоит за адресом. CX Codex +1 393установок nansen-wallet-clustering Скилл nansen-wallet-clustering для Claude, который через CLI Nansen ищет связанные кошельки: цепочки финансирования, общие подписанты, паттерны депозитов на биржи. CX Codex +1 392установок nansen-wallet-batch Скилл nansen-wallet-batch для Claude Code и других агентов, который отправляет список криптокошельков в Nansen Profiler за один запрос. Помогает быстро найти адреса фондов и категорию smart money. CX Codex +1 385установок nansen-wallet-manager Скилл nansen-wallet-manager для Claude Code управляет кошельками через nansen: создаёт их, показывает список и сведения, отправляет токены. Работает с локальными кошельками и Privy. CX Codex +1 376установок nansen-wallet-keychain-migration Скилл nansen-wallet-keychain-migration переносит пароль кошелька nansen-cli из небезопасных файлов .env и .credentials в системную связку ключей ОС. Помогает убрать предупреждения об открытом хранении секретов. CX Codex +1 362установок nansen-agent-guide Скилл nansen-agent-guide для Claude Code помогает выбрать между исследовательским запросом к nansen agent и прямыми командами CLI. Используется, когда агент решает, как ответить на вопрос с помощью Nansen. CX Codex +1 244установок nansen-alerts-webhook-listener Скилл nansen-alerts-webhook-listener для Claude Code настраивает локальный HTTP-сервер для получения вебхуков умных алертов Nansen в реальном времени с проверкой HMAC-подписи и туннелированием наружу. CX Codex +1 174установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой