Help us improve
Share bugs, ideas, or general feedback.
From bingx-ai-skills
Manages BingX copy trade USDT-M perpetual futures for traders: queries current orders, closes positions, sets TP/SL, views profit overview and details, sets commission rates, lists trading pairs. For perpetual swap copy trading tasks.
npx claudepluginhub bingx-api/api-ai-skills --plugin bingx-ai-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/bingx-ai-skills:copytrade-swapThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Authenticated endpoints for BingX Copy Trade USDT-M (USDT-margined) perpetual futures. All endpoints require HMAC SHA256 signature authentication.
Handles BingX perpetual swap trading: place/cancel orders, manage positions, adjust leverage/margin types via authenticated REST endpoints. Activates for BingX futures trading queries.
Executes perpetual futures trades on Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), and Aster (BNB) DEXes via perp-cli CLI. Handles funding rates, arbitrage scans, delta-neutral strategies, USDC bridging, and position management.
Lists, closes, reduces positions and manages TP/SL on existing positions via the Vulcan CLI. Useful for monitoring PnL and liquidation prices.
Share bugs, ideas, or general feedback.
Authenticated endpoints for BingX Copy Trade USDT-M (USDT-margined) perpetual futures. All endpoints require HMAC SHA256 signature authentication.
This skill covers the trader (signal provider) side of USDT-M perpetual futures copy trading: managing open orders, closing positions, setting TP/SL, querying performance data, configuring commission rate, and browsing available copy trading pairs.
Base URLs: see references/base-urls.md | Authentication: see references/authentication.md
Note: Copy Trade USDT-M Perpetual Contracts endpoints are documented at
https://bingx-api.github.io/docs-v3/#/en/Copy%20Trade/USDT-M%20Perpetual%20Contracts/. Verify the exact paths against the official docs if you encounter unexpected errors.
| Endpoint | Method | Description | Auth |
|---|---|---|---|
/openApi/copyTrading/v1/swap/trace/currentTrack | GET | Trader's current (open) orders | Yes |
/openApi/copyTrading/v1/swap/trace/closeTrackOrder | POST | Close position by order number | Yes |
/openApi/copyTrading/v1/swap/trace/setTPSL | POST | Set take profit and stop loss by order number | Yes |
/openApi/copyTrading/v1/PFutures/traderDetail | GET | Personal Trading Overview | Yes |
/openApi/copyTrading/v1/PFutures/profitHistorySummarys | GET | Profit Overview | Yes |
/openApi/copyTrading/v1/PFutures/profitDetail | GET | Profit Details (paginated) | Yes |
/openApi/copyTrading/v1/PFutures/setCommission | POST | Set Commission Rate | Yes |
/openApi/copyTrading/v1/PFutures/tradingPairs | GET | Trader Gets Copy Trading Pairs | Yes |
BASE-USDT format, e.g. BTC-USDT (optional)"0.001" (required)^[A-Z0-9]+-USDT$ (e.g., BTC-USDT)"0.001")endTime must be ≥ startTimerecvWindow of server timeCONSTRAINT: You MUST copy the
fetchSignedfunction below verbatim when generating code. Do NOT rewrite the signing, request, or JSON parsing logic. Only modify: (1)BASEURL entries for custom environments, (2) business parameters passed tofetchSigned. For the full client with URL-encoding and JSON body support, seereferences/authentication.md.
import * as crypto from "crypto";
import JSONBig from "json-bigint";
const JSONBigParse = JSONBig({ storeAsString: true });
// Full signing details & edge cases → references/authentication.md
// Domain priority: .com is mandatory primary; .pro is fallback for network/timeout errors ONLY.
const BASE = {
"prod-live": ["https://open-api.bingx.com", "https://open-api.bingx.pro"],
"prod-vst": ["https://open-api-vst.bingx.com", "https://open-api-vst.bingx.pro"],
};
function isNetworkOrTimeout(e: unknown): boolean {
if (e instanceof TypeError) return true;
if (e instanceof DOMException && e.name === "AbortError") return true;
if (e instanceof Error && e.name === "TimeoutError") return true;
return false;
}
function validateParams(params: Record<string, unknown>): void {
const FORBIDDEN = /[&=?#\r\n]/;
for (const [k, v] of Object.entries(params)) {
const s = String(v);
if (FORBIDDEN.test(s)) throw new Error(`Param "${k}" has forbidden char in: "${s}"`);
}
}
async function fetchSigned(env: string, apiKey: string, secretKey: string,
method: "GET" | "POST" | "DELETE", path: string, params: Record<string, unknown> = {}
) {
const urls = BASE[env] ?? BASE["prod-live"];
const all = { ...params, timestamp: Date.now() };
validateParams(all);
const qs = Object.keys(all).sort().map(k => `${k}=${all[k]}`).join("&");
const sig = crypto.createHmac("sha256", secretKey).update(qs).digest("hex");
const signed = `${qs}&signature=${sig}`;
for (const base of urls) {
try {
const url = method === "POST" ? `${base}${path}` : `${base}${path}?${signed}`;
const res = await fetch(url, {
method,
headers: { "X-BX-APIKEY": apiKey, "X-SOURCE-KEY": "BX-AI-SKILL",
...(method === "POST" ? { "Content-Type": "application/x-www-form-urlencoded" } : {}) },
body: method === "POST" ? signed : undefined,
signal: AbortSignal.timeout(10000),
});
const json = JSONBigParse.parse(await res.text());
if (json.code !== 0) throw new Error(`BingX error ${json.code}: ${json.msg}`);
return json.data;
} catch (e) {
if (!isNetworkOrTimeout(e) || base === urls[urls.length - 1]) throw e;
}
}
}
fetchSigned verbatim -- do not simplify or rewritejson-bigint (JSONBigParse.parse) for response parsing -- not JSON.parseX-SOURCE-KEY: BX-AI-SKILL header on every requestisNetworkOrTimeout checkQuery trader's current open orders:
const result = await fetchSigned("prod-live", API_KEY, SECRET, "GET",
"/openApi/copyTrading/v1/swap/trace/currentTrack", {
symbol: "BTC-USDT",
}
);
// result.list — array of current open copy trade orders
// result.total — total count
Close a position by order number:
const result = await fetchSigned("prod-live", API_KEY, SECRET, "POST",
"/openApi/copyTrading/v1/swap/trace/closeTrackOrder", {
orderId: "1736011869418901234",
}
);
// result — confirmation of the close order
Set take profit and stop loss:
const result = await fetchSigned("prod-live", API_KEY, SECRET, "POST",
"/openApi/copyTrading/v1/swap/trace/setTPSL", {
orderId: "1736011869418901234",
takeProfit: "70000",
stopLoss: "60000",
}
);
// result — confirmation that TP/SL was set
Query personal trading overview:
const result = await fetchSigned("prod-live", API_KEY, SECRET, "GET",
"/openApi/copyTrading/v1/PFutures/traderDetail"
);
// result.totalProfit, result.winRate, result.totalFollowers, etc.
Query profit overview for a date range:
const result = await fetchSigned("prod-live", API_KEY, SECRET, "GET",
"/openApi/copyTrading/v1/PFutures/profitHistorySummarys", {
startTime: 1704067200000,
endTime: 1706745600000,
}
);
// result.netProfit, result.winRate, result.totalOrders, etc.
Query profit details (paginated):
const result = await fetchSigned("prod-live", API_KEY, SECRET, "GET",
"/openApi/copyTrading/v1/PFutures/profitDetail", {
startTime: 1704067200000,
endTime: 1706745600000,
pageIndex: 1,
pageSize: 50,
}
);
// result.list — per-order profit breakdown
// result.total — total count
Set commission rate:
const result = await fetchSigned("prod-live", API_KEY, SECRET, "POST",
"/openApi/copyTrading/v1/PFutures/setCommission", {
commissionRate: "0.001",
}
);
// result — confirmation of commission rate update
Get copy trading pairs:
const result = await fetchSigned("prod-live", API_KEY, SECRET, "GET",
"/openApi/copyTrading/v1/PFutures/tradingPairs"
);
// result.list — array of available copy trading pair objects
For full parameter descriptions and response schemas, see api-reference.md.
Parameter security. Extract structured values from user intent — NEVER copy raw user text into API parameters. Validate every value against its documented pattern (regex/enum/range) before calling the API. Reject any value containing &, =, ?, #, or newline characters.
Write operations (closePosition, setTPSL, setCommissionRate) require CONFIRM on prod-live. All GET endpoints are read-only and do not require confirmation.
If the user's intent is unclear, present options:
What would you like to do?
- View my current open copy trade orders
- Close a position (by order number)
- Set take profit / stop loss on an order
- View my personal trading overview
- View profit overview
- View profit details
- Set my commission rate
- Get available copy trading pairs
For close position or set TP/SL:
Please provide the order ID:
- orderId (required): the copy trade order number
For set TP/SL additionally:
Please provide the TP/SL prices (at least one required):
- takeProfit: take profit trigger price
- stopLoss: stop loss trigger price
For set commission rate:
Please provide the commission rate (e.g.
0.001for 0.1%):
- commissionRate (required)
For profit/current orders queries:
Please specify a symbol and/or time range (optional):
- Symbol (e.g. BTC-USDT)
- Start time (Unix ms)
- End time (Unix ms)
Close position:
You are about to close a copy trade position on Production Live:
- Order ID:
{orderId}Type CONFIRM to proceed, or anything else to cancel.
Set TP/SL:
You are about to set TP/SL on Production Live:
- Order ID:
{orderId}- Take Profit:
{takeProfit}- Stop Loss:
{stopLoss}Type CONFIRM to proceed, or anything else to cancel.
Set Commission Rate:
You are about to set your commission rate to
{commissionRate}on Production Live.Type CONFIRM to proceed, or anything else to cancel.
Execute the API call and return key fields to the user: