Protocol history
Query daily protocol TVL over a historical window.
Available data
- Returns
- Query daily protocol TVL over a historical window.
- What each request returns
- One TVL record per protocol and day
Authentication
Query Parameters
Use protocol_<slug>, for example protocol_lido. MCP uses range=latest for a profile and range=window for history
protocol_idstringpathExampleprotocol_lidorequiredCanonical protocol_* ID, for example protocol_lido. Numeric source IDs and protocol names are not accepted
Use the endpoint’s documented time format and boundaries. Do not assume that missing dates mean zero
fromstringqueryExample2026-10-01T00:00:00ZrequiredStart UTC date/time; must be earlier than to
tostringqueryExample2026-10-15T00:00:00ZrequiredEnd UTC date/time. Use a fixed historical window and inspect actual coverage
timeframestringqueryExample1doptionalDaily observations; only 1d is supported. · 1d · Default: 1d
limitintegerqueryExample10optionalMaximum rows returned. · Default: 100 · ≤ 500
Response
dataobject[]Business data; shape is specific to this endpoint
data_statusDataStatusBusiness status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage
errornull | string | objectNull on success; otherwise an error string or object
empty_reasonstringReason for an empty or unavailable result; may be absent
missing_fieldsstring[]Fields not supplied by the source
coverage_fromstringFirst date actually returned, not the requested start
coverage_tostringLast date actually returned, not a guarantee of continuous coverage
coverage_notestringCoverage and methodology notes
request_idstringRequest trace identifier
operation_idstringOperation identifier
route_codestringResponse route identifier
observed_atstringResponse observation time; not the business snapshot date
Response metadata
updated_atstringMetadata update time; not the business data time
object_refsobject[]Matched object references
limitationsstring[]Coverage or source limitations
protocol_idstringCanonical protocol identifier
rangestringQuery mode: latest or window
fromstringRequested start time
tostringRequested end time
seriesobject[]Daily observations; an empty array means no covered observations
timestringBusiness observation time in ISO 8601 UTC
datestringBusiness date (YYYY-MM-DD)
obs_datestringSource business date
tvl_usdstringTotal value locked, as a decimal string in USD