API Reference
Account Info
Query your current plan, usage, and auto-upgrade progress programmatically.
/v1/accountOverview
This endpoint returns your current plan tier, TPS limits, required tip amount, and progress toward the next tier. Ideal for bots that want to monitor their account status or adjust tip amounts based on plan thresholds.
About Bolt Points (BP)
Bolt Points are the unit used to track your plan tier and upgrade progress. Every transaction you send contributes BP based on the tip amount included. Reaching BP thresholds automatically unlocks higher tiers with better rates and higher TPS.
Request
curl 'https://bolttx.io/v1/account?api-key=YOUR_API_KEY'Response
Example
{
"plan": "growth",
"plan_upgraded_at": "2026-04-15T12:34:56",
"member_since": "2026-04-01T09:00:00",
"limits": {
"max_tps": 30,
"min_tip_bp": 5
},
"usage": {
"bolt_points": 235000,
"transactions_total": 125432,
"transactions_today": 1234
},
"next_tier": {
"plan": "pro",
"threshold_bp": 800000,
"remaining_bp": 565000,
"progress_percent": 29.4,
"benefits": {
"new_max_tps": 80,
"new_tip_bp": 3,
"tip_savings_percent": 40
}
}
}Response Fields
| Field | Type | Description |
|---|---|---|
| plan | string | Current tier: starter / growth / pro / whale |
| limits.max_tps | number | Max transactions per second for current plan |
| limits.min_tip_bp | number | Minimum tip per transaction (in Bolt Points) |
| usage.bolt_points | number | Cumulative Bolt Points earned from tips |
| next_tier | object | null | Next tier info, or null if already on top tier (Whale) |
| next_tier.threshold_bp | number | Bolt Points required to unlock next tier |
| next_tier.progress_percent | number | Progress toward next tier (0 - 100) |
Auto-adjust tip amount in your bot
Use this endpoint to read your plan's minimum tip requirement and set your transaction tip accordingly. When you upgrade, the minimum drops automatically — poll this endpoint periodically (e.g., once per hour) to always know your current minimum.