Ghid de pornire rapidă pentru utilizatorii cu asistenți de codare AI.

 

Prezentare generală

Acest document este o colecție de competențe API BingX pentru asistenți de codare AI, inclusiv 15 module de competențe, care acoperă Perpetual Futures, tranzacționarea Spot, Copy Trading și gestionarea conturilor.

După instalare, poți interacționa direct în limbaj natural cuAI pentru a interoga datele de piață, a plasa tranzacții și a gestiona conturi, fără a scrie manual niciun cod de solicitare API.

AsistențiAIacceptați:Claude Code,Cursorși alți asistenți de codare AI care acceptă mecanismul Skills.

 

Instalează

  • Instalare generală (Cod Claude / Cursor / Altele)
npx skills add BingX-API/api-ai-skills
  • Cod Claude Instalare dedicată (acceptă actualizări automate)
/plugin add BingX-API/api-ai-skills

Pentru instrucțiuni detaliate de instalare, consultă README.md

 

Prezentarea generală a competențelor

  • USDT-M Perpetual
Numele competenței Scop Autorizație necesară
bingx-swap-market Date de piață: preț, adâncime, linie K, rată de finanțare, poziții deschise etc.         Incomplet
bingx-swap-trade Operațiuni de tranzacționare: plasarea ordinelor, anularea ordinelor, setarea levierului, modul Active etc.          Da
bingx-swap-account Informații despre cont: solduri, poziții active, ratele comisioanelor, fluxuri de fonduri etc.          Da
  • Spot
Numele competenței Scop Autorizație necesară
bingx-spot-market Date de piață: preț, adâncime, linie K,Istoricul de tranzacționare etc.   Incomplet
bingx-spot-trade Operațiuni de tranzacționare: plasarea ordinelor, anularea ordinelor, interogări ale ordinelor,ordine OCO etc.           Da
bingx-spot-account Informații despre cont: solduri, prezentare generală a activelor, transferul activelor etc.        Da
bingx-spot-wallet Operațiuni în cadrul portofelului: depuneri, retrageri, înregistrări ale transferurilor etc.       Da
  • Copy Trading
Numele competenței Scop Autorizație necesară
bingx-copytrade-spot Copy Trading Spot: închiderea pozițiilor de copiere, interogare profituri etc.      Da
bingx-copytrade-swap Copy Trading Futures: închiderea pozițiilor, stabilirea TP/SL, setarea comisionului etc.              Da
  • Gestionarea contului
Numele competenței Scop Autorizație necesară
bingx-fund-account Cont fonduri: interogarea soldului, prezentarea generală a activelor, transfer intern etc.           Da
bingx-sub-account Gestionarea conturilor secundare: crearea/blocarea conturilor secundare,gestionarea cheilor APIetc.           Da
bingx-agent Broker/parteneri: invită utilizatori, interoghează comisioane și verifică datele partenerilor etc.            Da
  • Standard Futures
Numele competenței Scop Autorizație necesară
bingx-standard-trade Futures standard: interogarea pozițiilor, istoricul ordinelor, sold etc.             Da

 

Explicația autorizației

  • Competențe care nu necesită autorizare

Următoarele competențe de date de piață pot fi utilizate fără a configura cheia API :

  1. bingx-swap-market (date de piață Perp Futures)
  2. bingx-spot-market (date de piață Spot)
  • Competențe care necesită autorizare

Toate celelalte abilități legate de tranzacționare și conturi necesită configurarea următoarelor variabile de ecosistem:

  1. BINGX_API_KEY — cheia ta API
  2. BINGX_SECRET_KEY — cheia ta secretă

Cheia API este creată în Centrul utilizatorilor BingX → Gestionarea API .

  • Medii de operare
Mediu Descriere Bază URL
prod-live Producție (live) https://open-api.bingx.com
prod-vst Demo (nu sunt necesare fonduri reale)         https://open-api-vst.bingx.com

Pentru detalii tehnice complete despre semnătura de autentificare, consultă skills/references/authentication.md

 

Mecanism de securitate

  • Scrie confirmarea operațiunii

În mediul prod-live (producție), toate operațiunile de scriere (plasarea ordinelor, anularea ordinelor, transferurile etc.) necesită introducerea de către utilizator a comenzii CONFIRM înainte de execuție. Nu este necesară confirmare în mediul demo.

  • Mascarea cheilor

AI va masca automat tastele atunci când sunt afișate:

  1. Cheie API: afișează primele 5 și ultimele 4 caractere, de exemplu, su1Qc...8akf
  2. Cheia secretă: complet mascată, afișează doar ultimele 5 caractere, de exemplu, ***...aws1

 

Scenarii frecvente de utilizare

După finalizarea instalării, poți interacționa direct cu inteligența artificială folosind limbajul natural. Iată câteva exemple comune:

  • Interogarea datelor de piață
Interogare prețul actual al BTC-USDT
Vezi datele K-line din ultima oră pentru ETH-USDT
Care este rata actuală de finanțare pentru BTC-USDT?
  • Operațiuni de tranzacționare
Plasează un ordin de cumpărare pe piață pentru BTC-USDT cu cantitate de 0,01
Plasează un ordin de vânzare limită pentru ETH la prețul de 4.000 USDT cu o cantitate de 0,1
Anulează toate ordinele deschise pentru BTC-USDT
  • Gestionarea cardurilor
Afișează soldul contului meu Futures și pozițiile active
Interogarea soldului contului meu Spot
Transferă 100 USDT din contul meu Spot în contul meu Futures
  • Alte operațiuni
Afișează lista conturilor mele secundare
Consultă lista mea de recomandări pentru parteneri

 

Flux de lucru multi-competențe

Mai multe abilități pot fi combinate pentru a finaliza procese complete de tranzacționare:

  • Flux de lucru Futures
piața swap (vezi datele și profunzimea pieței BTC-USDT)
       ↓
cont swap (verifică soldul contului și marja disponibilă)
          ↓
tranzacție swap (plasează ordinul)
  • Flux de lucru pentru gestionarea poziției
cont swap (vezi pozițiile active și PnL)
       ↓
piață swap (vezi ultimul preț)
       ↓
tranzacție swap (închide sau ajustează poziția)
       ↓
cont swap (confirmă rezultatul închiderii)
  • Flux de lucru de tranzacționarea Spot
piața Spot (interogare preț Spot și profunzime)
    ↓
cont Spot (verificare sold cont Spot)
    ↓
tranzacție Spot (plasarea ordinelor de cumpărare sau vânzare)
  • Transferul de active între conturi
cont Spot (vezi soldul Spot)
    ↓
cont Spot / contul de fonduri (transfer active în contul Futures)
    ↓
tranzacție swap (tranzacționează Futures cu fonduri transferate)

 

Structura fișierului

Fiecare modul de competențe este alcătuit din două fișiere:

competențe/<skill-name>/
├── SKILL.md           # Descrierea utilizării agentului
└── api-reference.md    # Documentație API completă
  1. SKILL.md: Definește scopul competenței, tabelul de referință rapidă, furnizează exemple de cod TypeScript, reguli de interacțiune cu agenții (autorizare, mecanism de confirmare etc.)
  2. api-reference.md: Documentație completă a endpoint-urilor API, inclusiv detalii despre parametri, câmpuri de răspuns, exemple JSON și coduri de eroare

Documentația generală de referință poate fi găsită în dosarul competențe/referințe:

  1. authentication.md — implementarea semnăturii HMAC SHA256
  2. base-urls.md — Configurarea URL-ului de bază pentru mediu