Actions20
- Bridge Actions
- Category Actions
- Chain Actions
- DEXs & Volume Actions
- Fees & Revenue Actions
- Hack Actions
- Oracle Actions
- Protocol Actions
- Raise Actions
- Stablecoin Actions
- TVL Actions
- Yield Actions
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.,
volumePrevDayfor 24h). - Calculated fields like
volumeChangeshowing percentage change compared to the previous period. - Formatted fields for easier reading, e.g.,
volumePrevDay_formattedshowing 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, andtimestampfields.
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.