Guida rapida per gli utenti con AI coding assistant.

 

Riepilogo

Questo documento è una raccolta delle Competenze API di BingX per gli AI Coding Assistant: include 15 moduli sulle competenze, coprendo argomenti come Futures perpetui, trading spot, copy trading e gestione dell'account.

Dopo l'installazione,puoi interagire direttamente con l'AI usando il linguaggio naturale per controllare dati di mercato, piazzare operazioni e gestire gli account, senza dover scrivere manualmente del codice per le chiamate API.

Assistenti AI supportati:Claude Code,Cursor e altri assistenti alla programmazione AI che supportano il meccanismo delle Competenze.

 

Installa

  • Installazione generale (Claude Code / Cursor / Altri)
npx skills add BingX-API/api-ai-skills
  • Claude Code Installazione dedicata (supporta gli aggiornamenti automatici)
/plugin add BingX-API/api-ai-skills

Per istruzioni dettagliate sull'installazione, consulta il file README.md

 

Panoramica competenze

  • Perpetui USDT-M
Nome competenza Scopo Autorizzazione richiesta
bingx-swap-market Dati di mercato: prezzo, profondità, k-line, tasso di finanziamento, interesse aperto, ecc.         Incompleto
bingx-swap-trade Operazioni di trading: piazzare/annullare ordini, configurare la leva, modalità asset, ecc.          Sì
bingx-swap-account Info account: saldi, posizioni correnti, tassi di commissione, flussi di fondi, ecc.          Sì
  • Spot
Nome competenza Scopo Autorizzazione richiesta
bingx-spot-market Dati di mercato: prezzo, profondità, K-line,cronologia operazioni, ecc.   Incompleto
bingx-spot-trade Operazioni di trading: piazzare/annullare ordini,, ricerche sugli ordini,ordini OCO, ecc.            Sì
bingx-spot-account Informazioni account: saldi, panoramica asset, trasferimento asset, ecc.        Sì
bingx-spot-wallet Operazioni sui wallet: depositi, prelievi, registri dei trasferimenti, ecc.       Sì
  • Copy Trading
Nome competenza Scopo Autorizzazione richiesta
bingx-copytrade-spot Copy Trading Spot: chiusura posizioni di copia, ricerca dei profitti, ecc.      Sì
bingx-copytrade-swap Copy Trading di Futures: chiudere posizioni, configurare TP/SL, configurare commissioni, ecc.              Sì
  • Gestione dell'account
Nome competenza Scopo Autorizzazione richiesta
bingx-fund-account Account fondi: controllare il saldo, panoramica asset, trasferimenti interni, ecc.           Sì
bingx-sub-account Gestione sub-account: creare/congelare sub-account, gestioneChiave API , ecc.           Sì
bingx-agent Broker partner/: invitare utenti, controllare le commissioni, controllare dati del partner, ecc.            Sì
  • Futures standard
Nome competenza Scopo Autorizzazione richiesta
bingx-standard-trade Futures standard: ricerca sulle posizioni, cronologia degli ordini, saldo, ecc.             Sì

 

Spiegazione autorizzazione

  • Competenze che non necessitano dell'autorizzazione

Le seguenti competenze per i dati di mercato possono essere utilizzate senza configurare la Chiave API :

  1. bingx-swap-market (dati di mercato Futures perpetui)
  2. bingx-spot-market (dati di mercato Spot)
  • Competenze che richiedono l'autorizzazione

Tutte le altre competenze per il trading e relative all'account richiedono la configurazione delle seguenti variabili ambientali:

  1. BINGX_API_KEY — la tua chiave API
  2. BINGX_SECRET_KEY — la tua chiave segreta

La chiave API viene creata in Centro utenti BingX → Gestione API .

  • Ambienti operativi
Ambiente Descrizione URL di base
prod-live Produzione (live) https://open-api.bingx.com
prod-vst Demo (non sono necessari fondi reali)         https://open-api-vst.bingx.com

Per i dettagli tecnici completi sulla firma di autenticazione, consulta skills/references/authentication.md

 

Meccanismo di sicurezza

  • Conferma delle operazioni di scrittura

Nell'ambiente (produzione) prod-live, tutte le operazioni di scrittura (apertura/cancellazione di ordini, trasferimenti, ecc.) richiedono l'inserimento dell'input CONFIRM da parte dell'utente prima dell'esecuzione. L'ambiente demo non richiede alcuna conferma.

  • Mascheramento delle chiavi

L'AI occulterà automaticamente le chiavi al momento di visualizzarle:

  1. Chiave API: visualizza le i primi 5 e gli ultimi 4 caratteri, ad es. su1Qc...8akf
  2. Chiave segreta: completamente occultata. Vengono visualizzati solo gli ultimi 5 caratteri, ad es. ***...aws1

 

Scenari comuni di utilizzo

Al termine dell'installazione, puoi interagire direttamente con l'AI usando il linguaggio naturale. Ecco alcuni esempi comuni:

  • Ricerca dei dati di mercato
Chiedi il prezzo attuale di BTC-USDT
Visualizza i dati della K-line relativi all'ultima ora per ETH-USDT
Qual è il tasso di finanziamento attuale di BTC-USDT?
  • Operazioni di trading
Piazza un ordine di acquisto a mercato per BTC-USDT con un importo di 0,01
Piazza un ordine limite di vendita per ETH al prezzo di 4.000 USDT con un importo di 0,1
Annulla tutti gli ordini aperti per BTC-USDT
  • Gestione account
Visualizza il saldo del mio account futures e le posizioni attuali
Controlla il saldo del mio account spot
Trasferisci 100 USDT dal mio account spot al mio account futures
  • Altre operazioni
Visualizza l'elenco dei miei sub-account
Controlla la lista dei miei partner invitati

 

Flusso di lavoro multi-competenza

È possibile combinare più competenze per completare interi processi di trading:

  • Flusso di lavoro del trading di futures
swap-market (visualizza dati di mercato e profondità BTC-USDT)
↓
swap-account (controlla il saldo dell'account e il margine disponibile)
↓
swap-trade (piazza un ordine)
  • Flusso di lavoro per la gestione delle posizioni
swap-account (visualizza posizioni e PnL attuali)
    ↓
swap-market (visualizza l'ultimo prezzo)
    ↓
swap-trade (chiudi o regola la posizione)
    ↓
swap-account (conferma il risultato della chiusura)
  • Flusso di lavoro del trading spot
spot-market (controlla prezzo spot e profondità)
    ↓
spot-account (controlla saldo account spot)
    ↓
spot-trade (piazza un ordine di acquisto o vendita)
  • Trasferimento di asset tra account
spot-account (visualizza saldo spot)
    ↓
spot-account / fund-account (trasferisci asset all'account futures)
    ↓
swap-trade (scambia futures con fondi trasferiti)

 

Struttura del file

Ogni modulo delle competenze include due file:

skills/<skill-name>/
├── SKILL.md           # Descrizione utilizzo agente
└── api-reference.md   # Documentazione API completa
  1. SKILL.md: definisce lo scopo della competenza, tabelle di riferimento rapide, esempi di codice TypeScript, regole per l'interazione con l'agente (autorizzazione, meccanismo di conferma, ecc.)
  2. api-reference.md: completa la documentazione dell'endpoint API, inclusi dettagli del parametro, campi di risposta, esempi JSON e codici errore

Puoi trovare la documentazione di riferimento nella directory skills/references/:

  1. authentication.md — Implementazione della firma HMAC SHA256
  2. base-urls.md — Configurazione dell'URL di base