Client de linie de comandă REST API (NodeJS)

Ultima actualizare: 31 decembrie 2025

Clientul de linie de comandă REST API în NodeJS permite accesul complet la Kraken REST API prin linia de comandă (cum ar fi Terminal pe macOS), prin urmare nu sunt necesare cunoștințe de programare sau experiență API.

Toate funcționalitățile REST API sunt accesibile, inclusiv:

  • endpoint-uri publice de date de piață

  • endpoint-uri private de gestionare a contului

  • endpoint-uri de tranzacționare

  • endpoint-uri private de finanțare

  • endpoint-uri private de staking*

Clientul de linie de comandă poate fi utilizat ca un client API independent sau poate fi apelat din alte programe (cum ar fi alte limbaje interpretate precum scripturile Bash sau limbaje compilate precum C/C++).

Instalare

1. Instalați NodeJS (dacă este necesar).

  • macOS și Linux au probabil deja NodeJS instalat.

  • Windows probabil nu are NodeJS instalat, dar poate fi instalat de pe https://www.nodejs.org/.

2. Descărcați și salvați fișierul krakenapi.js pe computerul dumneavoastră în folderul (directorul) ales. De exemplu:

Macintosh HD > Users > Satoshi > KrakenAPI


3. Deschideți o linie de comandă (cum ar fi Terminalul macOS) și navigați la folderul (directorul) ales la pasul anterior.

Puteți utiliza comanda "cd" (change directory) pentru a naviga. De exemplu:

cd /Users/Satoshi/KrakenAPI


4. Adăugați cheile API în același folder în care păstrați fișierul krakenapi.js.

Copiați/lipiți cheia publică API din gestionarea contului într-un fișier text simplu numit "API_PUBLIC_KEY".

Copiați/lipiți cheia privată (secretă) API într-un fișier text simplu numit "API_PRIVATE_KEY".

O cheie API este necesară doar dacă intenționați să utilizați endpoint-urile API private pentru a accesa contul dumneavoastră Kraken (cum ar fi interogări de sold, plasarea/anularea ordinelor, exporturi de istoric al contului etc.).

Consultați Cum se generează o pereche de chei API? pentru instrucțiuni suplimentare.

Comenzi exemplu

Utilizarea clientului de linie de comandă REST API este următoarea:

bash

Bash

nodejs krakenapi.js endpoint [parameters]

The command line client supports all of the REST API endpoints. Here are a few example commands:

nodejs krakenapi.js Time
nodejs krakenapi.js Ticker pair=xbtusd
nodejs krakenapi.js Trades pair=etheur since=1574067140000000000
nodejs krakenapi.js Balance
nodejs krakenapi.js TradeBalance asset=xbt
nodejs krakenapi.js QueryOrders txid=O7MN22-ZCX7J-TGLQHD
nodejs krakenapi.js AddOrder pair=xbtusd type=buy ordertype=limit price=6500 volume=0.002 leverage=5
nodejs krakenapi.js CancelOrder txid=O7MN22-ZCX7J-TGLQHD

Cod NodeJS

bash

Bash

const axios = require("axios");
const { clear } = require("console");
const crypto = require("crypto");
const fs = require("fs");

const main = async () => {
  let response = "";
  let apiMethod = "";
  let inputParameters = "";

  const api_private = [
    "Balance",
    "BalanceEx",
    "TradeBalance",
    "OpenOrders",
    "ClosedOrders",
    "QueryOrders",
    "TradesHistory",
    "QueryTrades",
    "OpenPositions",
    "Ledgers",
    "QueryLedgers",
    "TradeVolume",
    "AddExport",
    "ExportStatus",
    "RetrieveExport",
    "RemoveExport",
    "GetWebSocketsToken",
    "AddOrder",
    "AddOrderBatch",
    "EditOrder",
    "CancelOrder",
    "CancelAll",
    "CancelAllOrdersAfter",
    "DepositMethods",
    "DepositAddresses",
    "DepositStatus",
    "WithdrawInfo",
    "Withdraw",
    "WithdrawStatus",
    "WithdrawCancel",
    "WalletTransfer",
    "Staking/Assets",
    "Stake",
    "Unstake",
    "Staking/Pending",
    "Staking/Transactions",
  ];

  const api_public = [
    "Time",
    "Assets",
    "AssetPairs",
    "Ticker",
    "OHLC",
    "Depth",
    "Trades",
    "Spread",
    "SystemStatus",
  ];

  // Destructuring the input command
  if (process.argv.length < 3) {
    apiMethod = "Time";
  } else if (process.argv.length == 3) {
    apiMethod = process.argv[2];
  } else {
    apiMethod = process.argv[2];
    for (count = 3; count < process.argv.length; count++) {
      if (count == 3) {
        inputParameters = process.argv[count];
      } else {
        inputParameters = inputParameters + "&" + process.argv[count];
      }
    }
  }

  // Condition to check the private or public endpoints
  if (api_private.includes(apiMethod)) {
    response = await QueryPrivateEndpoint(apiMethod, inputParameters);

    if (apiMethod == "RetrieveExport") {
      try {
        fs.writeFileSync("Report.zip", response); // write the zip file response
        console.log("Report.zip file successfully received");
      } catch (err) {
        console.log(err);
      }
    } else {
      console.log(response.toString());
    }
  } else if (api_public.includes(apiMethod)) {
    response = await QueryPublicEndpoint(apiMethod, inputParameters);
    console.log(JSON.stringify(response));
  } else {
    console.log("Usage: app method [parameters]");
    console.log("Example: app OHLC pair=xbtusd interval=1440");
  }
};

// Public API Endpoint
async function QueryPublicEndpoint(endPointName, inputParameters) {
  let jsonData;
  const baseDomain = "https://api.kraken.com";
  const publicPath = "/0/public/";
  const apiEndpointFullURL = baseDomain + publicPath + endPointName + "?" + inputParameters;

  await axios
    .get(apiEndpointFullURL)
    .then((res) => {
      jsonData = res;
    })
    .catch((err) => {
      jsonData = err;
    });
  return jsonData.data;
}

// Private API Endpoint
async function QueryPrivateEndpoint(endPointName, inputParameters) {
  const baseDomain = "https://api.kraken.com";
  const privatePath = "/0/private/";

  const apiPublicKey = fs.readFileSync("API_PUBLIC_KEY").toString().trim(); // get data from API_PUBLIC_KEY text file
  const apiPrivateKey = fs.readFileSync("API_PRIVATE_KEY").toString().trim(); // get data from API_PRIVATE_KEY text file

  const apiEndpointFullURL = baseDomain + privatePath + endPointName;
  const nonce = Date.now().toString();
  const apiPostBodyData = "nonce=" + nonce + "&" + inputParameters;

  const signature = CreateAuthenticationSignature(
    apiPrivateKey,
    privatePath,
    endPointName,
    nonce,
    apiPostBodyData
  );
  const httpOptions = {
    headers: { "API-Key": apiPublicKey, "API-Sign": signature },
    responseType: "arraybuffer",
  };

  let jsonData;
  await axios
    .post(apiEndpointFullURL, apiPostBodyData, httpOptions)
    .then((res) => {
      jsonData = res;
    })
    .catch((err) => {
      jsonData = err;
    });

  return jsonData.data;
}

// Authentication algorithm
function CreateAuthenticationSignature(
  apiPrivateKey,
  apiPath,
  endPointName,
  nonce,
  apiPostBodyData
) {
  const apiPost = nonce + apiPostBodyData;
  const secret = Buffer.from(apiPrivateKey, "base64");
  const sha256 = crypto.createHash("sha256");
  const hash256 = sha256.update(apiPost).digest("binary");
  const hmac512 = crypto.createHmac("sha512", secret);
  const signatureString = hmac512
    .update(apiPath + endPointName + hash256, "binary")
    .digest("base64");
  return signatureString;
}

main();

*O prezentare generală a criteriilor de eligibilitate (inclusiv restricțiile geografice) pentru staking poate fi găsită aici.

Ai nevoie de mai mult ajutor?