# TrustIn DART API

> TrustIn DART is a blockchain AML screening API. Give it a wallet address (KYA) or a transaction hash (KYT) and it traces the funds up to five hops through labeled counterparties, matches every fund-flow path against a ruleset, and returns a 0–100 fund-attribution score with a verdict — accept, review, edd or block — and the exact rules behind it. Every screening is saved as an immutable snapshot. The same API lets a customer manage the rulesets and rules that drive the verdicts.

Base URL https://api.trustin.bond · API key in the X-Api-Key header · JSON envelope {code, msg, data} · errors use HTTP status codes (400 field named in msg, 401, 403 builtin read-only, 404, 409 duplicate rule_code, 429).

## Docs

- [Complete reference (one file)](https://v2.trustin.bond/llms-full.txt): auth, rulesets, the condition DSL, workflows, every endpoint with request and response examples
- [OpenAPI 3.1](https://v2.trustin.bond/openapi.json): schemas for every endpoint, for tool generation
- [Agent skill](https://v2.trustin.bond/agent/SKILL.md): a ready-to-use skill file
- [Interactive reference](https://v2.trustin.bond/api-reference): the same content with a Try-it panel
- [MCP endpoint](https://api.trustin.bond/mcp): the API as tools; connect with Authorization: Bearer <api key>

## Endpoints

### v3 Screening (Chainalysis)

- `GET /api/v3/chains` — Supported Chains (v3): The chains and canonical assets screening accepts, read live from the investigation backend — a value returned here is one screen/kya and screen/kyt will take.
- `POST /api/v3/screen/kya` — KYA Screen (v3): Chainalysis-aligned address screening.
- `POST /api/v3/screen/kyt` — KYT Screen (v3): Chainalysis-aligned transaction screening.
- `GET /api/v3/screen/result/{jobId}` — Get Screen Result (async): Poll an async screening job.

### v3 Rulesets & Rules

- `POST /api/v3/rulesets/list` — List Rulesets: Every ruleset the caller can see: their own plus the builtins (AML KYA Default, KYT-IN, KYT-OUT, the scoring default).
- `POST /api/v3/rulesets/get` — Get Ruleset: One ruleset with all of its rules inline — the same shape rule/list returns per rule, plus scoring_config for a scoring ruleset.
- `POST /api/v3/rulesets/create` — Create Ruleset: An empty ruleset of your own.
- `POST /api/v3/rulesets/update` — Update Ruleset: Rename a ruleset, change its jurisdiction or icon, or replace a scoring ruleset's scoring_config.
- `POST /api/v3/rulesets/delete` — Delete Ruleset: Removes one of your rulesets and its rules.
- `POST /api/v3/rulesets/clone` — Clone Ruleset: Copies a ruleset — a builtin or one of your own — into a new ruleset of yours, rules and highlights included.
- `POST /api/v3/rulesets/rule/list` — List Rules: The rules of one ruleset, in sort_order.
- `POST /api/v3/rulesets/rule/get` — Get Rule: One rule.
- `POST /api/v3/rulesets/rule/create` — Create Rule: Adds a rule to one of your rulesets.
- `POST /api/v3/rulesets/rule/update` — Update Rule: Changes one of your rules.
- `POST /api/v3/rulesets/rule/delete` — Delete Rule: Removes a rule from one of your rulesets.
- `POST /api/v3/rulesets/rule/highlight` — Highlight Rules: Flags or unflags several rules of one ruleset as highlighted (★) in one call.