API Reference

Analyze any crypto wallet programmatically. Available on Pro and Advanced plans.

Authentication

Pass your API key in one of two ways:

# Header (recommended)
X-Api-Key: wdna_your_key_here

# Or as a Bearer token
Authorization: Bearer wdna_your_key_here

Generate keys in Developer → API Keys. Keys are shown only once — store them securely.

Base URL

https://walletdna.com

Endpoints

POST/api/analyzeAnalyze a single wallet

Request

curl -X POST https://walletdna.com/api/analyze \
  -H "X-Api-Key: wdna_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"wallet": "1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf6Y"}'

Response

{
  "wallet":     "1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf6Y",
  "chain":      "BTC",
  "balance":    "72.31337 BTC",
  "confidence": "verified",
  "entity": {
    "name":   "Satoshi Genesis Block",
    "type":   "Exchange",
    "source": "walletdna-verified"
  },
  "tags": [
    "Chain: BTC",
    "Veteran wallet (since 2009)",
    "Whale (72 BTC)"
  ],
  "riskScore": {
    "score":   12,
    "label":   "LOW",
    "color":   "#22c55e",
    "factors": ["No risk signals detected"],
    "breakdown": [...]
  },
  "analysisId": "uuid",
  "evidence":   [...],
  "summary":    "Unique DNA found for 1A1zP1…"
}

POST/api/analyze/batchAnalyze up to 20 wallets at once — Advanced plan only

Request

curl -X POST https://walletdna.com/api/analyze/batch \
  -H "X-Api-Key: wdna_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      "1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf6Y",
      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    ]
  }'

Response

{
  "results": [
    { "wallet": "1A1z...", "chain": "BTC", ... },
    { "wallet": "0xd8...", "chain": "ETH", ... }
  ],
  "count": 2
}

Errors

Status	Code	Meaning
401	Unauthorized	Missing or invalid API key
403	Forbidden	Plan doesn't include this endpoint
429	rate_limited	Monthly call limit reached
400	Bad Request	Missing or invalid wallet address

Rate Limits

Plan	Calls / month	Batch
Pro	1,000	No
Advanced	Unlimited	Yes (20 per request)

Supported Chains

Chain is auto-detected from the address format. Supported: BTC, ETH, SOL, XRP, TRX, BNB, MATIC, LTC, ADA, DOT, AVAX, ATOM, XLM, BASE, ARB, OP, TON, SUI.

Ready to integrate?

Generate your API key in Developer.

Get API key ↗