DefiLlama icon

DefiLlama

Access DeFi protocols data using the DefiLlama API

Overview

The node integrates with the DefiLlama API to retrieve data about cross-chain bridges in the decentralized finance (DeFi) ecosystem. Specifically, the "List Bridges" operation fetches a list of all cross-chain bridges along with their volume data over selectable time ranges.

This node is useful for users who want to monitor or analyze cross-chain bridge activity, such as tracking transaction volumes, understanding liquidity flows between blockchains, or comparing bridge usage trends.

Practical examples:

  • A DeFi analyst can use this node to get the latest volume statistics of popular bridges over the past 24 hours or 7 days.
  • A developer building a dashboard can list bridges and display their recent volume changes and supported chains.
  • Portfolio managers can filter bridges by minimum volume thresholds to focus on significant liquidity providers.

Properties

Name Meaning
Additional Fields Collection of optional filters and settings:
- Max Results Maximum number of bridge results to return (1-100). Default is 20.
- Date Range Time range for volume data aggregation. Options: "24 Hours", "7 Days", "30 Days". Default "24h".
- Min Volume Minimum volume threshold in USD to filter bridges by activity level. Default is 0 (no filter).
- AI Agent Mode Whether to optimize output format for AI agents (simplified and structured). Default false.
- Include Summary When AI Agent Mode is enabled, whether to include a human-readable summary. Default true.

Output

The node outputs an array of JSON objects representing bridges. Each bridge object includes:

  • Basic bridge information such as name and supported chains.
  • Volume data corresponding to the selected date range (e.g., volumePrevDay for 24h).
  • Calculated fields like volumeChange showing percentage change compared to the previous period.
  • Formatted fields for easier reading, e.g., volumePrevDay_formatted showing volume in human-readable currency format.
  • Metadata including resource type ("bridges"), operation ("listBridges"), and timestamp of data retrieval.

If AI Agent Mode is enabled, the output is a single JSON object containing:

  • ai_summary: a concise human-readable summary of the top bridges.
  • total_results: total number of bridges returned.
  • data: the full array of bridge data.
  • resource, operation, and timestamp fields.

No binary data is produced by this node.

Dependencies

  • Requires internet access to call the DefiLlama public API endpoints at https://bridges.llama.fi/.
  • Optionally supports using an API key credential if provided, which will be sent as a Bearer token in the Authorization header.
  • No other external dependencies are required.

Troubleshooting

  • Empty or no data returned:
    Check that the API endpoint is reachable and that the DefiLlama service is operational. Also verify that any filters (e.g., minVolume) are not too restrictive.

  • Invalid parameter errors:
    Ensure that numeric inputs like Max Results and Min Volume are within allowed ranges. For example, Max Results must be between 1 and 100.

  • API rate limits or authorization errors:
    If using an API key, confirm it is valid and has sufficient permissions. Without a key, the node uses public endpoints which may have stricter rate limits.

  • Unexpected response structure:
    The node expects certain fields from the API; if the API changes, the node might fail or produce incomplete data. Check for updates to the node or API documentation.

Links and References

Discussion