API usage
Monitor request volume and response latency.
Partner APIAuthentication · Errors · Amounts and units
Response examples below come from a local test account. IDs, balances and timestamps are sample data. Replace IDs and credentials with values from your account.
Request/latency time series + totals from real request logs
GET /usage
Access: partner:read.
SDK methods: TypeScript client.usage.get(…); Python client.usage.get(…).
Parameters
| Name | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| range | query | "24h", "7d", "30d" | No | |
Request example
bash
curl --fail-with-body -X GET "$THESAUROS_API_BASE/usage" \
-H "Authorization: Bearer $THESAUROS_API_KEY"
Response · 200
| Field | Type | Required | Description |
|---|---|---|---|
object |
string |
Yes | |
data |
UsageReport | Yes |
View example response
json
{
"object": "usage",
"data": {
"object": "usage",
"range": "30d",
"totals": {
"requests": 30,
"errors": 0,
"error_rate": 0,
"p50_ms": 11,
"p99_ms": 81
},
"series": [
{
"t": "2026-08-09T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-10T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-11T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-12T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-13T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-14T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-15T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-16T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-17T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-18T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-19T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-20T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-21T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-22T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-23T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-24T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-25T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-26T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-27T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-28T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-29T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-30T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-08-31T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-09-01T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-09-02T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-09-03T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-09-04T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-09-05T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-09-06T00:00:00.000Z",
"requests": 0,
"errors": 0,
"p50_ms": 0,
"p99_ms": 0
},
{
"t": "2026-09-07T00:00:00.000Z",
"requests": 30,
"errors": 0,
"p50_ms": 11,
"p99_ms": 81
}
],
"top_endpoints": [
{
"endpoint": "GET /api/v1/partner/summary",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/users",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/deposits",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/withdrawals",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/tvl",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/yield",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/points",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/revenue",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/user/:id/positions",
"requests": 1,
"errors": 0
},
{
"endpoint": "GET /api/v1/partner/yield/history/:asset",
"requests": 1,
"errors": 0
}
]
}
}
For failed requests, inspect error.code, error.message and the request ID. Error handling.