Account

Check your plan tier, limits, and current API usage

GET https://api.tickerdb.com/v1/account

Returns your current plan tier, credit limits, and current monthly usage. Useful for agents that need to check remaining quota before making requests.

Response Fields

FieldTypeDescription
tierstringBase plan code: free, plus, or pro. Business accounts report pro here because they include Pro access. In the UI, free is shown as Starter.
tier_fullstringFull plan code, such as business for Business accounts.
emailstringAccount email

limits

FieldTypeDescription
monthly_requestsintegerIncluded credits per month. Business limits are per seat.
overage_enabledbooleanWhether requests continue after the included monthly amount and are billed as overage.
watchlist_limitintegerMax tickers in saved watchlist. Business watchlist capacity is per seat.
history_daysintegerDays of historical data available

usage

FieldTypeDescription
monthly_requests_usedintegerCredits used this month
monthly_requests_remainingintegerIncluded monthly credits remaining. This is 0 after the included amount is exceeded.

Example

GET /v1/account
{ "tier": "plus", "tier_full": "plus", "email": "dev@example.com", "limits": { "monthly_requests": 100000, "overage_enabled": true, "watchlist_limit": 20, "history_days": 730 }, "usage": { "monthly_requests_used": 142, "monthly_requests_remaining": 99858 } }