Wallet Spec API

AML decisions your crypto product can automate.

Connect wallet risk scoring, transaction intelligence, token risk, website checks and P2P exposure into onboarding, payments, OTC desks, compliance queues and internal dashboards.

JSON responseRisk score 1-100Webhook-ready data
01 RequestWallet + chainPOST /external/check
02 EngineGraph analysisScam, mixer, sanctions
03 DecisionRisk scoreAllow / review / block
SanctionsMixersScam graphP2P exposure
JSONReportDashboard
<900msmedian demo response

Fast enough for onboarding and payment holds

5check types

Wallet, token, transaction, website and P2P

27networks

Core chains plus Silver-only extended networks

Integration

One endpoint returns a compliance-ready decision.

Send the subject you want to review and receive structured risk fields that can be stored, displayed to an analyst or used inside automated approval rules.

POST
/api/external/checkRun a risk check

Submit wallet, token, transaction, website or P2P subject with network context.

GET
/api/profile/api-keysManage API keys

Create employee keys from the Gold workspace and keep access separated by user.

GET
/api/admin/api-analyticsMonitor API usage

Admin view for request volume, critical checks and active API clients.

request
curl -X POST https://wallet-risk-ai-backend.onrender.com/api/external/check
  -H "Content-Type: application/json"
  -H "x-api-key: wrk_live_your_key"
  -d "{
    \"wallet\": \"0xA1...89F\",
    \"chain\": \"Ethereum\",
    \"checkType\": \"wallet\"
  }"
response
{
  "wallet": "0xA1...89F",
  "chain": "Ethereum",
  "checkType": "wallet",
  "riskScore": 82,
  "status": "Critical Risk",
  "signals": [
    "Mixer proximity detected",
    "Linked scam cluster found",
    "No-KYC exchange exposure"
  ],
  "recommendation": "Block and escalate for manual review",
  "silverIntel": {
    "lastActivity": "2026-06-19T09:31:00.000Z",
    "openSourceFindings": 4,
    "sourceConfidence": 91
  }
}
Coverage

More than wallet checks.

Wallet screening

Risk score, reputation, scam exposure, sanctions links, mixers and graph connections.

Token checks

Honeypot behavior, owner permissions, liquidity, holders and suspicious contract controls.

Transaction tracing

Source and destination risk, suspicious hops, transfer path and laundering-style routing.

Website intelligence

Phishing similarity, domain age, fake wallet-connect flows, reports and linked wallets.

P2P risk

Dirty-fund exposure, account-freeze risk, counterparty patterns and incoming source quality.

Monitoring ready

Save reports, build watchlists and connect alerts into internal review workflows.

Workflow

From a pasted address to a business rule.

01

Send subject

Your app sends wallet, chain and check type with an API key.

02

Score risk

Wallet Spec maps exposure, graph links and behavior signals.

03

Return decision

Receive score, status, signals, explanation and next action.

04

Store evidence

Use the response in your case review, dashboard or payment logic.

Security and controls

Built for teams that need clean operational control.

Keep API checks gated by plan, separate employee access with API keys, and monitor usage from the admin analytics workspace.

API keys are available on the Gold planUp to 10 employee keys for team separationServer-side plan checks for protected functionalityStructured JSON for logs, reports and automationAdmin analytics for request volume and critical checksSilver intelligence fields for eligible plans
Gold plan

Connect automated AML checks to your product.

Gold gives access to the Business API and employee API keys. Silver unlocks richer user-side intelligence, while Gold is built for teams that need automation.