De REST API-opdrachtregelclient in Python biedt volledige toegang tot de Kraken REST API via de opdrachtregel (zoals Terminal op macOS), waardoor geen programmeerkennis of API-ervaring vereist is.
Alle REST API-functies zijn toegankelijk, waaronder:
openbare marktdata-eindpunten
privé accountdata-eindpunten
privé handels-eindpunten
privé financierings-eindpunten
privé earn-eindpunten
De opdrachtregelclient kan worden gebruikt als een zelfstandige API-client, of kan worden aangeroepen vanuit andere programma's (zoals andere geïnterpreteerde talen zoals Bash-scripts, of gecompileerde talen zoals C/C++).
1. Installeer Python 3 (indien nodig).
macOS en Linux hebben mogelijk al Python 3 geïnstalleerd.
Windows heeft waarschijnlijk geen Python 3 geïnstalleerd, maar het kan worden geïnstalleerd via https://www.python.org/.
2. Download en sla het krakenapi.py bestand op uw computer op in de map (directory) van uw keuze.
Bijvoorbeeld: Macintosh HD > Gebruikers > Satoshi > KrakenAPI
3. Open een opdrachtprompt (zoals Terminal van macOS) en navigeer naar de map (directory) die in de vorige stap is gekozen. U kunt de UNIX/Linux "cd"-opdracht (change directory) gebruiken om te navigeren.
Bijvoorbeeld:cd /Users/Satoshi/KrakenAPI
4. Maak het bestand krakenapi.py uitvoerbaar.
U kunt de UNIX/Linux "chmod 755"-opdracht (change mode) gebruiken.
Bijvoorbeeld: chmod 755 krakenapi.py
5. Voeg uw API-sleutel toe aan dezelfde map waar u het krakenapi.py-bestand bewaart.
Kopieer/plak uw openbare API-sleutel vanuit accountbeheer in een platte tekstbestand genaamd "API_Public_Key".
Kopieer/plak uw privé (geheime) API-sleutel in een platte tekstbestand genaamd "API_Private_Key".
Instructies voor het aanmaken/configureren van een API-sleutel zijn beschikbaar.
Een API-sleutel is alleen nodig als u van plan bent de privé API-eindpunten te gebruiken om toegang te krijgen tot uw Kraken-account (zoals saldo-aanvragen, plaatsen/annuleren van orders, exporteren van accountgeschiedenis, enz.).
Het gebruik van de REST API-opdrachtregelclient is als volgt:
./krakenapi.py endpoint [parameters] [-pretty]
De opdrachtregelclient ondersteunt alle REST API-eindpunten, dus de volgende zijn slechts enkele voorbeeldopdrachten:
Python
# Time
./krakenapi.py Time
# Ticker
./krakenapi.py Ticker pair=xbtusd
# Trades
./krakenapi.py Trades pair=etheur since=1574067140000000000
# Balance
./krakenapi.py Balance
# Trade Balance
./krakenapi.py TradeBalance asset=xbt
# Query Orders
./krakenapi.py QueryOrders txid=O7MN22-ZCX7J-TGLQHD
# Add Order
./krakenapi.py AddOrder pair=xbtusd type=buy ordertype=limit price=6500 volume=0.002 leverage=5
# Cancel Order
./krakenapi.py CancelOrder txid=O7MN22-ZCX7J-TGLQHDStandaard zal de commandoregelclient de oorspronkelijke API-respons uitvoeren (JSON geschikt voor interpretatie via code), maar als een extra commandoregelargument -pretty wordt gebruikt:
./krakenapi.py TradeBalance asset=shib -pretty
zal de client dezelfde API-respons uitvoeren als mensvriendelijke JSON (met regeleinden/inspringingen).
Python
#!/usr/bin/env python3
# Kraken Rest API
#
# Usage: ./krakenapi endpoint [parameters]
# Example: ./krakenapi Time
# Example: ./krakenapi OHLC pair=xbtusd interval=1440
# Example: ./krakenapi Balance
# Example: ./krakenapi TradeBalance asset=xdg
# Example: ./krakenapi OpenPositions
# Example: ./krakenapi AddOrder pair=xxbtzusd type=buy ordertype=market volume=0.003 leverage=5
import sys
import time
import base64
import hashlib
import hmac
import urllib.request
import json
api_public = {"Time", "Assets", "AssetPairs", "Ticker", "OHLC", "Depth", "Trades", "Spread", "SystemStatus"}
api_private = {"Balance", "BalanceEx", "TradeBalance", "OpenOrders", "ClosedOrders", "QueryOrders", "TradesHistory", "QueryTrades", "OpenPositions", "Ledgers", "QueryLedgers", "TradeVolume", "AddExport", "ExportStatus", "RetrieveExport", "RemoveExport", "GetWebSocketsToken", "CreateSubaccount", "AccountTransfer"}
api_trading = {"AddOrder", "AddOrderBatch", "EditOrder", "CancelOrder", "CancelOrderBatch", "CancelAll", "CancelAllOrdersAfter","OrderAmends","AmendOrder","ListSubaccounts"}
api_funding = {"DepositMethods", "DepositAddresses", "DepositStatus", "WithdrawMethods", "WithdrawAddresses", "WithdrawInfo", "Withdraw", "WithdrawStatus", "WithdrawCancel", "WalletTransfer"}
api_staking = {"Earn/Strategies", "Earn/Allocations", "Earn/Allocate", "Earn/Deallocate", "Earn/AllocateStatus", "Earn/DeallocateStatus", "Staking/Assets", "Staking/Balance", "Stake", "Unstake", "Staking/Pending", "Staking/Transactions"}
api_domain = "https://api.kraken.com"
api_data = ""
output_format = 0
if len(sys.argv) < 2:
api_method = "Time"
elif len(sys.argv) == 2:
api_method = sys.argv[1]
else:
api_method = sys.argv[1]
for count in range(2, len(sys.argv)):
if sys.argv[count] == '-pretty':
output_format = 1
continue
if count == 2:
api_data = sys.argv[count]
else:
api_data = api_data + "&" + sys.argv[count]
if api_method in api_private or api_method in api_trading or api_method in api_funding or api_method in api_staking:
api_path = "/0/private/"
api_nonce = str(int(time.time()*1000))
try:
api_key = open("API_Public_Key").read().strip()
api_secret = base64.b64decode(open("API_Private_Key").read().strip())
except:
print("API public key and API private (secret) key must be in plain text files called API_Public_Key and API_Private_Key")
sys.exit(1)
api_postdata = api_data + "&nonce=" + api_nonce
api_postdata = api_postdata.encode('utf-8')
api_sha256 = hashlib.sha256(api_nonce.encode('utf-8') + api_postdata).digest()
api_hmacsha512 = hmac.new(api_secret, api_path.encode('utf-8') + api_method.encode('utf-8') + api_sha256, hashlib.sha512)
api_request = urllib.request.Request(api_domain + api_path + api_method, api_postdata)
api_request.add_header("API-Key", api_key)
api_request.add_header("API-Sign", base64.b64encode(api_hmacsha512.digest()))
api_request.add_header("User-Agent", "Kraken REST API")
elif api_method in api_public:
api_path = "/0/public/"
api_request = urllib.request.Request(api_domain + api_path + api_method + '?' + api_data)
api_request.add_header("User-Agent", "Kraken REST API")
else:
print("Usage: %s method [parameters]" % sys.argv[0])
print("Example: %s OHLC pair=xbtusd interval=1440" % sys.argv[0])
sys.exit(1)
try:
api_reply = urllib.request.urlopen(api_request).read()
except Exception as error:
print("API call failed (%s)" % error)
sys.exit(1)
try:
api_reply = api_reply.decode()
except Exception as error:
if api_method == 'RetrieveExport':
sys.stdout.buffer.write(api_reply)
sys.exit(0)
print("API response invalid (%s)" % error)
sys.exit(1)
if '"error":[]' in api_reply:
print(api_reply if output_format == 0 else json.dumps(json.loads(api_reply), indent = 4))
sys.exit(0)
else:
print(api_reply if output_format == 0 else json.dumps(json.loads(api_reply), indent = 4))
sys.exit(1)