Query Executions - Dune Docs

Query Execution Triggers

Queries on Dune need to be triggered before they are executed. Query executions can be triggered by any user or team for public queries, and by the owner for private queries. There are four ways a query execution can be triggered:

Interactive Execution

Interactive executions are manually triggered by a user clicking the “Run” button in the query editor or by refreshing an entire dashboard. You can choose to route interactive executions through the Small, Medium, or Large engine depending on the engine size you select.

Scheduled Execution

Scheduled executions are triggered automatically at a specific time and frequency that you configure. Scheduled executions can be routed through the Medium or Large engine depending on the execution tier you select.

API Execution

API executions are triggered programmatically through a Dune API call. This is useful for embedding query results in your own application or automating query runs via a cron job. API executions can be routed through the Small, Medium, or Large engine depending on the engine size you select.→ Learn more about API executions

Popular Dashboard Execution

Popular dashboards are automatically refreshed by Dune based on their view count. The most popular dashboards are refreshed every hour, while less popular dashboards are refreshed every 24 hours. These executions run on the community cluster at no credit cost.

Query Engine Sizes

Dune has three query engine sizes: Small, Medium, and Large. The query engine size determines the amount of resources allocated to your query. The larger the engine, the more resources are allocated — meaning queries run faster and are less likely to time out.

The Small engine consumes a small amount of credits, while Medium and Large consume more credits based on actual compute used. Learn more about credit usage.

Small Engine

The Small engine is the default for all queries on Dune. It runs on a shared community cluster, which means performance can vary when many users are running queries at the same time. Executions on the Small engine consume a small amount of credits and will time out after 2 minutes. You are limited to a maximum of three (3) concurrent executions.

Medium Engine

Run queries manually or programmatically with a larger timeout and no limit on concurrent executions. Credits are consumed based on actual compute resources used. Suitable for most standard queries and dashboards.

Large Engine

Optimized for complex workloads requiring maximum computational power. The Large engine provides approximately 2x the capacity of Medium, completing queries faster but consuming more credits for the same query. Ideal for data-intensive queries and heavy analytics.