{"_id":"@1xp-ai/binance-skill","name":"@1xp-ai/binance-skill","dist-tags":{"latest":"1.4.0"},"versions":{"1.4.0":{"name":"@1xp-ai/binance-skill","version":"1.4.0","description":"Public-only Binance market data skill for Spot and USDT-M Futures.","type":"module","bin":{"binance-skill":"dist/cli.js"},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc -p tsconfig.json","dev":"tsc -w -p tsconfig.json","lint":"eslint . && node scripts/validate-md-tables.js","prepublishOnly":"npm run build","pretest":"npm run build","test:unit":"vitest","test:watch":"vitest","test":"npm run test:unit -- --run","precoverage":"npm run build","coverage":"npx vitest run --coverage"},"keywords":["binance","spot","futures","market-data","ai","crypto","skill"],"author":{"name":"1XP-AI"},"license":"MIT","homepage":"https://1xp-ai.github.io/binance-skill/","repository":{"type":"git","url":"git+https://github.com/1XP-AI/binance-skill.git"},"bugs":{"url":"https://github.com/1XP-AI/binance-skill/issues"},"devDependencies":{"@eslint/compat":"^2.0.2","@eslint/js":"^9.39.2","@types/node":"^25","@vitest/coverage-v8":"^4.0.18","eslint":"^9.39.2","globals":"^17.3.0","husky":"^9.1.7","typescript":"^5.9.3","typescript-eslint":"^8.53.1","vitest":"^4.0.18"},"dependencies":{},"_id":"@1xp-ai/binance-skill@1.4.0","gitHead":"6491170eb198b25741828051db7708fa3230a4bd","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-bURcKveCRKWxl3gTx7ZrzUJPlv0iQhJ9PwtSpmeaEIaqv8OC71c7k1cDVuYzPJ/GEu64OLK2CSIx1VysiBijLQ==","shasum":"511e0da2e029308e04d4b909abe702ded9e05e2e","tarball":"https://registry.npmjs.org/@1xp-ai/binance-skill/-/binance-skill-1.4.0.tgz","fileCount":22,"unpackedSize":66997,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDOtVZhijFrywWvdAelnF6LpOcszegUsisbcfKLWvaFswIgeaijXJdftO11RiWQwB3dve3olBJnHe2hV8Hc0Vn+VVM="}]},"_npmUser":{"name":"1xp-ai","email":"tech@1xp.com"},"directories":{},"maintainers":[{"name":"1xp-ai","email":"tech@1xp.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/binance-skill_1.4.0_1770432229264_0.5226386103110203"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-07T02:43:49.164Z","1.4.0":"2026-02-07T02:43:49.404Z","modified":"2026-02-07T02:43:49.604Z"},"maintainers":[{"name":"1xp-ai","email":"tech@1xp.com"}],"description":"Public-only Binance market data skill for Spot and USDT-M Futures.","homepage":"https://1xp-ai.github.io/binance-skill/","keywords":["binance","spot","futures","market-data","ai","crypto","skill"],"repository":{"type":"git","url":"git+https://github.com/1XP-AI/binance-skill.git"},"author":{"name":"1XP-AI"},"bugs":{"url":"https://github.com/1XP-AI/binance-skill/issues"},"license":"MIT","readme":"# @1xp-ai/binance-skill\n\n[![npm version](https://img.shields.io/npm/v/@1xp-ai/binance-skill.svg)](https://www.npmjs.com/package/@1xp-ai/binance-skill)\n[![npm downloads](https://img.shields.io/npm/dm/@1xp-ai/binance-skill.svg)](https://www.npmjs.com/package/@1xp-ai/binance-skill)\n[![Coverage](https://img.shields.io/badge/Coverage-90%25-brightgreen.svg)](https://github.com/1XP-AI/binance-skill)\n[![Tests](https://github.com/1XP-AI/binance-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/1XP-AI/binance-skill/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)\n\n> 🤖 Public-only Binance market data skill (Spot + USDT-M Futures)\n\nA lightweight, public-only wrapper for Binance market data with built-in backoff handling for rate limits. No API keys required.\n\n## 📦 Installation\n\n```bash\nnpm install @1xp-ai/binance-skill\n```\n\n## 🚀 Quick Start\n\n```typescript\nimport {\n  pingSpot,\n  getSpotTickerPrice,\n  getSpotOrderbook,\n  getFuturesTicker24hr\n} from '@1xp-ai/binance-skill';\n\nawait pingSpot();\n\nconst ticker = await getSpotTickerPrice('BTCUSDT');\nconsole.log(`BTCUSDT price: ${ticker.price}`);\n\nconst orderbook = await getSpotOrderbook('BTCUSDT', 100);\nconsole.log(`Top bid: ${orderbook.bids[0][0]}`);\n\nconst futuresTicker = await getFuturesTicker24hr('BTCUSDT');\nconsole.log(`Futures 24h last: ${(futuresTicker as { lastPrice: string }).lastPrice}`);\n```\n\n## ✨ Features\n\n### 📊 Spot Public Data\n- Ping and server time\n- Exchange info\n- Ticker price (single/all)\n- Order book, recent trades, klines\n\n### 📈 USDT-M Futures Public Data\n- Exchange info\n- Funding rate, mark price, premium index\n- 24hr ticker, order book, recent trades, klines\n\n### 🧠 Analysis Utilities\n- Generic orderbook analysis helpers\n- Microstructure analytics (OBI/WOBI, VWAP, liquidity slope)\n\n## 📖 API Reference (Summary)\n\n### Spot (Public)\n\n| Function | Description |\n|----------|-------------|\n| `pingSpot()` | Ping spot API |\n| `getSpotServerTime()` | Spot server time |\n| `getSpotExchangeInfo({ symbol?, symbols? })` | Exchange info |\n| `getSpotTickerPrice(symbol?)` | Ticker price (symbol/all) |\n| `getSpotOrderbook(symbol, limit?)` | Order book depth |\n| `getSpotTrades(symbol, limit?)` | Recent trades |\n| `getSpotKlines({ symbol, interval, startTime?, endTime?, limit? })` | Klines |\n\n### USDT-M Futures (Public)\n\n| Function | Description |\n|----------|-------------|\n| `getFuturesExchangeInfo()` | Futures exchange info |\n| `getFuturesFundingRate({ symbol?, startTime?, endTime?, limit? })` | Funding rate |\n| `getFuturesMarkPrice(symbol?)` | Mark price (premium index) |\n| `getFuturesPremiumIndex(symbol?)` | Premium index |\n| `getFuturesTicker24hr(symbol?)` | 24hr ticker |\n| `getFuturesOrderbook(symbol, limit?)` | Order book depth |\n| `getFuturesRecentTrades(symbol, limit?)` | Recent trades |\n| `getFuturesKlines({ symbol, interval, startTime?, endTime?, limit? })` | Klines |\n\n## 🧪 Testing\n\n```bash\nnpm test\n```\n\n## 📁 Project Structure\n\n```\nbinance-skill/\n├── src/\n│   ├── api/\n│   │   └── public.ts    # Spot + Futures public endpoints\n│   ├── analyzer.ts      # Microstructure analysis utilities\n│   ├── trading.ts       # Generic analysis helpers\n│   └── index.ts         # Main exports\n├── skill/               # Skill documentation (GitHub Pages)\n│   ├── SKILL.md\n│   ├── SECURITY.md\n│   └── HEARTBEAT.md\n└── docs/                # Internal documentation\n    ├── API.md\n    └── VERSIONING.md\n```\n\n## 📄 License\n\nMIT © [1XP-AI](https://github.com/1XP-AI)\n\n## 🔗 Links\n\n- [📘 Skill Documentation](https://1xp-ai.github.io/binance-skill/)\n- [📦 npm Package](https://www.npmjs.com/package/@1xp-ai/binance-skill)\n- [🐛 Issues](https://github.com/1XP-AI/binance-skill/issues)\n","readmeFilename":"README.md","_rev":"1-40b719d832872e0bac66b1d6ea3de9af"}