GET /api/v1/usage
Returns your current tier, billing period, rate limits, and usage counters (monthly requests, WebSocket connections/subscriptions). Use this to monitor quota consumption and understand your tier’s capabilities.
A value of 0 for any limit field means unlimited .
Response
Current tier: free, pro, or scale.
Unix seconds — 1st of current month UTC.
Unix seconds — 1st of next month UTC.
Tier limits for this account. Monthly REST request cap. 0 means unlimited.
Sustained REST queries per second. 0 means unlimited.
REST burst QPS allowance. 0 means unlimited.
Max WebSocket subscriptions across all connections. 0 means unlimited.
Max orderbook depth per WebSocket subscription.
Max historical data age in days. 0 means unlimited.
Current measured usage for this billing period. REST requests consumed this billing period.
Currently active WebSocket connections.
Currently active WebSocket subscriptions.
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.parsecapi.com/api/v1/usage"
{
"tier" : "pro" ,
"billing_period_start" : 1772524800 ,
"billing_period_end" : 1775203200 ,
"limits" : {
"monthly_requests" : 100000 ,
"rest_qps" : 10 ,
"rest_qps_burst" : 20 ,
"ws_max_subscriptions" : 50 ,
"ws_max_depth" : 20 ,
"history_max_age_days" : 30
},
"usage" : {
"monthly_requests" : 4237 ,
"ws_active_connections" : 2 ,
"ws_active_subscriptions" : 8
}
}
Use /api/v1/ws/usage when you need the more detailed
WebSocket telemetry breakdown by market or customer scope.