API Dokumentation

Programmatischer Zugang zu Sentiment-basierten Krypto-Prognosen

Einführung

Die Knecht Prognosetool API bietet programmatischen Zugang zu unseren Sentiment-basierten Krypto-Prognosen. Die API basiert auf Prediction Market Daten von Polymarket und liefert prognostizierte Preise, Sentiment-Werte und Handelssignale.

Base URL: https://ihre-domain/prognosetool/

Authentifizierung

Alle API-Anfragen erfordern einen API-Key und API-Secret, die als Header übergeben werden.

Headers:
X-API-KEY: ihr_api_key
X-API-SECRET: ihr_api_secret
            

Um einen API-Key zu erhalten, nutzen Sie den öffentlichen Endpunkt:

GET /api_public.php

Generiert einen neuen API-Key.

Wichtig: Der api_secret wird nur ein einziges Mal angezeigt. Speichern Sie ihn sofort!

Endpunkte

GET /api.php?tf=1D

Liefert Prognose-Daten für den angegebenen Timeframe.

Parameter:

Parameter	Typ	Beschreibung
tf	string	Timeframe: 1D, 1W, 1M, 1Y

Response-Format

{
  "timeframe": "1D",
  "meta": {
    "plan": "free",
    "limit": 100,
    "used": 23,
    "remaining": 77
  },
  "coins": [
    {
      "coin": "BTC",
      "current": 65000,
      "expected": 67000,
      "low": 0,
      "high": 0,
      "sentiment": 3.1,
      "confidence": 0,
      "signal": "LONG",
      "delta": 0.2
    }
  ],
  "updated": "2026-04-06"
}
            

Response-Felder

Feld	Typ	Beschreibung
coin	string	Kürzel: BTC, ETH, SOL, XRP
current	float	Aktueller Preis (Binance)
expected	float	Erwarteter Preis basierend auf Polymarket
low	float	Untergrenze (nur 1M/1Y)
high	float	Obergrenze (nur 1M/1Y)
sentiment	float	Sentiment in % (-100 bis +100)
confidence	float	Modell-Sicherheit (nur 1M/1Y)
signal	string	Signal: STRONG_SHORT, SHORT, NEUTRAL, LONG, STRONG_LONG
delta	float	Veränderung zum Vortag

Fehlercodes

Code	Beschreibung
401 Unauthorized	Ungültiger API-Key oder Secret
429 Too Many Requests	Rate Limit überschritten
500 Internal Server Error	Server-Fehler

{
  "error": "Unauthorized"
}

{
  "error": "Daily limit reached",
  "meta": {
    "limit": 100,
    "used": 100,
    "remaining": 0
  }
}
            

Rate Limits

Plan	Tageslimit	Minute Limit
Free	100	10

Rate Limit Header in jeder Response:

X-RateLimit-Limit: 100
X-RateLimit-Used: 23
X-RateLimit-Remaining: 77
X-RateLimit-Reset: 1712419200
            

Code-Beispiele

Python

import requests

url = "http://localhost/prognosetool/api.php?tf=1D"
headers = {
    "X-API-KEY": "ihr_key",
    "X-API-SECRET": "ihr_secret"
}
response = requests.get(url, headers=headers)
print(response.json())
            

JavaScript (fetch)

fetch("http://localhost/prognosetool/api.php?tf=1D", {
  headers: {
    "X-API-KEY": "ihr_key",
    "X-API-SECRET": "ihr_secret"
  }
})
.then(res => res.json())
.then(data => console.log(data));
            

PHP (cURL)

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 
    "http://localhost/prognosetool/api.php?tf=1D");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-KEY: ihr_key",
    "X-API-SECRET: ihr_secret"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
            

cURL (Shell)

# API-Anfrage mit curl
curl -v \
  -H "X-API-KEY: ihr_api_key" \
  -H "X-API-SECRET: ihr_api_secret" \
  "http://localhost/prognosetool/api.php?tf=1D"
            

Key generieren (ohne Auth)

# Neuen API-Key generieren
curl -v "http://localhost/prognosetool/api_public.php"
            