RiskChain

Elevator Pitch RiskChain: Analyze any Bitcoin address instantly for signs of abuse, sanctions, scams, or suspicious behavior using blockchain heuristics and public threat intelligence APIs.

Project Story

What inspired it? While Bitcoin is transparent, it's notoriously difficult to assess the trustworthiness of a wallet address before sending or receiving funds. Most tools require switching between block explorers, abuse databases, and manual heuristics.

We wanted a tool that provides real-time, reliable, and automatic risk assessments for any BTC address — helping individuals, developers, and investigators make safer decisions.

RiskChain was created to close that gap by combining blockchain analysis with multiple external data sources and behavioral heuristics.

How we built it

Language: Python (compatible with 3.8+)

Public blockchain data sources:

Blockstream.info

Mempool.space

Blockchair

External abuse/sanction databases:

Chainabuse

BitcoinAbuse

Chainalysis Sanctions API

BitcoinWhosWho

Local features:

Custom-built address validator

JSON-based local cache (btc_db.json)

Report generation in both .json and .txt formats

Heuristics implemented:

Reused address detection

Dust attack pattern detection

Mixer-like transaction structure (many inputs and outputs)

Dormancy analysis (time since last transaction)

High transaction volume indicators

What we learned

Managing API variability, error handling, and rate limits across multiple services

Scoring risk fairly while avoiding false positives

Designing usable tooling for both technical and non-technical audiences

Combining on-chain data with off-chain threat intelligence for better context

Challenges we faced

Rate limits and occasional instability in public APIs

Data inconsistency between sources

False negatives due to limited abuse database coverage

Managing configuration and protecting API credentials

Outcome

RiskChain enables developers, researchers, and security teams to:

Evaluate whether a Bitcoin address is safe to interact with

Detect potential scam or abuse associations

Integrate abuse report APIs with on-chain behavior analytics

By combining public APIs, blockchain data, and local analysis, RiskChain delivers a fast, extensible framework for Bitcoin address risk intelligence.

Built With

  • bitcoinabuse-api
  • bitcoinwhoswho-api
  • blockchair-api
  • blockstream-api
  • chainabuse-api
  • chainalysis-sanctions-api
  • json
  • mempool.space-api
  • python
  • requests
Share this project:

Updates