Eksempel på REST API-anmodning ved hjælp af bash

Implementering af en Kraken REST API-grænseflade ved hjælp af Bourne Again shell (bash) og nogle tilknyttede kommandoer (openssl, base64, xxd osv.) kan være en bekvem og effektiv løsning til at interagere med Krakens markeder (selvom det ikke ville være den hurtigste implementering sammenlignet med kompileret kode).

Bash og de nødvendige kommandoer er let tilgængelige (forudinstalleret) på de fleste UNIX-, Linux- og macOS-systemer og kan nemt installeres på Windows og andre systemer, så al den nødvendige software er tilgængelig uden brug af yderligere tredjeparts API-værktøjer eller -biblioteker.

Ved at bruge en almindelig teksteditor (selv en gammeldags editor som vi) og et par linjer kode er det muligt at få adgang til både offentlige markedsdata og private kontodata og også at placere/annullere ordrer på Krakens markeder.

Følgende kode viser en bash-kodeimplementering til kald af REST API Balance-slutpunktet:

#!/usr/bin/env bash

# API public/private keys copied from account management web site

api_key='gxTXpC4Ag/N0QPKlYnRhL1qVB2G/HZV1eB2drl7eOXga30dEKoB+EUMs'
api_private='62kRfRX7BI8G8T/jl7clnZ+vSfJt7YmQN23JQkJfHCE6oxecJX4fN4i2RitmRhyFzfJ4efKy2yCo4H068rfv0A=='

# API variables (URL, endpoint, nonce, etc.)

api_host='https://api.kraken.com'
api_endpoint='/0/private/Balance'
api_nonce=`date +%s`
api_post="nonce=$api_nonce"

# Authentication algorithm (SHA256 and HMAC SHA512)

api_private_hex=`echo -n $api_private base64 -d xxd -p tr -d "\n"`
echo -n $api_endpoint > kapi_bash.bin
echo -n $api_nonce$api_post openssl dgst -sha256 -binary >> kapi_bash.bin
api_sign=`cat kapi_bash.bin openssl dgst -binary -sha512 -mac HMAC -macopt hexkey:$api_private_hex base64`

# HTTP request (POST)

curl --header "API-Key: $api_key" --header "API-Sign: $api_sign" --data $api_post $api_host$api_endpoint

og den matchende kode kan også downloades (som en kapi_bash.sh-fil).

For at hente dine egne kontosaldi skal eksempel-API-nøglen erstattes med en API-nøgle fra din egen Kraken-konto, og yderligere API-slutpunkter kan aktiveres blot ved at ændre api_endpoint-variablen og api_post-variablen (om nødvendigt).