dydt CLI and agent skills

Ask your AI agent about any Solana token or wallet, and get answers from live on-chain data.

Setup guide · Get a free API key · API docs · Pricing

---

What it does

You ask your AI agent a question in plain words, such as "Is this token safe?" or "What are KOLs buying today?". The agent runs the dydt command to fetch live data from dydt, then explains what it found.

It is read-only: it cannot trade, move funds, or touch your wallet.

What you need

• An AI coding agent: Claude Code, Cursor, Codex, Windsurf, Gemini CLI, GitHub Copilot, Cline, or OpenCode. Chat websites such as claude.ai cannot run commands, so they cannot use dydt.
• Node.js 22.4 or newer: check with node --version. If it is missing or older, install the LTS version from nodejs.org.
• A free dydt API key: create one at dydt.ai/developers/keys. No payment needed.

Set it up in 4 steps

Run these in your terminal (Terminal on macOS, PowerShell on Windows, or the terminal panel in Cursor or VS Code).

1. Install the dydt command

npm install -g dydt-cli

2. Add the dydt skills to your agent

npx skills add dydtai/dydt-skills -g

Pick your agent from the list when asked. Skills are short instruction files that tell your agent which dydt command answers which question.

3. Save your API key

dydt config set <your-api-key>

The key is saved on your computer only.

4. Check that it works

dydt sol-price

You should see something like {"price_usd": 121.13}. Restart your agent and ask your first question.

Prefer to let your agent do it? Paste this into your agent: "Set up dydt for me from https://github.com/dydtai/dydt-skills: install the dydt-cli npm package, install the dydt skills globally with npx skills add dydtai/dydt-skills -g, ask me for my API key and save it with dydt config set, then show me the SOL price to confirm it works."

Things to ask

Is <token address> safe? Give me the red flags.
Find the real WIF token, not a copycat, and show its top holders.
What is trending on Solana in the last hour with more than $50k liquidity?
Which pump.fun tokens are about to graduate?
How has wallet <address> done over the last 30 days? Was it one lucky trade?
Who created <token address>, and what happened to their other launches?
What are KOLs buying in the last 24 hours? Group it by token.
Write me a morning brief of the Solana memecoin market.

Copy a token or wallet address from its page on dydt.ai. If your agent answers without using dydt, start your question with "Using dydt, …".

What your agent can look up

Skill	Ask about	Plan
dydt-token	A token's details, supply, holders, pools, and launch curve	Free
dydt-token-check	Red flags on a token, each backed by the data it came from	Free
dydt-dev-check	Who launched a token and how their other launches went	Free
dydt-market	Charts, prices, trades, and top traders	Free
dydt-discover	New, trending, gaining, and about-to-graduate tokens	Free
dydt-wallet	Any wallet's profit and loss, holdings, and trades	Free
dydt-brief	A market summary	Free; KOL and signal parts need Pro
dydt-setup	Installing, saving the key, plans, and fixing errors	Free
dydt-watch	Watching a token or wallet live for a few minutes	Starter and up
dydt-smart-money	What KOLs and labeled wallets are buying and selling	Pro and Scale
dydt-signals	dydt token signals	Pro and Scale

Plans

	Free	Starter	Pro	Scale
Tokens, pools, trades, wallets, discovery	✓	✓	✓	✓
Live monitoring (dydt watch)		✓	✓	✓
KOL trades, labeled wallets, signals			✓	✓

Start on Free. If you ask for something your plan does not include, your agent tells you which plan does. Limits and prices are on the pricing page; pay in USDC or SOL.

Safety

• Read-only. There is no command that trades, transfers, or signs. dydt never asks for a seed phrase or private key; anyone who does is trying to steal from you.
• Your key stays with you. It is stored on your computer (file mode 600) and sent only to dydt.
• Pinned hosts. Requests go only to data.dydt.ai.
• Verifiable builds. Every npm release is published from this repository by GitHub Actions with npm provenance, so the npm page links to the exact commit and build.
• Protected from tricks in token names. Anyone can write a token's name and description. The CLI strips hidden characters and replaces instruction-like text with [filtered] before your agent reads it.
• Not financial advice. Answers report what dydt observed on chain. Labels and signals can be wrong, and memecoins are high risk.

This is the beginning of the README. Read the rest at the original. Read the full README ↗