Skip to content

voidly-ai/censorship-alpha

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Censorship Alpha

When countries block crypto exchanges, where does the money go?

Correlates real-time internet censorship data from Voidly with on-chain blockchain fund flows from Nansen to reveal how smart money adapts when authoritarian governments block crypto exchanges.

Built for the Nansen CLI Challenge #NansenCLI

Exchange Censorship Heat Map

What It Does

Interactive CLI for real-time crypto censorship intelligence:

# Is Binance accessible in Turkey right now?
python3 censorship_alpha.py --check binance.com --country Turkey

# Compare censorship across countries
python3 censorship_alpha.py --compare China,Iran,Turkey

# Real-time smart money signal for BNB chain
python3 censorship_alpha.py --signal bnb

# Quick ranking of all 15 countries
python3 censorship_alpha.py --rank

# Full 10-section HTML report (17 Nansen CLI calls)
python3 censorship_alpha.py --report --png --json

Quick Start

# Prerequisites: Python 3.9+, Node.js 18+
pip install -r requirements.txt
npm i -g nansen-cli
nansen login --api-key YOUR_KEY

# Try it — instant results
python3 censorship_alpha.py --rank

# Full report
python3 censorship_alpha.py --report --png --json

# Open the report
open output/report.html

Sample Output

Impact Ranking

Impact Ranking

Smart Money Flows (24h / 7d / 30d)

Smart Money Flows

BNB Ecosystem Capital Flight

Alpha Signal

Exchange Blocks vs Censorship Severity

Correlation

What Gets Checked

Exchanges monitored (8): Binance, Coinbase, Kraken, KuCoin, OKX, Bybit, Gate.io, Crypto.com

Countries analyzed (15): Iran, China, Russia, Turkey, Nigeria, Pakistan, Egypt, Vietnam, India, Saudi Arabia, UAE, Thailand, Myanmar, Belarus, Venezuela

Chains analyzed (4): Ethereum, BNB Chain, Solana, Base

Data Sources

Source What API Calls
Voidly Exchange accessibility, risk tiers, ISP blocking, 7-day forecasts 6+
Nansen CLI Smart money flows, DEX trades, token screener, wallet balances, prediction markets, token search 14
Chainalysis Ground-truth exchange blocking data
CoinGecko Country-level crypto bans

Total: 20+ API calls per report

Censorship Impact Score

Each country gets a composite score (0-1) based on:

Factor Weight Source
Exchange block count (out of 8) 35% Voidly + ground-truth
Country risk tier (1-5) 25% Voidly
Censorship severity score 25% Voidly (OONI + CensoredPlanet)
7-day forecast risk 15% Voidly

Report Sections

  1. Exchange Censorship Heat Map — Which exchanges are blocked where (8 exchanges x 15 countries)
  2. Smart Money Flows — Net flows across 24h/7d/30d on 4 chains
  3. Censorship Impact Ranking — Countries ranked by composite score
  4. Exchange Blocks vs Censorship — Scatter: blocks vs independent severity score
  5. The Alpha Signal — BNB ecosystem capital flight (Binance = most-blocked exchange)
  6. Top Movers — Tokens with largest smart money net flows (24h/7d/30d)
  7. Country Deep Dives — ISP-level blocking, incidents, forecasts for top 3
  8. Privacy Tokens — Censorship-resistant tokens from Nansen search
  9. Prediction Markets — Polymarket events affecting crypto censorship dynamics

Output

output/
├── report.html       # Interactive HTML report (Plotly charts)
├── data.json         # Structured JSON for programmatic access
├── heatmap.png       # Exchange blocking heat map
├── flows.png         # Smart money flow trends (24h/7d/30d)
├── impact.png        # Impact score ranking
├── correlation.png   # Blocks vs severity scatter
└── alpha.png         # BNB ecosystem capital flight

The Thesis

When authoritarian countries block crypto exchanges:

  • BNB Chain DEX volume is 31x higher than ETH DEX among smart money — consistent with Binance being the most-blocked exchange globally
  • BNB 30d net flow: -$751K while Base (Coinbase ecosystem) is +$18K — capital migrating from censored to uncensored ecosystems
  • Exchange censorship predicts broader internet censorship — countries that block exchanges almost always block social media, news, and messaging too
  • Privacy tokens are a leading indicator — micro-cap privacy/VPN tokens see volume spikes when exchange blocks increase

For AI Agents

Access Voidly censorship data via MCP:

npx @voidly/mcp-server

Tools: check_service_accessibility, get_platform_risk, get_isp_risk_index, get_risk_forecast

License

MIT — Built by Voidly with Nansen CLI

About

When countries block crypto exchanges, where does the money go? Correlates Voidly censorship data with Nansen on-chain flows. #NansenCLI

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages