csds-cli 0.1.0

Command-line client for CSDS — the Crypto Scam Detection System token risk API

csds — Crypto Scam Detection System CLI

csds is the terminal app for CSDS, a blockchain token risk-analysis service that scores tokens for scam / rug-pull indicators across Ethereum, BNB Smart Chain, and Solana.

It's a single, keyboard-driven, transcript-style app. Analysis is a paid service: you sign in with your own API key and each check is billed against your account balance.

  ____ ____  ____  ____
 / ___/ ___||  _ \/ ___|    crypto safety · token risk checks
| |   \___ \| | | \___ \
| |___ ___) | |_| |___) |   signed in ●   balance $7.10  ≈71 quick   ● localhost:5000
 \____|____/|____/|____/

> 0x6982508145…  ethereum · quick
● risk 26 / 100   SAFE
  ⎿ liquidity locked · ownership renounced · no honeypot detected
  ⎿ saved to history · just now   ^y copy   ^e export json

Install

pip install csds-cli

Requires Python 3.10+. Then just run:

csds

Getting started

1. Create an API key in the dashboard → API Keys, and top up your balance (analysis is billed per check).
2. Launch csds. If you're not signed in, type :login and paste your key (or just paste the key on its own line).
3. Check a token: paste an address at the prompt and press Enter.

Using the app

• Address prompt — paste/type a contract address, press Enter to analyze.
• chain / depth — inline selectors below the prompt. Press Tab to move between fields and ←/→ to change the value. Defaults are remembered.
• Results append to a scrolling transcript (risk score, level, flags, recommendation).

Keys

Key	Action
Enter	run the check (or a :command)
Tab	cycle between address / chain / depth
←/→	change the focused selector
↑/↓	recall previous addresses
^y	copy the last result's summary
^e	export the last result as JSON
^q	quit

Commands

Type these at the prompt:

Command	Does
:login [key]	sign in (prompts for the key if omitted)
:logout	sign out
:history	show recent checks
:account	show email + balance
:export	export the last result as JSON (to Downloads by default)
:exportdir <path>	choose where exports are saved
:help	show help

Keys and balance are per-environment — a key created on production only works on production, and likewise for local.

Supported chains

Ethereum, BNB Smart Chain (bsc), and Solana are live. More are coming.

Links

• Service & dashboard: https://csds.blockchainrangers.com
• Documentation: https://csds.blockchainrangers.com/docs/

License

MIT — see LICENSE.