Submit Fraud Evaluation Request

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

Send wallet intents or chain events for real-time scoring.

Header parameters

Content-Type | string · requiredJSON payload describing the target under reviewe.g. application/json

x-api-key | string · requiredAPI key authorizing your org to call the fraud service

Authorization | string · requiredBearer token obtained from the Auth Token endpointe.g. Bearer eyJ0eXAiOiJKV1Qi...

Request body

target | string · requiredWallet, transaction hash, or other target identifiere.g. 1.1074515723846148e+48

user_id | string · requiredInternal subject identifier for correlatione.g. 2130860c-8519-48d5-8a29-4b5d3aa57aad

target_type | string · requiredDefines how Monchain parses the target valuee.g. wallet_address

blockchain_type | string · requiredNetwork the target belongs toe.g. ethereum

Responses

202Request accepted

Evaluation queued successfully

id· string· required

Unique fraud evaluation identifier

status· string· required

Lifecycle status (queued, processing, complete)

blockchain_type· string· required

Echo of requested chain

risk_score· number· optional

0-1 score representing risk

created_at· string· required

ISO timestamp when the evaluation request was accepted

risk_level· string· optional

Categorical risk level (low, medium, high)

400Invalid payload

Missing required fields or unsupported target type

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

401Authorization failure

Bearer token missing/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

403Forbidden

API key lacks fraud scope

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

422Target not supported

Unsupported chain or malformed address

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

Too many concurrent evaluations

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