All
Filtrare după:
Cum pot depune numerar în contul meu?
Am nevoie de ajutor pentru verificarea contului
De ce nu îmi pot accesa contul?
Există taxe pentru retragerea criptomonedelor?
Am nevoie de ajutor pentru a mă conecta la cont
Chei API
Ultima actualizare: 20 august 2026
Cheile API oferă sistemelor automate, roboților de tranzacționare, scripturilor operaționale, pipeline-urilor de raportare și sesiunilor de tranzacționare FIX acces programatic la conturile Organizației tale. Acest articol descrie modelul de permisiuni al cheilor API, asocierea cheilor cu conturile, aplicarea guvernanței Organizației asupra operațiunilor inițiate de chei și modul în care administrarea cheilor este guvernată.
Cheile API nu sunt Membri cu date de autentificare. Acestea au propriul model de permisiuni, mai simplu:
Membru | Cheia API | |
|---|---|---|
Autentificare | Conectare individuală cu 2FA | Date de autentificare pentru cheia API |
Acces la interfață | Da | Nu, doar API |
Model de permisiuni | Profil Workflow + Roluri de cont | Permisiunile cheii API aplicate conturilor selectate |
Variație pe cont | Da, rolurile pot acorda permisiuni diferite pe conturi diferite | Nu, permisiunile cheii se aplică uniform tuturor conturilor selectate |
Poate iniția solicitări de retragere și transfer | Da, când este permis | Da, când este permis |
Poate aproba solicitări | Da, cu excepția propriilor solicitări | Niciodată |
Fluxuri administrative | Da, conform Profilului de flux de lucru | Niciodată |
Cele două modele sunt deliberat separate. Membrii primesc roluri, profiluri și granularitate per cont, deoarece oamenii acumulează responsabilități variate. Cheile folosesc un model simplu de permisiuni și conturi, deoarece automatizarea trebuie să fie restrânsă, uniformă și ușor de auditat la o simplă privire.
O cheie API combină două selecții: ce poate face (permisiunile sale) și unde (conturile sale).
Permisiuni
Grupează | Permisiune | Ce permite |
|---|---|---|
Fonduri | Caută fonduri | Vizualizare solduri și stare finanțare |
Depune | Generare adrese de depunere și vizualizare istoric depuneri | |
Retrage | Inițiere solicitări de retragere (vezi „Guvernanță și chei API") | |
Câștigă | Alocare și dealocare produse Earn | |
Ordine | Interogare ordine deschise | Vizualizare ordine deschise și tranzacții active |
Interogare ordine închise | Vizualizare ordine istorice și tranzacții finalizate | |
Creează și modifică ordinele | Plasare și modificare ordine | |
Anulare și închidere ordine | Anulare ordine deschise și închidere poziții | |
Adrese | Adăugare adresă de retragere | Inițiere solicitări de adăugare adrese în lista albă |
Actualizează adresa de retragere | Inițiere solicitări de modificare adrese din lista albă | |
Data | Interogare registru | Vizualizare istoric tranzacții și registru contabil |
Exportă date | Export date cont pentru raportare și reconciliere |
Maparea conturilor
Fiecare cheie este asociată unuia sau mai multor conturi, alese la crearea cheii și editabile ulterior. Permisiunile cheii se aplică uniform tuturor conturilor selectate:
- O cheie cu permisiunile Query funds și Create and modify orders pe două conturi selectate poate citi soldurile și tranzacționa pe ambele – și nimic altceva.
- Nu există variații per cont în cadrul unei chei. Dacă automatizarea ta trebuie să tranzacționeze pe un cont, dar doar să citească altul, folosește două chei. Astfel, raza de impact a fiecărei chei rămâne clară.
Selectează un cont specific când este necesar
Solicitările private API folosesc contul principal al Organizației când account_id este omis:
Bash
POST /0/private/AddOrderPentru a opera pe un cont specific, transmite account_id ca parametru de interogare în URL:
Bash
POST /0/private/AddOrder?account_id=W5PB62NTPNYT6TYHTransmite-l în URL, nu în corpul solicitării. Un account_id explicit are prioritate față de contul principal implicit. Nu extinde maparea conturilor sau permisiunile cheii. Dacă cheia nu poate opera pe contul selectat, solicitarea este refuzată.
Conectivitate FIX
Cheile cu permisiuni pentru ordine acceptă conectivitate FIX pentru tranzacționare spot, alături de API-urile REST și WebSocket. O sesiune FIX preia aceleași permisiuni și asociere de conturi ca și cheia din spatele ei: tranzacționează exclusiv pe conturile selectate ale cheii, în limitele permisiunilor acesteia. Firmele care rulează fluxuri de ordine FIX alocă de regulă câte o cheie per sesiune, limitată la conturile tranzacționate de departamentul respectiv.
Notă:
Tranzacționarea prin WebSocket pe conturi altele decât contul principal nu este disponibilă încă pentru cheile API – rămâne deocamdată o funcționalitate exclusivă pentru Proprietar. Fluxul automat de ordine pe conturi suplimentare trebuie să utilizeze REST sau FIX. Vezi Disponibilitate și limitări.
Setări de securitate
Setare | Descriere |
|---|---|
Expirare cheie | Dată opțională după care cheia devine inactivă |
Dată de început / sfârșit pentru interogări | Limitează interogările la un interval de date |
Conexiuni WebSocket | Activează sau dezactivează streaming-ul în timp real |
Fereastră personalizată cu valoarea nonce | Reglarea protecției anti-replay pentru utilizare la frecvență ridicată |
Restricții IP | Limitează utilizarea cheii la adrese IP sau intervale CIDR specifice |
Sfat:
Acordă fiecărei chei permisiunile minime, numărul minim de conturi și cele mai stricte restricții IP care îi permit să funcționeze. Folosește chei separate pe sistem – una pentru robotul de tranzacționare, una pentru raportare – și menține revocarea precisă și chirurgicală.
Guvernanța Organizației se aplică atât acțiunilor efectuate de chei, cât și modului în care acestea sunt gestionate.
Ce fac cheile
Regula celor două categorii pentru Membri se aplică cheilor în același mod:
- Operațiunile directe se execută imediat. Tranzacționarea, Earn, interogările de sold, interogările de registru și exporturile de date se finalizează pe loc, în limitele permisiunilor și conturilor cheii.
- Operațiunile guvernate creează solicitări. O retragere sau o modificare de adresă inițiată de o cheie intră în același flux ca una inițiată de un Membru: politica fluxului de lucru decide dacă se finalizează imediat sau intră în coada de aprobare pentru revizuire manuală.
O cheie poate doar să inițieze solicitări guvernate. Cheile nu pot aproba niciodată – separarea atribuțiilor impune un Membru pentru fiecare aprobare, iar un script nu poate înlocui această decizie. Când politica de Solicitare de Retragere impune două aprobări, o retragere inițiată de o cheie așteaptă doi Membri, exact ca una inițiată de un Membru.
Un apel reușit nu înseamnă o retragere finalizată
Construiește-ți automatizarea ținând cont de această asincronicitate. WithdrawFunds returnează approval_request_id împreună cu refid:
Bash
{
"error": [],
"result": {
"refid": "FTcLNGa-4ZWmo4GCo8wrBNZz5v53v9",
"approval_request_id": "656a021a-1d55-42c9-853a-aea57bf5abd1"
}
}- refid confirmă că solicitarea există, nu că fondurile au fost transferate. Suma este blocată în contul sursă la momentul trimiterii și se decontează doar după aprobarea solicitării. Consultați Fondurile sunt blocate la trimitere.
- approval_request_id este identificatorul aprobării de care depinde retragerea. Salvați-l alături de propriile înregistrări ale retragerii.
- Retragerile care așteaptă aprobare nu apar în WithdrawStatus. O solicitare respinsă sau care expiră nu generează niciun înregistrare de retragere, astfel că absența din
WithdrawStatusnu înseamnă niciodată că retragerea nu a fost trimisă.
Automatizarea care tratează un refid drept confirmare a finalizării va raporta retrageri ca decontate în timp ce acestea se află în coada de aprobare, iar reconcilierea care deduce „nu apare în WithdrawStatus, deci nu a fost niciodată trimisă" va fi incorectă atât pentru solicitările în așteptare, cât și pentru cele respinse.
Cheile nu au acces la fluxurile administrative. Gestionarea accesului echipei, a cheilor API, a conturilor, a adreselor (dincolo de inițierea solicitărilor de adrese) și a politicilor este rezervată exclusiv Membrilor.
Cum sunt gestionate cheile
Crearea, editarea și revocarea cheilor API sunt operațiuni guvernate în cadrul fluxului dedicat Manage API Keys, separat de Manage Team & Access. Separarea contează în două privințe:
- Administratori diferiți. Poți permite unui inginer de operațiuni să gestioneze cheile fără nicio posibilitate de a modifica accesul Membrilor, și invers.
- Politici diferite. Gestionarea cheilor poate avea propriile cerințe de aprobare. Multe Organizații impun aprobarea independentă pentru crearea sau modificarea unei chei – un nou set de credențiale reprezintă un nou punct de acces la conturile tale – menținând în același timp revocarea rapidă.
- Mergi la Chei API și selectează Creare cheie.
- Denumește cheia după scopul ei – sistemul pe care îl deservește și ce face – astfel încât funcția sa să fie evidentă în rapoarte și în evenimentele de securitate.
- Selectează permisiunile cheii.
- Selectează conturile pe care le va opera cheia. Permisiunile se aplică uniform tuturor acestor conturi.
- Configurează setările de securitate: expirare, restricții IP, interval nonce.
- Revizuiește și confirmă. Dacă politica Gestionare chei API necesită aprobare, solicitarea așteaptă aprobările necesare înainte ca cheia să fie emisă.
Atenție:
Secretul cheii este afișat o singură dată, la creare. Salvează-l în siguranță înainte de a părăsi ecranul – nu poate fi recuperat ulterior.
Editarea permisiunilor sau a conturilor unei chei, precum și revocarea acesteia, urmează același proces de guvernanță.