Podręcznik dla użytkowników korzystających z asystentów kodowania AI.

 

Przegląd

Niniejszy dokument stanowi zbiór umiejętności API BingX dla asystentów kodowania AI, obejmujący 15 modułów umiejętności, obejmujących perpetual futures, handel spot, copy trading i zarządzanie kontami.

Po zainstalowaniu można komunikować się z AI, aby wyszukiwać dane rynkowe, składać zlecenia i zarządzać kontami, bez konieczności ręcznego pisania kodu dyspozycji API.

Obsługiwani asystenci AI: Claude Code, Cursor i inni asystenci kodowania AI, którzy obsługują mechanizm Skills.

 

Instalacja

  • Instalacja ogólna (Claude Code/Cursor/inne)
moduły npx dodaj BingX-API/api-ai-skills
  • Instalacja Claude Code (obsługuje automatyczne aktualizacje)
/plugin dodaj BingX-API/api-ai-skills

Szczegółowe instrukcje instalacji: README.md

 

Przegląd modułów Skills

  • USDT-M perpetual
Nazwa modułu Skill Cel Wymagana autoryzacja
bingx-swap-market Dane rynkowe: cena, głębokość, linia K, stopa finansowania, otwarte pozycje itp.         Nie
bingx-swap-trade Operacje handlowe: składanie zleceń, anulowanie zleceń, ustawianie dźwigni, trybu aktywów itp.          Tak
bingx-swap-account Dane konta: salda, bieżące pozycje, stawki opłat, przepływy środków itp.          Tak
  • Spot
Nazwa modułu Skill Cel Wymagana autoryzacja
bingx-spot-market Dane rynkowe: cena, głębokość, linia K,historia handlu itp.  Nie
bingx-spot-trade Operacje handlowe: składanie zleceń, anulowanie zleceń, zapytania dotyczące zleceń, zlecenia OCO itp.  Tak
bingx-spot-account Dane konta: salda, przegląd aktywów, transfer aktywów itp.        Tak
bingx-spot-wallet Operacje na portfelu: wpłaty, wypłaty, historia transferów itp.       Tak
  • Copy trading
Nazwa modułu Skill Cel Wymagana autoryzacja
bingx-copytrade-spot Copy trading spot: zamykanie kopiowanych pozycji, zapytania o zyski itp.      Tak
bingx-copytrade-swap Copy trading futures: zamykanie pozycji, ustawianie TP/SL, ustawianie prowizji itp.              Tak
  • Zarządzanie kontem
Nazwa modułu Skill Cel Wymagana autoryzacja
bingx-fund-account Konto funduszy: sprawdzanie salda, przegląd aktywów, transfery wewnętrzne itp.           Tak
bingx-sub-account Zarządzanie subkontem: tworzenie/blokowanie subkont,klucz API zarządzanie itp.  Tak
bingx-agent Partner/broker: zapraszanie użytkowników, wyszukiwanie prowizji, sprawdzanie danych partnerów itp.  Tak
  • Standard futures
Nazwa modułu Skill Cel Wymagana autoryzacja
bingx-standard-trade Standard futures: zapytania o pozycję, historię zleceń, saldo itp.             Tak

 

Wyjaśnienie autoryzacji

  • Moduły, które nie wymagają autoryzacji

Następujące moduły Skills związane z danymi rynkowymi można wykorzystać bez konfigurowania klucza API.

  1. bingx-swap-market (dane rynkowe perp. futures)
  2. bingx-spot-market (dane rynkowe dotyczące spot)
  • Moduły, które wymagają autoryzacji

Wszystkie inne moduły związane z handlem i kontem wymagają skonfigurowania poniższych zmiennych systemowych.

  1. BINGX_API_KEY - Twój klucz API
  2. BINGX_SECRET_KEY - Twój tajny klucz

Klucz API tworzy się w Centrum użytkownika BingX → Zarządzanie API.

  • Systemy operacyjne
System Opis Podstawowy adres URL
prod-live Produkcja (środowisko produkcyjne) https://open-api.bingx.com
prod-vst Demo (prawdziwe środki nie są wymagane)         https://open-api-vst.bingx.com

Pełne dane techniczne dotyczące podpisu uwierzytelniającego znajdziesz w: skills/references/authentication.md.

 

Mechanizm bezpieczeństwa

  • Potwierdzenie operacji zapisu

W środowisku prod-live (produkcyjnym) wszystkie operacje zapisu (składanie zleceń, anulowanie zleceń, transfery itp.) wymagają wprowadzenia przez użytkownika słowa CONFIRM przed realizacją. Potwierdzenie nie jest wymagane w środowisku demo.

  • Maskowanie kluczy

AI automatycznie maskuje klucze podczas ich wyświetlania.

  1. Klucz API wyświetla pierwsze pięć i ostatnie cztery znaki, np. su1Qc...8akf
  2. Tajny klucz wyświetla tylko ostatnie pięć znaków, np. ***...aws1

 

Scenariusze wykorzystania

Po zakończeniu instalacji możesz komunikować się z AI, używając zwykłego języka. Sprawdź przykłady poniżej.

  • Zapytanie o dane rynkowe
Wyszukaj bieżącą cenę BTC-USDT
Wyświetl dane z ostatniej godziny dla ETH-USDT
Jaka jest bieżąca stopa finansowania dla BTC-USDT?
  • Operacje handlowe
Złóż zlecenie rynkowe kupna na BTC-USDT na kwotę 0,01
Złóż zlecenie limit sprzedaży dla ETH po cenie 4000 USDT na kwotę 0,1
Anuluj wszystkie otwarte zlecenia na BTC-USDT
  • Zarządzanie kontem
Wyświetl saldo na moim koncie futures i bieżące pozycje
Sprawdź saldo na moim koncie spot
Transferuj 100 USDT z mojego konta spot na konto futures
  • Inne operacje
Wyświetl listę moich subkont
Sprawdź listę poleconych partnerów

 

Wielomodułowy przepływ pracy

Moduły Skills można łączyć, aby realizować procesy tradingowe.

  • Transakcje futures
swap-market (wyświetl dane rynkowe i głębokość rynku BTC-USDT)
↓
swap-account (sprawdź saldo konta i dostępny depozyt zabezpieczający)
↓
swap-trade (złóż zlecenie)
  • Zarządzanie pozycją
swap-account (wyświetl bieżące pozycje i PnL)
    ↓
swap-market (wyświetl ostatnią cenę)
    ↓
swap-trade (zamknij lub dostosuj pozycję)
    ↓
swap-account (potwierdź wynik zamknięcia)
  • Handel spot
spot-market (sprawdź cenę spot i głębokość rynku)
    ↓
spot-account (sprawdź saldo na koncie spot)
    ↓
spot-trade (złóż zlecenie kupna lub sprzedaży)
  • Transfer aktywów między kontami
spot-account (wyświetl saldo na koncie spot)
    ↓
spot-account/fund-account (transferuj aktywa na konto futures)
    ↓
swap-trade (handluj futures wykorzystując przetransferowane aktywa)

 

Struktura pliku

Każdy moduł składa się z dwóch plików.

skills/<skill-name>/
├── SKILL.md           # Opis wykorzystania agenta
└── api-reference.md   # Pełna dokumentacja API
  1. SKILL.md definiuje cel modułu, zawiera tabelę szybkiego odniesienia, przykłady kodu TypeScript oraz reguły interakcji agenta (autoryzacja, mechanizm potwierdzania itp.).
  2. api-reference.md zawiera kompletną dokumentację punktów końcowych API, w tym szczegóły parametrów, pola odpowiedzi, przykłady JSON i kody błędów.

Ogólna dokumentacja referencyjna znajduje się w katalogu skills/references/.

  1. authentication.md - implementacja podpisu HMAC SHA256
  2. base-urls.md - konfiguracja podstawowego adresu URL środowiska