Query KYT Result

Every request must contain common parameters.

Retrieves the processing status and structured risk result for a KYT transaction check.

POST /v1/kyt/query

Request body

Name	Type	Required	Description
request_id	String	Yes	The same request_id used for the original transaction check.
order_no	String	No	Order number returned by the transaction check. If provided, it must match the order associated with request_id.

Request example

{
  "request_id": "kyt-tx-202609100001",
  "order_no": "FEE202609100001"
}

Response body

Name	Type	Description
request_id	String	The request identifier used for the original transaction check.
order_no	String	MusePay order number for the screening request.
status	Number	Current order status: 22 Processing, 44 Failed, 88 Closed, or 99 Success.
risk_level	String	Risk level returned by the screening provider. Returned when the analysis has completed and a risk record is available.
risk_status	String	Risk decision returned by the screening provider. Returned when available.
result_data	Object	Structured risk metrics. Returned when available.
created_time	Number	Risk record creation time as a 13-digit Unix timestamp in milliseconds. Returned when available.
updated_time	Number	Risk record update time as a 13-digit Unix timestamp in milliseconds. Returned when available.

result_data

Name	Type	Description
source	String	Data source used for the screening.
riskScore	Number	Risk score returned by the data source.
riskAmount	Number	Amount identified as risky, denominated in USD.
orderAmtUSDT	Number	Transaction amount denominated in USDT, when available.
riskAmountRatio	Number	Proportion of the transaction amount identified as risky.
riskCategoryAmount	Object	Risk amount by category. Keys are category names and values are amounts.
riskCategoryAmountPercentage	Object	Risk amount percentage by category.
riskCategoryLevelAmount	Object	Risk amount by level. Keys include values such as HIGH, MEDIUM, and LOW.
riskCategoryLevelAmountPercentage	Object	Risk amount percentage by risk level.
riskCategoryLevel	Object	Risk level by category. Keys are category names and values are risk levels.

Processing response

{
  "code": "200",
  "message": "success",
  "data": {
    "request_id": "kyt-tx-202609100001",
    "order_no": "FEE202609100001",
    "status": 22
  }
}

Completed response

{
  "code": "200",
  "message": "success",
  "data": {
    "request_id": "kyt-tx-202609100001",
    "order_no": "FEE202609100001",
    "status": 99,
    "risk_level": "PASS",
    "risk_status": "APPROVED",
    "result_data": {
      "source": "elliptic",
      "riskScore": 0.0316,
      "riskAmount": 54.10,
      "orderAmtUSDT": null,
      "riskAmountRatio": 0,
      "riskCategoryAmount": {
        "Gambling": 2.05,
        "Dark Service": 2.94
      },
      "riskCategoryAmountPercentage": {},
      "riskCategoryLevelAmount": {
        "HIGH": 50.81,
        "MEDIUM": 3.29
      },
      "riskCategoryLevelAmountPercentage": {},
      "riskCategoryLevel": {
        "Gambling": "MEDIUM",
        "Dark Service": "HIGH"
      }
    },
    "created_time": 1788998400000,
    "updated_time": 1788998401000
  }
}

Risk labels and categories are supplied by the configured screening provider. Build your policy around the returned fields instead of relying on a fixed list of labels.