TokenMix Crypto Intelligence Agent

TokenMix Crypto Intelligence Agent

Personalized crypto market intelligence and decision-support reports powered by TokenMix.

TokenMix Crypto Intelligence Agent is an open-source crypto research tool. It reads public market data, exchange data, DeFi data, news, and developer signals, then combines them with your risk profile, watchlist, and time horizon to generate evidence-backed research reports.

This guide focuses on one thing: configuring your TokenMix API key so the agent can call models through TokenMix.

Important: this is a research and decision-support tool. It is not a trading bot, does not place trades, and should not be treated as financial advice.

Before You Start

You need:

  1. A TokenMix account.
  2. A TokenMix API key.
  3. A computer or server with Node.js or Docker.
  4. A crypto asset to analyze, such as BTC, ETH, or SOL.

If you do not have an API key yet, sign in to TokenMix, open the API Key page in the dashboard, and create a new key. Copy the full key. It usually starts with sk-tm-.

Step 1: Download the Project

Open a terminal and run:

git clone https://github.com/TokenMixAi/tokenmix-crypto-intelligence-agent
cd tokenmix-crypto-intelligence-agent
npm install
cp .env.example .env

This creates a .env file. You will put your TokenMix API key there.

Step 2: Fill In TokenMix Settings

Open .env and find:

TOKENMIX_API_KEY=
TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1
TOKENMIX_MODEL=claude-opus-4.7
TOKENMIX_ROUTING=balanced
REQUIRE_TOKENMIX_KEY=true

Change it to:

TOKENMIX_API_KEY=sk-tm-your-tokenmix-key
TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1
TOKENMIX_MODEL=<model-short-id>
TOKENMIX_ROUTING=balanced
REQUIRE_TOKENMIX_KEY=true

Notes:

  1. Keep TOKENMIX_BASE_URL as https://api.tokenmix.ai/v1.
  2. Make sure the API key has no extra spaces.
  3. TOKENMIX_MODEL must be a model ID supported by TokenMix.
  4. For complex reports, use a stronger model.

Step 3: Set Your Profile

The agent adjusts its report based on your role and risk profile. A short-term trader and a long-term researcher should not receive the same framing.

Example:

npm run dev -- profile --role crypto_researcher --risk balanced --horizon weekly --interests "AI agents,Solana,DeFi" --style standard

If you only want to test quickly, you can skip this step and use the default profile.

Step 4: Analyze an Asset

Start with BTC:

npm run dev -- analyze BTC

Or analyze SOL:

npm run dev -- analyze SOL

A successful run prints a Markdown report with market context, evidence, data quality, risk score, personalized observations, and confirmation or invalidation signals.

Action Bias is not a buy or sell instruction. It is only a research-oriented bias such as watch, wait for confirmation, opportunity watch, caution, or risk-off.

Step 5: Set a Watchlist

npm run dev -- watchlist BTC ETH SOL TAO VIRTUAL

Then generate a daily brief:

npm run dev -- daily

Step 6: Use the Web UI

Start the API server and Web UI:

npm run dev:api

Open:

http://localhost:3000

On first production launch, if APP_AUTH_PASSWORD is empty, the browser will ask you to create a deployment password. The app stores only a password hash in data/auth.json.

Optional: Run with Docker

cp .env.example .env

Fill in .env, then run:

docker compose up --build

Open:

http://localhost:3000

Troubleshooting

Missing TokenMix API Key

Check that .env contains:

TOKENMIX_API_KEY=sk-tm-your-tokenmix-key

If REQUIRE_TOKENMIX_KEY=true, AI reports require a TokenMix key.

Model Not Available

Check that TOKENMIX_MODEL is a model ID currently supported by TokenMix.

Report Generation Is Slow

The agent fetches multiple public data sources and asks a model to generate a long report. Start with BTC for testing.

The Report Sounds Like Investment Advice

Treat it as research material only. The agent does not provide buy, sell, short, or guaranteed upside instructions, and it does not control wallets or execute trades.

Summary

Set TOKENMIX_API_KEY to your TokenMix sk-tm-... key, keep TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1, choose a TokenMix model, and run npm run dev -- analyze BTC to generate a TokenMix-powered crypto intelligence report.