AML Screening API

Compliance-as-a-Service: проверяйте риск любого блокчейн-адреса одним HTTP-запросом и получайте готовый обезличенный отчёт - в JSON и PDF. Движок скоринга, правила и источники данных работают на нашей стороне; вам остаётся вызвать API и применить готовый вердикт. Одна проверка возвращает единый risk_score (0-100), уровень risk_level, готовую рекомендацию recommendation, набор сигналов, факторы риска и агрегаты по сетям.

Как это работает

Проверка синхронная: один POST выполняет всю оценку и возвращает полный отчёт в теле ответа 201 - очереди и опроса результата нет. Каждой проверке присваивается id, по которому отчёт можно перечитать или выгрузить в PDF без повторной тарификации.

Аутентификация и окружения

Все запросы авторизуются секретным ключом в заголовке Authorization: Bearer sk_live_... (боевой контур) или sk_test_... (sandbox). Окружение выбирается по префиксу ключа - отдельного заголовка нет. Подробнее - в разделе Authentication.

Тарификация

Боевая проверка платная: стоимость одного вызова списывается с вашего мастер-счёта в момент запроса. Базовая цена - 0.2 USDT за проверку; для вашей учётной записи она может быть изменена по договору, поэтому действующее значение всегда смотрите в витрине тарифа (GET /api/v1/merchant/service-pricing).

Эндпоинты раздела

• POST /api/v1/aml/checks - проверить адрес и получить полный отчёт. Проверка адреса →
• GET /api/v1/aml/checks - последние проверки текущего окружения. Отчёты и PDF →
• GET /api/v1/aml/checks/{id} - перечитать сохранённую проверку по id. Отчёты и PDF →
• GET /api/v1/aml/checks/{id}/report.pdf - скачать обезличенный отчёт в PDF. Отчёты и PDF →

Коды ошибок и конверт - Error Codes →.

Лимиты частоты

При превышении приходит 429 rate_limited с заголовком Retry-After: спите указанное число секунд, затем повторяйте с экспоненциальной задержкой. Корзина AML не пересекается с корзинами кошельков и мастер-счёта.

Быстрый старт

Проверьте адрес в sandbox (ключ sk_test_) и примите решение по единому вердикту recommendation. Панель справа - тот же вызов на cURL, JavaScript, PHP и Python.

# Проверить адрес (sandbox - по префиксу sk_test_)
curl -X POST https://fin-os.io/api/v1/aml/checks \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"address": "TXYZ1234567890abcdefGHIJKLmnop", "network": "tron"}'

const FINOS = 'https://fin-os.io/api/v1';
const KEY   = process.env.FINOS_SECRET_KEY; // sk_test_ (sandbox) или sk_live_ (live)

async function checkAddress(address, network) {
  const res = await fetch(`${FINOS}/aml/checks`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ address, network }),
  });
  const { data } = await res.json();
  console.log(data.risk_level, data.risk_score, data.report.recommendation);
  return data;
}

checkAddress('TXYZ1234567890abcdefGHIJKLmnop', 'tron');

use Illuminate\Support\Facades\Http;

$key  = config('services.finos.secret_key'); // sk_test_ или sk_live_
$data = Http::withToken($key)
    ->post('https://fin-os.io/api/v1/aml/checks', [
        'address' => 'TXYZ1234567890abcdefGHIJKLmnop',
        'network' => 'tron',
    ])
    ->json('data');

if (in_array($data['report']['recommendation'], ['reject', 'block'], true)) {
    // задержать операцию / отправить на ручной комплаенс
}

import requests, os

FINOS = 'https://fin-os.io/api/v1'
KEY   = os.environ['FINOS_SECRET_KEY']  # sk_test_ (sandbox) или sk_live_ (live)
H     = {'Authorization': f'Bearer {KEY}'}

r = requests.post(f'{FINOS}/aml/checks', headers=H,
                  json={'address': 'TXYZ1234567890abcdefGHIJKLmnop', 'network': 'tron'})
r.raise_for_status()
data = r.json()['data']
print(data['risk_level'], data['risk_score'], data['report']['recommendation'])