Protocol history

Query daily protocol TVL over a historical window.

GET/api/v1/protocols/{protocol_id}/history
Domain
Network & Protocol
Level
One TVL record per protocol and day
MCP tool
defi_protocol (range=window)

Available data

Returns
Query daily protocol TVL over a historical window.
What each request returns
One TVL record per protocol and day

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Protocol identification

Use protocol_<slug>, for example protocol_lido. MCP uses range=latest for a profile and range=window for history

protocol_idstringpathExampleprotocol_lidorequired

Canonical protocol_* ID, for example protocol_lido. Numeric source IDs and protocol names are not accepted

Time range

Use the endpoint’s documented time format and boundaries. Do not assume that missing dates mean zero

fromstringqueryExample2026-10-01T00:00:00Zrequired

Start UTC date/time; must be earlier than to

tostringqueryExample2026-10-15T00:00:00Zrequired

End UTC date/time. Use a fixed historical window and inspect actual coverage

Return options
timeframestringqueryExample1doptional

Daily observations; only 1d is supported. · 1d · Default: 1d

limitintegerqueryExample10optional

Maximum rows returned. · Default: 100 · ≤ 500

Response

dataobject[]

Business data; shape is specific to this endpoint

data_statusDataStatus

Business status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage

errornull | string | object

Null on success; otherwise an error string or object

empty_reasonstring

Reason for an empty or unavailable result; may be absent

missing_fieldsstring[]

Fields not supplied by the source

coverage_fromstring

First date actually returned, not the requested start

coverage_tostring

Last date actually returned, not a guarantee of continuous coverage

coverage_notestring

Coverage and methodology notes

request_idstring

Request trace identifier

operation_idstring

Operation identifier

route_codestring

Response route identifier

observed_atstring

Response observation time; not the business snapshot date

metadataobject

Response metadata

updated_atstring

Metadata update time; not the business data time

object_refsobject[]

Matched object references

limitationsstring[]

Coverage or source limitations

data[]array[object]
protocol_idstring

Canonical protocol identifier

rangestring

Query mode: latest or window

fromstring

Requested start time

tostring

Requested end time

seriesobject[]

Daily observations; an empty array means no covered observations

series[]array[object]
timestring

Business observation time in ISO 8601 UTC

datestring

Business date (YYYY-MM-DD)

obs_datestring

Source business date

tvl_usdstring

Total value locked, as a decimal string in USD

Errors & fallback

200
Only part of the requested data is available. Inspect missing_fields, limitations and actual coverage.
200
No covered records for these filters. Empty arrays do not mean a measured zero.
400
A required parameter is missing; history queries require both from and to.
400
Invalid parameter format, time range, scope, sorting or limit. Use the endpoint-specific rules above.
404
The requested protocol object does not exist. Other onchain lookups may instead return no_data; see the endpoint notes.
401
Check the API key.
403
Check data-domain permissions for the key.