Protocol profile

Query a protocol profile, latest TVL and per-chain TVL.

GET/api/v1/protocols/{protocol_id}
Domain
Network & Protocol
Level
One protocol snapshot with chain_distribution.
MCP tool
defi_protocol (range=latest)

Available data

Returns
Query a protocol profile, latest TVL and per-chain TVL.
What each request returns
One protocol snapshot with chain_distribution.

Authentication

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

Query Parameters

protocol_idstringpathExampleprotocol_lidorequired

Canonical 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_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

namestring

Display name

symbolstring

Asset or pool token symbol

categorystring

Protocol category, or category breakdown when returned as an array

descriptionstring

Source description

urlstring

Official website

defillama_idstring

Source protocol identifier; do not pass it as public protocol_id

chainsstring[]

Covered chain names

chain_countinteger

Number of covered chains

tvl_usdstring

Total value locked, as a decimal string in USD

tvl_prev_daystring

TVL approximately one day earlier, in USD

tvl_prev_weekstring

TVL approximately one week earlier, in USD

tvl_prev_monthstring

TVL approximately one month earlier, in USD

obs_datestring

Source business date

snapshot_timestring

Business snapshot time of this record, distinct from response time

metricsobject

Metrics for this object; see their units individually

chain_distributionobject[]

Per-chain distribution

chain_distribution[]array[object]
chain_idstring

Canonical chain identifier

chainstring

Chain name

chain_namestring

Chain display name

obs_datestring

Source business date

tvl_usdstring

Total value locked, as a decimal string in USD

tvl_prev_daystring

TVL approximately one day earlier, in USD

tvl_prev_weekstring

TVL approximately one week earlier, in USD

tvl_prev_monthstring

TVL approximately one month earlier, in USD

Errors & fallback

400
Invalid parameter format, time range, scope, sorting or limit. Use the endpoint-specific rules above.
400
The supplied ID belongs to another object type.
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.