> For the complete documentation index, see [llms.txt](https://docs.musepay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.musepay.io/reference/api-reference/kyt-api.md).

# KYT API

Screen on-chain transactions for risk and retrieve structured KYT results.

The KYT API lets you submit an on-chain transaction for risk screening and retrieve the result asynchronously.

## Integration flow

1. Complete [Authentication](/integration/authentication.md) and prepare the transaction you want to screen.
2. Generate a unique `request_id`, then call [Transaction Check](/reference/api-reference/kyt-api/transaction-check.md) with the transaction's `chain`, `currency`, and `txn_hash`. Include `destination_address` when available.
3. Store the `request_id` and returned `order_no` with the transaction in your system.
4. Call [Query KYT Result](/reference/api-reference/kyt-api/query.md) with the same `request_id` until the status changes to `99`, `44`, or `88`. You may also include the returned `order_no`.
5. Use `risk_level`, `hit`, `hit_rules`, `actions`, and `result_data` from the completed result to apply your own review, approval, or rejection policy.

{% hint style="info" %}
Transaction checks are asynchronous. A successful API response means the screening request was accepted, not that the risk analysis is complete.
{% endhint %}

## Endpoints

| Endpoint                                                                   | Description                                             |
| -------------------------------------------------------------------------- | ------------------------------------------------------- |
| [Transaction Check](/reference/api-reference/kyt-api/transaction-check.md) | Submit a blockchain transaction for KYT screening.      |
| [Query KYT Result](/reference/api-reference/kyt-api/query.md)              | Retrieve the current status and structured risk result. |