API by router
Metrics
GET
HTTPBearerheader
AuthorizationBearer <token>days?DaysRange
7 <= value <= 90Default
30Successful Response
application/json- response
Instance-level usage breakdown.
"Get to the chopper!" — Dutch, Predator (about getting to the right instance)
instances*array<>total_count*Total Countcurl -X GET 'https://example.com/v1/metrics/instances'Example Response
{ "instances": [ { "estimated_cost_usd": "string", "hostname": "string", "instance_id": "string", "request_count": 0, "status": "string", "total_tokens": 0 } ], "total_count": 0}GET
HTTPBearerheader
AuthorizationBearer <token>days?DaysRange
7 <= value <= 90Default
30Successful Response
application/json- response
Model usage breakdown.
"Hasta la vista, baby." — T-800 (to the models you'll stop using after seeing these numbers)
models*array<>total_requests*Total Requestscurl -X GET 'https://example.com/v1/metrics/models'Example Response
{ "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}GET
HTTPBearerheader
AuthorizationBearer <token>days?DaysRange
7 <= value <= 90Default
30Successful Response
application/json- response
High-level usage summary for the selected period.
active_instances*Active Instancesestimated_cost_usd*Estimated Cost Usdperiod_days*Period Daystotal_requests*Total Requeststotal_tokens*Total Tokenstotal_tokens_in*Total Tokens Intotal_tokens_out*Total Tokens Outunique_models*Unique Modelscurl -X GET 'https://example.com/v1/metrics/summary'Example Response
{ "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}GET
HTTPBearerheader
AuthorizationBearer <token>days?DaysRange
7 <= value <= 90Default
30Successful Response
application/json- response
Time-series usage data with zero-fill.
period_days*Period Dayspoints*array<>curl -X GET 'https://example.com/v1/metrics/usage'Example Response
{ "period_days": 0, "points": [ { "date": "string", "estimated_cost_usd": "string", "requests": 0, "tokens_in": 0, "tokens_out": 0 } ]}