Getting started

Wellat is a copy-trading platform. A strategy manager trades, and every copier who joins the strategy mirrors those trades automatically on their own account. The Bot API lets you run that strategy from software instead of by hand.

The API speaks Binance's own wire format: the same paths, parameters, response bodies, error codes, signing scheme and rate-limit headers. If your bot already runs on Binance through CCXT, it runs on Wellat by swapping the exchange class. There is no Wellat SDK to learn.

npm install ccxt @wellat/ccxt

import wellat from '@wellat/ccxt';

const exchange = new wellat({
  apiKey: WELLAT_API_KEY,
  secret: WELLAT_API_SECRET,
});

await exchange.createOrder('BTC/USDT', 'market', 'buy', 0.001);

wellat is a thin subclass of CCXT's binance class with Wellat's hosts and options built in. Stock ccxt.binance works too with a few overrides; see the Quickstart. Requires @wellat/ccxt 0.1.9 or later. For a Futures key pass options: {defaultType: 'future'}.

How it fits together

Thing	What it is
Base URL	`https://bot.mywellat.com`
Spot	`/api/v3/*`, Binance spot shape
USDⓈ-M futures	`/fapi/v1/`, `/fapi/v2/`, `/fapi/v3/*`, Binance futures shape
API key	Created in your trader dashboard, protected by 2FA. One key is bound to exactly one strategy.
Strategy	The thing your bot trades. Spot or Futures. Runs in demo with a virtual balance.
Copiers	Real accounts that mirror the strategy. You never address them; the platform fans out every order.

Your bot never names a strategy, never deposits or withdraws, and can never reach any other account. The API key is the strategy identifier.

Before you write code

Complete the five steps in Account setup:

Sign up and pass KYC.
Switch to the Trader profile.
Enable 2FA and create an API key and secret.
Create a strategy and bind it to that key.
Note the strategy type: it decides whether your bot calls /api/v3 (Spot) or /fapi (Futures).

Then follow the Quickstart to place a first order.

What the API covers

Market data: exchange info, tickers, order book, trades, candles, funding rates.
Account: balances, positions, commission rates.
Orders: place, cancel, cancel all, query, open orders, order history, fills.
Futures controls: leverage, take-profit / stop-loss legs.
Strategy close.

What it does not cover: deposits, withdrawals, transfers, sub-accounts, margin borrowing, WebSocket streams, or anything about copiers. Those are platform concerns, not bot concerns.

Demo with real copiers

A bot strategy runs in demo: real market data, simulated fills, a seeded virtual balance (200 USDT spot, 1,000 USDT futures). Its track record is public, and copiers who join mirror every order on their own real accounts. A funded mode for the strategy itself is planned; the API will not change when it arrives.