👁️ Address tracking

GET /api/fast-check/{id}/tracking

Enables or disables daily tracking of an address. For tracked addresses the service re-runs the quick check once a day on its own, so you do not have to call /run manually — it is enough to fetch the list of checks periodically.

🛠️ Parameters

Example request

curl 'https://amlkyc.tech/api/fast-check/1234/tracking' \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Accept: application/json'

Example responses

200 Response

{
  "success": true,
  "tracking": true
}

🔁 Responses

⚙️ How tracking works

• The re-run happens once a day, on the service schedule. Updates "on fund movement" are not provided.
• Every daily run charges the price of one quick check. If the balance is not sufficient, the address is simply skipped that day.
• A notification is sent only when something changed: the risk score, the set of labels, or the balance, transaction count or last operation date.
• After every completed run the check gets new: true — the "unseen update" flag.

📥 Pulling updates passively

# all tracked addresses updated since the given date
curl 'https://amlkyc.tech/api/fast-check?tracking=true&updated_from=2026-09-11&limit=50' \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Accept: application/json'

✅ Marking a result as seen

POST /api/fast-check/{id}/viewed

Resets the new flag to false. Handy as an acknowledgement that you have already processed the update for that address.

Example responses

200 Response

{
  "success": true
}

🔁 Responses