Skip to content
REST-API

Programmatischer Zugriff auf alle Flow-Daten

Die BTC-FlowWatch-API liefert Netflows, Kategorie- und Provider-Matrizen, Preise und Korrelationen als JSON — für Dashboards, Trading-Bots, Alert-Systeme und wissenschaftliche Analyse.

Exklusiv für Platinum

Die API ist Platinum-Kunden vorbehalten. Sowohl die Key-Generierung als auch die API-Nutzung setzt eine aktive Platinum-Subscription voraus — läuft dein Abo ab, wird der Key deaktiviert. Key erstellen: Account → API-Key, sofort einsatzbereit.

Platinum buchen →

Authentifizierung

Jeder Platinum-User bekommt genau einen API-Key im Format fw_<32-hex>. Sende ihn im X-API-Key-Header bei jedem Request.

curl -H "X-API-Key: fw_your_key" \
  "https://flowwatch.coinator.eu/api/flows/..."

Key generieren oder zurücksetzen: in der App unter Account → API-Key.

Base-URL

https://flowwatch.coinator.eu

Rate-Limits

Pro API-Key gilt ein Limit von 100 Requests pro Minute. Überschreitungen quittiert die API mit HTTP 429 und dem Header Retry-After.

Endpunkte

Alle Endpunkte sind GET-Requests und liefern JSON. Klicke einen Endpunkt, um Parameter, Beispiel-Request und Beispiel-Response zu sehen.

GET /api/flows/netflow-blocks

Netflow pro Block und Kategorie. Liefert Inflow, Outflow, Net-Flow (in Satoshi) und TX-Count je Kategorie und Block — in Echtzeit ab aktuellstem Block.

Parameter

Name Type Description Default
limit int Anzahl Blöcke / block count 144
start int Start-Zeitstempel (Unix) / start timestamp —
end int End-Zeitstempel (Unix) / end timestamp —
bucket int Zeit-Bucket in Sekunden (z. B. 3600 für stündlich) —

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/netflow-blocks?limit=2"

Antwort

{
  "blocks": [
    {
      "block_height": 944320,
      "timestamp": 1775725000,
      "categories": [
        { "category": "Börse", "inflow_sat": 523400000, "outflow_sat": 612300000, "net_sat": -88900000, "tx_count": 42 },
        { "category": "Mining", "inflow_sat": 312500000, "outflow_sat": 0, "net_sat": 312500000, "tx_count": 1 }
      ]
    }
  ],
  "tier": "platinum",
  "delayed": false
}
GET /api/flows/category-matrix

Kategorie-zu-Kategorie-Flow-Matrix. Zeigt aggregiertes Volumen in BTC zwischen jedem Kategorie-Paar (alle Kategorien, Echtzeit).

Parameter

Name Type Description Default
limit int Anzahl aggregierter Blöcke 144
topn int Nur Top-N Kategorien all
start int Start-Zeitstempel —
end int End-Zeitstempel —

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/category-matrix?limit=10&topn=5"

Antwort

{
  "categories": ["Börse", "Mining", "Neobroker", "..."],
  "matrix": {
    "Börse":  { "Börse": 12.45, "Mining": 0.83 },
    "Mining": { "Börse": 5.21 }
  }
}
GET /api/flows/provider-matrix

Provider-Level: Inflow/Outflow mit Kategorie. Top-N Provider nach Volumen.

Parameter

Name Type Description Default
limit int Anzahl Blöcke 144
topn int Top-N Provider 10
start int Start-Zeitstempel —
end int End-Zeitstempel —

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/provider-matrix?limit=10&topn=5"

Antwort

{
  "providers": [
    { "provider": "Coinbase Prime", "category": "Börse", "inflow_btc": 353.90, "outflow_btc": 818.63, "net_btc": -464.73 },
    { "provider": "Binance.com",    "category": "Börse", "inflow_btc": 278.72, "outflow_btc": 316.46, "net_btc":  -37.73 }
  ]
}
GET /api/flows/provider-pair-matrix

Provider-zu-Provider-Flow-Matrix. Zeigt BTC-Volumen zwischen Provider-Paaren.

Parameter

Name Type Description Default
limit int Anzahl Blöcke 144
topn int Top-N Provider 10
start int Start-Zeitstempel —
end int End-Zeitstempel —

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/provider-pair-matrix?limit=10&topn=5"

Antwort

{
  "providers": ["Coinbase Prime", "Binance.com", "..."],
  "matrix": {
    "Coinbase Prime": { "Binance.com": 1.234 }
  }
}
GET /api/flows/prices

BTC-Preis-Historie (USD + EUR) in Echtzeit, mit optionaler Zeit-Bucket-Aggregation.

Parameter

Name Type Description Default
limit int Anzahl Preispunkte 1000
start int Start-Zeitstempel —
end int End-Zeitstempel —
interval int Bucket-Größe in Sekunden (z. B. 3600 für stündlich) —

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/prices?limit=3"

Antwort

{
  "prices": [
    { "timestamp": 1775725000, "price_usd": "71234.50", "price_eur": "61100.00", "volume_24h": "37262037666.58" }
  ],
  "tier": "platinum",
  "delayed": false
}
GET /api/flows/correlation

Preis-Flow-Korrelations-Matrix. Pearson-Korrelation zwischen Kategorie-Flows und Preisänderungen, mit konfigurierbarem zeitlichen Versatz.

Parameter

Name Type Description Default
blocks int Anzahl analysierter Blöcke 48
lag int Preis-Lag in Minuten 10
start int Start-Zeitstempel —
end int End-Zeitstempel —

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/correlation?blocks=24&lag=10"

Antwort

{
  "categories": ["Börse", "Mining", "..."],
  "matrix":  { "Börse": { "Mining": 0.4231 } },
  "nMatrix": { "Börse": { "Mining": 18 } },
  "lag_minutes": 10,
  "blocks_used": 24
}
GET /api/flows/observations

Flow-Observations — Cross-Kategorie-Signale pro Block.

Parameter

Name Type Description Default
limit int Anzahl Observations 100
from_category string Nach Quell-Kategorie filtern —
to_category string Nach Ziel-Kategorie filtern —

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/observations?limit=5"

Antwort

{
  "observations": [
    { "block_height": 944320, "timestamp": 1775725000, "from_category": "Börse", "to_category": "Mining", "net_btc": "2.45" }
  ]
}
GET /api/flows/categories

Liste aller verfügbaren Kategorien (sortiert nach Anzeige-Reihenfolge).

Parameter

Keine Parameter.

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/categories"

Antwort

{
  "categories": [
    { "name": "Börse",  "display_order": 1 },
    { "name": "Mining", "display_order": 2 }
  ]
}
GET /api/flows/providers

Liste aller bekannten Provider-Namen (nützlich für Autocomplete und Parameter-Validierung).

Parameter

Keine Parameter.

Beispiel

curl -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/providers"

Antwort

{
  "providers": ["Binance.com", "Bitfinex", "Coinbase Prime", "Kraken", "Luxor Mining", "..."]
}

Error-Codes

Code Bedeutung
401 Ungültiger oder fehlender API-Key
403 Endpunkt erfordert höheren Tier (z. B. Platinum)
429 Rate-Limit überschritten (100 req/min pro Key)
500 Interner Server-Fehler

Code-Beispiele

Drei typische Sprachen für den Einstieg — tausche YOUR_KEY gegen deinen echten API-Key.

curl
curl -s -H "X-API-Key: YOUR_KEY" \
  "https://flowwatch.coinator.eu/api/flows/netflow-blocks?limit=24" | jq
Python
import requests

r = requests.get(
    "https://flowwatch.coinator.eu/api/flows/netflow-blocks",
    params={"limit": 24},
    headers={"X-API-Key": "YOUR_KEY"},
    timeout=15,
)
r.raise_for_status()
data = r.json()
for blk in data["blocks"]:
    print(blk["block_height"], blk["categories"])
JavaScript (Node 20+)
const res = await fetch(
  "https://flowwatch.coinator.eu/api/flows/netflow-blocks?limit=24",
  { headers: { "X-API-Key": "YOUR_KEY" } }
);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
for (const blk of data.blocks) {
  console.log(blk.block_height, blk.categories);
}

API-Zugang schalten

Upgrade auf Platinum und starte sofort mit eigener Analyse, eigenem Dashboard oder eigenem Trading-Signal.

Zur Tarif-Auswahl →