Blockchain Analytics API for Developers
Yes — OnChainRisk is a REST API you can call to score any crypto wallet's risk before deposits, payouts, P2P settlement, or compliance review. Create a free sandbox key, test your integration, then upgrade to a paid key for production.
Integrate wallet risk scoring, fund flow tracing, and compliance screening into your app, bot, or compliance workflow. Simple REST API with predictable per-request pricing. One endpoint, full analysis, 23 networks.
Sandbox-first: create a free sandbox key (prefixed ocr_test_), test your integration against real endpoints, then upgrade to a paid key for production. Prefer to browse first? Explore Swagger UI or download the OpenAPI YAML.
Developer quickstart
Create a sandbox API key
Sign up for a free account and create a sandbox key (prefixed ocr_test_) in the dashboard. No card required.
Test your integration
Call POST /api/v1/check with Authorization: Bearer <your sandbox key>. Sandbox returns the same JSON shape as paid tiers, so your client code drops in unchanged.
Upgrade for production
Once your integration is tested, swap in a paid key for production rate limits and full analysis — no code changes beyond the key.
API Capabilities
Address Risk Scoring
Pass any address, get a 0-100 risk score with risk level (LOW/MEDIUM/HIGH/CRITICAL), pattern flags, and detailed breakdown.
Fund Flow Tracing
Get inbound and outbound fund flows with labeled counterparties. Track exchange deposits, DeFi interactions, and bridge transfers.
Label Database (510K+)
Every response is enriched with labels from our database: exchange hot/cold wallets, known scammers, protocol contracts, and VASP entities.
Sanctions & Risk Signals
Where supported, addresses are checked against OFAC SDN entries and known exploiter, scam, and abuse lists. Matches surface as risk flags in the response — coverage varies by network.
Cross-Chain Detection
Automatic bridge transfer detection across 23 networks. Follow funds that hop between Ethereum, Arbitrum, Optimism, and more.
Webhook Alerts
Monitor addresses via the watchlist API. Receive real-time webhook notifications with HMAC signatures when new transactions appear.
Quick Start
The same call works with a sandbox (ocr_test_) or a paid key — start in the sandbox, then swap the key for production.
curl -X POST https://api.onchainrisk.io/api/v1/check \
-H "Authorization: Bearer ocr_test_your_sandbox_key" \
-H "Content-Type: application/json" \
-d '{"address": "0x722122dF12D4e14e13Cf261CbaE0587c9e5b6967"}'{
"address": "0x722122dF12D4e14e13Cf261CbaE0587c9e5b6967",
"network": "eth",
"riskScore": 95,
"riskLevel": "critical",
"riskConfidence": "high",
"addressInfo": {
"type": "contract",
"balance": "0.42 ETH",
"balanceUsd": 852.74,
"txCount": 78642,
"firstSeen": "2019-12-16T18:05:00Z",
"lastSeen": "2026-05-30T11:42:10Z"
},
"patternFlags": [
"OFAC/sanctions list match",
"BULK COLLECTION pattern: 24 inbound TXs in 600s"
],
"analysisTime": 4218,
"timestamp": "2026-05-30T11:42:14Z"
}Risk signals come through documented fields like patternFlags and riskReasons (with index-aligned detail in patternFlagDetails). Sanctions and abuse checks are applied where supported — coverage varies by network, and a clean result is not a guarantee.
Language Examples
import requests
resp = requests.post(
"https://api.onchainrisk.io/api/v1/check",
headers={"Authorization": "Bearer ocr_test_your_sandbox_key"},
json={"address": "TXyz..."}
)
data = resp.json()
print(f"Risk: {data['riskScore']}/100")const resp = await fetch(
"https://api.onchainrisk.io/api/v1/check",
{
method: "POST",
headers: {
"Authorization": "Bearer ocr_test_your_sandbox_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
address: "0x722122dF..."
}),
}
);
const data = await resp.json();
console.log(`Risk: ${data.riskScore}/100`);API Features
API Pricing
Free
For testing and evaluation
- 10 requests per 24 hours
- All 23 networks
- Basic risk score
- Sandbox API key for integration testing
Pro
For developers and small teams
- 1,000 requests/month
- 1 API key
- 10 req/sec rate limit
- Full analysis response
- Email alerts
Business
For companies and compliance teams
- 5,000 requests/month
- 10 API keys
- 50 req/sec rate limit
- Webhook alerts (HMAC)
- Bulk CSV analysis
Pay with USDT (TRC-20 or ERC-20). No KYC, no bank account needed. Instant activation.
API Use Cases
| Who | How they use the API |
|---|---|
| Exchanges & wallets | Screen deposits and withdrawals before accepting funds, and flag high-risk addresses for manual review. |
| OTC desks & P2P platforms | Check counterparty wallets before settlement to reduce exposure to funds linked to hacks, scams, or mixers. |
| Payment processors & gateways | Screen a destination wallet before releasing a merchant payout, including USDT-TRC20 flows. |
| Compliance teams | Automate wallet risk review and route elevated-risk addresses into your existing case workflow. |
| Investigators | Triage suspicious wallets, trace fund flows, and surface labeled counterparties during an investigation. |
| Crypto apps & payments | Add wallet risk scoring before payouts or withdrawals to reduce counterparty risk in your product. |
Pre-Settlement / Pre-Payout Wallet Screening
Screening a destination or counterparty wallet's risk before a payout or settlement is a common use of the API for payment processors, OTC desks, and P2P platforms: payout/settlement request → screening API call → review the risk score and signals → approve, route to manual review, or escalate — before funds move. Sanctions checks apply where supported.
See the full payout / settlement screening workflow & use cases →Docs, tools & developer surface
Everything you need to evaluate and integrate is public and inspectable — interactive docs, the full OpenAPI spec, ready-to-import Postman collections, and a sandbox you can call against real data.
Start Building with the API
Create a free account, generate a sandbox key, and make your first call in minutes. Upgrade to a paid key when you're ready for production.