{"_id":"@daniyal0100101/binance-mcp","_rev":"2-a77c6c85ea38ea77ce3251eb25275dd3","name":"@daniyal0100101/binance-mcp","dist-tags":{"latest":"2.0.1"},"versions":{"2.0.0":{"name":"@daniyal0100101/binance-mcp","version":"2.0.0","keywords":["binance","mcp","model-context-protocol","claude","trading","crypto","ai","llm"],"author":{"name":"Daniyal","email":"https://github.com/Daniyal0100101"},"license":"MIT","_id":"@daniyal0100101/binance-mcp@2.0.0","maintainers":[{"name":"daniyal0100101","email":"dasif1477@gmail.com"}],"homepage":"https://github.com/Daniyal0100101/binance-mcp-server#readme","bugs":{"url":"https://github.com/Daniyal0100101/binance-mcp-server/issues"},"bin":{"binance-mcp":"dist/index.js"},"dist":{"shasum":"76b651656e115f992a90648b87c54adf44d351bb","tarball":"https://registry.npmjs.org/@daniyal0100101/binance-mcp/-/binance-mcp-2.0.0.tgz","fileCount":54,"integrity":"sha512-C6UAUlx+aJD19+HKk0LAgwZN22bg4Q8BDGpbjC3MXwdoJt0vsK+USgejBghqHFaKg3+TmRShi1Y7nCVxC3uetQ==","signatures":[{"sig":"MEYCIQDbn5wc4DwiHHqVtotnnSHuFdJXtKZ/gcHQFYjf95FXqwIhAJlurJ8i+MN787rwouomr4S51wQbeGqhyn8eLRXuK44F","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157598},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"e4733431277f246c191667cd5dc1709ff5c1c62e","scripts":{"dev":"tsx src/index.ts","lint":"eslint src/**/*.ts","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit"},"_npmUser":{"name":"daniyal0100101","email":"dasif1477@gmail.com"},"repository":{"url":"git+https://github.com/Daniyal0100101/binance-mcp-server.git","type":"git"},"_npmVersion":"10.9.8","description":"Hardened MCP server for Binance market data, account management, and trading — forked from ethancod1ng/binance-mcp-server with critical fixes and expanded tool set","directories":{},"_nodeVersion":"22.23.0","dependencies":{"zod":"^3.22.4","binance-api-node":"^0.12.6","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/binance-mcp_2.0.0_1784206362671_0.7301430495746093","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@daniyal0100101/binance-mcp","version":"2.0.1","description":"Hardened MCP server for Binance market data, account management, and trading — forked from ethancod1ng/binance-mcp-server with critical fixes and expanded tool set","main":"dist/index.js","bin":{"binance-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","lint":"eslint src/**/*.ts tests/**/*.ts","typecheck":"tsc --noEmit","test":"tsc -p tsconfig.test.json && node --test .test-dist/tests/*.test.js"},"keywords":["binance","mcp","model-context-protocol","claude","trading","crypto","ai","llm"],"author":{"name":"Daniyal","email":"https://github.com/Daniyal0100101"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Daniyal0100101/binance-mcp-server.git"},"homepage":"https://github.com/Daniyal0100101/binance-mcp-server#readme","bugs":{"url":"https://github.com/Daniyal0100101/binance-mcp-server/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","binance-api-node":"^0.13.10","zod":"^3.22.4"},"devDependencies":{"@eslint/js":"^10.0.1","@types/node":"^22.0.0","eslint":"^10.10.0","tsx":"^4.23.13","typescript":"^5.7.0","typescript-eslint":"^8.70.0"},"engines":{"node":">=18.0.0"},"gitHead":"623b35a078e798bf589f511fde55ddd7c75ca9c7","types":"./dist/index.d.ts","_id":"@daniyal0100101/binance-mcp@2.0.1","_nodeVersion":"24.20.0","_npmVersion":"11.19.0","dist":{"integrity":"sha512-lJUi1a3bn64RgsoTwwkeUd1iu1+jv0r2OG/ZqJIx4pWzwkKJSai5VoEu1TpnJ4xtxVBXKL09A7omm+ohBZ7u2A==","shasum":"52467d14b2dd732252e946c862bc90b020d9d4b3","tarball":"https://registry.npmjs.org/@daniyal0100101/binance-mcp/-/binance-mcp-2.0.1.tgz","fileCount":59,"unpackedSize":155638,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@daniyal0100101%2fbinance-mcp@2.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCmY3gem9SkyeqkVGx89g0OnhCtPlIONV0bkZelFBG4aQIhAOfMRpD1UtG3pZV1mxJHG91fbkHoBeWdfIGPrDwtGovl"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ce37cd1d-e37a-4659-aad1-16ab82a3f939"}},"directories":{},"maintainers":[{"name":"daniyal0100101","email":"dasif1477@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/binance-mcp_2.0.1_1789561450649_0.21999407142240024"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-16T12:52:42.115Z","modified":"2026-09-16T12:24:11.087Z","2.0.0":"2026-07-16T12:52:42.819Z","2.0.1":"2026-09-16T12:24:10.773Z"},"bugs":{"url":"https://github.com/Daniyal0100101/binance-mcp-server/issues"},"author":{"name":"Daniyal","email":"https://github.com/Daniyal0100101"},"license":"MIT","homepage":"https://github.com/Daniyal0100101/binance-mcp-server#readme","keywords":["binance","mcp","model-context-protocol","claude","trading","crypto","ai","llm"],"repository":{"type":"git","url":"git+https://github.com/Daniyal0100101/binance-mcp-server.git"},"description":"Hardened MCP server for Binance market data, account management, and trading — forked from ethancod1ng/binance-mcp-server with critical fixes and expanded tool set","maintainers":[{"name":"daniyal0100101","email":"dasif1477@gmail.com"}],"readme":"# Binance MCP Server (Hardened Fork)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server for Binance exchange — market data, account management, and trading. Forked from [ethancod1ng/binance-mcp-server](https://github.com/ethancod1ng/binance-mcp-server) with critical bug fixes, an expanded tool set, and production hardening.\n\n## What's fixed vs the original\n\n| Issue | Original | This fork |\n|---|---|---|\n| Timestamp sync | Missing `useServerTime` — signed endpoints fail with -1021 | Fixed with `useServerTime: true` |\n| Symbol validation | Rejects numeric-prefixed symbols (1000SATSUSDT, 1INCHUSDT) | Fixed regex accepts numeric-prefixed symbols |\n| Order types | Only MARKET and LIMIT | All 7 types: MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT, LIMIT_MAKER |\n| Time in force | Hardcoded GTC | Configurable GTC, IOC, FOK |\n| `cancel_all_orders` | Requires symbol parameter | Symbol is optional — can cancel across all pairs |\n| Tool descriptions | Chinese only | English (international) |\n| Rate limiting | No retry logic | Exponential backoff with jitter for -1003 and network errors |\n| Error format | Doubled `isError` + `error` in JSON | Clean single error format |\n| Balance precision | `parseFloat + parseFloat` with FP artifacts | Exact decimal-string addition |\n| Config wiring | `recvWindow`/`timeout` declared but never passed to client | Properly wired |\n| MCP SDK | `@modelcontextprotocol/sdk@0.4.0` | Maintained v1 line (`@modelcontextprotocol/sdk@^1.30.0`) |\n| dotenv | Loads `.env` from cwd at startup | Removed — env vars only via config |\n| Vulnerabilities | 13 known (3 moderate, 10 high) | 0 |\n\n## New tools (not in original)\n\n| Tool | Description |\n|---|---|\n| `get_exchange_info` | Trading rules, lot size filters, price filters, min notional |\n| `get_server_time` | Binance server time + local offset for clock sync diagnostics |\n| `get_avg_price` | 5-minute average price for a trading pair |\n| `get_asset_balance` | Balance for a specific asset |\n| `get_account_trades` | Executed trade history for a pair |\n| `get_trade_fee` | Trading fee rates |\n| `test_order` | Validate order parameters without placing |\n| `get_order` | Get details of a specific order by ID |\n| `get_dust_assets` | List dust assets convertible to BNB |\n| `convert_dust_to_bnb` | Convert dust assets to BNB |\n\n**Total: 20 tools** (up from 10 in the original)\n\n## Installation\n\n```bash\nnpm install @daniyal0100101/binance-mcp\n```\n\nOr use directly with npx:\n\n```bash\nnpx @daniyal0100101/binance-mcp\n```\n\n## Configuration\n\nAdd to your MCP client configuration (Claude Desktop, Hermes, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"binance\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@daniyal0100101/binance-mcp\"],\n      \"env\": {\n        \"BINANCE_API_KEY\": \"your_api_key\",\n        \"BINANCE_API_SECRET\": \"your_api_secret\",\n        \"BINANCE_TESTNET\": \"false\"\n      }\n    }\n  }\n}\n```\n\nSet `BINANCE_TESTNET` to `\"true\"` for testnet mode.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `BINANCE_API_KEY` | Yes | Binance API key |\n| `BINANCE_API_SECRET` | Yes | Binance API secret |\n| `BINANCE_TESTNET` | No | Set `\"true\"` for testnet (default: mainnet) |\n| `LOG_LEVEL` | No | `info` (default) or `debug` for stack traces |\n\n## Tools Reference\n\n### Market Data (7 tools, no API key needed)\n\n- `get_price` — Current price for a trading pair\n- `get_orderbook` — Order book depth data\n- `get_klines` — K-line/candlestick history\n- `get_24hr_ticker` — 24-hour price change statistics\n- `get_exchange_info` — Exchange trading rules and symbol filters\n- `get_server_time` — Binance server time for clock sync diagnostics\n- `get_avg_price` — 5-minute average price\n\n### Account (6 tools, API key required)\n\n- `get_account_info` — Account info with filtered balances\n- `get_asset_balance` — Balance for a specific asset\n- `get_open_orders` — Current open orders (all or by pair)\n- `get_order_history` — Historical orders for a pair\n- `get_account_trades` — Executed trade history\n- `get_trade_fee` — Trading fee rates\n\n### Trading (5 tools, API key required)\n\n- `place_order` — Place an order (all 7 Binance order types)\n- `test_order` — Test order validation without executing\n- `get_order` — Get order details by ID\n- `cancel_order` — Cancel a specific order\n- `cancel_all_orders` — Cancel all open orders (by pair or all)\n\n### Dust Conversion (2 tools, API key required)\n\n- `get_dust_assets` — List dust assets convertible to BNB\n- `convert_dust_to_bnb` — Convert dust to BNB\n\n## Development\n\n```bash\nnpm install\nnpm run build       # Compile TypeScript\nnpm run typecheck   # Type checking without emit\nnpm test            # Regression tests\nnpm run lint        # ESLint\nnpm run dev         # Development mode with tsx\n```\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n## Acknowledgments\n\nOriginally forked from [ethancod1ng/binance-mcp-server](https://github.com/ethancod1ng/binance-mcp-server) by Ethan, published under MIT.","readmeFilename":"README.md"}