Open App

get_job_results

>-

get_job_results

Retrieves the results of a completed or partially completed batch job. Returns full wallet analysis data - fraud scores, behavioural profiles, intent signals - for each processed address in the batch.

Only call this when check_job_status shows status "completed" or "partial". Do not call this while a job is "pending" or "processing".

Both job_id and signature from the original batch scheduling call are required. Never call this tool without both values.

MCP Endpoint: https://prediction.mcp.chainaware.ai/sse

Input Schema

Field Type Required Description
job_id string Yes The job_id returned when scheduling the batch job
signature string Yes The signature returned when scheduling the batch job

Output Schema

Returns an array of wallet analysis records - one per successfully processed address. Each record matches the output format of the corresponding single-wallet tool (predictive_fraud or predictive_behaviour).

{
  "message": "Success",
  "data": [
    {
      "walletAddress": "0xABC...",
      "status": "Not Fraud",
      "probabilityFraud": "0.0421858616",
      "chain": "ETH",
      "lastChecked": "2026-03-12T16:01:17.000Z",
      "forensic_details": {
        "cybercrime": "0",
        "money_laundering": "0",
        "mixer": "0",
        "sanctioned": "0",
        "honeypot_related_address": "0"
      },
      "categories": [
        { "Category": "DeFi", "Count": 126 }
      ],
      "experience": { "Type": "Experience", "Value": 87 },
      "intention": {
        "Type": "Intentions",
        "Value": {
          "Prob_Trade": "High",
          "Prob_Lend": "High",
          "Prob_Stake_ETH": "Medium"
        }
      },
      "protocols": [
        { "Protocol": "uniswap", "Count": 25 }
      ],
      "userDetails": {
        "wallet_age_days": 3798,
        "total_balance_usd": 104859.49,
        "transaction_count": 19972,
        "wallet_rank": 20042
      },
      "recommendation": {
        "Type": "Recommendation",
        "Value": ["ETH holding", "Stablecoin lending"]
      },
      "sanctionData": [
        { "isSanctioned": false }
      ],
      "checked_times": 2135,
      "createdAt": "2023-10-12T11:46:55.000Z",
      "updatedAt": "2026-03-12T16:01:17.000Z"
    }
  ]
}

Top-level fields

Field Type Description
message string "Success" or error description
data array Array of wallet analysis objects - one per completed wallet

Each object in data contains the full output fields from predictive_fraud / predictive_behaviour. See those tool pages for complete field descriptions:
- predictive_fraud output fields
- predictive_behaviour output fields

Batch Workflow

1. predictive_fraud_batch or predictive_behaviour_batch  →  schedule job, get job_id + signature
2. check_job_status                                      →  poll until "completed" or "partial"
3. get_job_results                                       →  retrieve wallet data

Code Examples

Node.js

// Only call after check_job_status shows "completed" or "partial"
const results = await client.callTool({
  name: "get_job_results",
  arguments: {
    job_id: "0fc5897a-ad64-4f21-88b5-1274d1cfec46",
    signature: "260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a"
  }
});

for (const wallet of results.data) {
  console.log(wallet.walletAddress, wallet.status, wallet.probabilityFraud);
}

Python

# Only call after check_job_status shows "completed" or "partial"
results = await session.call_tool("get_job_results", {
    "job_id": "0fc5897a-ad64-4f21-88b5-1274d1cfec46",
    "signature": "260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a"
})

for wallet in results["data"]:
    print(wallet["walletAddress"], wallet["status"], wallet["probabilityFraud"])

Example Agent Prompts

"Get the results of job 0fc5897a-ad64-4f21-88b5-1274d1cfec46, signature 260866..."
"My batch job is done - retrieve the fraud results. Job ID: 0fc5897a..."
"Show me the behavioural profiles from my completed batch job."

Error Codes

Code Meaning
403 Invalid apiKey or signature
400 Malformed job_id
500 Temporary backend failure - retry after a short delay

See also: Prediction MCP Overview | Setup Guide