Too Many Cooks CLI

Command-line interface for the Too Many Cooks funding rates API. Find delta-neutral arbitrage opportunities, compare funding rates across 25 DEX exchanges, and script your workflow.

Install

# One-shot via npx
npx -y @toomanycooks/cli --help

# Or install globally
npm i -g @toomanycooks/cli
tmc --help

Set up

1. Get an API key at https://toomanycooks.app/dashboard/api-keys
2. Save it locally:

   tmc auth set tmc_live_xxxxxxxx
   tmc auth whoami

The key is stored at ~/.toomanycooks/config.json with mode 0600. You can also pass it via TMC_API_KEY env var instead.

Commands

# Authentication
tmc auth set <key>           # Save a key
tmc auth whoami              # Show tier + quota
tmc auth logout              # Forget saved key

# Discovery
tmc exchanges                # List all 25 exchanges

# Live data
tmc rates hyperliquid                       # Top 20 markets, sorted by |APR|
tmc rates hyperliquid --ticker BTC          # Single market
tmc rates hyperliquid --json | jq           # Pipe-friendly JSON

# Arbitrage
tmc strategies                                                  # Top 10 delta-neutral
tmc strategies -c 25 -p 14 -e hyperliquid,lighter,extended      # Custom config
tmc strategies --min-volume 1000000 --json                      # Liquid pairs only

# Compare
tmc compare BTC                              # BTC across all exchanges
tmc compare ETH -e hyperliquid,lighter       # ETH on a subset

Automation examples

# Cron: log top opportunity every hour
0 * * * * /usr/local/bin/tmc strategies -c 1 --json >> /var/log/tmc-strategies.log

# Alert on a specific spread threshold
tmc strategies --json | jq 'map(select(.profitAPR > 0.30)) | length' \
  | xargs -I{} test {} -gt 0 && curl -X POST $WEBHOOK_URL

# Get all funding rates for a ticker as CSV-ish
tmc compare BTC --json | jq -r '.[] | [.exchange, .fundingRateAPR] | @csv'

Local development

git clone https://github.com/toomanycooks/toomanycooks-cli
cd toomanycooks-cli
npm install
npm run dev -- exchanges          # any subcommand works

To point at a local backend:

TMC_API_BASE_URL=http://localhost:3001 tmc exchanges

License

MIT.