Exemplo de pedido REST API usando bash

Última atualização: 31/03/2025

Introdução

A implementação de uma interface Kraken REST API utilizando a shell Bourne Again (bash) e alguns comandos associados (openssl, base64, xxd, etc.) pode ser uma solução conveniente e eficiente para interagir com os mercados da Kraken (embora não seja a implementação mais rápida em comparação com código compilado).

O Bash e os comandos necessários estão prontamente disponíveis (pré-instalados) na maioria dos sistemas UNIX, Linux e macOS, e podem ser facilmente instalados no Windows e noutros sistemas, pelo que todo o software necessário está disponível sem a utilização de ferramentas ou bibliotecas de API de terceiros adicionais.

Utilizando um editor de texto simples (mesmo um editor antigo como o vi) e algumas linhas de código, é possível aceder a dados de mercado públicos e dados de conta privados, e também colocar/cancelar ordens nos mercados da Kraken.

Exemplo de Código

O código seguinte mostra uma implementação de código bash para chamar o endpoint Balance da REST API:

#!/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

e o código correspondente também pode ser descarregado (como um ficheiro kapi_bash.sh).

Utilização/Desenvolvimento Adicional

Para recuperar os seus próprios saldos de conta, a chave API de exemplo deve ser substituída por uma chave API da sua própria conta Kraken, e endpoints API adicionais podem ser ativados simplesmente modificando a variável api_endpoint e a variável api_post (se necessário).

Precisa de mais ajuda?