API Credit Tiers
BlockchainAnalysis.io API access is billed through a credit system. Credits are purchased in tiers, with higher tiers offering lower per-credit pricing. Credits are consumed with each API call — different endpoints cost different amounts.
Credit Tiers
| Tier | Monthly Price | Credits Included | Price per Credit | Savings | |------|--------------|------------------|-----------------|---------| | Starter | $250 | 2,500 | $0.100 | — | | Basic | $500 | 5,500 | $0.091 | 9% | | Professional | $1,000 | 12,000 | $0.083 | 17% | | Business | $2,500 | 32,500 | $0.077 | 23% | | Scale | $5,000 | 70,000 | $0.071 | 29% | | Enterprise | $12,500 | 200,000 | $0.063 | 38% |
All tiers are billed monthly. Credits expire at the end of each billing period and do not roll over. Contact sales for annual billing discounts.
Credit Costs by Endpoint
| Endpoint | Credits per Call | |----------|-----------------| | Wallet Screening | 1 | | Exchange Screening | 2 | | Comprehensive Report (Standard) | 5 | | Comprehensive Report (Deep) | 10 | | Entity Lookup | 0.5 | | Entity Search | 0.5 | | Usage Summary | Free | | Usage History | Free | | Key Management | Free |
Low-Credit Alerts
When your remaining credits drop below a configurable threshold, the platform sends automated alerts:
| Alert Level | Default Threshold | Notification |
|-------------|-------------------|-------------|
| Warning | 20% remaining | Email + dashboard banner |
| Critical | 5% remaining | Email + dashboard banner + optional webhook |
| Depleted | 0 remaining | Email + API returns 402 Insufficient Credits |
Configuring Alerts
Navigate to Account > API Settings > Credit Alerts to:
- Adjust warning and critical thresholds (percentage or absolute number)
- Enable/disable email notifications
- Configure webhook URL for programmatic alerts
- Add additional email recipients (e.g., billing team)
When credits are depleted, API calls will return 402 Insufficient Credits. The web dashboard and Telegram bot continue to function using dashboard credits (separate from API credits).
Upgrading Tiers
You can upgrade your credit tier at any time:
- Go to Account > Billing > API Credits.
- Select a new tier.
- The price difference is prorated for the remainder of the current billing period.
- New credits are added immediately.
Downgrading takes effect at the start of the next billing period.
Overage Protection
By default, API calls that would exceed your credit balance are rejected with a 402 status code. Enterprise customers can enable overage mode, which allows API calls to continue beyond the credit balance at the per-credit rate of their current tier. Overages are billed at the end of the billing period.
Next Steps
- Authentication — API key setup.
- Endpoints — Full endpoint reference with credit costs.
- Rate Limits — Rate limiting and error handling.