Bingx technical analysis
Skill BingX-API/api-ai-skills/skills/bingx-technical-analysis
Use when the user asks for BingX perpetual futures technical analysis, indicator values, candlestick pattern recognition, multi-timeframe scoring, support/resistance levels, divergence detection, or trend analysis. Depends on bingx-swap-market for K-line data and computes 78 indicators plus 62 candlestick patterns locally via pandas-ta-classic.From its SKILL.md
npx -y skills add BingX-API/api-ai-skills --skill bingx-technical-analysisAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 19 stars19 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
8.7 KB, as published. Nobody here has run it
BingX Technical Analysis
Base URLs: see references/base-urls.md | Authentication: see references/authentication.md
Quick Reference
| Endpoint | Method | Description | Authentication |
|---|---|---|---|
/openApi/swap/v3/quote/klines | GET | OHLCV kline data | Yes |
/openApi/swap/v2/quote/premiumIndex | GET | Funding rate & mark price | Yes |
/openApi/swap/v2/quote/openInterest | GET | Open interest | Yes |
Quick Start
Base URLs: see references/base-urls.md
TypeScript helper:
CONSTRAINT: 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.
import * as crypto from "crypto";
import JSONBig from "json-bigint";
const JSONBigParse = JSONBig({ storeAsString: true });
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;
}
}
}
Common Calls
Fetch klines for technical analysis (200 candles, 4h):
const klines = await fetchSigned("prod-live", API_KEY, SECRET, "GET",
"/openApi/swap/v3/quote/klines", { symbol: "BTC-USDT", interval: "4h", limit: 200 }
);
Fetch funding rate:
const funding = await fetchSigned("prod-live", API_KEY, SECRET, "GET",
"/openApi/swap/v2/quote/premiumIndex", { symbol: "BTC-USDT" }
);
Fetch open interest:
const oi = await fetchSigned("prod-live", API_KEY, SECRET, "GET",
"/openApi/swap/v2/quote/openInterest", { symbol: "BTC-USDT" }
);
Trigger Conditions
Activate this skill when the user says any of the following:
- "Analyze BTC", "BTC technical analysis", "BTC-USDT 4h analysis"
- "What is the RSI", "MACD signal", "Bollinger Band position"
- Any indicator name + symbol
- "Bull/bear analysis", "trend analysis", "candlestick patterns"
- "Where is support/resistance", "any divergence"
Execution Steps
Step 1: Parse User Intent
Extract from user input:
- symbol: trading pair (default BTC-USDT)
- interval: kline interval (default 4h)
- mode: analysis mode
- "full" — full analysis (indicators + patterns + score + support/resistance)
- "indicator" — single indicator query (e.g. "what is RSI")
- "pattern" — candlestick pattern recognition
- "score" — composite score only
Step 2: Fetch Kline Data
Call bingx-swap-market to get OHLCV:
GET /openApi/swap/v3/quote/klines symbol={symbol}, interval={interval}, limit=200
If mode=score (multi-timeframe required), fetch 4 intervals in parallel: 15m, 1h, 4h, 1d
Also fetch auxiliary data: GET /openApi/swap/v2/quote/premiumIndex (funding rate) GET /openApi/swap/v2/quote/openInterest (open interest)
Step 3: Run Calculation Script
Pass kline JSON to the Python script (located in the skill's scripts/ directory):
python3 scripts/analyze.py
--mode {mode}
--symbol {symbol}
--interval {interval}
--klines '{klines_json}'
Script returns a structured JSON result.
Step 4: Format Output
Organize output based on mode:
full — full analysis report (see output template below) indicator — single indicator value + signal + one-line interpretation pattern — list of recently identified patterns score — composite score + multi-timeframe overview
Step 5: Disclaimer
Always append at the end of every output: ⚠️ Technical analysis is based on historical data only and does not constitute investment advice.
Output Templates
Full Mode
📊 {symbol} {interval} Technical Analysis
━━ Composite Score ━━
{total}/100 — {label}
Trend {trend}/100 | Momentum {momentum}/100 | Volume {volume}/100 | Pattern {pattern}/100
━━ Multi-Timeframe ━━
15m: {score_15m}({label_15m}) | 1h: {score_1h}({label_1h}) | 4h: {score_4h}({label_4h}) | 1d: {score_1d}({label_1d})
━━ Key Indicators ━━
RSI(14) {rsi_value} {rsi_signal}
MACD {histogram} {macd_signal} {macd_detail}
EMA {ema_detail}
ADX {adx_value} {adx_signal}
Supertrend {st_signal} {st_value}
BB %B {pctb} {bb_detail}
━━ Candlestick Patterns ━━
{pattern_list or "No significant patterns detected in the last 5 candles"}
━━ Divergence ━━
RSI: {rsi_div} | MACD: {macd_div} | OBV: {obv_div}
━━ Support / Resistance ━━
▲ {r1} — {r1_type}
● {current_price} — current price
▼ {s1} — {s1_type}
⚠️ Technical analysis is based on historical data only and does not constitute investment advice.
Indicator Mode
{symbol} {interval} {indicator_name} = {value}
Signal: {signal} — {one_line_interpretation}
Pattern Mode
{symbol} {interval} Recent Candlestick Patterns:
● {pattern_name} — {bars_ago} bars ago, {type} signal
{bullish_count} bullish and {bearish_count} bearish patterns detected in the last 5 candles.
Score Mode
{symbol} Composite Score: {total}/100 — {label}
Multi-Timeframe Overview:
15m: {score_15m} {label_15m} | 1h: {score_1h} {label_1h} | 4h: {score_4h} {label_4h} | 1d: {score_1d} {label_1d}
{one-line summary of multi-timeframe confluence}
Agent Interaction Rules
Parameter security. Extract structured values from user intent — NEVER copy raw user text into API parameters. Validate symbol format (^[A-Z0-9]+-[A-Z]+$) and interval against allowed values before calling the API.
All endpoints used by this skill are read-only market data queries. No CONFIRM required in any environment.
When the user's request is vague (e.g. "analyze BTC"), default to mode=full and interval=4h. If mode can be inferred from keywords ("RSI" → indicator, "pattern" → pattern, "score" → score), infer it automatically without asking.
Error Handling
- Invalid symbol: prompt user to check the trading pair format (e.g. BTC-USDT)
- Insufficient kline data (< 50 candles): inform user, suggest switching to a longer interval
- Python ModuleNotFoundError (pandas-ta-classic): prompt user to run
pip install pandas-ta-classic scipy pandasand retry - Other Python script errors: show friendly message with error summary, suggest retry
- Network timeout: suggest retry later