DefiLlama icon

DefiLlama

Access DeFi protocols data using the DefiLlama API

Overview

The node integrates with the DefiLlama API to retrieve data about DeFi oracle protocols. Specifically, for the "Oracle" resource and "List Oracles" operation, it fetches a list of oracle protocols along with their Total Value Secured (TVS) metrics. This node is useful for users who want to monitor or analyze oracle services in the DeFi ecosystem, such as tracking the security and scale of oracle providers.

Practical examples include:

  • Listing top oracle protocols by TVS to assess market leaders.
  • Filtering oracles based on minimum TVS thresholds to focus on more secure or significant players.
  • Integrating oracle data into dashboards or reports for DeFi analytics.

Properties

Name Meaning
Additional Fields Collection of optional filters and settings:
- Max Results Maximum number of oracle results to return (1-100). Default is 20.
- Min TVS Minimum Total Value Secured (TVS) threshold in USD to filter oracle protocols. Default 0.

Output

The output is an array of JSON objects, each representing an oracle protocol with its associated data fields. Key fields include:

  • name: Oracle protocol name.
  • tvs: Total Value Secured in USD (numeric).
  • tvs_formatted: Human-readable formatted TVS (e.g., "$1.23B").
  • chains: Array of blockchain chains supported by the oracle.
  • _metadata: Metadata including resource ("oracles"), operation ("listOracles"), and timestamp of data retrieval.

If no data is found, the output contains a message indicating no data was found for the resource and operation.

The node does not output binary data.

Dependencies

  • Requires access to the public DefiLlama API endpoint at https://api.llama.fi/oracles.
  • Optionally supports use of an API key credential for authorization if provided, but it is not mandatory.
  • Uses HTTP GET requests via Axios library.
  • No special environment variables are required beyond optional API credentials configured in n8n.

Troubleshooting

  • No Data Returned: If the result is empty, verify that the Min TVS filter is not set too high, which could exclude all oracles.
  • API Errors: Network issues or API downtime can cause request failures. Check internet connectivity and DefiLlama service status.
  • Invalid Property Values: Ensure "Max Results" is between 1 and 100; otherwise, the node may throw validation errors.
  • Credential Issues: If using an API key, ensure it is valid and correctly configured in n8n credentials.

Links and References

Discussion