Skip to main content
The usage endpoint gives you a detailed view of your agent’s API call history. You can see how many calls have been made in the current calendar month, how many remain under your quota, and a day-by-day breakdown of the past seven days. This is the right endpoint to poll when you want to monitor agent activity, stay ahead of rate limits, or investigate unexpected consumption patterns.

​
Endpoint

GET https://lithtrix.ai/v1/usage

​
Authentication

Authorization: Bearer ltx_your_key

​
Request example

curl https://lithtrix.ai/v1/usage \
  -H "Authorization: Bearer ltx_your_key"

​
Response fields

​
calls_this_month
integer
Number of API calls made in the current calendar month (resets at midnight UTC on the first of each month).
​
calls_remaining
integer | null
Calls remaining before the Free tier lifetime cap of 300 is reached. Returns null on the Pro tier, where calls are unlimited.
​
daily_breakdown
array
An array of daily call counts covering the past 7 days, ordered from oldest to most recent.

​
Response example

{
  "calls_this_month": 87,
  "calls_remaining": 213,
  "daily_breakdown": [
    { "date": "2025-04-07", "calls": 10 },
    { "date": "2025-04-08", "calls": 14 },
    { "date": "2025-04-09", "calls": 8 },
    { "date": "2025-04-10", "calls": 21 },
    { "date": "2025-04-11", "calls": 13 },
    { "date": "2025-04-12", "calls": 15 },
    { "date": "2025-04-13", "calls": 6 }
  ]
}
Poll this endpoint periodically from your agent to track consumption trends. A sudden spike in daily_breakdown calls can indicate a loop, a misconfigured retry policy, or unexpected agent invocations — catching it early lets you intervene before hitting the Free tier cap.