AML-Verlauf abrufen

Rufen Sie eine paginierte Liste der von Ihnen erstellten AML-Prüfungen ab. Verwenden Sie Filter, um nach Status einzugrenzen.

POST /v1/aml-checks/history

Anfrage

Parameter

Feld	Typ	Erforderlich	Beschreibung
page	integer	Nein	Seitenzahl (Standard: 1, Minimum: 1)
per_page	integer	Nein	Einträge pro Seite (Standard: 10, Bereich: 1-50)
status	string	Nein	Filter nach AML-Prüfstatus (siehe Tabelle)

Statuswerte

Wert	Beschreibung
pending	Prüfung erstellt und wartet auf Verarbeitung
processing	Prüfung wird aktuell bearbeitet
completed	Prüfung erfolgreich abgeschlossen
failed	Prüfung aufgrund von Fehlern fehlgeschlagen
expired	Prüfung abgelaufen, bevor ein Ergebnis vorlag
skipped	Prüfung wurde nicht ausgeführt und nicht berechnet (z. B. eine Adresse ohne On-Chain-Aktivität); sie enthält keine Risikobewertung

processing und expired werden vom Filter akzeptiert, Prüfungen werden derzeit aber nur als pending, completed, skipped oder failed erfasst.

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "page": 1,
  "per_page": 10,
  "status": "completed"
}'

# Signatur berechnen
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# API-Anfrage senden
curl -X POST "https://api.trxup.com/v1/aml-checks/history" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  page: 1,
  per_page: 10,
  status: 'completed'
});

// Signatur berechnen
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// API-Anfrage senden
axios({
  method: 'post',
  url: 'https://api.trxup.com/v1/aml-checks/history',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'page' => 1,
  'per_page' => 10,
  'status' => 'completed'
]);

// Signatur berechnen
$signature = hash('sha256', $requestBody . $apiSecret);

// API-Anfrage senden
$ch = curl_init('https://api.trxup.com/v1/aml-checks/history');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

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

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'page': 1,
  'per_page': 10,
  'status': 'completed'
})

# Signatur berechnen
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# API-Anfrage senden
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.trxup.com/v1/aml-checks/history',
  headers=headers,
  data=request_body
)

print(response.json())

Antwort

Die Antwort liefert Paginierungsdaten zusammen mit AML-Prüfungen im gleichen Format wie bei den Einzelendpunkten.

Antwortfelder

Feld	Typ	Beschreibung
code	integer	Antwortcode (0 = Erfolg)
request_id	string	Eindeutiger Anfrage-Bezeichner
result	object	Paginierte Ergebnisdaten
result.page	integer	Aktuelle Seitenzahl
result.per_page	integer	Anzahl der zurückgegebenen Elemente
result.total	integer	Gesamtanzahl der Prüfungen für den Filter
result.items	array	Array von AML-Prüfobjekten
result.items[].id	string	Kennung der AML-Prüfung
result.items[].type	string	AML-Servicetyp (address oder hash)
result.items[].address	string	Geprüfte Adresse
result.items[].network	string	Blockchain-Netzwerkcode, so geschrieben wie in der Liste der unterstützten Netzwerke (z. B. TRX, TetherOMNI)
result.items[].status	string	Aktueller Status (pending, processing, completed, failed, expired, skipped)
result.items[].risk_score	string|null	Risikowert als String mit zwei Nachkommastellen (z. B. "12.50") oder null, solange kein Wert vorliegt
result.items[].risk_level	string|null	Textuelle Risikostufe (low, medium, high)
result.items[].blacklist	boolean	Zeigt an, ob ein Blacklist-Treffer vorliegt
result.items[].risk_factors	array	Risikokategorien, mit denen die Mittel verbunden sind, absteigend nach score sortiert, ein Eintrag pro Kategorie; leeres [], wenn keine Kategorien gemeldet wurden (z. B. solange die Prüfung nicht abgeschlossen ist)
result.items[].risk_factors[].name	string	Kategorieschlüssel, einer der unter Kategorien der Risikofaktoren aufgeführten Schlüssel; eine Kategorie außerhalb dieser Liste wird als other gemeldet
result.items[].risk_factors[].label	string	Englische Bezeichnung der Kategorie (wird nicht übersetzt)
result.items[].risk_factors[].group	string	Risikogruppe der Kategorie: low, medium oder high
result.items[].risk_factors[].score	number	Anteil der Mittel, der mit dieser Kategorie verbunden ist, von 0 bis 1, auf 3 Nachkommastellen gerundet
result.items[].checked_at	string	Zeitpunkt der Erstellung der Prüfung (ISO 8601)
result.items[].hash	string	Geprüfter Transaktionshash (nur bei Hash-Prüfungen)
result.items[].direction	string	Geprüfte Seite der Transaktion, deposit oder withdrawal (nur bei Hash-Prüfungen)

Die vollständige Liste der Kategorieschlüssel mit Bezeichnungen und Gruppen finden Sie unter Kategorien der Risikofaktoren.

Beispielantwort

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "page": 1,
    "per_page": 2,
    "total": 5,
    "items": [
      {
        "id": "1042",
        "type": "hash",
        "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
        "network": "TRX",
        "status": "completed",
        "risk_score": "64.30",
        "risk_level": "high",
        "blacklist": true,
        "risk_factors": [],
        "checked_at": "2024-03-25T11:14:48+00:00",
        "hash": "E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2",
        "direction": "withdrawal"
      },
      {
        "id": "1041",
        "type": "address",
        "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
        "network": "TRX",
        "status": "pending",
        "risk_score": null,
        "risk_level": null,
        "blacklist": false,
        "risk_factors": [],
        "checked_at": "2024-03-25T11:12:03+00:00"
      }
    ]
  }
}

Mögliche Fehler

Fehlercode	Key	Beschreibung
1	auth	Authentifizierungsfehler (falsches Token oder Signatur)
2	invalid_service_or_params	Ungültige Paginierungs- oder Statusparameter
500	internal_server_error	Interner Serverfehler