claudeers.
// Finance & Trading

bytx-skills

Crypto trading skills for AI assistants on bytx: MCP server + CLI + Claude skills. Paper by default, never without your yes.

// Finance & Trading[ cli ][ api ][ desktop ][ claude ]#claude#finance◷ NOASSERTION$open-sourceupdated 1 day ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up bytx-skills (claude-plugin project) into my current project.
Found on https://claudeers.com/bytx-skills
Repo: https://github.com/byttrade/bytx-skills
Homepage/docs: https://byttrade.com
Detected install method: claude-plugin → /plugin install bytx-skills@byttrade/bytx-skills
Category: finance. Platforms: cli, api, desktop.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)

⚠ Unverified / not recently updated — review before pasting a run-this config.

/plugin marketplace add byttrade/bytx-skills
/plugin install bytx-skills@byttrade/bytx-skills
// or clone
git clone https://github.com/byttrade/bytx-skills

// compatibility

Platformscli, api, desktop
Operating systems—
AI compatibilityclaude
LicenseNOASSERTION
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

bytx-skills — crypto trading skills for AI assistants

English | Русский

Eight steps for one crypto trade, from "what's moving" to the order: scan the perps, read funding and open interest, time the entry, plan the exit, replay the rest of the session 10,000 times, size the position from the money you are ready to lose, check it against your limits, and send it — paper by default, never without your yes.

Works with any AI assistant that supports MCP — for example, Claude. The logic is a Python package with an MCP server and a CLI on the bytx exchange library; for Claude there are also skills (/crypto-scanner …) on top.

Paper trading runs on the exchange's live order book with virtual money: no keys, no signup.

Install

You need uv (brew install uv or curl -LsSf https://astral.sh/uv/install.sh | sh).

Any MCP client (Claude Desktop, Claude Code, Cursor, …): add the server to the client's MCP config — templates in mcp-configs/:

{ "mcpServers": { "bytx-trader": {
    "command": "uvx",
    "args": ["--refresh-package", "bytx", "--refresh-package", "bytx-trader",
             "--from", "bytx-trader@latest", "bytx-trader-mcp"] } } }

Restart the assistant and talk to it: "scan the crypto market", "switch to Bybit, 5 dollars risk per trade", "plan a long on ETH with a stop at 1.5 ATR", "what are my positions". Or start from the server's trade_pipeline prompt. Symbols can be written any way (BTC, btcusdt, BTC/USDT). Set the confirm tool to ask you every time. Without uv: pip install bytx-trader and "command": "bytx-trader-mcp". Claude Desktop says the server failed to start? It may not see uvx: put the full path from which uvx in "command".

Claude only, on top of that:

/plugin marketplace add byttrade/bytx-skills
/plugin install bytx-trader@bytx-skills

or copy the folders: cp -r bytx-skills/crypto-* ~/.claude/skills/ (or your project's .claude/skills/).

any MCP clientClaude only
all eight steps, paper and demoMCP tools
risk gate and one-time confirm tokenin the server
the trade as a scripttrade_pipeline promptskills
/crypto-* commands, triggers by phrase, plugin install✓

The steps

stepMCP tool / CLIwhat it does
crypto-scannerscanTop perps by 24h volume: breakout of the session's opening range, RSI extremes.
crypto-derivsderivsFunding now and 7-day average, open interest change, perp/spot basis, crowded-side flags.
crypto-entryentry_checkWaiting / triggered / expired, on closed bars only.
crypto-exitexit_planStop (range-mid, range, ATR, price), target in R, flat-by time.
crypto-timemachinetimemachine10,000 replays of the rest of the session from the coin's own bars + the same rule on every past session.
crypto-sizesizeSize from risk with fees, margin, liquidation estimate, funding cost. Places nothing.
crypto-riskrisk_checkPASS / BLOCK against your limits.
crypto-brokerexecute, confirm, flatten, positions, reconcileThe only step that sends anything.
settingsMode, exchange, account, limits, session — shown, and changed when you ask.

Crypto trades 24/7, so the "session" is yours: session.start (00:00 UTC by default), range_minutes, entry_until, flat_by — ask the assistant to change them, or bytx-trader settings session.start=13:30. Everything lands in ~/bytx-trader (a project's own crypto/ folder if it has one; BYTX_TRADER_HOME overrides) and each step reads what the last one wrote.

An example: BTC on Binance, November 18 2026, real candles

  1. scan at 01:05 UTC: BTC broke its first-hour range (64,673.5–64,976.3) to the downside; the 01:00 bar closed at 64,588.5, 0.131 % below.
  2. entry_check: triggered, short.
  3. exit_plan --stop range-mid --target-r 2: stop 64,824.9 (0.366 % away), target 64,115.7, flat by 23:55 UTC.
  4. timemachine: 10,000 replays from the last 30 sessions (seed 19): target first 37.6 %, stop first 62.4 %. The same rule on those 30 sessions: fired 30 times, 9 targets, 21 stops. Expectancy before fees +0.13R simulated, −0.10R historical. Verdict: close to a coin flip — that is the point of looking before you risk a dollar.
  5. size with 10 USDT at risk, 5x: ≈0.033 BTC, ≈2,131 USDT notional, margin ≈426, loss at the stop ≈9.94 USDT with fees.
  6. risk_check: PASS.
  7. execute shows the ticket and returns a one-time token; you answer yes; confirm sends it to the paper account.

tests/ reproduce these numbers offline from the candles in tests/fixtures/.

Modes and the gates

modehowkeys
paper (default)live order book, virtual balance account_usdt, real taker feesnone
demo"switch to demo" (settings): the exchange's demo/testnetBYTX_API_KEY, BYTX_SECRET (BYTX_PASSWORD for OKX, KuCoin, Bitget; BYTX_WALLET_ADDRESS, BYTX_PRIVATE_KEY for Hyperliquid) in the server's environment
realnot sent by this package: real orders go through the hosted BYTtrade MCPkept by BYTtrade

Every order, in every mode, passes three gates, enforced in the code:

  1. the risk check passed this exact ticket today (fingerprint);
  2. execute sends nothing — it returns the ticket and a one-time token (5 min); confirm takes the token and your reply word for word, and anything but a plain yes cancels; the risk check runs again;
  3. your client's own approval prompt for confirm.

The client order id comes from the ticket, so if the exchange times out the order is found by that id with reconcile — it is never sent twice. Getting out (flatten) is never blocked by daily limits.

Updates

Started with uvx as above, the server picks up the newest bytx-trader and the newest compatible bytx every time your assistant starts it: fixes and new exchange features arrive with no action on your side. bytx-trader accepts bytx within one series (>=0.2.2,<0.3), so a breaking bytx release never arrives on its own: it comes with a bytx-trader release that was tested against it. Installed with pip, the server checks PyPI once a day and tells you in its first answer when an update is out (BYTX_TRADER_NO_UPDATE_CHECK=1 turns that off). Claude skills installed as a plugin update with the marketplace (/plugin).

Development

pip install -e ".[test]" && pytest

Tests are offline: real candles in tests/fixtures/, orders on bytx.testing paper accounts. CI runs them on every push and daily against the newest bytx; before a bytx release, run them against the release candidate: gh workflow run tests.yml -R byttrade/bytx-skills -f bytx=git+https://github.com/byttrade/bytx@<branch>.

Fine print

Not financial advice. Most people who trade actively lose money; leverage makes it faster. A stop is a plan, not a guarantee: gaps, slippage and auto-deleveraging can fill it far away, and liquidation can come first if leverage is high. Funding is charged every period while a position is open. The time machine is a simulation from the last few weeks, not a prediction. Paper trading simplifies margin and liquidation and does not watch your stop between runs. Keys live in environment variables, never in the chat. Orders are sent only by bytx and bytx-trader as released: an edited install is refused (the bytx license does not permit modified copies; uv cache clean restores it).

MIT. Built on bytx (BYTtrade Source-Available License, installed from PyPI, not copied here). No-code bots, backtests and trade confirmations in Telegram — at byttrade.com.

All risk is yours. bytx-skills is a tool, provided as is, without any warranty. You alone decide whether and how to use it, and you alone bear every loss, missed profit or other consequence, including those caused by errors in the software, the data, an exchange or an AI assistant. Test it yourself — on paper, then on an exchange demo account — and only once you are satisfied that it works for you, use it with real money, in amounts you can afford to lose. The authors and BYTtrade are not liable for any trading results.

// faq

What is bytx-skills?

Crypto trading skills for AI assistants on bytx: MCP server + CLI + Claude skills. Paper by default, never without your yes.. It is open-source on GitHub.

Is bytx-skills free to use?

bytx-skills is open-source under the NOASSERTION license, so it is free to use.

What category does bytx-skills belong to?

bytx-skills is listed under finance in the Claudeers registry of Claude-compatible tools.

0 views
★ 92 stars
unclaimed
updated 1 day ago

// embed badge

bytx-skills on Claudeers
[![Claudeers](https://claudeers.com/api/badge/bytx-skills.svg)](https://claudeers.com/bytx-skills)

// retro hit counter

bytx-skills hit counter
[![Hits](https://claudeers.com/api/counter/bytx-skills.svg)](https://claudeers.com/bytx-skills)

// reviews

// guestbook

0/500

// related in Finance & Trading

🔓

An AI SKILL that provide design intelligence for building professional UI/UX multiple platforms

// financenextlevelbuilder/⟨Python⟩★ 148,689◷ MIT[ claude ]
🔓

TradingAgents: Multi-Agents LLM Financial Trading Framework

// financeTauricResearch/⟨Python⟩★ 123,296◷ Apache-2.0[ claude ]
🔓

AI-powered job application framework built on Claude Code. Fork it, fill in your profile, and let Claude evaluate jobs, tailor CVs, write cover letters, and…

// financeMadsLorentzen/⟨TypeScript⟩★ 72,605◷ MIT[ claude ]
🔓

"Vibe-Trading: Your Personal Trading Agent"

// financeHKUDS/⟨Python⟩★ 38,169◷ MIT[ claude ]
→ see how bytx-skills connects across the ecosystem