Docs

Lookup-Beispiele

curl https://api.traceexit.com/v1/ip/203.0.113.10 \
  -H "Authorization: Bearer te_live_…" \
  -H "Accept: application/json"

const res = await fetch("https://api.traceexit.com/v1/ip/203.0.113.10", {
  headers: { Authorization: "Bearer " + process.env.TRACE_EXIT_API_KEY },
});
const dto = await res.json();

import { TraceExitClient } from "@traceexit/sdk";

const client = new TraceExitClient({
  apiKey: process.env.TRACE_EXIT_API_KEY,
});
const dto = await client.lookupIp("203.0.113.10");

import os
import requests

res = requests.get(
    "https://api.traceexit.com/v1/ip/203.0.113.10",
    headers={"Authorization": f"Bearer {os.environ['TRACE_EXIT_API_KEY']}"},
)
dto = res.json()

req, _ := http.NewRequest("GET", "https://api.traceexit.com/v1/ip/203.0.113.10", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("TRACE_EXIT_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
    log.Fatal(err)
}
defer res.Body.Close()

$ch = curl_init('https://api.traceexit.com/v1/ip/203.0.113.10');
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('TRACE_EXIT_API_KEY'),
    'Accept: application/json',
  ],
  CURLOPT_RETURNTRANSFER => true,
]);
$dto = json_decode(curl_exec($ch), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.traceexit.com/v1/ip/203.0.113.10"))
    .header("Authorization", "Bearer " + System.getenv("TRACE_EXIT_API_KEY"))
    .header("Accept", "application/json")
    .GET()
    .build();
HttpResponse<String> res = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer",
        Environment.GetEnvironmentVariable("TRACE_EXIT_API_KEY"));
var json = await client.GetStringAsync("https://api.traceexit.com/v1/ip/203.0.113.10");

require "net/http"
require "json"

uri = URI("https://api.traceexit.com/v1/ip/203.0.113.10")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{ENV['TRACE_EXIT_API_KEY']}"
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
dto = JSON.parse(res.body)

let client = reqwest::Client::new();
let dto = client
    .get("https://api.traceexit.com/v1/ip/203.0.113.10")
    .bearer_auth(std::env::var("TRACE_EXIT_API_KEY")?)
    .send()
    .await?
    .json::<serde_json::Value>()
    .await?;

{
  "mcpServers": {
    "traceexit": {
      "command": "npx",
      "args": ["-y", "@traceexit/mcp"],
      "env": {
        "TRACE_EXIT_API_KEY": "te_live_…",
        "TRACE_EXIT_BASE_URL": "https://api.traceexit.com"
      }
    }
  }
}

Authentifizierung

Senden Sie Ihren API-Schlüssel als Bearer-Token bei jedem Lookup. Schlüssel erstellen Sie in der Konsole unter Keys. Schlüssel beginnen mit te_live_ (Produktion) oder te_test_ (Sandbox). Browser-Sitzungscookies authentifizieren nur die Konsole — nicht /v1/ip-Lookups.

Authorization: Bearer te_live_…

Ratenlimits und Kontingent

Zwei Limits gelten: ein kurzfristiges Requests-pro-Sekunde Fair-Use-Limit je Plan und ein monatliches Lookup-Kontingent (täglich × 30, UTC). REST und MCP teilen einen Zähler. Bei RPS-Limit kurz warten und erneut versuchen. Ist das Monatskontingent auf Free erschöpft, stoppen Anfragen bis zum nächsten UTC-Monat; bezahlte Pläne können Overage erlauben.

Weiches RPS je Plan (ungefähr): Free 10 · Lite 25 · Starter 50 · Pro 100 · Business 200 · Scale 500. Tägliche Kontingente siehe Pricing.

Fehler

Fehler nutzen application/problem+json mit mindestens title und status. Häufige Fälle:

• 401 — Fehlender oder ungültiger API-Schlüssel. Authorization-Header prüfen.
• 429 — Zu viele Anfragen in kurzer Zeit. Retry-After beachten (oft 1 Sekunde) und backoffen.
• 429 — Monatskontingent erschöpft. Upgraden, bis zum nächsten UTC-Monat warten oder Volumen senken. X-Quota-Remaining kann 0 sein.
• 400 / 404 — Ungültige IP oder Pfad. Anfrage korrigieren; nicht blind erneut versuchen.
• 5xx — Vorübergehendes Problem. Mit exponentiellem Backoff erneut versuchen; unklare Privacy als unbekannt behandeln, wenn sofort entschieden werden muss.

Beispiel Problem-Body

{
  "title": "Monthly quota exceeded",
  "status": 429,
  "detail": "Upgrade plan or wait for next UTC month"
}

Antwortform

Verschachtelte Lookup-Antwort mit location, network, Tri-State-Privacy, risk, fraud und meta.

{
  "ip": "203.0.113.10",
  "ipVersion": 4,
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "datacenter": true,
    "residentialProxy": false,
    "anonymizer": false
  },
  "risk": {
    "score": 42,
    "level": "medium",
    "reasons": ["datacenter"]
  },
  "location": {
    "countryCode": "US",
    "city": "Ashburn"
  },
  "meta": {
    "cacheHit": true,
    "partial": false,
    "confidence": 85
  }
}

Teilergebnisse und Vertrauen

Nutzen Sie meta.partial und meta.confidence zusammen mit Tri-State-Privacy (true / false / null), um die Durchsetzungsstärke zu wählen.

risk.reasons und fraud.reasons

Kurze Tags, die erklären, warum ein Score angehoben wurde. Für Logging, Allowlists und Regeltuning — nicht als alleinige Deny-Liste.

• vpn, proxy, tor, residential_proxy — ein passendes Privacy-Flag hat zum Risiko beigetragen.
• datacenter, hosting_asn — die Adresse gehört zu Hosting- oder Rechenzentrums-Infrastruktur.
• high_network_abuse, elevated_network_abuse — beprobter Traffic in diesem Netz zeigt erhöhte Anonymisierer-Nutzung.
• anonymizer — das abgeleitete Anonymizer-Flag hat zum Fraud-Score beigetragen.
• high_geo_risk — der Geo-Kontext erhöht Checkout- oder Fraud-Risiko.
• ml_anonymizer — wahrscheinliche Maskierung, wenn Privacy nicht vollständig bestätigt ist; mit meta.partial und confidence kombinieren.
• feedback_abuse — frühere Operator-Meldungen haben dieses Netz markiert.

CGNAT / Mobil

Geteilte Carrier-NATs können rauschen. ASN-Allowlists für bekannte Mobilbereiche bevorzugen; siehe Enterprise-Guidance bei Skalierung.

Webhooks

Konfigurieren Sie eine HTTPS-Webhook-URL in den Einstellungen, um Änderungsbenachrichtigungen zu erhalten. Jede Zustellung ist ein POST mit JSON-Body und signierten Headern.

{
  "event": "watch.risk_changed",
  "eventId": "550e8400-e29b-41d4-a716-446655440000",
  "occurredAt": "2026-07-27T12:00:00Z",
  "organizationId": 42,
  "watch": {
    "id": 7,
    "label": "Login gateway",
    "targetType": "ip",
    "targetValue": "203.0.113.10"
  },
  "subject": {
    "ip": "203.0.113.10",
    "ipVersion": 4
  },
  "changes": [
    {
      "field": "risk.score",
      "previous": 25,
      "current": 72
    },
    {
      "field": "risk.level",
      "previous": "low",
      "current": "high"
    }
  ]
}