Get Fraud Evaluation Results by Targets

GEThttps://api.monchain.ai/a/fes/api/v1/fraud-evaluations/results

Poll verdicts by targets when webhooks are unavailable.

Header parameters

Authorization | string · requiredBearer token issued via Auth Token endpointe.g. Bearer eyJ0eXAiOiJKV1Qi...

x-api-key | string · requiredAPI key enabling fraud evaluation reads

Query parameters

targets | string · requiredComma-separated targets (wallets, mission IDs) to polle.g. 0xc1fbd893de51d28a9d0dc52bd4cebc45311da652,mission_123

Responses

200Verdicts available

All requested targets completed

items· object[]· required

Collection of fraud evaluation results that match the requested targets

items[].evaluation_id· string· required

Unique evaluation identifier for the processed target

items[].target· string· required

Target identifier echoed from your query

items[].target_type· string· optional

Target classification (wallet_address, transaction_hash)

items[].blockchain_type· string· optional

Chain associated with the evaluated target

items[].status· string· required

Evaluation lifecycle status (queued, processing, completed)

items[].fraud_score· number· optional

0-100 score summarizing Monchain risk assessment

items[].risk_level· string· optional

Normalized categorical risk level

items[].evaluation_comment· string· optional

Narrative summary explaining the decision

items[].date_created· string· optional

ISO timestamp when the evaluation was initiated

items[].date_updated· string· optional

ISO timestamp for the latest evaluation update

items[].date_completed· string· optional

ISO timestamp for when scoring finalized

items[].date_last_score_update· string· optional

ISO timestamp for the latest score recalculation

items[].transactions_evaluated· string[]· optional

Array of transaction hashes referenced during scoring

items[].risk_breakdown· object[]· optional

Category-level breakdown of contributing risk signals

items[].risk_breakdown[].category· string· optional

Category label (transaction_pattern, smart_contract_anomalies, etc.)

items[].risk_breakdown[].score· number· optional

Category-level score contributing to the final fraud_score

items[].risk_breakdown[].risk_level· string· optional

Category-specific risk level

items[].risk_breakdown[].features· object[]· optional

Feature-level evidence supporting the category score

items[].recommendations· object[]· optional

Recommended follow-up actions derived from the evaluation

items[].recommendations[].content· string· optional

Actionable guidance describing the recommendation

items[].recommendations[].urgency· string· optional

Urgency classification (low, medium, high)

items[].recommendations[].completed· boolean | null· optional

Completion flag for downstream tracking

total_records· integer· required

Total number of records across all pages

total_pages· integer· required

Total number of pages available for the current query

page· integer· required

Current page index

page_size· integer· required

Maximum number of items returned per page

202Evaluations still processing

At least one target is not ready yet

items· object[]· required

Collection of fraud evaluation results that match the requested targets

items[].evaluation_id· string· required

Unique evaluation identifier for the processed target

items[].target· string· required

Target identifier echoed from your query

items[].target_type· string· optional

Target classification (wallet_address, transaction_hash)

items[].blockchain_type· string· optional

Chain associated with the evaluated target

items[].status· string· required

Evaluation lifecycle status (queued, processing, completed)

items[].fraud_score· number· optional

0-100 score summarizing Monchain risk assessment

items[].risk_level· string· optional

Normalized categorical risk level

items[].evaluation_comment· string· optional

Narrative summary explaining the decision

items[].date_created· string· optional

ISO timestamp when the evaluation was initiated

items[].date_updated· string· optional

ISO timestamp for the latest evaluation update

items[].date_completed· string· optional

ISO timestamp for when scoring finalized

items[].date_last_score_update· string· optional

ISO timestamp for the latest score recalculation

items[].transactions_evaluated· string[]· optional

Array of transaction hashes referenced during scoring

items[].risk_breakdown· object[]· optional

Category-level breakdown of contributing risk signals

items[].risk_breakdown[].category· string· optional

Category label (transaction_pattern, smart_contract_anomalies, etc.)

items[].risk_breakdown[].score· number· optional

Category-level score contributing to the final fraud_score

items[].risk_breakdown[].risk_level· string· optional

Category-specific risk level

items[].risk_breakdown[].features· object[]· optional

Feature-level evidence supporting the category score

items[].recommendations· object[]· optional

Recommended follow-up actions derived from the evaluation

items[].recommendations[].content· string· optional

Actionable guidance describing the recommendation

items[].recommendations[].urgency· string· optional

Urgency classification (low, medium, high)

items[].recommendations[].completed· boolean | null· optional

Completion flag for downstream tracking

total_records· integer· required

Total number of records across all pages

total_pages· integer· required

Total number of pages available for the current query

page· integer· required

Current page index

page_size· integer· required

Maximum number of items returned per page

401Unauthorized

Bearer token missing or expired

status· integer· required

HTTP status code returned by the API

message· string· required

Human-readable error details

path· string | null· optional

Request path that triggered the error

timestamp· string· required

UTC timestamp for when the error occurred

404Target not found

Requested target was never evaluated or aged out

status· integer· required

HTTP status code returned by the API

message· string· required

Human-readable error details

path· string | null· optional

Request path that triggered the error

timestamp· string· required

UTC timestamp for when the error occurred

429Rate limited

Polling frequency exceeded

status· integer· required

HTTP status code returned by the API

message· string· required

Human-readable error details

path· string | null· optional

Request path that triggered the error

timestamp· string· required

UTC timestamp for when the error occurred