Scan Wallet

POST /v1/scan/wallet Analyze a blockchain address for quantum vulnerability across 19 supported chains. Returns a risk score (W1-W4), chain readiness grade, and detailed risk factors. Authentication: Publishable or Secret key (qs_pub_* or qs_sec_*)

Request

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
  "chain": "ethereum"
}

Parameters

Field	Type	Required	Description
`address`	string	Yes	Blockchain address to scan
`chain`	string	No	Chain identifier (default: auto-detect)

Supported Chains (19)

Value	Category	Description
`ethereum`	Major	Ethereum mainnet
`bitcoin`	Major	Bitcoin mainnet
`solana`	Major	Solana mainnet
`base`	EVM L2	Base (Coinbase L2)
`arbitrum`	EVM L2	Arbitrum One
`optimism`	EVM L2	Optimism mainnet
`polygon`	EVM L2 ZK	Polygon PoS
`zksync`	EVM L2 ZK	zkSync Era
`linea`	EVM L2	Linea mainnet
`scroll`	EVM L2	Scroll mainnet
`gnosis`	EVM L1	Gnosis Chain
`celo`	EVM L1	Celo mainnet
`mantle`	EVM L2	Mantle mainnet
`blast`	EVM L2	Blast mainnet
`sonic`	EVM L2	Sonic (prev. Fantom)
`bsc`	EVM L1	BNB Smart Chain
`avalanche`	EVM L1	Avalanche C-Chain
`cosmos`	Non-EVM	Cosmos Hub
`tron`	Non-EVM	Tron mainnet

Address Validation Rules

Chain Type	Format	Example
EVM chains	`0x` + 40 hex chars	`0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18`
Solana	Base58, 32-44 chars	`9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM`
Bitcoin	`1`/`3`/`bc1` prefix	`bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh`
Cosmos	`cosmos1` prefix (bech32)	`cosmos1xy2kgdygjrsqtzq2n0yrf2493p83kkfj6mvnqd`
Tron	`T` prefix (base58check)	`TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW`

Request Examples

EVM Chain (Ethereum)

curl -X POST https://api.qsafe.dev/v1/scan/wallet \
  -H "Authorization: Bearer qs_pub_live_pk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
    "chain": "ethereum"
  }'

Solana

curl -X POST https://api.qsafe.dev/v1/scan/wallet \
  -H "Authorization: Bearer qs_pub_live_pk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "chain": "solana"
  }'

Bitcoin

curl -X POST https://api.qsafe.dev/v1/scan/wallet \
  -H "Authorization: Bearer qs_pub_live_pk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "chain": "bitcoin"
  }'

Cosmos

curl -X POST https://api.qsafe.dev/v1/scan/wallet \
  -H "Authorization: Bearer qs_pub_live_pk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "address": "cosmos1xy2kgdygjrsqtzq2n0yrf2493p83kkfj6mvnqd",
    "chain": "cosmos"
  }'

Tron

curl -X POST https://api.qsafe.dev/v1/scan/wallet \
  -H "Authorization: Bearer qs_pub_live_pk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW",
    "chain": "tron"
  }'

Response `200 OK`

EVM Chain Response

{
  "data": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
    "chain": "ethereum",
    "riskScore": "W3",
    "riskLabel": "High",
    "riskValue": 72,
    "chainGrade": "D",
    "chainGradeLabel": "No PQC activity",
    "publicKeyExposed": true,
    "balanceAtRisk": "15.42 ETH",
    "balanceAtRiskUsd": 48250.00,
    "riskFactors": [
      {
        "factor": "public_key_exposure",
        "weight": 0.35,
        "score": 95,
        "detail": "Public key exposed in 142 outbound transactions"
      },
      {
        "factor": "balance_at_risk",
        "weight": 0.25,
        "score": 70,
        "detail": "15.42 ETH ($48,250) held in exposed address"
      },
      {
        "factor": "transaction_frequency",
        "weight": 0.15,
        "score": 60,
        "detail": "142 transactions in the last 12 months"
      },
      {
        "factor": "address_type",
        "weight": 0.15,
        "score": 50,
        "detail": "EOA address — no hash protection layer"
      },
      {
        "factor": "address_reuse",
        "weight": 0.10,
        "score": 85,
        "detail": "Single address used for all transactions"
      }
    ],
    "chainFactors": [
      {
        "factor": "pqc_migration_plan",
        "status": "none",
        "detail": "No official PQC migration plan announced"
      },
      {
        "factor": "signature_scheme",
        "status": "vulnerable",
        "detail": "ECDSA (secp256k1) — vulnerable to Shor's algorithm"
      },
      {
        "factor": "community_activity",
        "status": "active",
        "detail": "EIP discussions on PQC account abstraction"
      }
    ],
    "scannedAt": "2026-01-15T10:30:00Z"
  },
  "meta": {
    "requestId": "req_xyz789",
    "timestamp": "2026-01-15T10:30:00Z"
  }
}

Solana Response (Non-EVM Differences)

{
  "data": {
    "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "chain": "solana",
    "riskScore": "W2",
    "riskLabel": "Medium",
    "riskValue": 45,
    "chainGrade": "F",
    "chainGradeLabel": "Public key exposed by address format. No PQC plan.",
    "publicKeyExposed": true,
    "balanceAtRisk": "120.5 SOL",
    "balanceAtRiskUsd": 15200.00,
    "riskFactors": [
      {
        "factor": "public_key_exposure",
        "weight": 0.35,
        "score": 40,
        "detail": "Solana address is the public key — always exposed (baseline 40)"
      },
      {
        "factor": "balance_at_risk",
        "weight": 0.25,
        "score": 55,
        "detail": "120.5 SOL ($15,200) held in address"
      },
      {
        "factor": "transaction_frequency",
        "weight": 0.15,
        "score": 40,
        "detail": "35 transactions in the last 12 months"
      },
      {
        "factor": "address_type",
        "weight": 0.15,
        "score": 70,
        "detail": "Ed25519 public key address — no hash protection"
      },
      {
        "factor": "address_reuse",
        "weight": 0.10,
        "score": 30,
        "detail": "Standard single-address usage"
      }
    ],
    "chainFactors": [
      {
        "factor": "pqc_migration_plan",
        "status": "none",
        "detail": "No PQC migration plan. EdDSA (Ed25519) vulnerable to Shor's algorithm."
      },
      {
        "factor": "signature_scheme",
        "status": "vulnerable",
        "detail": "EdDSA (Ed25519) — vulnerable to Shor's algorithm"
      },
      {
        "factor": "address_format_exposure",
        "status": "vulnerable",
        "detail": "Address = public key. All addresses inherently exposed."
      }
    ],
    "scannedAt": "2026-01-15T10:31:00Z"
  },
  "meta": {
    "requestId": "req_abc456",
    "timestamp": "2026-01-15T10:31:00Z"
  }
}

Bitcoin Response (UTXO Model)

{
  "data": {
    "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "chain": "bitcoin",
    "riskScore": "W1",
    "riskLabel": "Low",
    "riskValue": 18,
    "chainGrade": "D",
    "chainGradeLabel": "No PQC activity",
    "publicKeyExposed": false,
    "balanceAtRisk": "0.85 BTC",
    "balanceAtRiskUsd": 52000.00,
    "riskFactors": [
      {
        "factor": "public_key_exposure",
        "weight": 0.35,
        "score": 0,
        "detail": "Bech32 address with unspent UTXOs only — public key hash-protected"
      },
      {
        "factor": "balance_at_risk",
        "weight": 0.25,
        "score": 72,
        "detail": "0.85 BTC ($52,000) in hash-protected UTXOs"
      },
      {
        "factor": "transaction_frequency",
        "weight": 0.15,
        "score": 0,
        "detail": "Receive-only address, no outbound transactions"
      },
      {
        "factor": "address_type",
        "weight": 0.15,
        "score": 35,
        "detail": "P2WPKH (bech32) — witness hash protection"
      },
      {
        "factor": "address_reuse",
        "weight": 0.10,
        "score": 0,
        "detail": "No outbound transaction reuse"
      }
    ],
    "chainFactors": [
      {
        "factor": "pqc_migration_plan",
        "status": "none",
        "detail": "No official PQC migration plan. BIP discussions ongoing."
      },
      {
        "factor": "signature_scheme",
        "status": "vulnerable",
        "detail": "ECDSA (secp256k1) — vulnerable to Shor's algorithm"
      },
      {
        "factor": "utxo_model",
        "status": "protective",
        "detail": "UTXO model: unspent outputs have hash-protected public keys"
      }
    ],
    "scannedAt": "2026-01-15T10:32:00Z"
  },
  "meta": {
    "requestId": "req_def789",
    "timestamp": "2026-01-15T10:32:00Z"
  }
}

Response Fields

Field	Type	Description
`address`	string	Scanned address
`chain`	string	Detected or specified chain
`riskScore`	string	Risk category: `W1`, `W2`, `W3`, or `W4`
`riskLabel`	string	Human-readable label: `Low`, `Medium`, `High`, `Critical`
`riskValue`	number	Numeric risk score (0-100)
`chainGrade`	string	Chain readiness grade: `A`, `B`, `C`, `D`, or `F`
`chainGradeLabel`	string	Human-readable grade description
`publicKeyExposed`	boolean	Whether the public key has been revealed on-chain
`balanceAtRisk`	string	Native token balance in the address
`balanceAtRiskUsd`	number	USD equivalent of balance at risk
`riskFactors`	array	Detailed breakdown of address-level risk factors
`chainFactors`	array	Chain-level PQC readiness factors
`scannedAt`	string	ISO 8601 scan timestamp

Risk Factor Object

Field	Type	Description
`factor`	string	Factor identifier
`weight`	number	Weight in composite score (0-1)
`score`	number	Individual score (0-100)
`detail`	string	Human-readable explanation

Chain Factor Object

Field	Type	Description
`factor`	string	Factor identifier
`status`	string	Status: `active`, `planned`, `none`, `vulnerable`, `protective`
`detail`	string	Human-readable explanation

Errors

Code	Description
`AUTH_001`	Missing API key
`SCAN_001`	Invalid address format
`SCAN_002`	Unsupported chain
`SCAN_003`	Address not found (no on-chain activity)
`SCAN_004`	Chain data temporarily unavailable
`RATE_001`	Rate limit exceeded

Getting Started

Guides

KMS Managed (v1.5)

Concepts

Resources

Scan Wallet

Scan Wallet

Request

Parameters

Supported Chains (19)

Address Validation Rules

Request Examples

EVM Chain (Ethereum)

Solana

Bitcoin

Cosmos

Tron

Response `200 OK`

EVM Chain Response

Solana Response (Non-EVM Differences)

Bitcoin Response (UTXO Model)

Response Fields

Risk Factor Object

Chain Factor Object

Errors

Getting Started

Guides

KMS Managed (v1.5)

Concepts

Resources

​Scan Wallet

​Request

​Parameters

​Supported Chains (19)

​Address Validation Rules

​Request Examples

​EVM Chain (Ethereum)

​Solana

​Bitcoin

​Cosmos

​Tron

​Response 200 OK

​EVM Chain Response

​Solana Response (Non-EVM Differences)

​Bitcoin Response (UTXO Model)

​Response Fields

​Risk Factor Object

​Chain Factor Object

​Errors

Scan Wallet

Request

Parameters

Supported Chains (19)

Address Validation Rules

Request Examples

EVM Chain (Ethereum)

Solana

Bitcoin

Cosmos

Tron

Response `200 OK`

EVM Chain Response

Solana Response (Non-EVM Differences)

Bitcoin Response (UTXO Model)

Response Fields

Risk Factor Object

Chain Factor Object

Errors