CLI reference

The csds CLI brings token risk checks to your terminal and scripts. It's scriptable (JSON/CSV/NDJSON output), CI-friendly (exit codes mirror risk), and starts free — three lifetime quick checks, no account.

Install

The recommended install is pipx. Full options on the installation page.

$ pipx install csds-cli
$ csds --version

Quickstart

# Analyze a token (chain auto-detected when omitted)
$ csds check 0x6982508145454ce325ddbe47a25d4ec3d2311933

# JSON for scripts; pipe into jq
$ csds check 0x6982… --format json | jq '.risk_score'

Global concepts

Output formats

Most commands take --format. Available formats vary by command:

Exit codes

check and batch set the process exit code from the risk result, so you can gate pipelines without parsing output:

Configuration & precedence

Settings resolve in this order (highest wins): command flags → environment variables → config file (~/.config/csds/config.toml).

csds check

Analyze a single token. Defaults to a quick check; --full runs a standard report and --deep a deep dive.

$ csds check ADDRESS [--chain CHAIN] [--full | --deep] [--format FMT] [--no-color]

# Markdown summary for a report (e.g. paste into an issue)
$ csds check 0x… --full --format md

# Fail a CI step on HIGH/CRITICAL risk
$ csds check 0x… || echo "flagged (exit $?)"

csds batch

Analyze many addresses from a file. Reads one address per line (an optional address,chain pair); lines starting with # are comments. Streams NDJSON by default; a summary is printed to stderr.

$ csds batch FILE [--chain CHAIN] [--format ndjson|csv|table] [--concurrency N]

$ csds batch watchlist.txt --format csv > report.csv

csds tokens

Search the public token database (free, read-only).

$ csds tokens [--search Q] [--chain CHAIN] [--risk-min N] [--risk-max N] [--limit N] [--format FMT]

$ csds tokens --search pepe --chain ethereum --risk-max 40

csds stats

Show platform-wide statistics.

$ csds stats --format json

csds config

Read and write persisted settings (see precedence).

# Set a default chain and output format
$ csds config set default-chain ethereum
$ csds config set default-format json

# Read one key, or all of them
$ csds config get default-chain
$ csds config get

Valid keys: default-chain, default-format, api-url, api-key, wallet-key.

csds auth & dashboard Stub

The auth subcommands (setup, status, fund, export) and dashboard are placeholders today — they print a "not yet implemented" message. They'll manage x402 wallet funding and an interactive dashboard once shipped. See Authentication for current options.

Common workflows

Gate CI on risk

- name: Screen contract
  run: |
    pipx install csds-cli
    csds check ${{ env.CONTRACT }} --chain ethereum --no-color
  # exit 1 (HIGH) or 2 (CRITICAL) fails the step

Extract fields with jq

$ csds check 0x… --format json | jq '{score:.risk_score, level:.risk_level}'

Screen a portfolio

$ csds batch portfolio.txt --format csv | column -t -s,

Troubleshooting

Next