Protocol profile
Query a protocol profile, latest TVL and per-chain TVL.
Available data
- Returns
- Query a protocol profile, latest TVL and per-chain TVL.
- What each request returns
- One protocol snapshot with chain_distribution.
Authentication
Query Parameters
protocol_idstringpathExampleprotocol_lidorequiredCanonical protocol_* ID, for example protocol_lido. Numeric source IDs and protocol names are not accepted
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
namestringDisplay name
symbolstringAsset or pool token symbol
categorystringProtocol category, or category breakdown when returned as an array
descriptionstringSource description
urlstringOfficial website
defillama_idstringSource protocol identifier; do not pass it as public protocol_id
chainsstring[]Covered chain names
chain_countintegerNumber of covered chains
tvl_usdstringTotal value locked, as a decimal string in USD
tvl_prev_daystringTVL approximately one day earlier, in USD
tvl_prev_weekstringTVL approximately one week earlier, in USD
tvl_prev_monthstringTVL approximately one month earlier, in USD
obs_datestringSource business date
snapshot_timestringBusiness snapshot time of this record, distinct from response time
metricsobjectMetrics for this object; see their units individually
chain_distributionobject[]Per-chain distribution
chain_idstringCanonical chain identifier
chainstringChain name
chain_namestringChain display name
obs_datestringSource business date
tvl_usdstringTotal value locked, as a decimal string in USD
tvl_prev_daystringTVL approximately one day earlier, in USD
tvl_prev_weekstringTVL approximately one week earlier, in USD
tvl_prev_monthstringTVL approximately one month earlier, in USD