Skip to content

wrbtc/satoshidata-examples

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

satoshidata.ai — Bitcoin Wallet Intelligence API

Other Bitcoin APIs tell you the fee rate. We tell you who you're sending to.

30M+ labeled Bitcoin addresses. Identify exchanges, mining pools, scams, gambling, government seizures — with confidence scoring on every response. No signup, no API key for free tier.

30-second demo

curl https://satoshidata.ai/v1/wallets/bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h/trust-safety
{
  "address": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
  "label": { "category": "exchange", "value": "Binance" },
  "confidence": "verified",
  "evidence_tier": "strong",
  "assessment": {
    "state": "labeled",
    "headline": "Verified entity hit"
  }
}

Add to your AI agent

Claude Code

claude mcp add satoshidata --url https://satoshidata.ai/mcp/

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "satoshidata": {
      "url": "https://satoshidata.ai/mcp/"
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "satoshidata": {
      "url": "https://satoshidata.ai/mcp/"
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "satoshidata": {
      "url": "https://satoshidata.ai/mcp/"
    }
  }
}

Then ask: "Who owns Bitcoin address bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h?"

Python examples

Investigate addresses (zero dependencies, free)

python python/investigate.py

Output:

Bitcoin Address Investigation
============================================================

  bc1qm34lsc65...j77s3h
  Entity:     Binance (exchange)
  Confidence: verified

  1N52wHoVR79P...CdGquK
  Entity:     Bittrex (exchange)
  Confidence: high

============================================================
Investigation complete. 0 sats spent.

Single address lookup

pip install requests
python python/lookup.py bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h

Batch check

python python/batch_check.py

Free endpoints (10)

Method Endpoint Description
GET /v1/wallets/{addr}/trust-safety Wallet trust & safety profile
GET /v1/price BTC price snapshot
GET /v1/onchain On-chain activity
GET /v1/fees/recommended Fee recommendations
GET /v1/mempool/stats Mempool state
GET /v1/tx/{txid}/status Transaction status
GET /v1/capabilities All capabilities
GET /v1/timestamp/{hash} Timestamp status
GET /v1/timestamp/quote Timestamp quote
POST /v1/timestamp/verify Verify a proof

Premium endpoints (21 sats / $0.01 per call)

Pay with Lightning L402 or x402 USDC on Base — per-call, no key needed. Or get a monthly API key for $4.99.

Method Endpoint Description
GET /v1/wallets/{addr}/summary Full wallet intelligence
GET /v1/wallets/{addr}/detail Label evidence
GET /v1/wallets/{addr}/contributors Label contributors
POST /v1/batch/trust-safety Batch (up to 100)
POST /v1/batch/summary Batch summaries
GET /v1/tx/{txid} Full transaction
POST /v1/tx/verify Payment verification
POST /v1/timestamp Submit timestamp
GET /v1/timestamp/{hash}/proof Download proof

Links

License

MIT

About

Bitcoin wallet intelligence API examples — Python scripts, curl commands, and MCP config for satoshidata.ai

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors