Scan Usage

Track your scan usage and manage your quota effectively. Each BlockSecOps plan includes a monthly scan quota: | Plan | Monthly Scans | |------|---------------|...

Last updated: January 14, 2026

Scan Usage

Track your scan usage and manage your quota effectively.

Understanding Scan Limits

Each BlockSecOps plan includes a monthly scan quota:

Plan Monthly Scans
Free 10
Developer 100
Startup 500
Professional Unlimited
Enterprise Unlimited

What Counts as a Scan?

One Scan Includes

  • Running all selected scanners on one contract/project
  • Generating unified results
  • Deduplication processing
  • Risk scoring

Counts as a Scan

  • Uploading and scanning a new contract
  • Re-scanning an existing contract
  • Scanning a project (ZIP archive)

Does NOT Count

  • Viewing past scan results
  • Exporting reports
  • Managing vulnerabilities
  • Team collaboration activities

Viewing Your Usage

Dashboard

  1. Log in to BlockSecOps
  2. Your usage appears in the top navigation:
Scans: 45/100 (45% used)

Billing Page

For detailed usage:

  1. Go to Settings → Billing
  2. View Usage Summary:
    • Scans used this period
    • Scans remaining
    • Billing period dates
    • Usage trend graph

Usage Details

See a breakdown of:

  • Scans by day
  • Scans by project
  • Scans by user (team plans)

Usage Alerts

BlockSecOps sends alerts as you approach your limit:

Usage Level Alert Type
75% used Dashboard warning
90% used Email notification
100% used Scan blocked

Customizing Alerts

Go to Settings → Notifications to:

  • Enable/disable email alerts
  • Add alert recipients
  • Set custom thresholds

When You Reach Your Limit

If you've used all your scans:

Option 1: Wait for Reset

Your quota resets at the start of each billing period.

Option 2: Use x402 Credits

Purchase credits for immediate access:

  • No subscription change needed
  • Pay with USDC on Base
  • Credits never expire

See x402 Credits.

Option 3: Upgrade Your Plan

Get more scans with a higher tier:

  • Immediate access to new limits
  • Prorated billing

See Upgrading.

Tips for Managing Usage

Prioritize Your Scans

  • Development phase: Use Quick scans (fewer scanners)
  • Pre-deployment: Use Deep scans (all scanners)
  • Routine checks: Use Standard scans

Avoid Redundant Scans

  • Don't re-scan unchanged contracts
  • Use scan comparison to see differences
  • Scan only modified files in a project

Use Projects Efficiently

  • Group related contracts into projects
  • Scan projects, not individual files
  • One project scan = one credit (regardless of file count)

Monitor Team Usage

On team plans:

  • View usage by team member
  • Set per-user guidelines
  • Identify usage patterns

Usage for Team Plans

Per-User Visibility

Admins can see:

  • Total team usage
  • Breakdown by user
  • High-usage members

Setting Guidelines

Consider establishing:

  • Scan approval workflows for high-cost scans
  • Guidelines for scan frequency
  • Preferred scan profiles (Quick vs Deep)

Billing Period

When Does Usage Reset?

  • Monthly plans: First day of each month
  • Annual plans: Same day each month (based on start date)

Rollover

Unused scans do not roll over to the next period. Use them or lose them.

Mid-Cycle Changes

  • Upgrade: Immediate access to new limits
  • Downgrade: Takes effect at next billing period

Usage Reports

Downloading Reports

  1. Go to Settings → Billing
  2. Click Download Usage Report
  3. Select date range
  4. Export as CSV or PDF

Report Contents

  • Scan date and time
  • Contract/project name
  • Scanners used
  • User who initiated scan
  • Result summary

API Usage

If you have API access, track separately:

Plan API Calls/Month
Developer 1,000
Startup 10,000
Professional Unlimited
Enterprise Unlimited

API usage is shown alongside scan usage in the billing dashboard.

FAQ

Q: Do failed scans count against my quota?
A: No. Only successful scans are counted.

Q: Does re-scanning use a credit?
A: Yes. Each scan (including re-scans) uses one credit.

Q: Can I see historical usage?
A: Yes. Go to Billing → Usage History for past months.

Q: How do project scans count?
A: One project scan = one credit, regardless of the number of files.

Q: Does viewing results use a scan?
A: No. Viewing, exporting, and managing results are free.

Next Steps