API by router
Metrics
Get Instance Usage
Per-instance usage breakdown — which agents are earning their keep.
"I'm too old for this shit." — Roger Murtaugh, Lethal Weapon (about agents that aren't pulling their weight)
AuthorizationBearer <token>
In: header
Query Parameters
days?Days
Default
30Range
7 <= value <= 90Response Body
curl -X GET "https://loading/v1/metrics/instances?days=30"{
"instances": [
{
"estimated_cost_usd": "string",
"hostname": "string",
"instance_id": "string",
"request_count": 0,
"status": "string",
"total_tokens": 0
}
],
"total_count": 0
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get Model Breakdown
Per-model usage breakdown — sorted by request count desc.
"Say hello to my little friend!" — Tony Montana, Scarface (introducing your most-used model)
AuthorizationBearer <token>
In: header
Query Parameters
days?Days
Default
30Range
7 <= value <= 90Response Body
curl -X GET "https://loading/v1/metrics/models?days=30"{
"models": [
{
"estimated_cost_usd": "string",
"model": "string",
"pct_of_total": 0,
"provider": "string",
"request_count": 0,
"tokens_in": 0,
"tokens_out": 0
}
],
"total_requests": 0
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get Metrics Summary
Aggregate usage summary for the selected period.
"That's a lot of nuts!" — Chosen One, Kung Pow
AuthorizationBearer <token>
In: header
Query Parameters
days?Days
Default
30Range
7 <= value <= 90Response Body
curl -X GET "https://loading/v1/metrics/summary?days=30"{
"active_instances": 0,
"estimated_cost_usd": "string",
"period_days": 0,
"total_requests": 0,
"total_tokens": 0,
"total_tokens_in": 0,
"total_tokens_out": 0,
"unique_models": 0
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get Usage Timeseries
Daily token usage time-series with zero-fill.
"Life is like a box of chocolates." — Forrest Gump (and every day is a data point)
AuthorizationBearer <token>
In: header
Query Parameters
days?Days
Default
30Range
7 <= value <= 90Response Body
curl -X GET "https://loading/v1/metrics/usage?days=30"{
"period_days": 0,
"points": [
{
"date": "string",
"estimated_cost_usd": "string",
"requests": 0,
"tokens_in": 0,
"tokens_out": 0
}
]
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}