/dashboard/statsDashboard statsDashboard metrics for a day, week, month or custom period, across every project the session user can access — or one project when projectId is given.
- operations carries the counts: total, byStatus, and byNetwork.
- fees groups platform fees by network and then by fee token: token totals, plus per-token USD from the price snapshotted on each fee, in micros where 1e6 = $1.
- A separate lifi section carries the routing fee earned on swap and cross_chain_swap operations — totals, grouped by operation kind, and grouped by network and fee token.
- Fee USD fields are null when no price was snapshotted for that token or operation.
Authentication: Bearer JWT (project member)
Input — query and path parameters
projectIdstring- Optional project id filter
periodstring- day | week | month | custom (default day)
fromISO datetime- Required when period=custom
toISO datetime- Range end; defaults to now
includeTestnetsstring- Boolean-as-string, default false. Testnet networks are excluded from results unless true; an explicit networkId filter takes precedence.
Output — example response (200)
{
"period": "week",
"operations": {
"total": 42,
"byStatus": {
"confirmed": 40,
"failed": 2
},
"byNetwork": {
"42161": 42
}
},
"fees": {
"totalCollectedUsdMicros": "1250000",
"totalNetUsdMicros": "900000",
"byNetwork": [
{
"networkId": "42161",
"operations": 42,
"collectedUsdMicros": "1250000",
"netUsdMicros": "900000",
"tokens": [
{
"feeAssetId": "0xB97E...",
"symbol": "USDC",
"decimals": 6,
"gasFeeRaw": "850000",
"staticFeeRaw": "50000",
"transferFeeRaw": "400000",
"collectedFeeRaw": "1250000",
"netRevenueRaw": "1250000",
"operations": 40,
"collectedUsdMicros": "1250000",
"netUsdMicros": "900000"
}
]
}
]
},
"lifi": {
"totalFeeUsdMicros": "300000",
"byKind": {
"swap": {
"operations": 5,
"feeUsdMicros": "200000"
},
"cross_chain_swap": {
"operations": 2,
"feeUsdMicros": "100000"
}
},
"byNetwork": [
{
"networkId": "42161",
"tokens": [
{
"assetId": "0xB97E...",
"symbol": "USDC",
"decimals": 6,
"feeTokenRaw": "300000",
"feeUsdMicros": "300000",
"operations": 7
}
]
}
]
}
}Output — every status this endpoint answers with
| Status | When |
|---|---|
200 | Stats. |
400 | Invalid request body or query parameters |
401 | Missing or invalid credentials |