Il client da riga di comando dell'API REST in NodeJS consente l'accesso completo all'API REST di Kraken tramite la riga di comando (come il Terminale su macOS), quindi non è richiesta alcuna conoscenza di programmazione o esperienza API.
Tutte le funzionalità dell'API REST sono accessibili, tra cui:
endpoint pubblici per i dati di mercato
endpoint privati per la gestione dell'account
endpoint di trading
endpoint privati di finanziamento
endpoint privati di staking*
Il client da riga di comando può essere utilizzato come client API autonomo, oppure può essere richiamato da altri programmi (come altri linguaggi interpretati come gli script Bash, o linguaggi compilati come C/C++).
1. Installa NodeJS (se necessario).
macOS e Linux probabilmente hanno già NodeJS installato.
Windows probabilmente non ha NodeJS installato, ma può essere installato da https://www.nodejs.org/.
2. Scarica e salva il file krakenapi.js sul tuo computer nella cartella (directory) di tua scelta. Ad esempio:
Macintosh HD > Utenti > Satoshi > KrakenAPI
3. Apri un prompt dei comandi (come il Terminale di macOS) e naviga nella cartella (directory) scelta nel passaggio precedente.
Puoi usare il comando "cd" (change directory) per navigare. Ad esempio:
cd /Users/Satoshi/KrakenAPI
4. Aggiungi le tue chiavi API alla stessa cartella in cui conservi il file krakenapi.js.
Copia/incolla la tua chiave pubblica API dalla gestione dell'account in un file di testo semplice chiamato "API_PUBLIC_KEY".
Copia/incolla la tua chiave privata (segreta) API in un file di testo semplice chiamato "API_PRIVATE_KEY".
Una chiave API è necessaria solo se intendi utilizzare gli endpoint API privati per accedere al tuo account Kraken (come richieste di saldo, piazzamento/annullamento ordini, esportazioni della cronologia dell'account, ecc.).
Consulta Come generare una coppia di chiavi API? per ulteriori istruzioni.
L'utilizzo del client da riga di comando dell'API REST è il seguente:
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-TGLQHDBash
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();*Una panoramica dei criteri di idoneità (incluse le restrizioni geografiche) per lo staking è disponibile qui.