mcpField
N
nansen-trade

nansen-trade

github.com/nansen-aiOther144122 installsUpdated today
Repository

About nansen-trade

nansen-trade is a skill for preparing and executing token swaps through the Nansen CLI. It uses a quote-then-execute flow, accepts token symbols or addresses, and requires a wallet even to request a quote.

Key features

  1. 01Request swap quotes for supported chains
  2. 02Specify tokens by symbol or address
  3. 03Execute trades using a quote ID
  4. 04Set slippage tolerance
  5. 05Simulate transactions before broadcast

Use cases

  1. 01Get a quote before swapping tokens
  2. 02Execute a swap using a valid quote
  3. 03Preview a transaction through simulation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-trade

After installing, type/nansen-tradein Claude Code to confirm it loaded.

Details

From the project README

Trade

Two-step flow: quote then execute. Trades are irreversible once on-chain.

Prerequisite: You need a wallet first. Run nansen wallet create before trading.

Quote

nansen trade quote \
  --chain solana \
  --from SOL \
  --to USDC \
  --amount 1000000000

Symbols resolve automatically: SOL, ETH, USDC, USDT, WETH. Raw addresses also work.

Execute

nansen trade execute --quote <quote-id>

Agent pattern

# Pipe quote ID directly into execute
quote_id=$(nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000 2>&1 | grep "Quote ID:" | awk '{print $NF}')
nansen trade execute --quote "$quote_id"

Common Token Addresses

TokenChainAddress
SOLSolanaSo11111111111111111111111111111111111111112
USDCSolanaEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
ETHBase0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
USDCBase0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Amounts are in base units

TokenDecimals1 token =
SOL91000000000
ETH181000000000000000000
USDC61000000

Flags

FlagPurpose
--chainsolana or base
--fromSource token (symbol or address)
--toDestination token (symbol or address)
--amountAmount in base units (integer)
--walletWallet name (default: default wallet)
--slippageSlippage tolerance as decimal (e.g. 0.03)
--quoteQuote ID for execute
--no-simulateSkip pre-broadcast simulation

Environment Variables

VarPurpose
NANSEN_WALLET_PASSWORDRequired for trade execute. Wallet encryption password — persisted in ~/.nansen/.env. Source before executing: source ~/.nansen/.env && nansen trade execute ...
NANSEN_API_KEYAPI key (also set via nansen login)

Agents: Never hold a wallet password only in session memory. If NANSEN_WALLET_PASSWORD is not in ~/.nansen/.env, follow the setup flow in the nansen-wallet skill Password Policy to generate and persist one before proceeding.

Notes

  • Quotes expire after ~1 hour. If execute fails, get a fresh quote.
  • A wallet is required even for quotes (the API builds sender-specific transactions).
  • ERC-20 swaps may require an approval step — execute handles this automatically.

Source

Comments

Markdown supported