§ · Developer API

Forensics in one HTTP call.
Same engine the app runs on.

Risk scoring, sanctions screening, and the full six-agent investigation pipeline — exposed as a REST API across registered chains incl. Bitcoin, Tron and stablecoins. Bearer-token auth. Free tier.

View endpoints

Low Latency

Risk checks in under 2 seconds. Full investigations queued and processed by 6 AI Agents.

Enterprise Security

API key authentication, TLS encryption, and rate limiting. SOC 2 compliant infrastructure.

RESTful API

Clean REST endpoints with JSON responses. Works with any language or framework.

Credit-Based Billing

Pay only for what you use. No minimum contracts. Free tier available for evaluation.

Authentication

All API requests require a Bearer token in the Authorization header. Generate your API key from the dashboard after signing up.

# Include your API key in every request curl -H "Authorization: Bearer YOUR_API_KEY" \ https://forensblock.com/api/v1/credits/balance

Endpoints

Three core endpoints cover address risk checks, full investigations, and account management.

GET/api/v1/address/check

Run a risk check on any blockchain address. Returns risk score, entity classification, sanctions status, and confidence level.

ParameterTypeRequiredDescription
addressstringRequiredBlockchain address to check
chainstringOptionalBlockchain network (default: "ethereum")

Example Request

curl -X GET "https://forensblock.com/api/v1/address/check?address=0x1234...&chain=ethereum" \ -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{ "address": "0x1234...", "riskScore": 72, "riskLevel": "high", "entity": { "type": "mixer", "name": "Tornado Cash" }, "sanctioned": true, "confidence": 0.89 }
POST/api/v1/investigate

Launch a full AI investigation with all six agents. Returns investigation ID for polling results.

ParameterTypeRequiredDescription
addressstringRequiredTarget address to investigate
chainstringOptionalBlockchain network (default: "ethereum")
depthstringOptional"quick" | "standard" | "deep"

Example Request

curl -X POST "https://forensblock.com/api/v1/investigate" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address": "0x1234...", "chain": "ethereum", "depth": "standard"}'

Example Response

{ "investigationId": "inv_abc123", "status": "queued", "estimatedCredits": 15, "agents": ["TRACER", "SENTINEL", "ANALYST", "REPORTER", "WATCHER", "HUNTER"] }
GET/api/v1/credits/balance

Check your current credit balance and usage statistics.

Example Request

curl -X GET "https://forensblock.com/api/v1/credits/balance" \ -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{ "credits": 450, "used": 550, "lifetimePurchased": 1000, "creditsExpire": false }

Rate Limits

Engagement

Per matter SoW

Scoped capacity

Professional

60 requests/min

1,000 credits/month

Enterprise

300 requests/min

Custom

Ready to integrate?

Sign up for free, generate an API key, and start making requests in minutes. No credit card required for the free tier.

View Pricing