⚡ Быстрый старт
Установка
$git clone github.com/weidali/mexc-sdk-js
$npm install
$cp .env.example .env # вставьте API ключи
npm scripts
order→спот: баланс и ордера
futures→фьючи: позиции и история
ws→live цена и P&L
start→публичные данные
$SYMBOL=ETH_USDT ORDER_ID=123 npm run futures
WebSocket Live — npm run ws
real-time
📈 BTC_USDT Last: $66 514 Fair: $66 512 24h: -1.13% │ 🔼 LONG x20 @ $66 514 P&L: +1.7420 USDT (10.39%)
import { FuturesWS, Futures } from './src/index.js'; const ws = new FuturesWS(API_KEY, API_SECRET); await ws.connect(); await ws.login(); // приватные каналы ws.subscribeTicker('BTC_USDT', (data) => { // цена каждую секунду printLine(`Last: $${data.lastPrice} P&L: ${calcPnl(position, data.lastPrice)}`); }); ws.subscribePersonal({ // live обновления onPosition: (pos) => { position = pos; }, // позиция изменилась onDeal: (deal) => { printDeal(deal); }, // сделка исполнена onAsset: (asset) => { printBalance(asset); }, // баланс обновился });
Spot API
api.mexc.com
src/spot.js
tickerPrice()
Текущая цена
pub
depth()
Стакан ордеров
pub
ticker24h()
24h статистика
pub
exchangeInfo()
Инфо о бирже
pub
accountInfo()
Баланс аккаунта
key
getOrder()
Детали ордера
key
openOrders()
Открытые ордера
key
allOrders()
История ордеров
key
newOrder()
Создать ордер
key
cancelOrder()
Отменить ордер
key
myTrades()
История сделок
key
import { Spot } from './src/index.js'; const client = new Spot(API_KEY, API_SECRET); const price = await client.tickerPrice('BTCUSDT'); const order = await client.getOrder('BTCUSDT', { orderId: '123' }); const account = await client.accountInfo();
Futures API
contract.mexc.com
src/futures.js
ticker()
Тикер + 7d/30d
pub
fairPrice()
Fair price
pub
fundingRate()
Funding rate
pub
depth()
Стакан
pub
accountAssets()
Баланс + P&L
key
openPositions()
Открытые позиции
key
getOrder()
Детали по ID
key
orderHistory()
История ордеров
key
openOrders()
Активные ордера
key
orderDeals()
Трейды ордера
key
getLeverage()
Текущий леверидж
key
import { Futures } from './src/index.js'; const client = new Futures(API_KEY, API_SECRET); const pos = await client.openPositions('BTC_USDT'); const history = await client.orderHistory('BTC_USDT', { pageSize: 20 }); const order = await client.getOrder('793688897413532160');
npm run futures — пример вывода
terminal
bash — mexc-sdk
$ npm run futures
> node --env-file=.env examples/futures.js
 
=== MEXC Futures API ===
 
📈 Тикер BTC_USDT:
   Последняя цена: $66 514
   Fair price:     $66 512,3
   High/Low 24h:   $68 132.5 / $64 941.7
   7d / 30d:       -4.65% / +3.16%
   Funding rate:   0.0007%
 
📋 Открытые позиции (BTC_USDT):
   ──────────────────────────────
   BTC_USDT 🔼 LONG x20
   Объём:         50
   Цена входа:    $66 514
   Ликв. цена:    $63 253.5
   Margin ratio:  2.52%
   Profit ratio:  -0.79%
 
📜 История ордеров:
   ──────────────────────────────
   ID: 793682153752841216   BTC_USDT x20
   Сторона: SELL SHORT   Тип: MARKET
   Цена: 66252.6   Кол-во: 50   P&L: +4.208 USDT (25.08%)
   Комиссия: 0.1325 USDT   30.03.2026, 22:29:31
Spot vs Futures — технические различия
Параметр Spot Futures
Base URL api.mexc.com/api/v3 contract.mexc.com/api/v1
Метод подписи HMAC(params) HMAC(apiKey + timestamp + params)
Заголовок ключа X-MEXC-APIKEY ApiKey + Request-Time + Signature
Формат символа BTCUSDT BTC_USDT
WebSocket URL wss://wbs-api.mexc.com/ws wss://contract.mexc.com/edge
WS авторизация listenKey в URL login { apiKey, signature, reqTime }
Зависимости ws@8.18 — только для WebSocket. REST работает на встроенном fetch