Developer-Referenz

API & Webhooks

Truth-Social-Alerts in Trading-Bots, Dashboards und Automations-Pipelines einbinden. Webhook und REST-Zugang ab Business-Tarif.

Überblick

TruthPush liefert angereicherte Post-Events — Sentiment, signierter Score, Ticker und Keywords — über zwei Integrationspfade:

  • Webhooks senden JSON in Echtzeit an Ihre URL, sobald ein überwachtes Profil postet (Business+).
  • REST Catch-up liefert chronologische Posts mit Cursor-Pagination zum Nachziehen verpasster Events (Business+).
  • API-Token erzeugen und Webhook-URL im TruthTerminal einrichten — nach Upgrade auf Business.

Telegram- und E-Mail-Alerts nutzen separate Kanäle; diese Referenz beschreibt nur den programmatischen Zugang.

Authentifizierung

REST-Anfragen nutzen ein Bearer-Token. Dasselbe Secret signiert Webhook-Payloads.

  1. Auf Business oder Enterprise upgraden.
  2. TruthTerminal öffnen → Developer Hub → API Key generieren.
  3. Bei jeder REST-Anfrage Authorization: Bearer YOUR_API_TOKEN mitsenden.
curl "https://truthpush.com/api/v1/posts/catch-up?handle=realDonaldTrump&limit=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

API-Token wie ein Passwort behandeln. Regenerieren macht das alte Token und alle Webhook-Signaturen sofort ungültig.

Webhooks

Webhook-URL im TruthTerminal konfigurieren. Jeder qualifizierende Post löst einen HTTP POST mit JSON-Body und TruthPush-Signatur-Headern aus.

Request-Header 

POST https://your-server.com/hooks/truthpush
Content-Type: application/json
X-TruthPush-Signature: t=<unix>,v1=<hmac_sha256_hex>
X-TruthPush-Event-Id: <post_id>

v1 = HMAC_SHA256(api_token, "<t>." + raw_body)

Signal-Filter

Mindest-|signed_score| im TruthTerminal setzen (0 = alle Events, 0,7 = nur starke Signale) — reduziert Rauschen in Trading-Pipelines.

REST API

GET /api/v1/posts/catch-up

Liefert Posts eines Handles in aufsteigender chronologischer Reihenfolge mit Cursor-Pagination. Antworten sind kurz gecacht (~7 s) und unterstützen ETag / If-None-Match für effizientes Polling.

Query-Parameter

  • handle — handle — Truth-Social-Username ohne @ (Pflicht)
  • since — since — ISO-8601-Anker für den ersten Abruf (optional)
  • cursor — cursor — opaker Wert aus meta.next_cursor (optional)
  • limit — limit — 1–200, Standard 100

Event-Objekt

Webhook-Payloads und REST-Post-Objekte teilen dieselben Anreicherungsfelder. event_id entspricht post_id zur Deduplizierung. 

{
  "event_id": "1234567890",
  "target": "realdonaldtrump",
  "post_id": "1234567890",
  "content": "Post text…",
  "url": "https://truthsocial.com/@realdonaldtrump/posts/1234567890",
  "media": [],
  "sentiment": "bullish",
  "signed_score": 0.89,
  "score": 0.89,
  "tickers": ["$DJT"],
  "keywords": ["tariffs", "trade"],
  "reasoning": "Direct market impact via trade policy.",
  "ai_analysis": { … }
}
event_id
Stabile Event-ID — für idempotente Verarbeitung
target
Überwachtes Truth-Social-Handle
sentiment
bullish | bearish | neutral
signed_score
Richtungs-Score von −1 bis +1
tickers
Extrahierte Ticker (z. B. DJT) — kein eigenes Trading-Signal-Produkt
keywords
Erkannte Keywords aus dem Post-Text
ai_analysis
Legacy verschachteltes Objekt — gleiche Daten, Rückwärtskompatibilität

Rate-Limits

Limits gelten pro API-Token. Überschreitung liefert HTTP 429 mit Retry-After.

  • Business: 60 Anfragen/Minute · 10.000/Tag
  • Enterprise: 300 Anfragen/Minute · 500.000/Tag
  • Antworten enthalten X-RateLimit-*-Header.

Tarife & Zugang

API und Webhooks sind auf Observer und Professional nicht verfügbar. TruthTerminal-Live-Feed ab Professional; programmatischer Zugang ab Business.

Pläne vergleichen Account erstellen

Fehler

Häufige API-Antworten:

  • 401 — fehlendes oder ungültiges Bearer-Token
  • 403 — Tarif ohne API-Zugang
  • 429 — Rate-Limit überschritten; Retry-After beachten
  • 400 — ungültiger Cursor oder upgrade_required_* aus Archiv-Fenster