# Table of Contents - [Overview - Dune Docs](#overview-dune-docs) - [Dune CLI & Skills - Dune Docs](#dune-cli-skills-dune-docs) - [Pricing & Best Practices - Dune Docs](#pricing-best-practices-dune-docs) - [Metabase - Dune Docs](#metabase-dune-docs) - [Hex - Dune Docs](#hex-dune-docs) - [DBeaver - Dune Docs](#dbeaver-dune-docs) - [Data API Overview - Dune Docs](#data-api-overview-dune-docs) - [dbt Connector Overview - Dune Docs](#dbt-connector-overview-dune-docs) - [Trino Connector Overview - Dune Docs](#trino-connector-overview-dune-docs) - [CI/CD & Workflows - Dune Docs](#ci-cd-workflows-dune-docs) - [Getting Started - Dune Docs](#getting-started-dune-docs) - [Incremental Models - Dune Docs](#incremental-models-dune-docs) - [Trino SDKs - Dune Docs](#trino-sdks-dune-docs) - [Dune MCP - Dune Docs](#dune-mcp-dune-docs) - [Get Dataset - Dune Docs](#get-dataset-dune-docs) - [List Datasets - Dune Docs](#list-datasets-dune-docs) - [Products Overview - Dune Docs](#products-overview-dune-docs) - [Analytics - Dune Docs](#analytics-dune-docs) - [Changelog - Dune Docs](#changelog-dune-docs) - [Engineering - Dune Docs](#engineering-dune-docs) - [Accounting, Audit & AML - Dune Docs](#accounting-audit-aml-dune-docs) - [Data Hub Overview - Dune Docs](#data-hub-overview-dune-docs) - [Google SSO Domain Restriction - Dune Docs](#google-sso-domain-restriction-dune-docs) - [Okta SSO Setup - Dune Docs](#okta-sso-setup-dune-docs) - [Kalshi - Dune Docs](#kalshi-dune-docs) - [Initia Data - Dune Docs](#initia-data-dune-docs) - [Video Tutorials - Dune Docs](#video-tutorials-dune-docs) - [Query Editor Overview - Dune Docs](#query-editor-overview-dune-docs) - [Schedule Queries and Dashboards - Dune Docs](#schedule-queries-and-dashboards-dune-docs) - [Charts and Graphs - Dune Docs](#charts-and-graphs-dune-docs) - [Teams and Roles - Dune Docs](#teams-and-roles-dune-docs) - [Query Templates - Dune Docs](#query-templates-dune-docs) - [Create your first visualization - Dune Docs](#create-your-first-visualization-dune-docs) - [Create your first query - Dune Docs](#create-your-first-query-dune-docs) - [How Contract Decoding Works - Dune Docs](#how-contract-decoding-works-dune-docs) - [How Credits Work - Dune Docs](#how-credits-work-dune-docs) - [Web3 Data Resources - Dune Docs](#web3-data-resources-dune-docs) - [Measuring User Activity - Dune Docs](#measuring-user-activity-dune-docs) - [Support & Contact - Dune Docs](#support-contact-dune-docs) - [kalshi.market_report - Dune Docs](#kalshi-market-report-dune-docs) - [FAQs - Dune Docs](#faqs-dune-docs) - [Balances - Dune Docs](#balances-dune-docs) - [kalshi.trade_report - Dune Docs](#kalshi-trade-report-dune-docs) - [Block Events - Dune Docs](#block-events-dune-docs) - [Blocks - Dune Docs](#blocks-dune-docs) - [Message Events - Dune Docs](#message-events-dune-docs) - [Bridge Transfers - Dune Docs](#bridge-transfers-dune-docs) - [Bug Bounty Submission - Dune Docs](#bug-bounty-submission-dune-docs) - [Transactions - Dune Docs](#transactions-dune-docs) - [Transaction Messages - Dune Docs](#transaction-messages-dune-docs) - [Transaction Messages - Dune Docs](#transaction-messages-dune-docs) - [Swaps - Dune Docs](#swaps-dune-docs) - [Migrating from Flipside to Dune - Dune Docs](#migrating-from-flipside-to-dune-dune-docs) - [Validators - Dune Docs](#validators-dune-docs) - [Web3 Data Resources - Dune Docs](#web3-data-resources-dune-docs) - [Receipts - Dune Docs](#receipts-dune-docs) - [Build a Frame with Dune API - Dune Docs](#build-a-frame-with-dune-api-dune-docs) - [Contract Submission Guide - Dune Docs](#contract-submission-guide-dune-docs) - [Build Dashboards - Dune Docs](#build-dashboards-dune-docs) - [Find Data Tables with the Data Explorer - Dune Docs](#find-data-tables-with-the-data-explorer-dune-docs) - [Writing Queries - Dune Docs](#writing-queries-dune-docs) - [Using Parameters - Dune Docs](#using-parameters-dune-docs) - [Set Up Alerts - Dune Docs](#set-up-alerts-dune-docs) - [Version History - Dune Docs](#version-history-dune-docs) - [Tables - Dune Docs](#tables-dune-docs) - [Query Lineage - Dune Docs](#query-lineage-dune-docs) - [Counters - Dune Docs](#counters-dune-docs) - [AI Query Tools - Dune Docs](#ai-query-tools-dune-docs) - [Submission Best Practices - Dune Docs](#submission-best-practices-dune-docs) - [Multichain Decoding - Dune Docs](#multichain-decoding-dune-docs) - [Decoding FAQs - Dune Docs](#decoding-faqs-dune-docs) - [Yominet Data - Dune Docs](#yominet-data-dune-docs) - [Blocks - Dune Docs](#blocks-dune-docs) - [LayerZero - Dune Docs](#layerzero-dune-docs) - [Block Events - Dune Docs](#block-events-dune-docs) - [Transactions - Dune Docs](#transactions-dune-docs) - [Transactions - Dune Docs](#transactions-dune-docs) - [Blocks - Dune Docs](#blocks-dune-docs) - [Message Events - Dune Docs](#message-events-dune-docs) - [Fuel Data - Dune Docs](#fuel-data-dune-docs) - [Noble Data - Dune Docs](#noble-data-dune-docs) - [TRC721 Transfers - Dune Docs](#trc721-transfers-dune-docs) - [layerzero.messages - Dune Docs](#layerzero-messages-dune-docs) - [layerzero.transfers - Dune Docs](#layerzero-transfers-dune-docs) - [Blocks - Dune Docs](#blocks-dune-docs) - [Block Events - Dune Docs](#block-events-dune-docs) - [Bridge Transfers - Dune Docs](#bridge-transfers-dune-docs) - [CCTP Transactions - Dune Docs](#cctp-transactions-dune-docs) - [Transaction Messages - Dune Docs](#transaction-messages-dune-docs) - [Message Events - Dune Docs](#message-events-dune-docs) - [Validators - Dune Docs](#validators-dune-docs) - [Swaps - Dune Docs](#swaps-dune-docs) - [Transactions - Dune Docs](#transactions-dune-docs) - [Tokens - Dune Docs](#tokens-dune-docs) - [USDT on tron - Dune Docs](#usdt-on-tron-dune-docs) - [TRC20 Transfers - Dune Docs](#trc20-transfers-dune-docs) - [TRON Overview - Dune Docs](#tron-overview-dune-docs) - [TRC1155 Transfers - Dune Docs](#trc1155-transfers-dune-docs) - [Succinct - Dune Docs](#succinct-dune-docs) - [Peaq Overview - Dune Docs](#peaq-overview-dune-docs) - [tron.logs - Dune Docs](#tron-logs-dune-docs) - [tron.transactions - Dune Docs](#tron-transactions-dune-docs) - [tron.blocks - Dune Docs](#tron-blocks-dune-docs) - [tron.contracts - Dune Docs](#tron-contracts-dune-docs) - [xrpl.aggregated_metrics_daily - Dune Docs](#xrpl-aggregated-metrics-daily-dune-docs) - [succinct.bids - Dune Docs](#succinct-bids-dune-docs) - [succinct.requests - Dune Docs](#succinct-requests-dune-docs) - [peaq.evm_blocks - Dune Docs](#peaq-evm-blocks-dune-docs) - [peaq.extrinsics - Dune Docs](#peaq-extrinsics-dune-docs) - [peaq.balances - Dune Docs](#peaq-balances-dune-docs) - [peaq.transfers - Dune Docs](#peaq-transfers-dune-docs) - [peaq.events - Dune Docs](#peaq-events-dune-docs) - [peaq.calls - Dune Docs](#peaq-calls-dune-docs) - [Event Logs - Dune Docs](#event-logs-dune-docs) - [Decoded Tron data - Dune Docs](#decoded-tron-data-dune-docs) - [XRPL Data - Dune Docs](#xrpl-data-dune-docs) - [xrpl.ledger - Dune Docs](#xrpl-ledger-dune-docs) - [xrpl.transactions - Dune Docs](#xrpl-transactions-dune-docs) - [thorchain.gov_validator_request_leave_events - Dune Docs](#thorchain-gov-validator-request-leave-events-dune-docs) - [THORChain Data - Dune Docs](#thorchain-data-dune-docs) - [thorchain.core_instantiate_events - Dune Docs](#thorchain-core-instantiate-events-dune-docs) - [thorchain.core_block - Dune Docs](#thorchain-core-block-dune-docs) - [thorchain.core_tss_keygen_success_events - Dune Docs](#thorchain-core-tss-keygen-success-events-dune-docs) - [thorchain.core_wasm_contracts_events - Dune Docs](#thorchain-core-wasm-contracts-events-dune-docs) - [thorchain.core_tss_keygen_failure_events - Dune Docs](#thorchain-core-tss-keygen-failure-events-dune-docs) - [thorchain.core_set_mimir_events - Dune Docs](#thorchain-core-set-mimir-events-dune-docs) - [thorchain.core_transfers - Dune Docs](#thorchain-core-transfers-dune-docs) - [thorchain.core_thorname_change_events - Dune Docs](#thorchain-core-thorname-change-events-dune-docs) - [thorchain.defi_active_vault_events - Dune Docs](#thorchain-defi-active-vault-events-dune-docs) - [thorchain.core_transfer_events - Dune Docs](#thorchain-core-transfer-events-dune-docs) - [thorchain.defi_add_events - Dune Docs](#thorchain-defi-add-events-dune-docs) - [thorchain.defi_affiliate_fee_events - Dune Docs](#thorchain-defi-affiliate-fee-events-dune-docs) - [thorchain.core_network_version_events - Dune Docs](#thorchain-core-network-version-events-dune-docs) - [thorchain.defi_daily_tvl - Dune Docs](#thorchain-defi-daily-tvl-dune-docs) - [thorchain.defi_block_pool_depths - Dune Docs](#thorchain-defi-block-pool-depths-dune-docs) - [thorchain.defi_fee_events - Dune Docs](#thorchain-defi-fee-events-dune-docs) - [thorchain.defi_bond_actions - Dune Docs](#thorchain-defi-bond-actions-dune-docs) - [thorchain.defi_inactive_vault_events - Dune Docs](#thorchain-defi-inactive-vault-events-dune-docs) - [thorchain.defi_block_rewards - Dune Docs](#thorchain-defi-block-rewards-dune-docs) - [thorchain.defi_daily_earnings - Dune Docs](#thorchain-defi-daily-earnings-dune-docs) - [thorchain.defi_failed_deposit_messages - Dune Docs](#thorchain-defi-failed-deposit-messages-dune-docs) - [thorchain.defi_gas_events - Dune Docs](#thorchain-defi-gas-events-dune-docs) - [thorchain.defi_errata_events - Dune Docs](#thorchain-defi-errata-events-dune-docs) - [thorchain.defi_asgard_fund_yggdrasil_events - Dune Docs](#thorchain-defi-asgard-fund-yggdrasil-events-dune-docs) - [thorchain.defi_bond_events - Dune Docs](#thorchain-defi-bond-events-dune-docs) - [thorchain.defi_outbound_events - Dune Docs](#thorchain-defi-outbound-events-dune-docs) - [thorchain.defi_loan_open_events - Dune Docs](#thorchain-defi-loan-open-events-dune-docs) - [thorchain.defi_pending_liquidity_events - Dune Docs](#thorchain-defi-pending-liquidity-events-dune-docs) - [thorchain.defi_loan_repayment_events - Dune Docs](#thorchain-defi-loan-repayment-events-dune-docs) - [thorchain.defi_mint_burn_events - Dune Docs](#thorchain-defi-mint-burn-events-dune-docs) - [thorchain.defi_pool_balance_change_events - Dune Docs](#thorchain-defi-pool-balance-change-events-dune-docs) - [thorchain.defi_pool_block_statistics - Dune Docs](#thorchain-defi-pool-block-statistics-dune-docs) - [thorchain.defi_pool_block_fees - Dune Docs](#thorchain-defi-pool-block-fees-dune-docs) - [thorchain.defi_pool_events - Dune Docs](#thorchain-defi-pool-events-dune-docs) - [thorchain.defi_pool_block_balances - Dune Docs](#thorchain-defi-pool-block-balances-dune-docs) - [thorchain.defi_refund_events - Dune Docs](#thorchain-defi-refund-events-dune-docs) - [thorchain.defi_reserve_events - Dune Docs](#thorchain-defi-reserve-events-dune-docs) - [thorchain.defi_rewards_event_entries - Dune Docs](#thorchain-defi-rewards-event-entries-dune-docs) - [thorchain.defi_tcy_unstake_events - Dune Docs](#thorchain-defi-tcy-unstake-events-dune-docs) - [thorchain.defi_tcy_distribution_events - Dune Docs](#thorchain-defi-tcy-distribution-events-dune-docs) - [thorchain.defi_send_messages - Dune Docs](#thorchain-defi-send-messages-dune-docs) - [thorchain.defi_rune_pool_withdraw_events - Dune Docs](#thorchain-defi-rune-pool-withdraw-events-dune-docs) - [thorchain.defi_tcy_claim_events - Dune Docs](#thorchain-defi-tcy-claim-events-dune-docs) - [thorchain.defi_stake_events - Dune Docs](#thorchain-defi-stake-events-dune-docs) - [thorchain.defi_rune_pool_deposit_events - Dune Docs](#thorchain-defi-rune-pool-deposit-events-dune-docs) - [thorchain.defi_tcy_stake_events - Dune Docs](#thorchain-defi-tcy-stake-events-dune-docs) - [thorchain.defi_scheduled_outbound_events - Dune Docs](#thorchain-defi-scheduled-outbound-events-dune-docs) - [thorchain.defi_total_block_rewards - Dune Docs](#thorchain-defi-total-block-rewards-dune-docs) - [thorchain.defi_total_value_locked - Dune Docs](#thorchain-defi-total-value-locked-dune-docs) --- # Overview - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/overview/introduction#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... Ctrl KAsk AI Search... Navigation Introduction Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [What do you want to build?](https://docs.dune.com/api-reference/overview/introduction#what-do-you-want-to-build) * [Quick Start with SDKs](https://docs.dune.com/api-reference/overview/introduction#quick-start-with-sdks) * [Additional Resources](https://docs.dune.com/api-reference/overview/introduction#additional-resources) * [Getting Help](https://docs.dune.com/api-reference/overview/introduction#getting-help) Build blockchain analytics workflows with Dune’s comprehensive API suite. Access the same data that powers thousands of Dune dashboards, available programmatically for your data pattern needs. Dune API provides a variety of endpoints for **analysts**, **data engineers**, and **data scientists**, ranging from low-level, customizable options to connectors ready for immediate use. Queries saved in the Dune App UI can be executed via API and results retrieved in your environment, enabling bulk data extraction and automated workflows. **New to Dune?** **[Create a free account](https://dune.com/auth/register) ** or **[get your API key](https://dune.com/apis?tab=keys) ** to get started. [​](https://docs.dune.com/api-reference/overview/introduction#what-do-you-want-to-build) What do you want to build? ---------------------------------------------------------------------------------------------------------------------- [Analyze onchain data programmatically\ -------------------------------------\ \ Execute SQL queries, retrieve results, and build custom analytics pipelines with Dune’s query execution engine. Perfect for data teams and analysts.→ Start with query execution](https://docs.dune.com/api-reference/apis/quickstart-analyze) [Run queries in your environment\ -------------------------------\ \ Connect directly to Dune’s data warehouse using Trino Connector for maximum flexibility. Perfect for enterprise teams with existing BI tools.→ Set up Trino connector](https://docs.dune.com/api-reference/connectors/overview) [Build custom dashboards & reports\ ---------------------------------\ \ Fetch query results, manage executions, and create dynamic visualizations in your own applications. Perfect for teams embedding analytics.→ Create your first dashboard](https://docs.dune.com/api-reference/apis/quickstart-dashboards) [Build real-time applications\ ----------------------------\ \ Create a multichain wallet with realtime balances, transactions, and NFTs using Sim by Dune. Perfect for mobile developers and DeFi applications.→ Build a realtime wallet with Sim](https://docs.sim.dune.com/evm/build-a-realtime-wallet) [Transform data with dbt\ -----------------------\ \ Build production-grade data transformation pipelines with write access to DuneSQL. Perfect for data engineering teams using dbt.→ Set up dbt connector](https://docs.dune.com/api-reference/connectors/dbt/overview) [BI Visualization Tools\ ----------------------\ \ Connect Dune to your favorite BI tools like Hex, Metabase, and DBeaver using the Trino/Presto connector.→ Connect BI tools](https://docs.dune.com/api-reference/connectors/trino/overview) [Get started with the basics\ ---------------------------\ \ New to APIs? Start here to make your first request and see results in minutes.Learn how to execute a simple SQL query, authenticate your requests, and retrieve blockchain data programmatically.→ Make your first request](https://docs.dune.com/api-reference/overview/getting-started) [​](https://docs.dune.com/api-reference/overview/introduction#quick-start-with-sdks) Quick Start with SDKs ------------------------------------------------------------------------------------------------------------- Our SDKs handle authentication, polling, pagination, and error handling automatically. The new `execute()` function manages the entire workflow for you. [](https://docs.dune.com/api-reference/overview/sdks#python) [](https://docs.dune.com/api-reference/overview/sdks#python) [Python\ ------](https://docs.dune.com/api-reference/overview/sdks#python) [Copy\ \ Ask AI\ \ pip install dune-client\ \ \ Copy\ \ Ask AI\ \ from dune_client import DuneClient\ \ dune = DuneClient(api_key="your-key")\ results = dune.execute(query_id=3493826)](https://docs.dune.com/api-reference/overview/sdks#python) [Full Python documentation →](https://docs.dune.com/api-reference/overview/sdks#python) [](https://docs.dune.com/api-reference/overview/sdks#typescript) [](https://docs.dune.com/api-reference/overview/sdks#typescript) [TypeScript\ ----------](https://docs.dune.com/api-reference/overview/sdks#typescript) [Copy\ \ Ask AI\ \ npm install @duneanalytics/client\ \ \ Copy\ \ Ask AI\ \ import { DuneClient } from '@duneanalytics/client';\ \ const dune = new DuneClient('your-key');\ const results = await dune.execute({ queryId: 3493826 });](https://docs.dune.com/api-reference/overview/sdks#typescript) [Full TypeScript documentation →](https://docs.dune.com/api-reference/overview/sdks#typescript) [](https://docs.dune.com/api-reference/overview/sdks#go) [](https://docs.dune.com/api-reference/overview/sdks#go) [Go\ --](https://docs.dune.com/api-reference/overview/sdks#go) [Copy\ \ Ask AI\ \ go get github.com/duneanalytics/duneapi-client-go\ \ \ Copy\ \ Ask AI\ \ client := duneapi.New("your-key")\ results := client.Execute(3493826)](https://docs.dune.com/api-reference/overview/sdks#go) [Full Go documentation →](https://docs.dune.com/api-reference/overview/sdks#go) **New:** All SDKs now include an `execute()` function that handles polling and pagination automatically. No more managing multiple API calls! [​](https://docs.dune.com/api-reference/overview/introduction#additional-resources) Additional Resources ----------------------------------------------------------------------------------------------------------- [API Reference\ -------------\ \ Complete documentation for all endpoints, parameters, response formats, and status codes.\ \ * Execute & Results endpoints\ * Query management\ * Dataset metadata\ * Usage & billing\ * Webhooks](https://docs.dune.com/api-reference/api-overview) [Troubleshooting Errors\ ----------------------\ \ Common API errors and how to resolve them.\ \ * Authentication issues\ * Rate limit errors\ * Query execution failures\ * Response format errors](https://docs.dune.com/api-reference/overview/errors) [API Pricing\ -----------\ \ Understand credit consumption and costs for different endpoints.\ \ * Execution endpoints: Credit-based\ * Metadata endpoints: Free\ * Usage tracking available via API](https://docs.dune.com/api-reference/overview/billing) [Authentication\ --------------\ \ Get started with API keys and authentication.\ \ * Auto-generated keys for new teams\ * Manage keys in settings\ * Best practices for key security](https://docs.dune.com/api-reference/overview/authentication) [​](https://docs.dune.com/api-reference/overview/introduction#getting-help) Getting Help ------------------------------------------------------------------------------------------- [Quickstarts\ -----------\ \ Step-by-step guides for common use cases](https://docs.dune.com/api-reference/overview/getting-started) [Community\ ---------\ \ Get help from the Dune community](https://discord.gg/duneanalytics) [Support\ -------\ \ Contact our support team](mailto:support@dune.com) Was this page helpful? YesNo [Getting Started](https://docs.dune.com/api-reference/overview/getting-started) Ctrl+I Assistant Responses are generated using AI and may contain mistakes. --- # Dune CLI & Skills - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/agents/cli-and-skills#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Agents Dune CLI & Skills [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Dune CLI](https://docs.dune.com/api-reference/agents/cli-and-skills#dune-cli) * [Install](https://docs.dune.com/api-reference/agents/cli-and-skills#install) * [Authenticate (manual)](https://docs.dune.com/api-reference/agents/cli-and-skills#authenticate-manual) * [Usage](https://docs.dune.com/api-reference/agents/cli-and-skills#usage) * [Dune Skills](https://docs.dune.com/api-reference/agents/cli-and-skills#dune-skills) * [Install](https://docs.dune.com/api-reference/agents/cli-and-skills#install-2) * [How it works](https://docs.dune.com/api-reference/agents/cli-and-skills#how-it-works) * [Key Benefits](https://docs.dune.com/api-reference/agents/cli-and-skills#key-benefits) * [Use Cases](https://docs.dune.com/api-reference/agents/cli-and-skills#use-cases) The Dune CLI and Agent Skills give your AI coding agent structured access to Dune’s datasets, query engine, and documentation — directly inside the tools you already use. The **Dune CLI** is a terminal-native interface for discovering datasets, executing DuneSQL queries, and managing results. **Dune Skills** are portable instruction packages that teach AI agents how to use the CLI effectively — from writing correct SQL to handling errors and optimizing costs. Together, they turn any skills-compatible agent into a blockchain data analyst. [​](https://docs.dune.com/api-reference/agents/cli-and-skills#dune-cli) Dune CLI ----------------------------------------------------------------------------------- The Dune CLI lets you query, explore, and manage blockchain data without leaving your terminal. All commands support both human-readable and JSON output, making them equally useful for interactive work and agent-driven workflows. ### [​](https://docs.dune.com/api-reference/agents/cli-and-skills#install) Install Copy Ask AI curl -sSfL https://dune.com/cli/install.sh | sh The install script handles everything you need to get started: it installs the Dune CLI, runs `dune auth` to configure your API key, and installs the Dune Agent Skill via `npx skills add`. In most cases, this single command is all you need. You’ll need a Dune API key during setup. Generate one at [dune.com](https://dune.com/) under **APIs and Connectors > API Keys** before running the install script. ### [​](https://docs.dune.com/api-reference/agents/cli-and-skills#authenticate-manual) Authenticate (manual) If you need to re-authenticate or configure a different API key after installation, you can run: Copy Ask AI dune auth You’ll be prompted to enter your API key. It’s saved to `~/.config/dune/config.yaml` for future sessions. Alternatively, pass the key inline or via environment variable: Copy Ask AI # Environment variable export DUNE_API_KEY= # Inline flag dune query run 12345 --api-key ### [​](https://docs.dune.com/api-reference/agents/cli-and-skills#usage) Usage Run `dune --help` to see all available commands. All commands support `-o json` for structured, machine-parseable output — ideal for agent consumption: Copy Ask AI dune query run-sql --sql "SELECT * FROM ethereum.transactions LIMIT 5" -o json * * * [​](https://docs.dune.com/api-reference/agents/cli-and-skills#dune-skills) Dune Skills ----------------------------------------------------------------------------------------- [Agent Skills](https://agentskills.io/) are an open standard for giving AI agents new capabilities. The Dune Skill teaches your agent how to use the Dune CLI to discover datasets, write DuneSQL, execute queries, handle errors, and manage costs — all from natural language prompts. Skills are supported by Claude Code, Cursor, OpenCode, OpenAI Codex, VS Code, Gemini CLI, Goose, and [many more](https://agentskills.io/) . ### [​](https://docs.dune.com/api-reference/agents/cli-and-skills#install-2) Install The Dune Skill is automatically installed when you run the [CLI install script](https://docs.dune.com/api-reference/agents/cli-and-skills#install) above — no extra steps required. If you need to install or reinstall the skill separately, you can run: Copy Ask AI npx skills add duneanalytics/skills * Claude Code * Cursor * Manual Skills are automatically installed to `~/.claude/skills/` and loaded when your conversation matches blockchain-related triggers. You can also add the skill via **Settings > Rules > Add Rule > Remote Rule (Github)** with `duneanalytics/skills`. Clone the [duneanalytics/skills](https://github.com/duneanalytics/skills) repository and copy the `skills/dune/` folder into your agent’s skill directory: | Agent | Directory | | --- | --- | | Claude Code | `~/.claude/skills/` | | Cursor | `~/.cursor/skills/` | | OpenCode | `~/.config/opencode/skills/` | | OpenAI Codex | `~/.codex/skills/` | ### [​](https://docs.dune.com/api-reference/agents/cli-and-skills#how-it-works) How it works Once installed, the Dune Skill activates automatically when your conversation involves blockchain data, on-chain analytics, DuneSQL, token transfers, DEX trades, smart contract events, or wallet analysis. The agent then: 1. Discovers the right tables using `dune dataset search` 2. Inspects column schemas to build correct SQL 3. Writes DuneSQL with proper partition filters for cost efficiency 4. Executes the query and parses results 5. Handles errors with built-in recovery strategies The skill includes detailed reference documents for query execution, dataset discovery, DuneSQL syntax, and error handling — loaded on demand to keep context window usage efficient. * * * [​](https://docs.dune.com/api-reference/agents/cli-and-skills#key-benefits) Key Benefits ------------------------------------------------------------------------------------------- Agent-Native Data Access ------------------------ Your AI agent queries blockchain data directly — no context switching, no copy-pasting SQL between apps. Works Where You Work -------------------- Compatible with Claude Code, Cursor, VS Code, Codex, and any agent that supports the Agent Skills standard. Cost-Aware by Default --------------------- The skill teaches agents to filter on partition columns and choose the right performance tier, reducing credit consumption. [​](https://docs.dune.com/api-reference/agents/cli-and-skills#use-cases) Use Cases ------------------------------------------------------------------------------------- Ad-Hoc Analysis --------------- Ask your agent a question in plain English and get results backed by DuneSQL — from DEX volumes to gas trends. Contract Exploration -------------------- Give the agent a contract address and let it discover all decoded event and call tables automatically. Pipeline Scripting ------------------ Use the CLI’s JSON output and async execution to integrate Dune queries into CI/CD pipelines or monitoring scripts. Reusable Parameterized Queries ------------------------------ Create saved queries with parameters, then run them with different inputs across sessions. Was this page helpful? YesNo [MCP](https://docs.dune.com/api-reference/agents/mcp) [Overview](https://docs.dune.com/api-reference/executions/execution-object) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Pricing & Best Practices - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Transform your Data Pricing & Best Practices [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Pricing & Credits](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#pricing-%26-credits) * [Credit Consumption](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#credit-consumption) * [Compute Credits](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#compute-credits) * [Write Operations](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#write-operations) * [Storage Credits](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#storage-credits) * [Maintenance Operations](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#maintenance-operations) * [Best Practices](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#best-practices) * [Model Organization](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#model-organization) * [Schema Organization](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#schema-organization) * [Performance Optimization](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#performance-optimization) * [Credit Management](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#credit-management) * [Data Management](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#data-management) * [Version Control](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#version-control) * [Documentation](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#documentation) * [Resources](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#resources) * [Documentation](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#documentation-2) * [Support](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#support) * [Getting Started](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#getting-started) Data Transformations is an **Enterprise-only feature** with usage-based credit consumption. **CI/CD and Credit Usage**Each dbt execution consumes credits, whether triggered locally, through CI/CD, or on a schedule. The template repository ships with automated CI/CD triggers **disabled by default** so you can enable them when you’re ready. See [CI/CD & Workflows](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows) for tips on managing costs in automated pipelines. [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#pricing-&-credits) Pricing & Credits --------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#credit-consumption) Credit Consumption Your credit usage includes three components: #### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#compute-credits) Compute Credits * Same as Fluid Engine credits for query execution * Charged based on actual compute resources used * Depends on query complexity and execution time #### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#write-operations) Write Operations * **Minimum 3 credits** per write operation * Scales with data volume (GB written) * Applied to INSERT, MERGE, CREATE TABLE AS SELECT, etc. #### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#storage-credits) Storage Credits * **4 credits per GB per month** * Calculated based on end-of-day storage usage * Encourages efficient data management and cleanup #### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#maintenance-operations) Maintenance Operations * OPTIMIZE, VACUUM, and ANALYZE operations consume credits * Based on compute resources and data written during maintenance * Can be automated with dbt post-hooks There is no separate platform fee. You only pay for what you use through credits. See [Billing](https://docs.dune.com/api-reference/overview/billing) for more details on credit pricing. [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#best-practices) Best Practices --------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#model-organization) Model Organization Copy Ask AI models/ ├── staging/ # Clean and standardize raw data ├── intermediate/ # Business logic transformations ├── marts/ # Final datasets for analytics └── utils/ # Reusable utility models ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#schema-organization) Schema Organization * Use `dev` target with personal suffixes during development * Keep `prod` target for production deployments only * Consider separate schemas for different projects or domains ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#performance-optimization) Performance Optimization * Use incremental models for large datasets * Partition by date fields when possible * Add appropriate partitions via dbt configurations * Run OPTIMIZE and VACUUM on large tables ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#credit-management) Credit Management * Monitor credit usage in your Dune dashboard * Use incremental models to reduce compute and write costs * Drop unused development tables regularly * Implement table lifecycle policies ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#data-management) Data Management * Clean up temporary/test data in `__tmp_` schemas * Document table retention requirements * Regularly review and optimize storage usage ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#version-control) Version Control * Store all transformation logic in Git * Use meaningful commit messages * Tag production releases * Review PRs before merging to main ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#documentation) Documentation Copy Ask AI # schema.yml models: - name: user_stats description: "Daily user trading statistics" columns: - name: user_address description: "Ethereum address of the user" tests: - not_null - unique - name: trade_count description: "Number of trades in the period" [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#resources) Resources ----------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#documentation-2) Documentation * [dbt Template Repository](https://github.com/duneanalytics/dune-dbt-template) * [SQL Operations Reference](https://docs.dune.com/api-reference/connectors/sql-operations) * [Query Engine Overview](https://docs.dune.com/query-engine/overview) - DuneSQL capabilities and read operations * [Trino Connector](https://docs.dune.com/api-reference/connectors/trino/overview) - General Trino connection guide * [dbt Documentation](https://docs.getdbt.com/) * [dbt-trino Setup Guide](https://docs.getdbt.com/docs/core/connect-data-platform/trino-setup) ### [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#support) Support * **Dune Discord**: [discord.gg/ErrzwBz](https://discord.gg/ErrzwBz) * **Enterprise Support**: Contact your account team * **GitHub Issues**: Report issues in the [template repository](https://github.com/duneanalytics/dune-dbt-template) [​](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices#getting-started) Getting Started ----------------------------------------------------------------------------------------------------------------- Ready to get started? Clone the [template repository](https://github.com/duneanalytics/dune-dbt-template) and have your first dbt model running on Dune in minutes! [dbt Template Repository\ -----------------------\ \ Clone our official template to get started](https://github.com/duneanalytics/dune-dbt-template) [Getting Started Guide\ ---------------------\ \ Step-by-step setup instructions](https://docs.dune.com/api-reference/connectors/dbt/getting-started) Was this page helpful? YesNo [CI/CD & Workflows](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows) [Supported SQL Operations](https://docs.dune.com/api-reference/connectors/sql-operations) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Metabase - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/trino/metabase#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation BI Visualization Tools Metabase [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Add the Database Connection](https://docs.dune.com/api-reference/connectors/trino/metabase#add-the-database-connection) * [Run a Test Query](https://docs.dune.com/api-reference/connectors/trino/metabase#run-a-test-query) Follow these steps to connect Dune as a data source in Metabase. [​](https://docs.dune.com/api-reference/connectors/trino/metabase#add-the-database-connection) Add the Database Connection ----------------------------------------------------------------------------------------------------------------------------- 1 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Open Admin settings From the Metabase home page, click the **Settings** gear icon in the top-right corner. Select **Admin settings** from the dropdown menu. ![Metabase step 1: Open Admin settings](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/metabase-1.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=11d62b503861c1281e4cb40a9be58f06) 2 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Go to Databases In the Admin panel, navigate to the **Databases** tab. ![Metabase step 2: Go to Databases](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/metabase-2.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=447561935cfe3b803c0c8acfa686d518) 3 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Add database Click the blue **Add database** button to open the configuration modal. ![Metabase step 3: Add database](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/metabase-3.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=65ba403f996e229014f1a01862b27c36) 4 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Choose driver In the modal, select `Starburst (Trino)` as the **Database type**. 5 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Enter connection details Fill in the form fields using the values from the [Connection Parameters](https://docs.dune.com/api-reference/connectors/trino/overview#connection-parameters) section. For best performance in Metabase, we recommend disabling **Rerun queries for simple explorations** and **Periodically refingerprint tables** in the advanced settings. Schema discovery queries such as `SHOW TABLES` or `SHOW SCHEMAS` may not be available in Metabase with this connector because Dune’s catalog spans millions of tables. Many BI tools are not yet optimized to enumerate catalogs at this scale. An update with improved schema discovery is planned for the future. [​](https://docs.dune.com/api-reference/connectors/trino/metabase#run-a-test-query) Run a Test Query ------------------------------------------------------------------------------------------------------- After configuring and saving the connection, you can run a query to verify that everything is working. 1 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Create a new SQL query Click the **\+ New** button and select **SQL query**. 2 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Select database In the editor, choose your newly created **Dune SQL** data source from the **Select a database** dropdown. 3 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Paste example SQL Paste the example query below into the editor. 4 [](https://docs.dune.com/api-reference/connectors/trino/metabase#) Run the query Run the query to verify the connection. You can use this query to test your connection. It fetches the daily transaction count from the last year on Base. Copy Ask AI SELECT date_trunc('day', block_time) AS time, count(*) AS count FROM base.transactions WHERE block_time > now() - interval '12' month GROUP BY 1 ORDER BY 1 DESC Was this page helpful? YesNo [Hex](https://docs.dune.com/api-reference/connectors/trino/hex) [DBeaver](https://docs.dune.com/api-reference/connectors/trino/dbeaver) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Hex - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/trino/hex#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation BI Visualization Tools Hex [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Add the Data Connection](https://docs.dune.com/api-reference/connectors/trino/hex#add-the-data-connection) * [Run a Test Query](https://docs.dune.com/api-reference/connectors/trino/hex#run-a-test-query) Follow these steps to connect Dune as a data source in your Hex workspace. [​](https://docs.dune.com/api-reference/connectors/trino/hex#add-the-data-connection) Add the Data Connection ---------------------------------------------------------------------------------------------------------------- 1 [](https://docs.dune.com/api-reference/connectors/trino/hex#) Open Data sources Under Workspace settings, select **Data sources**. ![Hex step 1: Open Data sources](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/hex-1.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=e95e4ac9c2430830cafdc2433d299c29) 2 [](https://docs.dune.com/api-reference/connectors/trino/hex#) Add connection and choose Trino Click the green **\+ Connection** button, then select **Trino** from the list of available connections. ![Hex step 2: Add connection and choose Trino](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/hex-2.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=c9722a16c4a89ccbda2bbd23fd1a93e9) 3 [](https://docs.dune.com/api-reference/connectors/trino/hex#) Enter connection details Fill in the form fields using the values from the [Connection Parameters](https://docs.dune.com/api-reference/connectors/trino/overview#connection-parameters) section. ![Hex step 3: Enter connection details](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/hex-3.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=86b6c8984f63b204cde1b220b5b0ec4c) [​](https://docs.dune.com/api-reference/connectors/trino/hex#run-a-test-query) Run a Test Query -------------------------------------------------------------------------------------------------- Once your data source is configured, you can query it directly from any Hex project. 1 [](https://docs.dune.com/api-reference/connectors/trino/hex#) Open or create a project Open an existing project or create a new one. 2 [](https://docs.dune.com/api-reference/connectors/trino/hex#) Add a SQL cell Add a new **SQL cell** to your notebook. 3 [](https://docs.dune.com/api-reference/connectors/trino/hex#) Select data source In the data source dropdown at the top of the cell, select your newly created **Dune SQL** connection. 4 [](https://docs.dune.com/api-reference/connectors/trino/hex#) Paste and run SQL Paste the example query below into the cell and run it. ![Hex step: Paste and run SQL](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/hex-4.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=54cd3f74347c6fd2168afeee30875ef7) You can use this query to test your connection. It fetches the daily transaction count from the last year on Base. Copy Ask AI SELECT date_trunc('day', block_time) AS time, count(*) AS count FROM base.transactions WHERE block_time > now() - interval '12' month GROUP BY 1 ORDER BY 1 DESC Was this page helpful? YesNo [Trino Connector Overview](https://docs.dune.com/api-reference/connectors/trino/overview) [Metabase](https://docs.dune.com/api-reference/connectors/trino/metabase) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # DBeaver - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/trino/dbeaver#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation BI Visualization Tools DBeaver [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Add a Database Connection](https://docs.dune.com/api-reference/connectors/trino/dbeaver#add-a-database-connection) * [Run a Test Query](https://docs.dune.com/api-reference/connectors/trino/dbeaver#run-a-test-query) Follow these steps to connect Dune as a data source in DBeaver. [​](https://docs.dune.com/api-reference/connectors/trino/dbeaver#add-a-database-connection) Add a Database Connection ------------------------------------------------------------------------------------------------------------------------ 1 [](https://docs.dune.com/api-reference/connectors/trino/dbeaver#) Create new connection In DBeaver, click the **New Database Connection** button. It usually looks like a plug with a plus on it. 2 [](https://docs.dune.com/api-reference/connectors/trino/dbeaver#) Select Trino database You’ll be taken to the “Connect to a database” screen. Find and select **Trino** from the list of accepted databases, then click on it. ![DBeaver step 2: Select Trino from database list](https://mintcdn.com/dune/bE2iCQxUVMqVPGif/images/trino-presto-connector/dbeaver-1.png?w=2500&fit=max&auto=format&n=bE2iCQxUVMqVPGif&q=85&s=aaf44d48889e342d96458e915df30599) 3 [](https://docs.dune.com/api-reference/connectors/trino/dbeaver#) Configure connection details You’ll be taken to a screen where you can fill in your connection details. Make sure to click **Connect by host**, then fill in the connection parameters using the values from the [Connection Parameters](https://docs.dune.com/api-reference/connectors/trino/overview#connection-parameters) section. ![DBeaver step 3: Enter connection details](https://mintcdn.com/dune/bE2iCQxUVMqVPGif/images/trino-presto-connector/dbeaver-2.png?w=2500&fit=max&auto=format&n=bE2iCQxUVMqVPGif&q=85&s=1dd1a1aa792441f2640e54f9eb6bad43) 4 [](https://docs.dune.com/api-reference/connectors/trino/dbeaver#) Finish connection setup Once you have all the details filled out properly, click **Finish** to create the connection. [​](https://docs.dune.com/api-reference/connectors/trino/dbeaver#run-a-test-query) Run a Test Query ------------------------------------------------------------------------------------------------------ After configuring your connection, you can run a query to verify that everything is working. 1 [](https://docs.dune.com/api-reference/connectors/trino/dbeaver#) Open SQL editor Right-click on your Dune database connection and navigate to the **SQL Editor** section. This will open up a new SQL editor. 2 [](https://docs.dune.com/api-reference/connectors/trino/dbeaver#) Write your SQL query In the SQL editor, you can write all of your Dune-compatible SQL. Paste the example query below into the editor. 3 [](https://docs.dune.com/api-reference/connectors/trino/dbeaver#) Run the script Click the **Run** button to execute your script. If everything went well, you will see the results displayed in the results panel. ![DBeaver step 5: Run SQL script and view results](https://mintcdn.com/dune/bE2iCQxUVMqVPGif/images/trino-presto-connector/dbeaver-3.png?w=2500&fit=max&auto=format&n=bE2iCQxUVMqVPGif&q=85&s=d3d55c612503e2091e0631ad507df9e6) You can use this query to test your connection. It fetches the daily transaction count from the last year on Base. Copy Ask AI SELECT date_trunc('day', block_time) AS time, count(*) AS count FROM base.transactions WHERE block_time > now() - interval '12' month GROUP BY 1 ORDER BY 1 DESC Was this page helpful? YesNo [Metabase](https://docs.dune.com/api-reference/connectors/trino/metabase) [Trino SDKs](https://docs.dune.com/api-reference/connectors/trino/sdks) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Data API Overview - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/api-overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Data API Data API Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Available Endpoints](https://docs.dune.com/api-reference/api-overview#available-endpoints) * [Full API Reference](https://docs.dune.com/api-reference/api-overview#full-api-reference) Access Dune’s onchain data programmatically via REST endpoints. The Data API provides programmatic access to execute queries, manage data, track usage, and integrate Dune’s onchain analytics into your applications, workflows, and environments. For complete endpoint documentation, authentication guides, and code examples, visit the **[API Reference](https://docs.dune.com/api-reference/overview/introduction) ** tab. [​](https://docs.dune.com/api-reference/api-overview#available-endpoints) Available Endpoints ------------------------------------------------------------------------------------------------ [Executions and Results\ ----------------------\ \ Execute saved queries and retrieve results in various formats](https://docs.dune.com/api-reference/executions/execution-object) [Query Management\ ----------------\ \ Create, update, and manage your Dune queries programmatically](https://docs.dune.com/api-reference/queries/endpoint/query-object) [Data Uploads\ ------------\ \ Upload and manage custom datasets as queryable tables](https://docs.dune.com/api-reference/tables/endpoint/overview) [Materialized Views\ ------------------\ \ Create and refresh materialized views for improved performance](https://docs.dune.com/api-reference/materialized-views/overview) [Pipelines\ ---------\ \ Execute and monitor query pipelines with coordinated workflows](https://docs.dune.com/api-reference/pipelines/overview) [Account Management\ ------------------\ \ Monitor API usage and credit consumption](https://docs.dune.com/api-reference/usage/overview) [​](https://docs.dune.com/api-reference/api-overview#full-api-reference) Full API Reference ---------------------------------------------------------------------------------------------- [API Reference Documentation\ ---------------------------\ \ Complete endpoint documentation with authentication, rate limits, SDKs, and detailed code examples →](https://docs.dune.com/api-reference/overview/introduction) Was this page helpful? YesNo [Enterprise Plan](https://docs.dune.com/enterprise/data-hub/overview) [dbt Connector Overview](https://docs.dune.com/api-reference/connectors/dbt/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # dbt Connector Overview - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/dbt/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Transform your Data dbt Connector Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Video Tutorial](https://docs.dune.com/api-reference/connectors/dbt/overview#video-tutorial) * [What is dbt?](https://docs.dune.com/api-reference/connectors/dbt/overview#what-is-dbt) * [Why dbt on Dune?](https://docs.dune.com/api-reference/connectors/dbt/overview#why-dbt-on-dune) * [Enterprise-Grade Transformations](https://docs.dune.com/api-reference/connectors/dbt/overview#enterprise-grade-transformations) * [Seamless Integration](https://docs.dune.com/api-reference/connectors/dbt/overview#seamless-integration) * [No Spellbook Dependency](https://docs.dune.com/api-reference/connectors/dbt/overview#no-spellbook-dependency) * [Connection Details](https://docs.dune.com/api-reference/connectors/dbt/overview#connection-details) * [Use Cases](https://docs.dune.com/api-reference/connectors/dbt/overview#use-cases) * [Enterprise Data Pipelines](https://docs.dune.com/api-reference/connectors/dbt/overview#enterprise-data-pipelines) * [Governance & Compliance](https://docs.dune.com/api-reference/connectors/dbt/overview#governance-%26-compliance) * [Complex Analytics Workflows](https://docs.dune.com/api-reference/connectors/dbt/overview#complex-analytics-workflows) * [Alternative to Spellbook](https://docs.dune.com/api-reference/connectors/dbt/overview#alternative-to-spellbook) * [Next Steps](https://docs.dune.com/api-reference/connectors/dbt/overview#next-steps) * [SQLMesh Compatibility](https://docs.dune.com/api-reference/connectors/dbt/overview#sqlmesh-compatibility) The dbt Connector enables you to run production-grade dbt projects directly against Dune’s data warehouse using the [dbt-trino adapter](https://docs.getdbt.com/docs/core/connect-data-platform/trino-setup) . Build, test, and deploy transformation pipelines with full support for incremental models, testing frameworks, and CI/CD orchestration. This connector provides **write access to DuneSQL** via a Trino API endpoint, enabling you to create, update, and manage tables in your private namespace while reading from Dune’s comprehensive blockchain datasets.[dbt Template Repository\ -----------------------\ \ Get started quickly with our official dbt template repository, featuring example models for all model strategies and CI/CD workflows.](https://github.com/duneanalytics/dune-dbt-template) The dbt Connector is currently only available to Enterprise customers with Data Transformations enabled. Interested in having the dbt Connector enabled for your team? [Contact our team](https://dune.com/enterprise) —please mention the dbt Connector when you reach out. **Credits & CI/CD**Each dbt run consumes Dune credits, including runs triggered by CI/CD pipelines. If you’re using GitHub Actions or similar tools, we recommend reviewing [Pricing & Best Practices](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices) for optimization tips and [CI/CD & Workflows](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows) for guidance on configuring triggers. [​](https://docs.dune.com/api-reference/connectors/dbt/overview#video-tutorial) Video Tutorial ------------------------------------------------------------------------------------------------- Watch this step-by-step guide to get started with the dbt Connector on Dune: [​](https://docs.dune.com/api-reference/connectors/dbt/overview#what-is-dbt) What is dbt? -------------------------------------------------------------------------------------------- [dbt (data build tool)](https://www.getdbt.com/) is the industry-standard framework for analytics engineering. It enables data teams to transform raw data into analysis-ready datasets using SQL and software engineering best practices. **Key capabilities:** * **SQL-based transformations**: Write SELECT statements, dbt handles the DDL/DML * **Incremental models**: Efficiently update large tables with merge, append, or delete+insert strategies * **Testing & documentation**: Built-in data quality tests and auto-generated documentation * **Version control**: Manage transformation logic in Git with code review workflows * **Dependency management**: Define relationships between models with automatic execution ordering [dbt Documentation\ -----------------\ \ Learn more about dbt’s features, best practices, and advanced capabilities in the official dbt documentation.](https://docs.getdbt.com/) [​](https://docs.dune.com/api-reference/connectors/dbt/overview#why-dbt-on-dune) Why dbt on Dune? ---------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/overview#enterprise-grade-transformations) Enterprise-Grade Transformations * **Full incremental support**: Use merge, delete+insert, or append strategies for efficient updates * **Testing framework**: Validate data quality with dbt’s built-in testing capabilities * **Documentation**: Generate and maintain documentation alongside your transformations * **Modularity**: Build reusable models and macros for complex transformation logic ### [​](https://docs.dune.com/api-reference/connectors/dbt/overview#seamless-integration) Seamless Integration * **Drop-in compatibility**: Works with your existing dbt projects and workflows * **Version control**: Manage transformation logic in Git with PR reviews * **Production orchestration**: Schedule with GitHub Actions, Airflow, Prefect, or dbt Cloud. See [Pricing & Best Practices](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices) for credit optimization tips * **Private by default**: Keep proprietary transformation logic within your organization ### [​](https://docs.dune.com/api-reference/connectors/dbt/overview#no-spellbook-dependency) No Spellbook Dependency * **Autonomous deployment**: Deploy transformations on your schedule without community review * **Proprietary logic**: Keep sensitive business logic private * **Faster iteration**: Test and deploy changes immediately [​](https://docs.dune.com/api-reference/connectors/dbt/overview#connection-details) Connection Details --------------------------------------------------------------------------------------------------------- Connect to Dune using these parameters: | Parameter | Value | | --- | --- | | **Host** | `trino.api.dune.com` | | **Port** | `443` | | **Protocol** | HTTPS | | **Catalog** | `dune` (required) | | **Authentication** | JWT (use your Dune API key) | | **Session Property** | `transformations=true` (required for write operations) | The session property `transformations=true` is **required** for all write operations. Without it, DDL and DML statements will be rejected. [​](https://docs.dune.com/api-reference/connectors/dbt/overview#use-cases) Use Cases --------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/overview#enterprise-data-pipelines) Enterprise Data Pipelines Add Dune to your existing data infrastructure without reworking your workflows: * **Drop-in compatibility**: Integrate with your current dbt projects, Airflow DAGs, or Prefect flows * **Full incremental support**: Use merge, delete+insert, or append strategies for efficient updates * **Production orchestration**: Schedule with the tools you already use (GitHub Actions, Airflow, Prefect) * **Version controlled**: Keep all transformation logic in Git alongside your other data pipelines ### [​](https://docs.dune.com/api-reference/connectors/dbt/overview#governance-&-compliance) Governance & Compliance Meet enterprise requirements for data control and auditability: * **Private by default**: All datasets remain private to your team unless explicitly shared * **Audit trails**: Track every transformation through Git history and PR workflows * **Data lineage**: Maintain clear lineage from raw data through transformations to analytics * **Review processes**: Implement PR reviews and approval workflows before deploying to production * **Access control**: Restrict write access to specific teams and namespaces ### [​](https://docs.dune.com/api-reference/connectors/dbt/overview#complex-analytics-workflows) Complex Analytics Workflows Build sophisticated multi-stage data pipelines: * Read from Dune’s comprehensive blockchain datasets across all chains * Transform and enrich with your proprietary business logic * Create reusable intermediate datasets for downstream analytics * Chain multiple transformations into complex data products ### [​](https://docs.dune.com/api-reference/connectors/dbt/overview#alternative-to-spellbook) Alternative to Spellbook Build and maintain custom datasets without community review processes: * Deploy transformations on your own schedule * Keep proprietary logic private to your organization * Faster iteration cycles without PR review delays [​](https://docs.dune.com/api-reference/connectors/dbt/overview#next-steps) Next Steps ----------------------------------------------------------------------------------------- [Getting Started\ ---------------\ \ Set up your dbt project and connect to Dune](https://docs.dune.com/api-reference/connectors/dbt/getting-started) [Incremental Models\ ------------------\ \ Learn about merge, delete+insert, and append strategies](https://docs.dune.com/api-reference/connectors/dbt/incremental-models) [CI/CD & Workflows\ -----------------\ \ Set up GitHub Actions and development workflows](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows) [Pricing & Best Practices\ ------------------------\ \ Understand credit consumption and optimization tips](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices) [​](https://docs.dune.com/api-reference/connectors/dbt/overview#sqlmesh-compatibility) SQLMesh Compatibility --------------------------------------------------------------------------------------------------------------- [SQLMesh](https://sqlmesh.com/) also works out of the box with Dune using the same Trino connection approach described above. If you prefer SQLMesh over dbt for your data transformation workflows, you can connect it to Dune using the [SQLMesh Trino adapter](https://sqlmesh.readthedocs.io/en/stable/integrations/engines/trino/) with the same connection parameters.We plan to release a dedicated SQLMesh template in the future. Until then, follow the same connection setup (host, port, authentication, and session properties) to get started with SQLMesh on Dune. Was this page helpful? YesNo [Data API Overview](https://docs.dune.com/api-reference/api-overview) [Getting Started](https://docs.dune.com/api-reference/connectors/dbt/getting-started) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Trino Connector Overview - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/trino/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation BI Visualization Tools Trino Connector Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Compatible Tools](https://docs.dune.com/api-reference/connectors/trino/overview#compatible-tools) * [Connection Parameters](https://docs.dune.com/api-reference/connectors/trino/overview#connection-parameters) * [Supported SQL Operations](https://docs.dune.com/api-reference/connectors/trino/overview#supported-sql-operations) * [Rate Limits](https://docs.dune.com/api-reference/connectors/trino/overview#rate-limits) * [Billing & Cost](https://docs.dune.com/api-reference/connectors/trino/overview#billing-%26-cost) * [Limitations](https://docs.dune.com/api-reference/connectors/trino/overview#limitations) Access Dune’s blockchain data from your favorite BI tools and clients using the DuneSQL Trino/Presto connector. Connect Dune with popular tools like Hex, Metabase, DBeaver, and any Trino, Presto, or Starburst-compatible application for seamless data analysis. ![Dune Trino Presto connector architecture diagram showing integration flow](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/trino%20-%20light.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=fbf8a40628116abb9567d03381f2a93f)![Dune Trino Presto connector architecture diagram showing integration flow](https://mintcdn.com/dune/Sfv_5QdqAPVofYTY/images/trino-presto-connector/trino%20-%20dark.png?w=2500&fit=max&auto=format&n=Sfv_5QdqAPVofYTY&q=85&s=3a7f184dcde5a798fc1f4b864d77b848) The DuneSQL Trino Connector is currently only available to Plus and Enterprise customers. [​](https://docs.dune.com/api-reference/connectors/trino/overview#compatible-tools) Compatible Tools ------------------------------------------------------------------------------------------------------- Dune’s Trino connector supports any tool that works with Trino, Presto, or Starburst connectors. Popular Dune integrations include: [Hex\ ---\ \ Connect Dune to Hex’s notebook-native analytics via built-in Trino connector.](https://docs.dune.com/api-reference/connectors/trino/hex) [Metabase\ --------\ \ Integrate Dune with Metabase using the Starburst/Trino driver for BI dashboards.](https://docs.dune.com/api-reference/connectors/trino/metabase) [DBeaver\ -------\ \ Connect Dune to DBeaver using the Trino driver for direct SQL access to blockchain data.](https://docs.dune.com/api-reference/connectors/trino/dbeaver) [Trino SDKs\ ----------\ \ Treat Dune like a Database in your language of choice with popular Trino libraries.](https://docs.dune.com/api-reference/connectors/trino/sdks) Any of the supported client applications listed in the [Trino ecosystem](https://trino.io/ecosystem/#official-client-applications) are supported. Please visit their documentation to learn about their specific connection instructions, though the configuration should generally follow the same pattern using the connection parameters below. [​](https://docs.dune.com/api-reference/connectors/trino/overview#connection-parameters) Connection Parameters ----------------------------------------------------------------------------------------------------------------- Use these values in your Trino, Presto, or Starburst client configuration: | Parameter | Value | Description | | --- | --- | --- | | Host | `trino.api.dune.com` | Dune’s Trino/Presto endpoint | | Port | `443` | Standard HTTPS port | | Username | `dune` | Fixed username for all connections | | Password | `` | [Your Dune API key](https://docs.dune.com/api-reference/overview/authentication) | | Catalog | `delta_prod` | Main data catalog | | SSL/TLS | `true` | Always use encrypted connections | | HTTP scheme | `https` | Required for secure connections | If you need an API key, see our guide on [Authentication](https://docs.dune.com/api-reference/overview/authentication) . Remember to keep your API keys secret and rotate them immediately if they are ever exposed. [​](https://docs.dune.com/api-reference/connectors/trino/overview#supported-sql-operations) Supported SQL Operations ----------------------------------------------------------------------------------------------------------------------- Queries executed via the connector align with what you can run on the Dune platform. See the [Query Engine overview](https://docs.dune.com/query-engine/overview) for more information on supported functions and syntax. [​](https://docs.dune.com/api-reference/connectors/trino/overview#rate-limits) Rate Limits --------------------------------------------------------------------------------------------- Rate limits for the connector mirror those of the Dune Data API. Please refer to the [Rate Limits](https://docs.dune.com/api-reference/overview/rate-limits) documentation for details. [​](https://docs.dune.com/api-reference/connectors/trino/overview#billing-&-cost) Billing & Cost --------------------------------------------------------------------------------------------------- All queries run via the connector are executed on the [Large Query Engine](https://docs.dune.com/query-engine/query-executions#query-engine-size) . Credits are consumed based on actual compute resources used. In addition, fetching results consumes credits proportional to the number of datapoints returned. For a full breakdown, please see our documentation on [Billing](https://docs.dune.com/api-reference/overview/billing) . [​](https://docs.dune.com/api-reference/connectors/trino/overview#limitations) Limitations --------------------------------------------------------------------------------------------- The connector currently has limited support for metadata discovery queries such as `SHOW TABLES` or `SHOW SCHEMAS`. This may impact the data source browsing and autocomplete experience within some BI tools. For schema and table discovery, see the [Data Explorer](https://docs.dune.com/web-app/query-editor/data-explorer) guide. If you encounter timeouts with large result sets, consider paginating your queries using `LIMIT` and `OFFSET`, narrowing your filters, or splitting complex queries into smaller, more manageable parts. Was this page helpful? YesNo [Supported SQL Operations](https://docs.dune.com/api-reference/connectors/sql-operations) [Hex](https://docs.dune.com/api-reference/connectors/trino/hex) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # CI/CD & Workflows - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Transform your Data CI/CD & Workflows [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Understanding Credit Costs in CI/CD](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#understanding-credit-costs-in-ci%2Fcd) * [Development Workflow](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#development-workflow) * [Local Development](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#local-development) * [Pull Request Workflow](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#pull-request-workflow) * [Production Deployment](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#production-deployment) * [CI/CD with GitHub Actions](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#ci%2Fcd-with-github-actions) * [CI Workflow (.github/workflows/ci.yml)](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#ci-workflow-github%2Fworkflows%2Fci-yml) * [Production Workflow (.github/workflows/prod.yml)](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#production-workflow-github%2Fworkflows%2Fprod-yml) * [Troubleshooting](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#troubleshooting) * [Connection Issues](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#connection-issues) * [Models Not Appearing in Dune](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#models-not-appearing-in-dune) * [Incremental Models Not Working](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#incremental-models-not-working) * [CI/CD Failures](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#ci%2Fcd-failures) * [Limitations](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#limitations) * [Metadata Discovery](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#metadata-discovery) * [Result Set Size](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#result-set-size) * [Read-After-Write Consistency](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#read-after-write-consistency) * [Rate Limits](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#rate-limits) The dbt template includes pre-configured GitHub Actions workflows for both CI and production deployments. **Credit Usage in CI/CD**All dbt executions triggered by CI/CD workflows consume Dune credits. This includes pull request workflows, deploy workflows, and scheduled runs. The template repository ships with automated triggers **disabled by default** so you can enable them on your own terms. See [Pricing & Best Practices](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices) for optimization guidance. [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#understanding-credit-costs-in-ci/cd) Understanding Credit Costs in CI/CD ------------------------------------------------------------------------------------------------------------------------------------------------- When you run dbt models through CI/CD, each execution consumes credits from your Dune plan. Here are a few things to keep in mind: * **Each push or PR can trigger a pipeline run.** If your GitHub Actions run on every commit, frequent pushes during development will each use credits. * **All executions draw from the same pool.** Whether a query is triggered locally, from a CI runner, or a scheduled job, it counts the same way. * **Concurrent executions add up.** Multiple CI jobs running simultaneously (e.g., several open PRs) each consume credits independently. * **Timed-out queries still use credits.** If a query runs for 30 minutes before timing out, credits are consumed for the compute used during that time. **Tips for managing costs:** * Start with `workflow_dispatch` (manual trigger only) until you’ve validated your models * Use `--select state:modified` to only run changed models in CI * Set appropriate query timeouts to keep costs predictable * Monitor your credit usage in the Dune dashboard after enabling automated workflows [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#development-workflow) Development Workflow ------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#local-development) Local Development 1. **Create a feature branch**: Copy Ask AI git checkout -b feature/new-transformation 2. **Develop models locally**: Copy Ask AI # Run specific model uv run dbt run --select my_model # Run with full refresh (ignore incremental logic) uv run dbt run --select my_model --full-refresh # Run tests for specific model uv run dbt test --select my_model 3. **Query your tables on Dune**: * Remember to use the `dune.` catalog prefix: Copy Ask AI SELECT * FROM dune.my_team__tmp_alice.my_model ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#pull-request-workflow) Pull Request Workflow 1. **Push changes and open PR**: Copy Ask AI git add . git commit -m "Add new transformation model" git push origin feature/new-transformation 2. **Automated CI runs**: * CI enforces that branch is up-to-date with main * Runs modified models with `--full-refresh` in isolated schema `{team}__tmp_pr{number}` * Runs tests on modified models * Tests incremental run logic **Tip:** The pull request workflow is disabled by default in the template. To enable it, uncomment the `on:` trigger block in `.github/workflows/dbt_ci.yml`. Each PR sync event (new commits pushed to a PR branch) will trigger a run and consume credits. 3. **Team review**: * Review transformation logic in GitHub * Check CI results * Approve and merge when ready ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#production-deployment) Production Deployment The [production workflow](https://github.com/duneanalytics/dune-dbt-template/blob/main/.github/workflows/dbt_prod.yml) includes an hourly schedule (0 \* \* \* \*), but it’s commented out by default. You can enable it by uncommenting the corresponding lines when you’re ready to run production jobs automatically. **Tip:** The deploy and scheduled workflows are disabled by default. Only `workflow_dispatch` (manual trigger) is enabled out of the box. Uncomment the `push` and `schedule` triggers in the respective workflow files when you’re ready to automate. 1. **State comparison**: Uses manifest from previous run to detect changes 2. **Full refresh modified models**: Any changed models run with `--full-refresh` 3. **Incremental run**: All models run with normal incremental logic 4. **Testing**: All models are tested 5. **Notification**: Email sent on failure [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#ci/cd-with-github-actions) CI/CD with GitHub Actions ----------------------------------------------------------------------------------------------------------------------------- The template includes two GitHub Actions workflows: ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#ci-workflow-github/workflows/ci-yml) CI Workflow (`.github/workflows/ci.yml`) Runs on every pull request: Copy Ask AI - Enforces branch is up-to-date with main - Sets DEV_SCHEMA_SUFFIX to pr{number} - Runs modified models with --full-refresh - Tests modified models - Runs incremental logic test - Tests incremental models **Required GitHub Secrets**: * `DUNE_API_KEY` **Required GitHub Variables**: * `DUNE_TEAM_NAME` ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#production-workflow-github/workflows/prod-yml) Production Workflow (`.github/workflows/prod.yml`) Runs hourly on main branch: Copy Ask AI - Downloads previous manifest (for state comparison) - Full refreshes any modified models - Tests modified models - Runs all models (incremental logic) - Tests all models - Uploads manifest for next run - Sends email notification on failure [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#troubleshooting) Troubleshooting --------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#connection-issues) Connection Issues **Problem**: `dbt debug` fails with connection error. **Solution**: * Verify `DUNE_API_KEY` and `DUNE_TEAM_NAME` are set correctly * Check that you have Data Transformations enabled for your team * Ensure `transformations: true` is in session properties ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#models-not-appearing-in-dune) Models Not Appearing in Dune **Problem**: Can’t find tables in Data Explorer or queries. **Solution**: * Check the Connectors section in Data Explorer under “My Data” * Remember to use `dune.` catalog prefix in queries * Verify the table was created in the correct schema ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#incremental-models-not-working) Incremental Models Not Working **Problem**: Incremental models always do full refresh. **Solution**: * Check that `is_incremental()` macro is used correctly * Verify the `unique_key` configuration matches your table structure * Ensure the target table exists before running incrementally ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#ci/cd-failures) CI/CD Failures **Problem**: GitHub Actions failing. **Solution**: * Verify secrets and variables are set correctly in GitHub * Check that branch is up-to-date with main * Review workflow logs for specific errors [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#limitations) Limitations ------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#metadata-discovery) Metadata Discovery Limited support for some metadata discovery queries like `SHOW TABLES` or `SHOW SCHEMAS` in certain contexts. This may affect autocomplete in some BI tools. **Workaround**: Use the [Data Explorer](https://docs.dune.com/web-app/query-editor/data-explorer) or query `information_schema` directly. ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#result-set-size) Result Set Size Large result sets may timeout. Consider: * Paginating with `LIMIT` and `OFFSET` * Narrowing filters to reduce data volume * Breaking complex queries into smaller parts ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#read-after-write-consistency) Read-After-Write Consistency Tables and views are available for querying immediately after creation, but catalog caching may cause brief delays (typically < 60 seconds) before appearing in some listing operations. ### [​](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows#rate-limits) Rate Limits Rate limits for Data Transformations align with the Dune Data API: * Requests are subject to the same rate limiting as API executions * Large query operations run on the [Large Query Engine tier](https://docs.dune.com/query-engine/query-executions#large-engine-size) * See [Rate Limits](https://docs.dune.com/api-reference/overview/rate-limits) for detailed information Was this page helpful? YesNo [Incremental Models](https://docs.dune.com/api-reference/connectors/dbt/incremental-models) [Pricing & Best Practices](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Getting Started - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/dbt/getting-started#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Transform your Data Getting Started [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Prerequisites](https://docs.dune.com/api-reference/connectors/dbt/getting-started#prerequisites) * [1\. Use the Template Repository](https://docs.dune.com/api-reference/connectors/dbt/getting-started#1-use-the-template-repository) * [2\. Configure Environment Variables](https://docs.dune.com/api-reference/connectors/dbt/getting-started#2-configure-environment-variables) * [3\. Configure dbt Profile](https://docs.dune.com/api-reference/connectors/dbt/getting-started#3-configure-dbt-profile) * [4\. Test Your Connection](https://docs.dune.com/api-reference/connectors/dbt/getting-started#4-test-your-connection) * [Project Structure](https://docs.dune.com/api-reference/connectors/dbt/getting-started#project-structure) * [Schema Organization](https://docs.dune.com/api-reference/connectors/dbt/getting-started#schema-organization) * [How It Works](https://docs.dune.com/api-reference/connectors/dbt/getting-started#how-it-works) * [Namespace Isolation](https://docs.dune.com/api-reference/connectors/dbt/getting-started#namespace-isolation) * [Write Operations](https://docs.dune.com/api-reference/connectors/dbt/getting-started#write-operations) * [Data Access](https://docs.dune.com/api-reference/connectors/dbt/getting-started#data-access) * [Querying dbt Models on Dune](https://docs.dune.com/api-reference/connectors/dbt/getting-started#querying-dbt-models-on-dune) * [Where Your Data Appears](https://docs.dune.com/api-reference/connectors/dbt/getting-started#where-your-data-appears) * [Next Steps](https://docs.dune.com/api-reference/connectors/dbt/getting-started#next-steps) The fastest way to get started is using our [dbt template repository](https://github.com/duneanalytics/dune-dbt-template) , which includes pre-configured profiles, sample models, and CI/CD workflows. [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#prerequisites) Prerequisites ------------------------------------------------------------------------------------------------------ * **Dune Enterprise account** with Data Transformations enabled * **Dune API key** ([generate one here](https://dune.com/settings/api) ) * **Team name** on Dune (defines your namespace) * **dbt installed locally** (we recommend using `uv` for dependency management) [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#1-use-the-template-repository) 1\. Use the Template Repository ---------------------------------------------------------------------------------------------------------------------------------------- We provide a complete dbt project template to get started quickly: **GitHub Template**: [github.com/duneanalytics/dune-dbt-template](https://github.com/duneanalytics/dune-dbt-template) The template includes: * Pre-configured dbt profiles for dev and prod environments * Sample models demonstrating all model types * GitHub Actions workflows for CI/CD * Cursor AI rules for dbt best practices on Dune * Example project structure following dbt conventions **CI Workflows Are Disabled by Default**The template repository ships with GitHub Actions CI workflows **disabled by default**. Since each dbt execution consumes Dune credits, we recommend: 1. Running models locally first to get familiar with your pipeline 2. Reviewing the [Pricing & Best Practices](https://docs.dune.com/api-reference/connectors/dbt/pricing-best-practices) guide 3. Enabling workflows when you’re ready by uncommenting triggers in the workflow files (see the [template README](https://github.com/duneanalytics/dune-dbt-template#-note-) for instructions) **To use the template:** Copy Ask AI # Create a new repository from the template # (Use GitHub's "Use this template" button) # Clone your new repository git clone https://github.com/your-org/your-dbt-project.git cd your-dbt-project # Install dependencies uv sync # Set up environment variables (see next section) [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#2-configure-environment-variables) 2\. Configure Environment Variables ------------------------------------------------------------------------------------------------------------------------------------------------ Set these required environment variables: Copy Ask AI # Required export DUNE_API_KEY="your_api_key_here" export DUNE_TEAM_NAME="your_team_name" # Optional - for personal dev environments export DEV_SCHEMA_SUFFIX="alice" **Persistence options:** Copy Ask AI # Option 1: Add to shell profile (recommended for local dev) echo 'export DUNE_API_KEY="your_key"' >> ~/.zshrc echo 'export DUNE_TEAM_NAME="your_team"' >> ~/.zshrc source ~/.zshrc # Option 2: Use a .env file (remember to add to .gitignore!) # Option 3: Set in CI/CD secrets for production deployments [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#3-configure-dbt-profile) 3\. Configure dbt Profile ---------------------------------------------------------------------------------------------------------------------------- Your `profiles.yml` should look like this: Copy Ask AI dune: outputs: dev: type: trino method: jwt user: "{{ env_var('DUNE_TEAM_NAME') }}" jwt_token: "{{ env_var('DUNE_API_KEY') }}" host: trino.api.dune.com port: 443 database: dune schema: "{{ env_var('DUNE_TEAM_NAME') }}__tmp_{{ env_var('DEV_SCHEMA_SUFFIX', '') }}" http_scheme: https session_properties: transformations: true prod: type: trino method: jwt user: "{{ env_var('DUNE_TEAM_NAME') }}" jwt_token: "{{ env_var('DUNE_API_KEY') }}" host: trino.api.dune.com port: 443 database: dune schema: "{{ env_var('DUNE_TEAM_NAME') }}" http_scheme: https session_properties: transformations: true target: dev The `transformations: true` session property is **required**. This tells Dune that you’re running data transformation operations that need write access. [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#4-test-your-connection) 4\. Test Your Connection -------------------------------------------------------------------------------------------------------------------------- Copy Ask AI # Install dbt dependencies uv run dbt deps # Test connection uv run dbt debug # Run your first model uv run dbt run # Run tests uv run dbt test [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#project-structure) Project Structure -------------------------------------------------------------------------------------------------------------- The template repository follows standard dbt conventions: Copy Ask AI your-dbt-project/ ├── models/ │ ├── templates/ # Example models for each strategy │ │ ├── dbt_template_view_model.sql │ │ ├── dbt_template_table_model.sql │ │ ├── dbt_template_merge_incremental_model.sql │ │ ├── dbt_template_delete_insert_incremental_model.sql │ │ └── dbt_template_append_incremental_model.sql │ └── your_models/ # Your transformation models ├── macros/ │ └── dune_dbt_overrides/ │ └── get_custom_schema.sql # Schema naming logic ├── tests/ # Custom data tests ├── seeds/ # CSV seed files ├── snapshots/ # Snapshot definitions ├── analyses/ # Ad-hoc analyses ├── .github/workflows/ # CI/CD workflows (disabled by default—see note above) ├── profiles.yml # dbt connection profile ├── dbt_project.yml # Project configuration └── README.md [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#schema-organization) Schema Organization ------------------------------------------------------------------------------------------------------------------ Schemas are automatically organized based on your dbt target: | Target | DEV\_SCHEMA\_SUFFIX | Schema Name | Use Case | | --- | --- | --- | --- | | `dev` | Not set | `{team}__tmp_` | Local development (default) | | `dev` | Set to `alice` | `{team}__tmp_alice` | Personal dev space | | `dev` | Set to `pr123` | `{team}__tmp_pr123` | CI/CD per PR | | `prod` | (any) | `{team}` | Production tables | This is controlled by the `get_custom_schema.sql` macro in the template. [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#how-it-works) How It Works ---------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#namespace-isolation) Namespace Isolation All tables and views you create are organized into your team’s namespace: * **Production schema**: `{your_team}` - For production tables * **Development schemas**: `{your_team}__tmp_*` - For development and testing This ensures complete isolation between teams and between development/production environments. ### [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#write-operations) Write Operations Execute SQL statements to create and manage your data: 1. **Create tables and views** in your namespace 2. **Insert, update, or merge** data using standard SQL 3. **Drop tables** when no longer needed 4. **Optimize and vacuum** tables for optimal performance when querying these tables All operations are authenticated via your Dune API key and restricted to your team’s namespace. ### [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#data-access) Data Access **What You Can Read:** * **All public Dune datasets**: Full access to blockchain data across all supported chains * **Your uploaded data**: Private datasets you’ve uploaded to Dune * **Your transformation outputs**: Tables and views created in your namespace * **Materialized views**: Views that are materialized as tables in your namespace via the APP **What You Can Write:** * **Your team namespace**: `{team_name}` for production tables * **Development namespaces**: `{team_name}__tmp_*` for dev and testing * **Private by default**: All created tables are private unless explicitly made public **Access Control:** * Write operations are restricted to your team’s namespaces only * Cannot write to public schemas or other teams’ namespaces * Schema naming rules enforced: no `__tmp_` in team handles [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#querying-dbt-models-on-dune) Querying dbt Models on Dune ---------------------------------------------------------------------------------------------------------------------------------- When querying your dbt models in the Dune app or via the API, you **must** use the `dune.` catalog prefix. **Pattern**: `dune.{schema}.{table}` Copy Ask AI -- ❌ Won't work (dbt logs show this but it won't work on Dune) SELECT * FROM my_team.my_model -- ✅ Correct SELECT * FROM dune.my_team.my_model SELECT * FROM dune.my_team__tmp_alice.dev_model dbt logs omit the catalog name for readability, so remember to add `dune.` when using queries in the Dune app. [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#where-your-data-appears) Where Your Data Appears -------------------------------------------------------------------------------------------------------------------------- Tables and views created through dbt appear in the **Data Explorer** under: **My Data → Connectors** ![Data Transformations in Data Explorer under Connectors](https://mintcdn.com/dune/Hf9LNgq7l6rcjPCE/images/data-transformations-explorer.png?w=2500&fit=max&auto=format&n=Hf9LNgq7l6rcjPCE&q=85&s=b5e29cd9a75b97d667c2060453eb10b2) You can: * Browse your transformation datasets * View table schemas and metadata * Delete datasets directly from the UI * Search and reference them in queries [​](https://docs.dune.com/api-reference/connectors/dbt/getting-started#next-steps) Next Steps ------------------------------------------------------------------------------------------------ [Incremental Models\ ------------------\ \ Learn about merge, delete+insert, and append strategies](https://docs.dune.com/api-reference/connectors/dbt/incremental-models) [CI/CD & Workflows\ -----------------\ \ Set up GitHub Actions and development workflows](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows) Was this page helpful? YesNo [dbt Connector Overview](https://docs.dune.com/api-reference/connectors/dbt/overview) [Incremental Models](https://docs.dune.com/api-reference/connectors/dbt/incremental-models) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Incremental Models - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Transform your Data Incremental Models [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [1\. Merge Strategy (Recommended)](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#1-merge-strategy-recommended) * [2\. Delete+Insert Strategy](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#2-delete%2Binsert-strategy) * [3\. Append Strategy](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#3-append-strategy) * [Strategy Comparison](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#strategy-comparison) * [Table Maintenance](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#table-maintenance) * [Manual Maintenance](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#manual-maintenance) * [Automated Maintenance with dbt post-hooks](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#automated-maintenance-with-dbt-post-hooks) * [Project level post-hooks](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#project-level-post-hooks) * [Dropping Tables](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#dropping-tables) * [Option 1: Use dbt’s —full-refresh flag then remove the model](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#option-1-use-dbt%E2%80%99s-%E2%80%94full-refresh-flag-then-remove-the-model) * [Option 2: Connect with a SQL client](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#option-2-connect-with-a-sql-client) * [Examples](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#examples) dbt supports multiple strategies for incremental models. The template includes examples of each strategy to help you get started. [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#1-merge-strategy-recommended) 1\. Merge Strategy (Recommended) ------------------------------------------------------------------------------------------------------------------------------------------- **When to use**: When you need to update existing rows and insert new ones. **Example**: Copy Ask AI {{ config( materialized='incremental', unique_key='user_address', incremental_strategy='merge' ) }} SELECT user_address, COUNT(*) as trade_count, SUM(volume_usd) as total_volume, MAX(block_time) as last_trade_time FROM {{ source('ethereum', 'dex_trades') }} WHERE block_time >= date_trunc('day', now() - interval '1' day) {% if is_incremental() %} AND block_time >= (SELECT MAX(last_trade_time) FROM {{ this }}) {% endif %} GROUP BY 1 [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#2-delete+insert-strategy) 2\. Delete+Insert Strategy --------------------------------------------------------------------------------------------------------------------------------- **When to use**: When recomputing entire partitions (e.g., daily aggregations). **Example**: Copy Ask AI {{ config( materialized='incremental', unique_key='date', incremental_strategy='delete+insert' ) }} SELECT date_trunc('day', block_time) as date, protocol, COUNT(*) as transaction_count, SUM(amount_usd) as volume FROM {{ source('ethereum', 'decoded_events') }} WHERE block_time >= date_trunc('day', now() - interval '7' day) {% if is_incremental() %} AND date_trunc('day', block_time) >= date_trunc('day', now() - interval '1' day) {% endif %} GROUP BY 1, 2 [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#3-append-strategy) 3\. Append Strategy ------------------------------------------------------------------------------------------------------------------- **When to use**: For immutable event logs that only need new rows appended. **Example**: Copy Ask AI {{ config( materialized='incremental', unique_key='tx_hash', incremental_strategy='append' ) }} SELECT tx_hash, block_time, block_number, "from" as from_address, "to" as to_address, value FROM {{ source('ethereum', 'transactions') }} WHERE block_time >= date_trunc('hour', now() - interval '1' hour) {% if is_incremental() %} AND block_time >= (SELECT MAX(block_time) FROM {{ this }}) {% endif %} [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#strategy-comparison) Strategy Comparison --------------------------------------------------------------------------------------------------------------------- | Strategy | Best For | How It Works | | --- | --- | --- | | **Merge** | Updating existing rows + inserting new | Matches on `unique_key`, updates existing, inserts new | | **Delete+Insert** | Recomputing partitions | Deletes matching rows, then inserts new data | | **Append** | Immutable event logs | Only inserts new rows, no updates or deletes | [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#table-maintenance) Table Maintenance ----------------------------------------------------------------------------------------------------------------- Maintenance operations consume credits based on compute and data written. These operations are necessary to keep your tables performant and to reclaim storage space. ### [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#manual-maintenance) Manual Maintenance Run OPTIMIZE and VACUUM to improve performance and reduce storage costs: Copy Ask AI # Optimize a specific table uv run dbt run-operation optimize_table --args '{table_name: "my_model"}' # Vacuum a specific table uv run dbt run-operation vacuum_table --args '{table_name: "my_model"}' ### [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#automated-maintenance-with-dbt-post-hooks) Automated Maintenance with dbt post-hooks Add post-hooks to your model configuration: Copy Ask AI {{ config( materialized='incremental', post_hook=[\ "ALTER TABLE {{ this }} EXECUTE OPTIMIZE",\ "ALTER TABLE {{ this }} EXECUTE VACUUM"\ ] ) }} SELECT ... ### [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#project-level-post-hooks) Project level post-hooks Add post-hooks to your project configuration: Copy Ask AI # dbt_project.yml post-hooks: - "ALTER TABLE {{ this }} EXECUTE OPTIMIZE" - "ALTER TABLE {{ this }} EXECUTE VACUUM" The [template repository](https://github.com/duneanalytics/dune-dbt-template) includes a default post-hook that runs OPTIMIZE and VACUUM on all tables. [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#dropping-tables) Dropping Tables ------------------------------------------------------------------------------------------------------------- dbt doesn’t have a built-in way to drop tables. Options: ### [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#option-1-use-dbt%E2%80%99s-%E2%80%94full-refresh-flag-then-remove-the-model) Option 1: Use dbt’s —full-refresh flag then remove the model Copy Ask AI # This will drop and recreate uv run dbt run --select my_model --full-refresh # Then delete the model file and run again rm models/my_model.sql uv run dbt run ### [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#option-2-connect-with-a-sql-client) Option 2: Connect with a SQL client Use any Trino-compatible client (Hex, Jupyter, DBeaver) to execute: Copy Ask AI DROP TABLE IF EXISTS dune.your_team.old_model; See the [SQL Operations Reference](https://docs.dune.com/api-reference/connectors/sql-operations) for details. [​](https://docs.dune.com/api-reference/connectors/dbt/incremental-models#examples) Examples ----------------------------------------------------------------------------------------------- Complete examples are available in the template repository: * **View Model**: Lightweight, always fresh data * **Table Model**: Static snapshots for specific points in time * **Merge Incremental**: Update existing rows, insert new ones * **Delete+Insert Incremental**: Recompute partitions efficiently * **Append Incremental**: Add-only with deduplication [dbt Template Repository\ -----------------------\ \ See all example models in our official dbt template repository](https://github.com/duneanalytics/dune-dbt-template) Was this page helpful? YesNo [Getting Started](https://docs.dune.com/api-reference/connectors/dbt/getting-started) [CI/CD & Workflows](https://docs.dune.com/api-reference/connectors/dbt/cicd-workflows) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Trino SDKs - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/connectors/trino/sdks#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation BI Visualization Tools Trino SDKs [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Code Examples](https://docs.dune.com/api-reference/connectors/trino/sdks#code-examples) * [Connection Parameters](https://docs.dune.com/api-reference/connectors/trino/sdks#connection-parameters) Connect to Dune using Trino SDKs in your preferred language. Dune supports any Trino, Presto, or Starburst-compatible client library. [​](https://docs.dune.com/api-reference/connectors/trino/sdks#code-examples) Code Examples --------------------------------------------------------------------------------------------- * Bash * TypeScript * Python * Rust * Go * Ruby Copy Ask AI # Install: brew install trino trino --server https://trino.api.dune.com:443 \ --user dune --password \ --catalog delta_prod \ --schema runtime \ --execute "SELECT count(*) FROM base.transactions WHERE block_time > now() - interval '1' day" Copy Ask AI import { Trino, BasicAuth } from "trino-client"; const trino = Trino.create({ server: "https://trino.api.dune.com:443", catalog: "delta_prod", schema: "runtime", auth: new BasicAuth("dune", process.env.DUNE_API_KEY), }); const iter = await trino.query("SELECT count(*) FROM base.transactions WHERE block_time > now() - interval '1' day"); for await (const result of iter) { console.log(result.data); } Copy Ask AI import trino import os conn = trino.dbapi.connect( host='trino.api.dune.com', port=443, user='dune', catalog='delta_prod', schema='runtime', auth=trino.auth.BasicAuthentication('dune', os.environ['DUNE_API_KEY']), http_scheme='https' ) cursor = conn.cursor() cursor.execute("SELECT count(*) FROM base.transactions WHERE block_time > now() - interval '1' day") print(cursor.fetchall()) Copy Ask AI use prusto::{ClientBuilder, Presto}; #[derive(Presto, Debug)] struct Foo { a: i64, b: f64, c: String, } #[tokio::main] async fn main() { let cli = ClientBuilder::new("user", "localhost") .port(8090) .catalog("catalog") .build() .unwrap(); let sql = "select 1 as a, cast(1.1 as double) as b, 'bar' as c "; let data = cli.get_all::(sql.into()).await.unwrap().into_vec(); for r in data { println!("{:?}", r) } } Copy Ask AI import "database/sql" import _ "github.com/trinodb/trino-go-client/trino" dsn := "http://user@localhost:8080?catalog=default&schema=test" db, err := sql.Open("trino", dsn) Copy Ask AI require 'trino-client' # create a client object: client = Trino::Client.new( server: "localhost:8880", # required option ssl: {verify: false}, catalog: "native", schema: "default", user: "frsyuki", password: "********", time_zone: "US/Pacific", language: "English", properties: { "hive.force_local_scheduling": true, "raptor.reader_stream_buffer_size": "32MB" }, http_proxy: "proxy.example.com:8080", http_debug: true ) # run a query and get results as an array of arrays: columns, rows = client.run("select * from sys.node") rows.each {|row| p row # row is an array } # run a query and get results as an array of hashes: results = client.run_with_names("select alpha, 1 AS beta from tablename") results.each {|row| p row['alpha'] # access by name p row['beta'] p row.values[0] # access by index p row.values[1] } # run a query and fetch results streamingly: client.query("select * from sys.node") do |q| # get columns: q.columns.each {|column| puts "column: #{column.name}.#{column.type}" } # get query results. it feeds more rows until # query execution finishes: q.each_row {|row| p row # row is an array } end # killing a query query = client.query("select * from sys.node") query_id = query.query_info.query_id query.each_row {|row| ... } # when a thread is processing the query, client.kill(query_id) # another thread / process can kill the query. # Use Query#transform_row to parse Trino ROW types into Ruby Hashes. # You can also set a scalar_parser to parse scalars how you'd like them. scalar_parser = -> (data, type) { (type === 'json') ? JSON.parse(data) : data } client.query("select * from sys.node") do |q| q.scalar_parser = scalar_parser # get query results. it feeds more rows until # query execution finishes: q.each_row {|row| p q.transform_row(row) } end Besides the code samples shown above, Trino supports a variety of other official and unofficial SDKs. Please check the [official Trino SDKs page](https://trino.io/ecosystem/client-driver#official-client-drivers) to see which ones are available and to view their GitHub repositories for updated code samples and documentation. [​](https://docs.dune.com/api-reference/connectors/trino/sdks#connection-parameters) Connection Parameters ------------------------------------------------------------------------------------------------------------- For all SDK integrations, use the following connection parameters: | Parameter | Value | | --- | --- | | Host | `trino.api.dune.com` | | Port | `443` | | Username | `dune` | | Password | Your Dune API key | | Catalog | `delta_prod` | | HTTP scheme | `https` | See the [Overview](https://docs.dune.com/api-reference/connectors/trino/overview#connection-parameters) for complete connection details. Was this page helpful? YesNo [DBeaver](https://docs.dune.com/api-reference/connectors/trino/dbeaver) [Datashare Overview](https://docs.dune.com/datashare/datashare) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Dune MCP - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/agents/mcp#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Agents Dune MCP [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Connect Dune MCP](https://docs.dune.com/api-reference/agents/mcp#connect-dune-mcp) * [Claude Code](https://docs.dune.com/api-reference/agents/mcp#claude-code) * [Claude Desktop / Web App](https://docs.dune.com/api-reference/agents/mcp#claude-desktop-%2F-web-app) * [OpenCode](https://docs.dune.com/api-reference/agents/mcp#opencode) * [Codex](https://docs.dune.com/api-reference/agents/mcp#codex) * [Cursor](https://docs.dune.com/api-reference/agents/mcp#cursor) * [ChatGPT](https://docs.dune.com/api-reference/agents/mcp#chatgpt) * [Key Benefits](https://docs.dune.com/api-reference/agents/mcp#key-benefits) * [Use Cases](https://docs.dune.com/api-reference/agents/mcp#use-cases) MCP (Model Context Protocol) is an open-source standard for connecting AI applications to external systems. Dune MCP gives your agent direct, structured access to Dune workflows: discover the right tables, create and run queries, inspect results, and create visualizations in the same conversation. This is the fastest way to move from prompt to reliable onchain analysis. Dune MCP currently ships with these official tools: | Category | Tool | Description | | --- | --- | --- | | **Discovery** | `searchDocs` | Search Dune docs for guides, examples, and API references | | **Discovery** | `searchTables` | Find tables by protocol, chain, category, or schema | | **Discovery** | `listBlockchains` | List indexed blockchains with table counts | | **Discovery** | `searchTablesByContractAddress` | Find decoded event/call tables for a contract address | | **Query Lifecycle** | `createDuneQuery` | Create and save a new Dune query | | **Query Lifecycle** | `getDuneQuery` | Fetch SQL and metadata for an existing query | | **Query Lifecycle** | `updateDuneQuery` | Update SQL, title, description, tags, or parameters | | **Query Lifecycle** | `executeQueryById` | Execute a saved query and return an execution ID | | **Query Lifecycle** | `getExecutionResults` | Fetch status and results for a query execution | | **Visualization** | `generateVisualization` | Create charts, counters, and tables from query results | | **Account** | `getUsage` | Check current billing-period credit usage | [​](https://docs.dune.com/api-reference/agents/mcp#connect-dune-mcp) Connect Dune MCP ---------------------------------------------------------------------------------------- All clients authenticate to Dune MCP with your [Dune API key](https://docs.dune.com/api-reference/overview/authentication) . * MCP endpoint: `https://api.dune.com/mcp/v1` * Header auth: `x-dune-api-key: ` * Query auth (for clients that prefer URL auth): `?api_key=` OAuth with your Dune account is coming soon. For now, authenticate with a Dune API key. ### [​](https://docs.dune.com/api-reference/agents/mcp#claude-code) Claude Code Copy Ask AI claude mcp add --scope user --transport http dune https://api.dune.com/mcp/v1 --header "x-dune-api-key: " ### [​](https://docs.dune.com/api-reference/agents/mcp#claude-desktop-/-web-app) Claude Desktop / Web App ### [​](https://docs.dune.com/api-reference/agents/mcp#opencode) OpenCode ![Connect opencode to Dune MCP](https://mintcdn.com/dune/uuYoKpKP5Xcm0UmT/images/open_code.png?w=2500&fit=max&auto=format&n=uuYoKpKP5Xcm0UmT&q=85&s=2ecc4eb1cd8cba85c51ccb95b99447c9) ### [​](https://docs.dune.com/api-reference/agents/mcp#codex) Codex Copy Ask AI codex mcp add dune_prod --url "https://api.dune.com/mcp/v1?api_key=" **Known issue: “Transport closed” errors during long-running queries**Codex’s MCP client has a default tool timeout of 60 seconds. When `getExecutionResults` polls for a query that takes longer than this, Codex terminates the connection. Due to a [known Codex bug](https://github.com/openai/codex/issues/11489) , the MCP transport does not auto-reconnect after a timeout — all subsequent tool calls will fail with `Transport closed` until you start a new session.**Workaround:** Increase the Codex tool timeout in your config: Copy Ask AI [mcp_servers.dune] url = "https://api.dune.com/mcp/v1?api_key=" tool_timeout_sec = 300 ### [​](https://docs.dune.com/api-reference/agents/mcp#cursor) Cursor Add this configuration to your Cursor settings: Copy Ask AI { "mcpServers": { "dune": { "url": "https://api.dune.com/mcp/v1", "headers": { "X-DUNE-API-KEY": "" } } } } ### [​](https://docs.dune.com/api-reference/agents/mcp#chatgpt) ChatGPT ChatGPT support is planned via OAuth and will be documented here once available. * * * [​](https://docs.dune.com/api-reference/agents/mcp#key-benefits) Key Benefits -------------------------------------------------------------------------------- Natural Language to SQL ----------------------- Describe the question in plain English and let your agent discover tables, draft SQL, and return results. Cross-Chain Coverage -------------------- Work across Dune’s indexed chains through one MCP interface, with discovery and query tools in the same flow. End-to-End Workflow ------------------- Go from question to execution to visualization in one conversation without switching apps. [​](https://docs.dune.com/api-reference/agents/mcp#use-cases) Use Cases -------------------------------------------------------------------------- Protocol Analytics ------------------ Track core metrics like volume, users, or activity using curated and decoded datasets. Wallet Intelligence ------------------- Analyze wallet behavior, holdings, and flows across multiple chains from a single prompt. Market Research --------------- Compare sectors, tokens, and venues with reusable query and visualization workflows. Data Workflow Prototyping ------------------------- Iterate quickly on query ideas, validate results, and turn them into saved assets. Was this page helpful? YesNo [Build Custom Dashboards & Reports](https://docs.dune.com/api-reference/apis/quickstart-dashboards) [CLI & Skills](https://docs.dune.com/api-reference/agents/cli-and-skills) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Get Dataset - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/datasets/endpoint/get#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Datasets Get Dataset [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) Get a dataset by slug cURL Copy Copy curl --request GET \ --url https://api.dune.com/api/v1/datasets/{slug} \ --header 'X-Dune-Api-Key: ' 200 400 401 403 404 500 Copy Copy { "columns": [\ {\ "metadata": {\ "description": "",\ "filtering_column": true\ },\ "name": "",\ "nullable": true,\ "type": ""\ }\ ], "created_at": "", "full_name": "", "is_private": true, "metadata": {}, "owner": { "handle": "", "type": "" }, "type": "", "updated_at": "" } GET / v1 / datasets / {slug} Try it Get a dataset by slug cURL Copy Copy curl --request GET \ --url https://api.dune.com/api/v1/datasets/{slug} \ --header 'X-Dune-Api-Key: ' 200 400 401 403 404 500 Copy Copy { "columns": [\ {\ "metadata": {\ "description": "",\ "filtering_column": true\ },\ "name": "",\ "nullable": true,\ "type": ""\ }\ ], "created_at": "", "full_name": "", "is_private": true, "metadata": {}, "owner": { "handle": "", "type": "" }, "type": "", "updated_at": "" } * Retrieve detailed information about a specific dataset by its slug - Returns complete schema including all columns with data types - Includes ownership details and metadata - Example slugs: `dex.trades`, `tokens.erc20`, `ethereum.transactions` [​](https://docs.dune.com/api-reference/datasets/endpoint/get#use-cases) Use Cases ===================================================================================== * **Schema Discovery**: Retrieve the complete schema of a dataset including column names, data types, and nullability. * **Table Exploration**: Understand the structure of a dataset before writing queries against it. * **Data Integration**: Programmatically fetch table schemas for ETL pipelines and data integration tools. * **Documentation Generation**: Automatically generate documentation for datasets based on their schemas. * **Validation**: Verify dataset structure and columns before building queries or applications. #### Headers [​](https://docs.dune.com/api-reference/datasets/endpoint/get#parameter-x-dune-api-key) X-Dune-Api-Key string required API Key for the service #### Path Parameters [​](https://docs.dune.com/api-reference/datasets/endpoint/get#parameter-slug) slug string required Dataset slug (e.g., 'dex.trades') #### Query Parameters [​](https://docs.dune.com/api-reference/datasets/endpoint/get#parameter-api-key) api\_key string API Key, alternative to using the HTTP header X-Dune-Api-Key #### Response 200 application/json OK [​](https://docs.dune.com/api-reference/datasets/endpoint/get#response-columns) columns object\[\] Show child attributes [​](https://docs.dune.com/api-reference/datasets/endpoint/get#response-created-at) created\_at string [​](https://docs.dune.com/api-reference/datasets/endpoint/get#response-full-name) full\_name string [​](https://docs.dune.com/api-reference/datasets/endpoint/get#response-is-private) is\_private boolean [​](https://docs.dune.com/api-reference/datasets/endpoint/get#response-metadata) metadata object [​](https://docs.dune.com/api-reference/datasets/endpoint/get#response-owner) owner object Show child attributes [​](https://docs.dune.com/api-reference/datasets/endpoint/get#response-type) type string [​](https://docs.dune.com/api-reference/datasets/endpoint/get#response-updated-at) updated\_at string Was this page helpful? YesNo [List Datasets](https://docs.dune.com/api-reference/datasets/endpoint/list) [Search Datasets](https://docs.dune.com/api-reference/datasets/endpoint/search) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # List Datasets - Dune Docs [Skip to main content](https://docs.dune.com/api-reference/datasets/endpoint/list#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Datasets List Datasets [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) List datasets cURL Copy Copy curl --request GET \ --url https://api.dune.com/api/v1/datasets \ --header 'X-Dune-Api-Key: ' 200 400 401 403 404 500 Copy Copy { "datasets": [\ {\ "columns": [\ {\ "metadata": {\ "description": "",\ "filtering_column": true\ },\ "name": "",\ "nullable": true,\ "type": ""\ }\ ],\ "created_at": "",\ "full_name": "",\ "is_private": true,\ "metadata": {},\ "owner": {\ "handle": "",\ "type": ""\ },\ "type": "",\ "updated_at": ""\ }\ ], "total": 123 } GET / v1 / datasets Try it List datasets cURL Copy Copy curl --request GET \ --url https://api.dune.com/api/v1/datasets \ --header 'X-Dune-Api-Key: ' 200 400 401 403 404 500 Copy Copy { "datasets": [\ {\ "columns": [\ {\ "metadata": {\ "description": "",\ "filtering_column": true\ },\ "name": "",\ "nullable": true,\ "type": ""\ }\ ],\ "created_at": "",\ "full_name": "",\ "is_private": true,\ "metadata": {},\ "owner": {\ "handle": "",\ "type": ""\ },\ "type": "",\ "updated_at": ""\ }\ ], "total": 123 } [​](https://docs.dune.com/api-reference/datasets/endpoint/list#use-cases) Use Cases ====================================================================================== * **Browse Available Data**: Programmatically discover all tables and datasets available on Dune for querying. * **Filter by Owner**: Find all datasets owned by a specific user or team using `owner_handle` parameter. * **Filter by Type**: Narrow down results to specific dataset types like curated tables, decoded tables, or transformations using the `type` parameter. * **Build Data Catalogs**: Create custom data discovery tools that index and search through Dune’s table ecosystem. * **Access Management**: Audit and manage datasets owned by your team or organization. #### Headers [​](https://docs.dune.com/api-reference/datasets/endpoint/list#parameter-x-dune-api-key) X-Dune-Api-Key string required API Key for the service #### Query Parameters [​](https://docs.dune.com/api-reference/datasets/endpoint/list#parameter-api-key) api\_key string API Key, alternative to using the HTTP header X-Dune-Api-Key [​](https://docs.dune.com/api-reference/datasets/endpoint/list#parameter-limit) limit integer Number of results to return (default 50, max 250) [​](https://docs.dune.com/api-reference/datasets/endpoint/list#parameter-offset) offset integer Offset for pagination [​](https://docs.dune.com/api-reference/datasets/endpoint/list#parameter-owner-handle) owner\_handle string Filter by owner handle [​](https://docs.dune.com/api-reference/datasets/endpoint/list#parameter-type) type string Filter by dataset types (comma-separated: transformation\_view, transformation\_table, uploaded\_table, decoded\_table, spell, dune\_table) #### Response 200 application/json OK [​](https://docs.dune.com/api-reference/datasets/endpoint/list#response-datasets) datasets object\[\] Show child attributes [​](https://docs.dune.com/api-reference/datasets/endpoint/list#response-total) total integer Was this page helpful? YesNo [Overview](https://docs.dune.com/api-reference/datasets/introduction) [Get Dataset](https://docs.dune.com/api-reference/datasets/endpoint/get) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Products Overview - Dune Docs [Skip to main content](https://docs.dune.com/docs/product-comparison#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Products Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Capabilities](https://docs.dune.com/docs/product-comparison#capabilities) * [Query & Architecture](https://docs.dune.com/docs/product-comparison#query-%26-architecture) * [Data Coverage](https://docs.dune.com/docs/product-comparison#data-coverage) * [Interface & Pricing](https://docs.dune.com/docs/product-comparison#interface-%26-pricing) * [Quick Selection Guide](https://docs.dune.com/docs/product-comparison#quick-selection-guide) Dune delivers blockchain data via three core products: **Data Hub**, **Datashare**, and **Sim (Realtime APIs)**. Each product serves different use cases, from ad-hoc analytics to real-time wallet application development. [​](https://docs.dune.com/docs/product-comparison#capabilities) Capabilities ------------------------------------------------------------------------------- What each product is best suited for. | | [Data Hub](https://docs.dune.com/web-app/overview) | [Datashare](https://docs.dune.com/datashare/datashare) | [Sim (Realtime APIs)](https://sim.dune.com/) | | --- | --- | --- | --- | | **Best For** | Primary onchain data warehouse, Analytic workflows, [Data transformations](https://docs.dune.com/api-reference/connectors/dbt/overview) | Data warehouse integration & Interoperability | Build realtime wallets, portfolio apps | | **SQL Access** | ✓ Full SQL | ✓ Full SQL | REST APIs | | **Historical Data** | ✓ Full historical | ✓ Full historical | Realtime | | **Authentication** | Dune account, API key | Warehouse credentials | Sim account, API key | [​](https://docs.dune.com/docs/product-comparison#query-&-architecture) Query & Architecture ----------------------------------------------------------------------------------------------- How each product handles queries and processes data under the hood. | | [Data Hub](https://docs.dune.com/web-app/overview) | [Datashare](https://docs.dune.com/datashare/datashare) | [Sim (Realtime APIs)](https://sim.dune.com/) | | --- | --- | --- | --- | | **Query Infra** | DuneSQL / Trino | Snowflake, BigQuery, Databricks | N/A | | **Query Speed** | ~3 seconds | N/A | N/A | | **Engine** | Custom Trino (Small, Medium, Large) | N/A | N/A | | **Architecture** | OLAP, Delta parquet | OLAP, mostly Iceberg parquet | Real-time | [​](https://docs.dune.com/docs/product-comparison#data-coverage) Data Coverage --------------------------------------------------------------------------------- What data is available and how fresh it is across each product. | | [Data Hub](https://docs.dune.com/web-app/overview) | [Datashare](https://docs.dune.com/datashare/datashare) | [Sim (Realtime APIs)](https://sim.dune.com/) | | --- | --- | --- | --- | | **Freshness** | EVM: ~1-15 min
Solana: ~1-5 min
Curated: ~1 hour | Hourly or daily | < 1 second | | **Blockchains** | [100+ chains](https://docs.dune.com/data-catalog/evm/overview) | [100+ chains](https://docs.dune.com/data-catalog/evm/overview) | 60+ chains | | **Schemas** | [Raw](https://docs.dune.com/data-catalog/evm/ethereum/raw/transactions)
, [Decoded](https://docs.dune.com/data-catalog/evm/ethereum/decoded/overview)
, Curated ([DEX Trades](https://docs.dune.com/data-catalog/curated/dex-trades)
, [Prices](https://docs.dune.com/data-catalog/curated/prices)
, [Token Transfers](https://docs.dune.com/data-catalog/curated/token-transfers/overview)
, [more](https://docs.dune.com/data-catalog/curated/overview)
) | Same as Data Hub | Curated (Balances, Activity, DeFi, Token Info) | [​](https://docs.dune.com/docs/product-comparison#interface-&-pricing) Interface & Pricing --------------------------------------------------------------------------------------------- How you access each product and pricing. | | [Data Hub](https://docs.dune.com/web-app/overview) | [Datashare](https://docs.dune.com/datashare/datashare) | [Sim (Realtime APIs)](https://sim.dune.com/) | | --- | --- | --- | --- | | **Interface** | [Dune App](https://dune.com/)
, [Data API](https://docs.dune.com/api-reference/api-overview)
, [External BI Tools](https://docs.dune.com/api-reference/connectors/trino/overview) | [BigQuery](https://docs.dune.com/datashare/datashare-bigquery)
, [Snowflake](https://docs.dune.com/datashare/datashare-snowflake)
, [Databricks](https://docs.dune.com/datashare/datashare-databricks) | REST APIs | | **Pricing** | Credits (compute-based) | Flat Subscription Fees | API Call Volume (CUs) | * * * [​](https://docs.dune.com/docs/product-comparison#quick-selection-guide) Quick Selection Guide ------------------------------------------------------------------------------------------------- [Data Hub\ --------\ \ **Best for:** Your primary onchain data warehouse, analytic workflows, and data transformationsFull SQL access with 100+ chains, flexible schemas, and compute-based pricing](https://docs.dune.com/web-app/overview) [Datashare\ ---------\ \ **Best for:** Data warehouse integration and interoperabilityDirect access via Snowflake, BigQuery, or Databricks with full historical data](https://docs.dune.com/datashare/datashare) [Sim (Realtime APIs)\ -------------------\ \ **Best for:** Building realtime wallets, portfolio trackers, and DeFi applicationsSub-second response times with 60+ chains via REST APIs](https://sim.dune.com/) [Catalyst\ --------\ \ **Best for:** Blockchain integration and data infrastructureDune’s toolkit for chains and protocols to get indexed and make their data accessible](https://docs.dune.com/catalyst/overview) **Why is Catalyst not in the comparison tables?** Catalyst is Dune’s blockchain integration toolkit designed for chains and protocols, not end-user data consumption. It powers how blockchains get indexed into Dune rather than how users query data, so it serves a fundamentally different purpose than Data Hub, Datashare, and Sim (Realtime APIs). Was this page helpful? YesNo [Introduction](https://docs.dune.com/) [Sim (Realtime APIs)](https://docs.dune.com/docs/sim-real-time-apis) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Analytics - Dune Docs [Skip to main content](https://docs.dune.com/docs/use-cases/analytics#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Use Cases Analytics [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Common Use Cases](https://docs.dune.com/docs/use-cases/analytics#common-use-cases) * [Who This Is For](https://docs.dune.com/docs/use-cases/analytics#who-this-is-for) * [How It Works](https://docs.dune.com/docs/use-cases/analytics#how-it-works) * [Case Studies](https://docs.dune.com/docs/use-cases/analytics#case-studies) * [Get Started](https://docs.dune.com/docs/use-cases/analytics#get-started) Analytics teams use Dune’s enriched data, query interface, and visualization layer to understand blockchain ecosystems, track protocol performance, analyze market trends, and generate insights from onchain activity. [​](https://docs.dune.com/docs/use-cases/analytics#common-use-cases) Common Use Cases ---------------------------------------------------------------------------------------- Protocol Metrics ---------------- Track TVL, user activity, revenue, and ecosystem growth for protocols and DAOs Trading Intelligence -------------------- Analyze DEX volumes, token flows, whale movements, and market trends Stablecoin & Payments Intelligence ---------------------------------- Flow analysis, payment tracking, peg stability, and adoption metrics Ecosystem Benchmarking ---------------------- Competitive analysis, market positioning, and chain comparisons User Behavior Analytics ----------------------- Wallet activity patterns, cohort analysis, retention, and user journeys [​](https://docs.dune.com/docs/use-cases/analytics#who-this-is-for) Who This Is For -------------------------------------------------------------------------------------- Protocols & DAOs ---------------- Track TVL, user activity, and ecosystem metrics to inform product and governance decisions L1s, L2s & Appchains -------------------- Monitor network health, adoption, developer activity, and ecosystem growth Trading & Research Teams ------------------------ Analyze DEX volumes, token flows, and market dynamics for trading strategies Investment Research ------------------- Track portfolio performance, analyze market trends, and identify opportunities Stablecoins ----------- Monitor flows, peg stability, adoption metrics, and payment volumes Web3 Ecosystems & Growth ------------------------ Analyze competitive landscape, partnerships, and growth opportunities [​](https://docs.dune.com/docs/use-cases/analytics#how-it-works) How It Works -------------------------------------------------------------------------------- Dune provides multiple products to power your analytics workflows: [](https://docs.dune.com/web-app/overview) [](https://docs.dune.com/web-app/overview) [Data Hub\ --------](https://docs.dune.com/web-app/overview) [Query blockchain data with SQL, build visualizations, and share dashboards with your team and stakeholders. Access 100+ chains with raw, decoded, and curated data.](https://docs.dune.com/web-app/overview) [Learn more →](https://docs.dune.com/web-app/overview) [](https://docs.dune.com/datashare/datashare) [](https://docs.dune.com/datashare/datashare) [Datashare\ ---------](https://docs.dune.com/datashare/datashare) [Stream Dune’s curated blockchain data directly to Snowflake, BigQuery, or Databricks for analysis in your existing data warehouse environment.](https://docs.dune.com/datashare/datashare) [Learn more →](https://docs.dune.com/datashare/datashare) [](https://docs.dune.com/data-catalog/overview) [](https://docs.dune.com/data-catalog/overview) [Data Catalog\ ------------](https://docs.dune.com/data-catalog/overview) [Explore 100+ blockchains with raw transactions, decoded events, and curated tables like DEX trades, token transfers, and prices.](https://docs.dune.com/data-catalog/overview) [Learn more →](https://docs.dune.com/data-catalog/overview) [](https://docs.dune.com/api-reference/connectors/trino/overview) [](https://docs.dune.com/api-reference/connectors/trino/overview) [External BI Tools\ -----------------](https://docs.dune.com/api-reference/connectors/trino/overview) [Connect Hex, Metabase, DBeaver, PowerBI and other tools via Dune’s Trino connector for analysis in your preferred environment.](https://docs.dune.com/api-reference/connectors/trino/overview) [Learn more →](https://docs.dune.com/api-reference/connectors/trino/overview) [​](https://docs.dune.com/docs/use-cases/analytics#case-studies) Case Studies -------------------------------------------------------------------------------- See how leading teams use Dune for analytics: [Blockworks\ ----------\ \ Blockworks Research powers institutional crypto research with Dune’s Data API and dbt Connector, moving from concept to production in hours instead of weeks.](https://dune.com/case-studies/blockworks) [OP Labs (Optimism)\ ------------------\ \ OP Labs uses Dune to define North Star metrics, track developer activity, and evaluate grant program effectiveness with full transparency.](https://dune.com/case-studies/how-op-labs-use-dune-to-power-ecosystem-growth-and-transparency) [1inch\ -----\ \ 1inch makes DeFi data transparent and accessible with Dune dashboards, Spellbooks, and real-time API integrations across all their products.](https://dune.com/case-studies/how-dune-helps-1inch-to-make-data-transparent-and-accessible) [Polygon\ -------\ \ Polygon Labs achieved 75% faster turnaround on data insights, tracking Reddit Avatars launch and validator rewards with Dune.](https://dune.com/case-studies/how-dune-enabled-polygon-labs-to-illuminate-community-engagement-and-rapidly-deliver-on-chain-insights) [CoW Protocol\ ------------\ \ CoW Protocol discovered they have the highest retention rates in the aggregator ecosystem and built automated solver rewards with Dune.](https://dune.com/case-studies/cow-protocols-journey-into-automated-payments-and-understanding-user-behavior) [​](https://docs.dune.com/docs/use-cases/analytics#get-started) Get Started ------------------------------------------------------------------------------ [Create an Account\ -----------------\ \ Sign up for free and start querying blockchain data in minutes](https://dune.com/auth/register) [Quickstart Guide\ ----------------\ \ Learn the basics of querying and visualizing data on Dune](https://docs.dune.com/quickstart) Was this page helpful? YesNo [Changelog](https://docs.dune.com/docs/changelog) [Engineering](https://docs.dune.com/docs/use-cases/engineering) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Changelog - Dune Docs [Skip to main content](https://docs.dune.com/docs/changelog#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Changelog [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) FiltersClear New releasesImprovements [​](https://docs.dune.com/docs/changelog#product-updates) Product updates ============================================================================ > New releases and improvements [​](https://docs.dune.com/docs/changelog#february-2026) February 2026 New releasesImprovements [​](https://docs.dune.com/docs/changelog#dune-mcp) Dune MCP -------------------------------------------------------------- We launched the Dune MCP (Model Context Protocol), enabling AI agents to query, execute, and interact with Dune directly. Connect the MCP to Claude, Cursor, or any compatible AI agent and let it search tables, execute queries, generate visualizations, and more — all without leaving your workflow. See the [MCP documentation](https://docs.dune.com/api-reference/agents/mcp) for setup instructions. [​](https://docs.dune.com/docs/changelog#defi-positions-api) DeFi Positions API ---------------------------------------------------------------------------------- The DeFi Positions API is now available on [Sim](https://docs.sim.dune.com/evm/defi-positions) . Get a wallet’s active DeFi positions — liquidity pools, lending, and yield strategies — with USD valuations and protocol metadata. Supports Uniswap V2/V3/V4 (and forks), Aave v2/v3, and ERC-4626 vaults across 9 EVM chains. [​](https://docs.dune.com/docs/changelog#stablecoin-dataset-&-showcase-page) Stablecoin Dataset & Showcase Page ------------------------------------------------------------------------------------------------------------------ A first-class stablecoin analytics product built on 346 SQL models across 38 chains. The classification layer matches every transfer to its onchain trigger (DEX swap, lending event, bridge deposit, CEX movement) and labels every holder address by venue type. Premium tables include `activity_enriched` and `balances_enriched` for EVM and Solana. Free foundation tables — `transfers` and `balances` — are available for EVM, Solana, and Tron. Explore the [Stablecoin Showcase](https://dune.com/collection/stablecoins/overview) or see the [Stablecoins documentation](https://docs.dune.com/data-catalog/curated/stablecoins/overview) . [​](https://docs.dune.com/docs/changelog#raw-solana-data-in-bigquery-us-datashare) Raw Solana Data in BigQuery US (Datashare) -------------------------------------------------------------------------------------------------------------------------------- All raw Solana data is now synced to BigQuery in the US region via Datashare — over 600TB across 9 tables including `solana.account_activity`, `solana.instruction_calls`, `solana.transactions`, and more. Existing US multi-region customers can access this data at no extra cost. [​](https://docs.dune.com/docs/changelog#credit-based-pricing-model) Credit-Based Pricing Model -------------------------------------------------------------------------------------------------- We’ve transitioned all self-serve plans to the new credit-based pricing model. This update consolidates exports, writes, and storage under a single credit-based system, removing datapoint conversions and simplifying billing. See [Billing](https://docs.dune.com/api-reference/overview/billing) for details. [​](https://docs.dune.com/docs/changelog#datasets-in-discover) Datasets in Discover -------------------------------------------------------------------------------------- Shipped [dune.com/discover/data](https://dune.com/discover/data) to surface Datasets in the Discover page. Browse and search curated datasets with chain coverage badges and direct links to documentation — part of a broader effort to drive visibility and traffic to Dune’s data products. [​](https://docs.dune.com/docs/changelog#sidebar-navigation-redesign) Sidebar Navigation Redesign ---------------------------------------------------------------------------------------------------- Elevated key pages from Library to the primary sidebar on dune.com. Dashboards, Queries, Schedules, Alerts, Uploaded data, Materialized views, Connectors, Custom endpoints, Folders, Contracts, and APIs are now directly accessible from the sidebar, making it easier to find and manage your content. [​](https://docs.dune.com/docs/changelog#improvements) Improvements ---------------------------------------------------------------------- * **Pie chart upgrade** — New color palette with blockchain color mapping, redesigned tooltips, and adjusted legend layout, bringing pie charts on par with other chart types * **Chart duplicate x handling** — New chart option to visualize and control how duplicate x values within a series are handled, with options to sum across duplicates * **9 new Solana DEX AMMs** — Added 9 new projects to `dex_solana.trades` under a unified prop AMM design * **Usage activity table** — The usage table now persists all modifications (search, filter, columns, sorting, pagination, time range) in the URL, so you can bookmark and share filtered views * **Datashare status page** — Datashare now has its own section on the [Dune status page](https://status.dune.com/) with per-target data warehouse status monitoring [​](https://docs.dune.com/docs/changelog#january-2026) January 2026 New releasesImprovements [​](https://docs.dune.com/docs/changelog#incremental-queries) Incremental Queries ------------------------------------------------------------------------------------ Incremental Queries allow you to write SQL that processes only recent data and merges it with previous query results. This enables fresh data analysis at a fraction of the cost, making it ideal for dashboards and reports that need regular updates. The feature supports complex queries including group bys and cumulative sums. See the [Incremental Queries documentation](https://docs.dune.com/query-engine/incremental-queries) for details. [​](https://docs.dune.com/docs/changelog#mermaid-charts-in-dashboards) Mermaid Charts in Dashboards ------------------------------------------------------------------------------------------------------ You can now create Mermaid diagrams directly in dashboard text widgets. Use the `mermaid` code block syntax to add flowcharts, sequence diagrams, and other visualizations to your dashboards. [​](https://docs.dune.com/docs/changelog#new-curated-table-tokens-fdv_latest) New Curated Table: tokens.fdv\_latest ---------------------------------------------------------------------------------------------------------------------- A new curated table for Fully Diluted Valuation (FDV) data across all EVM chains. The table shows ERC20 tokens with onchain transfers, their latest supply (updated on mint/burn events), and FDV calculated. This table is in open beta as we continue to work and improve it. [​](https://docs.dune.com/docs/changelog#data-sources-visibility) Data Sources Visibility -------------------------------------------------------------------------------------------- Queries now display their data sources in the sidebar. Additionally Dashboards include a new “Data” button showing all datasets used to build the dashboard. [​](https://docs.dune.com/docs/changelog#dbt-connector-video-tutorial) dbt Connector Video Tutorial ------------------------------------------------------------------------------------------------------ A new [video tutorial](https://www.youtube.com/watch?v=TRqqPC0PcZU) for the dbt Connector is now available, providing step-by-step guidance for setting up and using dbt on Dune. [​](https://docs.dune.com/docs/changelog#improvements-2) Improvements ------------------------------------------------------------------------ * **Dune AI** — Improved Dune AI with a modern agentic approach for better query generation and assistance * **Curated Data Explorer** — Reorganized curated data section with revamped categories and a new “More curated data” section * **Okta real-time sync (Enterprise)** — Users removed from an Okta organization are now immediately logged out of Dune * **Dashboard timestamps** — Dashboards now display “updated at” timestamps instead of “created at” on profile pages * **Simplified authentication** — Removed “Sign in with Ethereum” option to streamline the login experience (wallet linking remains available after signup) [​](https://docs.dune.com/docs/changelog#december-2025) December 2025 New releasesImprovements [​](https://docs.dune.com/docs/changelog#domain-restricted-google-sso-enterprise) Domain-Restricted Google SSO (Enterprise) ------------------------------------------------------------------------------------------------------------------------------ Team admins can now enable domain restriction via Google SSO in team settings. This forces team members to log in using their company email (e.g., @company.com), preventing non-employees from accessing the workspace. When enabled, all team members are logged out and must re-authenticate with Google SSO. See the [Google SSO documentation](https://docs.dune.com/web-app/google-sso-domain-restriction) for setup details. [​](https://docs.dune.com/docs/changelog#okta-sso-enterprise) Okta SSO (Enterprise) -------------------------------------------------------------------------------------- We now support Okta SSO for Enterprise customers, a frequently requested feature for enterprise security requirements. You can enable Okta SSO via team settings under the new “Settings & Privacy” tab. We also extended this feature to support multiple domains for organizations with complex Okta tenant configurations. See the [Okta SSO documentation](https://docs.dune.com/web-app/okta-sso) for setup details. [​](https://docs.dune.com/docs/changelog#usage-table) Usage Table -------------------------------------------------------------------- A new Usage table is now available, containing records of metered App, API, and Connector events. Users can search, filter, and export these records for detailed usage analysis and cost tracking. [​](https://docs.dune.com/docs/changelog#private-content-by-default-enterprise) Private Content by Default (Enterprise) -------------------------------------------------------------------------------------------------------------------------- Enterprise customers can now control the default privacy mode for team content with three options: * **Public by default** — Team members choose per content * **Private by default** — New content defaults to private, can be made public individually * **Private only** — All content forced private, external sharing disabled This helps teams working with sensitive data ensure privacy is the default, making link sharing an explicit opt-in. [​](https://docs.dune.com/docs/changelog#improvements-3) Improvements ------------------------------------------------------------------------ * **Export CSV downloads** — Improved CSV export experience for usage data * **Folder filtering** — Filter by Dashboards or Queries inside folders * **Embed fix** — Fixed an issue where embeds did not show username/avatar when the query belonged to a user * **EVM Contract resubmission** — Resubmission actions (rename, upgrade, delete) now gated to paid team plans * **Query editor UX** — Click the drag icon to expand the query editor (in addition to dragging) [​](https://docs.dune.com/docs/changelog#november-2025) November 2025 New releasesImprovements [​](https://docs.dune.com/docs/changelog#databricks-support-for-datashare-enterprise) Databricks Support for Datashare (Enterprise) -------------------------------------------------------------------------------------------------------------------------------------- Datashare now supports Databricks, expanding our data warehouse integrations beyond Snowflake and BigQuery. Stream Dune’s complete blockchain dataset directly into your Databricks environment. See the [Databricks documentation](https://docs.dune.com/datashare/datashare-databricks) and read the [announcement blog post](https://dune.com/blog/expanding-dune-datashare-with-databricks) . [​](https://docs.dune.com/docs/changelog#dbt-connector-enterprise) dbt Connector (Enterprise) ------------------------------------------------------------------------------------------------ Enterprise customers can now use dbt for in-platform data transformations with incremental runs. Build production data pipelines, version control your models, and run transformations directly on Dune. See the [dbt Connector documentation](https://docs.dune.com/api-reference/connectors/dbt/overview) and read the [announcement blog post](https://dune.com/blog/run-dbt-on-dune-your-crypto-data-warehouse) . [​](https://docs.dune.com/docs/changelog#new-chain-support) New Chain Support -------------------------------------------------------------------------------- Added support for [Initia](https://docs.dune.com/data-catalog/initia/overview) , [Kalshi](https://docs.dune.com/data-catalog/kalshi/overview) , [Story](https://docs.dune.com/data-catalog/evm/story/overview) , [Mezo](https://docs.dune.com/data-catalog/evm/mezo/overview) , and [Monad](https://docs.dune.com/data-catalog/evm/monad/overview) . Explore raw, decoded, and curated data for these new chains in the Data Catalog. [​](https://docs.dune.com/docs/changelog#new-api-landing-page) New API Landing Page -------------------------------------------------------------------------------------- A new [API landing page](https://dune.com/apis) provides a unified view of all endpoints with quick curl/preview actions and documentation links. [​](https://docs.dune.com/docs/changelog#new-api-endpoints) New API Endpoints -------------------------------------------------------------------------------- New endpoints for executing arbitrary SQL, pipeline executions, usage data, and dataset metadata. See the [API documentation](https://docs.dune.com/api-reference/overview/introduction) for details. [​](https://docs.dune.com/docs/changelog#improvements-4) Improvements ------------------------------------------------------------------------ * **Improved usage overview** — Charts and copyable API keys for better visibility * **Increased max query result size** — From 8GB to 32GB * **Restructured [API documentation](https://docs.dune.com/api-reference/overview/introduction) ** — Scannable for newcomers while keeping advanced details discoverable * **Updated SDKs** — All new endpoints included * **Deprecated `/v1/tables` endpoints** — Moved to `/v1/uploads`. See the [Tables API documentation](https://docs.dune.com/api-reference/tables/endpoint/overview) for migration details Was this page helpful? YesNo [Sim (Realtime APIs)](https://docs.dune.com/docs/sim-real-time-apis) [Analytics](https://docs.dune.com/docs/use-cases/analytics) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Engineering - Dune Docs [Skip to main content](https://docs.dune.com/docs/use-cases/engineering#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Use Cases Engineering [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Common Use Cases](https://docs.dune.com/docs/use-cases/engineering#common-use-cases) * [Who This Is For](https://docs.dune.com/docs/use-cases/engineering#who-this-is-for) * [How It Works](https://docs.dune.com/docs/use-cases/engineering#how-it-works) * [Case Studies](https://docs.dune.com/docs/use-cases/engineering#case-studies) * [Get Started](https://docs.dune.com/docs/use-cases/engineering#get-started) Data engineering teams use Dune to build production data pipelines, transform blockchain data, and integrate onchain insights into their applications and workflows. [​](https://docs.dune.com/docs/use-cases/engineering#common-use-cases) Common Use Cases ------------------------------------------------------------------------------------------ Build Data Pipelines -------------------- Create production-grade data models and transformation pipelines with dbt on Dune Stream to Your Warehouse ------------------------ Export blockchain data to Snowflake, BigQuery, or Databricks via Datashare Programmatic Access ------------------- Execute queries, manage data, and integrate Dune into your applications via Data API Power Wallet & App Backends --------------------------- Build realtime wallet experiences and DeFi apps with sub-second latency via Sim APIs [​](https://docs.dune.com/docs/use-cases/engineering#who-this-is-for) Who This Is For ---------------------------------------------------------------------------------------- Data Engineering Teams ---------------------- Build and maintain data pipelines, models, and transformations on blockchain data Wallets & Apps Engineering -------------------------- Power wallet backends, portfolio trackers, and DeFi applications with onchain data AI & Derived Analytics ---------------------- Build ML models, derived datasets, and AI-powered analytics on blockchain data Product Teams ------------- Integrate onchain data into product workflows, dashboards, and customer-facing features [​](https://docs.dune.com/docs/use-cases/engineering#how-it-works) How It Works ---------------------------------------------------------------------------------- Dune provides multiple products to power your data engineering workflows: [](https://docs.dune.com/api-reference/connectors/dbt/overview) [](https://docs.dune.com/api-reference/connectors/dbt/overview) [dbt Connector\ -------------](https://docs.dune.com/api-reference/connectors/dbt/overview) [Build production data pipelines with dbt on Dune. Create models, run tests, and schedule transformations with full SQL access to blockchain data.](https://docs.dune.com/api-reference/connectors/dbt/overview) [Learn more →](https://docs.dune.com/api-reference/connectors/dbt/overview) [](https://docs.dune.com/datashare/datashare) [](https://docs.dune.com/datashare/datashare) [Datashare\ ---------](https://docs.dune.com/datashare/datashare) [Stream Dune’s curated blockchain data directly to Snowflake, BigQuery, or Databricks. Integrate onchain data into your existing data warehouse.](https://docs.dune.com/datashare/datashare) [Learn more →](https://docs.dune.com/datashare/datashare) [](https://docs.dune.com/api-reference/api-overview) [](https://docs.dune.com/api-reference/api-overview) [Data API\ --------](https://docs.dune.com/api-reference/api-overview) [Programmatically execute queries, manage data, and integrate Dune into your applications. Full REST API access for automation and integration.](https://docs.dune.com/api-reference/api-overview) [Learn more →](https://docs.dune.com/api-reference/api-overview) [](https://docs.sim.dune.com/) [](https://docs.sim.dune.com/) [Sim (Realtime APIs)\ -------------------](https://docs.sim.dune.com/) [Build realtime applications with sub-second latency. Access balances, transactions, DeFi positions, and more via REST APIs.](https://docs.sim.dune.com/) [Explore Sim Docs →](https://docs.sim.dune.com/) [​](https://docs.dune.com/docs/use-cases/engineering#case-studies) Case Studies ---------------------------------------------------------------------------------- See how engineering teams build with Dune: [Blockworks\ ----------\ \ Blockworks builds data pipelines with dbt Connector and Data API, exporting aggregated data to their Postgres environment seamlessly.](https://dune.com/case-studies/blockworks) [CoW Protocol\ ------------\ \ CoW Protocol automates weekly solver rewards using Dune’s data upload, API, and query capabilities to calculate and distribute payments.](https://dune.com/case-studies/cow-protocols-journey-into-automated-payments-and-understanding-user-behavior) [​](https://docs.dune.com/docs/use-cases/engineering#get-started) Get Started -------------------------------------------------------------------------------- [Quickstart Guide\ ----------------\ \ Learn the basics of querying and working with data on Dune](https://docs.dune.com/quickstart) [dbt Setup Guide\ ---------------\ \ Get started with dbt on Dune for data transformations](https://docs.dune.com/api-reference/connectors/dbt/overview) [Sim Documentation\ -----------------\ \ Build realtime apps with Sim APIs](https://docs.sim.dune.com/) Was this page helpful? YesNo [Analytics](https://docs.dune.com/docs/use-cases/analytics) [Accounting, Audit & AML](https://docs.dune.com/docs/use-cases/accounting-audit-aml) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Accounting, Audit & AML - Dune Docs [Skip to main content](https://docs.dune.com/docs/use-cases/accounting-audit-aml#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Use Cases Accounting, Audit & AML [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Common Use Cases](https://docs.dune.com/docs/use-cases/accounting-audit-aml#common-use-cases) * [Who This Is For](https://docs.dune.com/docs/use-cases/accounting-audit-aml#who-this-is-for) * [How It Works](https://docs.dune.com/docs/use-cases/accounting-audit-aml#how-it-works) * [Case Studies](https://docs.dune.com/docs/use-cases/accounting-audit-aml#case-studies) * [Get Started](https://docs.dune.com/docs/use-cases/accounting-audit-aml#get-started) Accounting, audit, and compliance teams depend on Dune for transaction monitoring, data reconciliation, financial reporting, and AML investigations across blockchain networks. [​](https://docs.dune.com/docs/use-cases/accounting-audit-aml#common-use-cases) Common Use Cases --------------------------------------------------------------------------------------------------- Transaction Monitoring ---------------------- Track onchain transactions, wallet flows, and cross-chain movements for compliance Account Reconciliation ---------------------- Verify token balances, staking positions, and DeFi holdings at any point in time Financial Reporting ------------------- Calculate realized gains/losses from DEX trades, staking rewards, and LP positions Market Manipulation Detection ----------------------------- Pump and dump analysis, wash trading on DEXs, prediction market wash trading, LP manipulation AML & Fraud Investigation ------------------------- Wallet clustering, sybil detection, sanctions screening, illicit fund tracing [​](https://docs.dune.com/docs/use-cases/accounting-audit-aml#who-this-is-for) Who This Is For ------------------------------------------------------------------------------------------------- Accounting & Finance -------------------- Transaction monitoring, reconciliation, and financial reporting for crypto treasuries Risk & Compliance ----------------- AML/KYC workflows, sanctions screening, and regulatory compliance monitoring Brokerages & Exchanges ---------------------- Trade reconciliation, compliance reporting, and market surveillance Custodians ---------- Asset verification, balance audits, and custody reporting Professional Services --------------------- Big 4 auditors, tax preparers, and consulting firms serving crypto clients Public Sector ------------- Regulators, policymakers, and government agencies monitoring crypto markets [​](https://docs.dune.com/docs/use-cases/accounting-audit-aml#how-it-works) How It Works ------------------------------------------------------------------------------------------- Dune provides the data infrastructure to power your accounting, audit, and compliance workflows: [](https://docs.dune.com/datashare/datashare) [](https://docs.dune.com/datashare/datashare) [Datashare\ ---------](https://docs.dune.com/datashare/datashare) [Stream Dune’s complete blockchain dataset to Snowflake, BigQuery, or Databricks. Query historical balances, transactions, and DeFi activity in your existing compliance infrastructure.](https://docs.dune.com/datashare/datashare) [Learn more →](https://docs.dune.com/datashare/datashare) [](https://docs.dune.com/web-app/overview) [](https://docs.dune.com/web-app/overview) [Data Hub\ --------](https://docs.dune.com/web-app/overview) [Build custom queries and dashboards for transaction monitoring, balance verification, and compliance reporting with full SQL access.](https://docs.dune.com/web-app/overview) [Learn more →](https://docs.dune.com/web-app/overview) [](https://docs.dune.com/api-reference/api-overview) [](https://docs.dune.com/api-reference/api-overview) [Data API\ --------](https://docs.dune.com/api-reference/api-overview) [Integrate Dune data into your compliance systems, automate reporting workflows, and build custom monitoring pipelines.](https://docs.dune.com/api-reference/api-overview) [Learn more →](https://docs.dune.com/api-reference/api-overview) [](https://docs.dune.com/data-catalog/overview) [](https://docs.dune.com/data-catalog/overview) [Data Catalog\ ------------](https://docs.dune.com/data-catalog/overview) [Access raw transactions, decoded events, token transfers, DEX trades, and staking data across 100+ blockchains.](https://docs.dune.com/data-catalog/overview) [Learn more →](https://docs.dune.com/data-catalog/overview) [​](https://docs.dune.com/docs/use-cases/accounting-audit-aml#case-studies) Case Studies ------------------------------------------------------------------------------------------- See how teams use Dune for compliance and monitoring: [CoW Protocol\ ------------\ \ CoW Protocol uses Dune queries and alerts to monitor malicious solver behavior, triggering Slack notifications when thresholds are met. They also automate weekly solver reward calculations with transparent, publicly verifiable data.](https://dune.com/case-studies/cow-protocols-journey-into-automated-payments-and-understanding-user-behavior) [​](https://docs.dune.com/docs/use-cases/accounting-audit-aml#get-started) Get Started ----------------------------------------------------------------------------------------- [Contact Sales\ -------------\ \ Talk to our team about enterprise solutions for accounting, audit, and compliance](https://dune.com/enterprise) [Datashare Trial\ ---------------\ \ Get started with a free trial of Dune Datashare](https://docs.dune.com/datashare/datashare-trial) Was this page helpful? YesNo [Engineering](https://docs.dune.com/docs/use-cases/engineering) [Overview](https://docs.dune.com/web-app/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Data Hub Overview - Dune Docs [Skip to main content](https://docs.dune.com/web-app/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Data Hub Data Hub Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Prerequisites](https://docs.dune.com/web-app/overview#prerequisites) * [What You Can Do](https://docs.dune.com/web-app/overview#what-you-can-do) * [Quick Start](https://docs.dune.com/web-app/overview#quick-start) * [Next Steps](https://docs.dune.com/web-app/overview#next-steps) The Data Hub is Dune’s web-based workspace where you query blockchain data with SQL, build visualizations, assemble dashboards, and share insights with your team or the public. It is one of several ways to work with Dune’s data — alongside the [Data API](https://docs.dune.com/api-reference/api-overview) , [dbt integration](https://docs.dune.com/api-reference/connectors/dbt/overview) , [BI tool connectors](https://docs.dune.com/api-reference/connectors/trino/overview) , and [Datashare](https://docs.dune.com/datashare/datashare) . ![Data transformations on Dune](https://mintcdn.com/dune/7jTylmCpqk1GQLzb/images/data-transformations-dune.png?w=2500&fit=max&auto=format&n=7jTylmCpqk1GQLzb&q=85&s=7dcdde0d99b2ec3a6a76fffc2b936ec7) [​](https://docs.dune.com/web-app/overview#prerequisites) Prerequisites -------------------------------------------------------------------------- * **Dune Account:** [Sign up here](https://dune.com/auth/register) if you do not already have one. * **Basic SQL Knowledge:** Dune uses DuneSQL, a SQL dialect compatible with TrinoSQL. If you are new to SQL, [start here](https://www.w3schools.com/sql/) . [​](https://docs.dune.com/web-app/overview#what-you-can-do) What You Can Do ------------------------------------------------------------------------------ [Write and Run Queries\ ---------------------\ \ Use the Query Editor to write SQL against blockchain data, add parameters, and schedule automated runs.](https://docs.dune.com/web-app/query-editor) [Visualize and Present Results\ -----------------------------\ \ Turn query results into charts, counters, tables, and interactive dashboards.](https://docs.dune.com/web-app/visualizations/charts-graphs) [Automate and Monitor\ --------------------\ \ Schedule queries and dashboards to refresh automatically. Set up alerts for email or webhook notifications.](https://docs.dune.com/web-app/query-editor/query-scheduler) [Share and Embed\ ---------------\ \ Share dashboards by URL, embed live visualizations on any website, or export data via CSV and API.](https://docs.dune.com/web-app/share) [Import and Export Data\ ----------------------\ \ Upload your own CSV datasets to join with blockchain data. Export query results in CSV or JSON.](https://docs.dune.com/web-app/upload-data) [Decode Smart Contracts\ ----------------------\ \ Submit contracts for decoding to create structured, queryable tables from raw transaction bytecode.](https://docs.dune.com/web-app/decoding/decoding-contracts) [Manage Your Team\ ----------------\ \ Create team workspaces, assign roles, share credits, and configure SSO for your organization.](https://docs.dune.com/web-app/teams) [Search and Discover\ -------------------\ \ Find dashboards, queries, and analysts across Dune using search, discovery, and advanced filters.](https://docs.dune.com/web-app/search) [​](https://docs.dune.com/web-app/overview#quick-start) Quick Start ---------------------------------------------------------------------- Get from zero to a published dashboard in five minutes: 1. **Create a query** — Open the [Query Editor](https://dune.com/queries) and write SQL. For example, daily Ethereum active addresses: Copy Ask AI SELECT date_trunc('day', block_time) AS time, COUNT(DISTINCT "from") AS active_senders FROM ethereum.transactions WHERE block_time > DATE '2024-01-01' GROUP BY 1 ORDER BY 1 2. **Run and save** — Click **Run** to execute, then **Save** to persist your query. 3. **Add a visualization** — Click **New Visualization**, choose a chart type, and configure your axes. 4. **Build a dashboard** — Go to **Create > New Dashboard**, name it, then add your visualization as a widget. 5. **Share it** — Copy the dashboard URL or use the **Share** button to embed it externally. For a detailed walkthrough, see [Create Your First Query](https://docs.dune.com/learning/how-tos/create-your-first-query) and [Create Your First Visualization](https://docs.dune.com/learning/how-tos/create-your-first-visualization) . [​](https://docs.dune.com/web-app/overview#next-steps) Next Steps -------------------------------------------------------------------- * **[Query Templates](https://docs.dune.com/learning/how-tos/query-templates) :** Pre-built queries you can customize immediately. * **[Data Catalog](https://docs.dune.com/data-catalog/overview) :** Explore all available blockchain data tables. * **[Video Tutorials](https://docs.dune.com/resources/learning/video-tutorials) :** Visual walkthroughs of every Data Hub feature. Was this page helpful? YesNo [Accounting, Audit & AML](https://docs.dune.com/docs/use-cases/accounting-audit-aml) [Query Editor Overview](https://docs.dune.com/web-app/query-editor) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Google SSO Domain Restriction - Dune Docs [Skip to main content](https://docs.dune.com/web-app/google-sso-domain-restriction#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Manage Your Team Google SSO Domain Restriction [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [How the allowed domain is determined](https://docs.dune.com/web-app/google-sso-domain-restriction#how-the-allowed-domain-is-determined) * [What this setting does](https://docs.dune.com/web-app/google-sso-domain-restriction#what-this-setting-does) * [Before you enable this](https://docs.dune.com/web-app/google-sso-domain-restriction#before-you-enable-this) * [Enable Google SSO domain restriction](https://docs.dune.com/web-app/google-sso-domain-restriction#enable-google-sso-domain-restriction) **Enterprise Feature** — Domain-restricted SSO is available on the [Enterprise plan](https://dune.com/enterprise) . [Contact sales](https://dune.com/enterprise) to learn more. Dune can restrict **Google SSO join requests** so that only users with an email address on an approved domain can join your team. [​](https://docs.dune.com/web-app/google-sso-domain-restriction#how-the-allowed-domain-is-determined) How the allowed domain is determined --------------------------------------------------------------------------------------------------------------------------------------------- The **allowed domain is automatically set to the email domain of the team admin** who enables the setting. Example: * If the admin enabling the setting has `admin@dune.com`, then the allowed domain will be `dune.com`. [​](https://docs.dune.com/web-app/google-sso-domain-restriction#what-this-setting-does) What this setting does ----------------------------------------------------------------------------------------------------------------- When enabled: * Only users signing in with Google SSO using the **allowed domain** can join the team. * Users attempting to join with a different email domain will be blocked. This is useful to prevent personal Gmail accounts (or other unapproved domains) from joining your team. [​](https://docs.dune.com/web-app/google-sso-domain-restriction#before-you-enable-this) Before you enable this ----------------------------------------------------------------------------------------------------------------- > **Important:** You must remove any existing team members whose email domain does **not** match the admin’s domain **before** enabling this setting. Also note: * While enabled, **users cannot change their email address** in Dune. * Users who previously used **email/password** will be prompted to sign in using **Google SSO**. [​](https://docs.dune.com/web-app/google-sso-domain-restriction#enable-google-sso-domain-restriction) Enable Google SSO domain restriction --------------------------------------------------------------------------------------------------------------------------------------------- 1. Go to **Settings → Security & Privacy → Google SSO domain restriction**. 2. Toggle **Restrict Google SSO** on. 3. **Authenticate** your email domain. Once enabled, Dune will display the allowed domain (for example: `dune.com`) in the setting. Was this page helpful? YesNo [Teams and Roles](https://docs.dune.com/web-app/teams) [Okta SSO](https://docs.dune.com/web-app/okta-sso) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Okta SSO Setup - Dune Docs [Skip to main content](https://docs.dune.com/web-app/okta-sso#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Manage Your Team Okta SSO Setup [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Prerequisites](https://docs.dune.com/web-app/okta-sso#prerequisites) * [Step 1 — Add and verify your SSO domain(s)](https://docs.dune.com/web-app/okta-sso#step-1-%E2%80%94-add-and-verify-your-sso-domains) * [Verify the domain (DNS TXT record)](https://docs.dune.com/web-app/okta-sso#verify-the-domain-dns-txt-record) * [Step 2 — Create an Okta OIDC app (Web)](https://docs.dune.com/web-app/okta-sso#step-2-%E2%80%94-create-an-okta-oidc-app-web) * [Step 3 — Copy Okta credentials into Dune](https://docs.dune.com/web-app/okta-sso#step-3-%E2%80%94-copy-okta-credentials-into-dune) * [Step 4 — Enable Okta SSO](https://docs.dune.com/web-app/okta-sso#step-4-%E2%80%94-enable-okta-sso) **Enterprise Feature** — Okta SSO is available on the [Enterprise plan](https://dune.com/enterprise) . [Contact sales](https://dune.com/enterprise) to learn more. This guide walks you through enabling **Okta SSO** for your Dune team using **OIDC**. [​](https://docs.dune.com/web-app/okta-sso#prerequisites) Prerequisites -------------------------------------------------------------------------- You’ll need: * Admin access for your **Dune team** * Admin access for your **Okta tenant** * Access to your domain’s **DNS provider** (to add TXT records) [​](https://docs.dune.com/web-app/okta-sso#step-1-%E2%80%94-add-and-verify-your-sso-domains) Step 1 — Add and verify your SSO domain(s) ------------------------------------------------------------------------------------------------------------------------------------------ 1. In Dune, go to **Settings → Security & Privacy → Okta authentication**. 2. Under **Configure SSO domains**, click **Add domains**. 3. Enter the email domain(s) your team uses (for example, `company.com`). ### [​](https://docs.dune.com/web-app/okta-sso#verify-the-domain-dns-txt-record) Verify the domain (DNS TXT record) After adding a domain, it may show as **Pending**. Dune will display DNS instructions like: * **Host**: `dune-verification` * **Type**: `TXT` * **Value**: a unique verification token Add a TXT record in your DNS provider: * **Name / Host**: `dune-verification` (some providers require the full name like `dune-verification.company.com`) * **Type**: `TXT` * **Value**: (paste the token from Dune exactly) Then return to Dune and click **Verify** next to the domain. > **Tip** DNS changes can take time to propagate. If verification fails, double-check the host/name formatting in your DNS provider and try again after propagation. [​](https://docs.dune.com/web-app/okta-sso#step-2-%E2%80%94-create-an-okta-oidc-app-web) Step 2 — Create an Okta OIDC app (Web) ---------------------------------------------------------------------------------------------------------------------------------- In Okta: 1. Go to **Applications → Create App Integration**. 2. Choose **OIDC - OpenID Connect**. 3. Choose **Web Application**. 4. In the app settings, add the **Sign-in redirect URIs** shown in Dune. 5. Save the app. > **Note** Use the redirect URIs **exactly** as shown in Dune. A mismatch is the most common cause of Okta sign-in errors. [​](https://docs.dune.com/web-app/okta-sso#step-3-%E2%80%94-copy-okta-credentials-into-dune) Step 3 — Copy Okta credentials into Dune ---------------------------------------------------------------------------------------------------------------------------------------- Back in Dune (**Settings → Security & Privacy → Okta authentication**), fill in: * **Client ID**: from your Okta OIDC application * **Client secret**: from your Okta OIDC application * **Okta domain**: your Okta org URL, for example: * `https://your-domain.okta.com` [​](https://docs.dune.com/web-app/okta-sso#step-4-%E2%80%94-enable-okta-sso) Step 4 — Enable Okta SSO -------------------------------------------------------------------------------------------------------- 1. Make sure at least one domain shows as **Verified**. 2. Toggle **Enable Okta SSO** on. 3. Click **Enable**. > **Important** > > * Existing members with **non-matching domains must be removed** before enabling. > * Users **cannot change their email** while Okta SSO is enforced. > * Users with **email/password** accounts will be prompted to log in with Okta SSO. Was this page helpful? YesNo [Google SSO](https://docs.dune.com/web-app/google-sso-domain-restriction) [Enterprise Plan](https://docs.dune.com/enterprise/data-hub/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Kalshi - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/kalshi/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Kalshi Kalshi [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Event Contracts](https://docs.dune.com/data-catalog/kalshi/overview#event-contracts) * [Key Features](https://docs.dune.com/data-catalog/kalshi/overview#key-features) * [Company History](https://docs.dune.com/data-catalog/kalshi/overview#company-history) * [Kalshi Data on Dune](https://docs.dune.com/data-catalog/kalshi/overview#kalshi-data-on-dune) Kalshi is the first CFTC regulated exchange dedicated to trading on the outcome of future events. From inflation, to fed rates, to unemployment, to will the government shut down, Kalshi allows people to trade on a broad range of topics. Kalshi has developed a new asset class, event contracts, where you can buy Yes or No positions with respect to whether an event will happen or not. Kalshi’s vision is to allow people to capitalize on their opinions, trade in the domain of every day, and hedge risks that relate to them. [​](https://docs.dune.com/data-catalog/kalshi/overview#event-contracts) Event Contracts ------------------------------------------------------------------------------------------ Kalshi’s Event Contracts give people the ability to trade based on their opinions about a specific yes-or-no question. For example, if you have student debt and are worried about relief not passing, you can purchase a contract and get a payout even if it doesn’t pass. If you’re worried about the economic fallout of the government shutting down, you can place a trade to hedge against it. If you’ve developed a model on inflation, you can profit from that and maybe even offset your rising costs. Event Contracts have an interesting side effect - the price that a given event contract trades at is actually the market’s assessment of the probability that the event will happen. Kalshi’s inflation and federal rate forecasts have been more accurate than economists, pundits, and traditional news outlets over the past year. Kalshi offers Event Contracts on a wide range of topics, including economics, culture, weather, scientific advancements, and traditional financial markets such as commodities, forex, S&P, and NASDAQ indices. [​](https://docs.dune.com/data-catalog/kalshi/overview#key-features) Key Features ------------------------------------------------------------------------------------ * **CFTC Regulated**: Kalshi is regulated by the Commodity Futures Trading Commission (CFTC) as a Designated Contract Market (DCM) * **Event-Based Trading**: Trade on the outcome of future events with Yes or No positions * **Broad Market Coverage**: Event contracts on economics, politics, sports, culture, crypto, climate, health, and more * **Market Probability Assessment**: Event contract prices reflect the market’s assessment of event probability * **Risk Hedging**: Ability to hedge against everyday risks and economic events * **Election Trading**: First fully regulated platform in over a century to offer legal election trading in the United States [​](https://docs.dune.com/data-catalog/kalshi/overview#company-history) Company History ------------------------------------------------------------------------------------------ Kalshi was founded in 2018 by Tarek Mansour and Luana Lopes Lara, who met while studying at the Massachusetts Institute of Technology (MIT). During their early careers at financial institutions like Goldman Sachs, Citadel, and Bridgewater, Tarek and Luana observed that many financial decisions were driven by predictions about future events. However, they noticed a gap in the market: there was no straightforward way for people to trade directly on event outcomes. In 2019, Kalshi was accepted into Y Combinator’s Winter batch, where the team further developed the platform. In 2020, Kalshi made history by becoming the first fully regulated financial exchange in the U.S. specifically for event contracts, officially designated as a Designated Contract Market (DCM) by the CFTC. In 2024, Kalshi achieved a historic milestone by becoming the first fully regulated platform in over a century to offer legal election trading in the United States, following a federal appeals court ruling that upheld Kalshi’s right to list contracts on political outcomes. [​](https://docs.dune.com/data-catalog/kalshi/overview#kalshi-data-on-dune) Kalshi Data on Dune -------------------------------------------------------------------------------------------------- [Market Report\ -------------\ \ Contains market data and information about event contracts](https://docs.dune.com/data-catalog/kalshi/market_report) [Trade Report\ ------------\ \ Contains trade execution data and transaction information](https://docs.dune.com/data-catalog/kalshi/trade_report) [Kalshi Website\ --------------\ \ Learn more about Kalshi, event contracts, and the platform](https://kalshi.com/about) Was this page helpful? YesNo [Transaction Messages](https://docs.dune.com/data-catalog/yominet/tx_messages) [Market Report](https://docs.dune.com/data-catalog/kalshi/market_report) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Initia Data - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Initia Data [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [What is Initia?](https://docs.dune.com/data-catalog/initia/overview#what-is-initia) * [Key Features](https://docs.dune.com/data-catalog/initia/overview#key-features) * [Initia Data on Dune](https://docs.dune.com/data-catalog/initia/overview#initia-data-on-dune) [​](https://docs.dune.com/data-catalog/initia/overview#what-is-initia) What is Initia? ----------------------------------------------------------------------------------------- Initia’s core philosophy is to make opinionated decisions on the underlying infrastructure such as data availability, interoperability, and oracles. By reducing decision fatigue, the Interwoven Stack empowers developers with the tools to craft application-specific environments while maintaining un-fragmented accessibility to the application ecosystem. Initia provides a framework that powers all of Initia’s rollups through the Interwoven Stack, featuring enshrined liquidity solutions for bootstrapping cross-chain liquidity while maintaining network security. The platform includes InitiaDEX, Minitswap, and a Vested Interest Program (VIP) that aims to foster long-term ecosystem-wide alignment. [​](https://docs.dune.com/data-catalog/initia/overview#key-features) Key Features ------------------------------------------------------------------------------------ * **Interwoven Stack**: Framework that powers all of Initia’s rollups, enabling developers to craft application-specific environments * **Enshrined Liquidity**: Solution for bootstrapping cross-chain liquidity while maintaining network security * **VIP Program**: Incentive program that aims to foster long-term ecosystem-wide alignment * **InitiaDEX**: Decentralized exchange built on the Initia network * **Minitswap**: Swap functionality integrated into the ecosystem * **Developer-Friendly**: Tools and infrastructure that reduce decision fatigue for developers [​](https://docs.dune.com/data-catalog/initia/overview#initia-data-on-dune) Initia Data on Dune -------------------------------------------------------------------------------------------------- Initia blockchain data is organized into several key tables that capture different aspects of on-chain activity: [Balances\ --------\ \ Account balance snapshots and token holdings](https://docs.dune.com/data-catalog/initia/balances) [Blocks\ ------\ \ Contains each validated block in the chain](https://docs.dune.com/data-catalog/initia/blocks) [Block Events\ ------------\ \ Contains all block-level events and attributes in the chain, partitioned by event\_index](https://docs.dune.com/data-catalog/initia/block_events) [Bridge Transfers\ ----------------\ \ Cross-chain bridge transfer data](https://docs.dune.com/data-catalog/initia/bridge_transfers) [Message Events\ --------------\ \ Contains all events and their corresponding attributes partitioned by message\_index](https://docs.dune.com/data-catalog/initia/message_events) [Swaps\ -----\ \ Token swap and liquidity pool data](https://docs.dune.com/data-catalog/initia/swaps) [Transactions\ ------------\ \ Contains relevant data associated with each transaction](https://docs.dune.com/data-catalog/initia/transactions) [Transaction Messages\ --------------------\ \ Contains all messages submitted to the blockchain](https://docs.dune.com/data-catalog/initia/tx_messages) [Validators\ ----------\ \ Maps validator addresses to monikers (human-readable description) and other metadata](https://docs.dune.com/data-catalog/initia/validators) Was this page helpful? YesNo [Receipts](https://docs.dune.com/data-catalog/fuel/receipts) [Balances](https://docs.dune.com/data-catalog/initia/balances) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Video Tutorials - Dune Docs [Skip to main content](https://docs.dune.com/resources/learning/video-tutorials#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Learning Video Tutorials [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Getting Started with Dune](https://docs.dune.com/resources/learning/video-tutorials#getting-started-with-dune) * [Dune Official Getting Started Series](https://docs.dune.com/resources/learning/video-tutorials#dune-official-getting-started-series) * [Creating and Managing Dashboards](https://docs.dune.com/resources/learning/video-tutorials#creating-and-managing-dashboards) * [Learning DuneSQL and Our Engines](https://docs.dune.com/resources/learning/video-tutorials#learning-dunesql-and-our-engines) * [Exploring Queries (Views and Matviews)](https://docs.dune.com/resources/learning/video-tutorials#exploring-queries-views-and-matviews) * [Searching and Contributing to Spellbook](https://docs.dune.com/resources/learning/video-tutorials#searching-and-contributing-to-spellbook) * [Understanding Tables (Raw, Decoded, Curated, Views, Uploads)](https://docs.dune.com/resources/learning/video-tutorials#understanding-tables-raw-decoded-curated-views-uploads) * [Creating Visualizations (Charts)](https://docs.dune.com/resources/learning/video-tutorials#creating-visualizations-charts) * [Decoding Contracts](https://docs.dune.com/resources/learning/video-tutorials#decoding-contracts) * [SQL API and Developer API](https://docs.dune.com/resources/learning/video-tutorials#sql-api-and-developer-api) * [Roadmap to Becoming a Top Crypto Data Analyst](https://docs.dune.com/resources/learning/video-tutorials#roadmap-to-becoming-a-top-crypto-data-analyst) * [NEAR + Dune Tutorial](https://docs.dune.com/resources/learning/video-tutorials#near-%2B-dune-tutorial) * [More Tutorials](https://docs.dune.com/resources/learning/video-tutorials#more-tutorials) * [Query Filters vs Execution Parameters](https://docs.dune.com/resources/learning/video-tutorials#query-filters-vs-execution-parameters) * [Building Farcaster Frames with Dune API](https://docs.dune.com/resources/learning/video-tutorials#building-farcaster-frames-with-dune-api) * [Uniswap in 12 Days](https://docs.dune.com/resources/learning/video-tutorials#uniswap-in-12-days) * [Gnosis Safe Point-in-Time Analysis](https://docs.dune.com/resources/learning/video-tutorials#gnosis-safe-point-in-time-analysis) * [Additional Resources](https://docs.dune.com/resources/learning/video-tutorials#additional-resources) We’ve created tutorials covering all product surfaces of Dune—from navigating the platform and understanding data tables to creating compelling visualizations and becoming a skilled crypto data analyst. New to Dune? Start with the [Getting Started](https://docs.dune.com/resources/learning/video-tutorials#getting-started-with-dune) section and work your way through. Already familiar with the basics? Jump to the section that interests you most. * * * [​](https://docs.dune.com/resources/learning/video-tutorials#getting-started-with-dune) Getting Started with Dune -------------------------------------------------------------------------------------------------------------------- These videos will help you get up and running with Dune quickly, understanding how data flows through the platform and how to navigate the app effectively. ### [​](https://docs.dune.com/resources/learning/video-tutorials#dune-official-getting-started-series) Dune Official Getting Started Series Learn how the data flows and how to navigate the Dune app to create queries, visualizations, and dashboards. This comprehensive playlist covers all the essentials you need to get started. [View the full playlist on YouTube →](https://www.youtube.com/playlist?list=PLK3b5d4iK10ext4v-GBySekaA8-GP8quD) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#creating-and-managing-dashboards) Creating and Managing Dashboards ---------------------------------------------------------------------------------------------------------------------------------- Dashboards are where Dune’s content lives and gets discovered. Learn how to create dashboards, add widgets, embed visualizations, and share your work with the community. **Related docs:** [Create Dashboards](https://docs.dune.com/web-app/dashboards) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#learning-dunesql-and-our-engines) Learning DuneSQL and Our Engines ---------------------------------------------------------------------------------------------------------------------------------- DuneSQL is a Trino fork fine-tuned for blockchain analytics. Learn about its key features including varbinary data types, uint256 support, columnar storage, and materialized views. **Related docs:** [Query Engine](https://docs.dune.com/query-engine/overview) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#exploring-queries-views-and-matviews) Exploring Queries (Views and Matviews) -------------------------------------------------------------------------------------------------------------------------------------------- The Query Editor is where you’ll spend most of your time on Dune. Learn how to use its features effectively, including autocomplete, running query selections, and using keyboard shortcuts. **Related docs:** [Writing Queries](https://docs.dune.com/web-app/query-editor/query-window) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#searching-and-contributing-to-spellbook) Searching and Contributing to Spellbook ------------------------------------------------------------------------------------------------------------------------------------------------ Learn how to contribute to Dune’s curated datasets through Spellbook—our community-driven data modeling framework. Discover how curated datasets are built and learn how you can contribute your own data models to help the entire Dune community. **Related docs:** [Curated Data](https://docs.dune.com/data-catalog/curated/overview) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#understanding-tables-raw-decoded-curated-views-uploads) Understanding Tables (Raw, Decoded, Curated, Views, Uploads) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ Explore Dune’s comprehensive data catalog to find blockchain data, curated datasets, and community data. This video covers how to browse categories, filter tables, and preview data. **Related docs:** [Data Catalog](https://docs.dune.com/data-catalog/overview) , [Finding Tables](https://docs.dune.com/web-app/query-editor/data-explorer) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#creating-visualizations-charts) Creating Visualizations (Charts) -------------------------------------------------------------------------------------------------------------------------------- Visualizations make your data come to life. Learn how to create bar charts, area charts, scatter charts, line charts, pie charts, and mixed graphs from your query results. **Related docs:** [Create Graphs](https://docs.dune.com/web-app/visualizations/charts-graphs) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#decoding-contracts) Decoding Contracts ------------------------------------------------------------------------------------------------------ Learn how to decode smart contracts on Dune to transform raw blockchain bytecode into human-readable, queryable tables. This video covers how decoding works on Dune and walks through the contract submission process step-by-step. **Related docs:** [Decoding Contracts](https://docs.dune.com/web-app/decoding/decoding-contracts) , [Submit a Contract](https://docs.dune.com/web-app/decoding/short-guide-contract-submission) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#sql-api-and-developer-api) SQL API and Developer API -------------------------------------------------------------------------------------------------------------------- Learn how to build your own custom API endpoints using SQL queries. This video shows how to leverage Dune’s API to create tailored data endpoints for your specific needs. **Related docs:** [API Quickstart](https://docs.dune.com/api-reference/quickstart/results-eg) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#roadmap-to-becoming-a-top-crypto-data-analyst) Roadmap to Becoming a Top Crypto Data Analyst ------------------------------------------------------------------------------------------------------------------------------------------------------------ Ready to level up? Follow the crypto data analyst roadmap to build your skills and establish yourself as an expert in blockchain analytics. * * * [​](https://docs.dune.com/resources/learning/video-tutorials#near-+-dune-tutorial) NEAR + Dune Tutorial ---------------------------------------------------------------------------------------------------------- Understand how data flows on the NEAR blockchain—from transactions to actions to receipts. This video explains NEAR’s unique transaction lifecycle and sharded architecture. **Related docs:** [NEAR Data](https://docs.dune.com/data-catalog/near/overview) * * * [​](https://docs.dune.com/resources/learning/video-tutorials#more-tutorials) More Tutorials ---------------------------------------------------------------------------------------------- These additional tutorials cover specialized topics not included in the main playlist. ### [​](https://docs.dune.com/resources/learning/video-tutorials#query-filters-vs-execution-parameters) Query Filters vs Execution Parameters Understand the two primary methods for fetching data from the Dune API: using filters with scheduled queries for speed, or executing queries with parameters for real-time data. This video explains when to use each approach. **Related docs:** [Executions Overview](https://docs.dune.com/api-reference/executions/execution-object) , [Filtering Results](https://docs.dune.com/api-reference/executions/filtering) ### [​](https://docs.dune.com/resources/learning/video-tutorials#building-farcaster-frames-with-dune-api) Building Farcaster Frames with Dune API Build a Farcaster Frame using TypeScript and the Dune API. This step-by-step guide walks through creating a user recommendation frame, using filters for fast API responses, and deploying your frame. **Related docs:** [Build a Frame with Dune API](https://docs.dune.com/learning/how-tos/dune-frames) ### [​](https://docs.dune.com/resources/learning/video-tutorials#uniswap-in-12-days) Uniswap in 12 Days A comprehensive 12-part series covering end-to-end Uniswap analysis, including metrics like price impact, TVL, MEV volume, and liquidity stability. [View the full playlist on YouTube →](https://www.youtube.com/playlist?list=PLK3b5d4iK10cIrN8c_au9RrC0_eBCOyR2) ### [​](https://docs.dune.com/resources/learning/video-tutorials#gnosis-safe-point-in-time-analysis) Gnosis Safe Point-in-Time Analysis Learn how to analyze Gnosis Safe (now Safe) wallets with metrics including signers, diversification, and valuations. * * * [​](https://docs.dune.com/resources/learning/video-tutorials#additional-resources) Additional Resources ---------------------------------------------------------------------------------------------------------- Looking for more learning materials? Check out these resources: [Quickstart Guide\ ----------------\ \ Dive into Dune in five minutes with our hands-on quickstart tutorial.](https://docs.dune.com/quickstart) [Web3 Data Resources\ -------------------\ \ Curated guides, dashboards, and tips for web3 data analysis.](https://docs.dune.com/learning-resources) [Discord Community\ -----------------\ \ Get help from the community in #beginners and #query-questions channels.](https://discord.gg/ErrzwBz) Was this page helpful? YesNo [Measuring User Activity](https://docs.dune.com/web-app/user-activity) [Support & Contact](https://docs.dune.com/resources/support/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Query Editor Overview - Dune Docs [Skip to main content](https://docs.dune.com/web-app/query-editor#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Write and Run Queries Query Editor Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Left Sidebar](https://docs.dune.com/web-app/query-editor#left-sidebar) * [Central Editor](https://docs.dune.com/web-app/query-editor#central-editor) * [Right Sidebar](https://docs.dune.com/web-app/query-editor#right-sidebar) * [Features at a Glance](https://docs.dune.com/web-app/query-editor#features-at-a-glance) The Query Editor is where you spend most of your time on Dune. It consists of three main areas: [​](https://docs.dune.com/web-app/query-editor#left-sidebar) Left Sidebar ---------------------------------------------------------------------------- The left sidebar gives you quick access to data discovery and query management tools. The most important panel here is the **[Data Explorer](https://docs.dune.com/web-app/query-editor/data-explorer) **, which connects you directly to Dune’s full [Data Catalog](https://docs.dune.com/data-catalog/overview) — letting you search for tables, inspect schemas, and insert columns into your query without leaving the editor. * **Data Explorer** — Browse and search across curated datasets, decoded contracts, raw blockchain tables, partner data, and your own uploaded data. You can search by table name, contract address, or keyword. See [Find Data Tables](https://docs.dune.com/web-app/query-editor/data-explorer) for a full guide. * **Query Explorer** — Search for and locate existing queries relevant to your analysis. * **[Version History](https://docs.dune.com/web-app/query-editor/version-history) ** — Review past edits to your query and revert to any previous version. * **Settings** — Configure query-level settings such as ownership and privacy. Double-click any sidebar icon to collapse or expand it. [​](https://docs.dune.com/web-app/query-editor#central-editor) Central Editor -------------------------------------------------------------------------------- The central editor is your main workspace for writing and running SQL. It includes a full-featured code editor with autocomplete, syntax highlighting, and inline error messages, along with a results panel where you can view output, sort columns, and build visualizations. See [Writing Queries](https://docs.dune.com/web-app/query-editor/query-window) for a detailed guide on editor features, autocomplete, keyboard shortcuts, and running queries. [​](https://docs.dune.com/web-app/query-editor#right-sidebar) Right Sidebar ------------------------------------------------------------------------------ The right sidebar contains tools for automating and exporting your work once a query is ready: * **[Query Scheduler](https://docs.dune.com/web-app/query-editor/query-scheduler) ** — Set queries to run automatically on a recurring schedule so your dashboards and data stay up to date. * **[Materialized Views](https://docs.dune.com/query-engine/materialized-views) ** — Save query results as reusable tables that other queries can reference directly. * **Export as CSV** — Download your query results for use in external tools or reports. * **[Alerts](https://docs.dune.com/web-app/alerts) ** — Configure notifications that trigger when your query results meet specific conditions. [​](https://docs.dune.com/web-app/query-editor#features-at-a-glance) Features at a Glance -------------------------------------------------------------------------------------------- [Writing Queries\ ---------------\ \ Write and execute SQL using autocomplete, run selection, and keyboard shortcuts.](https://docs.dune.com/web-app/query-editor/query-window) [Finding Tables\ --------------\ \ Browse and search Dune’s data catalog directly from the query editor sidebar.](https://docs.dune.com/web-app/query-editor/data-explorer) [Parameters\ ----------\ \ Add variables to your queries for dynamic, reusable analysis.](https://docs.dune.com/web-app/query-editor/parameters) [Query Lineage\ -------------\ \ Visualize all tables, views, and nested query dependencies.](https://docs.dune.com/web-app/query-editor/query-lineage) Was this page helpful? YesNo [Overview](https://docs.dune.com/web-app/overview) [Create your first query](https://docs.dune.com/learning/how-tos/create-your-first-query) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Schedule Queries and Dashboards - Dune Docs [Skip to main content](https://docs.dune.com/web-app/query-editor/query-scheduler#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Automate and Monitor Schedule Queries and Dashboards [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [How to Schedule a Query](https://docs.dune.com/web-app/query-editor/query-scheduler#how-to-schedule-a-query) * [Query Scheduling Limitations](https://docs.dune.com/web-app/query-editor/query-scheduler#query-scheduling-limitations) * [Adjusting or Cancelling a Query Schedule](https://docs.dune.com/web-app/query-editor/query-scheduler#adjusting-or-cancelling-a-query-schedule) * [Scheduling entire dashboards](https://docs.dune.com/web-app/query-editor/query-scheduler#scheduling-entire-dashboards) **Query Scheduling allows you to schedule a query to run at a specific time and frequency.** Queries on Dune usually execute when a user triggers an automatic or interactive execution. This means that if you have a dashboard that is not frequently viewed, the data displayed on the dashboard may be outdated and execution of the queries will only be triggered once a user views the dashboard. Especially for dashboards that contain resource-intensive queries, this can lead to long loading times for the viewer. To keep your dashboard up-to-date and to ensure that your queries are executed reliably and in a timely manner, you can schedule them to run at a specific time and frequency. Scheduled queries can be run on medium and large query engines, which will require credits. Credits are consumed based on actual compute resources used for each scheduled query execution. ### [​](https://docs.dune.com/web-app/query-editor/query-scheduler#how-to-schedule-a-query) How to Schedule a Query 1. Start by clicking the scheduler (clock) icon located at the bottom of the query editor, to the left of the “Run” button 2. A dialog will prompt you to set a refresh schedule and an execution tier. Please note that scheduled queries can only be run on medium and large query engines, which will require credits. 3. The dialog will display an estimated monthly credit consumption for this query scheduling, along with a monthly quota. These values will adjust based on the frequency and execution tier you select. 4. Save the schedule 5. Your query will execute once to start the schedule, and then will execute according to the schedule you set. #### [​](https://docs.dune.com/web-app/query-editor/query-scheduler#query-scheduling-limitations) Query Scheduling Limitations * Query scheduling is currently not available for queries with parameters. * The query schedule is removed when the queries are archived or when the ownership changes (e.g., when a query is migrated). * There are no notifications available for scheduled query failures as of now. Rest assured, these failures do not result in any charges to your account. #### [​](https://docs.dune.com/web-app/query-editor/query-scheduler#adjusting-or-cancelling-a-query-schedule) Adjusting or Cancelling a Query Schedule To modify or cancel a query schedule, click the scheduler (clock) icon again to reopen the scheduling dialog. From there you can adjust the frequency, time, or execution tier. To stop the schedule entirely, scroll to the bottom of the dialog and click the **Stop** button. ![](https://mintcdn.com/dune/YGGGbX8CdbsnZ9Ri/web-app/query-editor/images/query-scheduler/cancel-scheduled-query.png?w=2500&fit=max&auto=format&n=YGGGbX8CdbsnZ9Ri&q=85&s=57f439209388a8ce05babe5985e00138) ### [​](https://docs.dune.com/web-app/query-editor/query-scheduler#scheduling-entire-dashboards) Scheduling entire dashboards Instead of scheduling individual queries, you can also schedule entire dashboards. Learn more about scheduling dashboards [here](https://docs.dune.com/web-app/dashboards#sharing-your-dashboard) . Was this page helpful? YesNo [Build Dashboards](https://docs.dune.com/web-app/dashboards) [Set Up Alerts](https://docs.dune.com/web-app/alerts) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Charts and Graphs - Dune Docs [Skip to main content](https://docs.dune.com/web-app/visualizations/charts-graphs#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Visualize and Present Results Charts and Graphs [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Chart Types](https://docs.dune.com/web-app/visualizations/charts-graphs#chart-types) * [Visualization Configuration Options](https://docs.dune.com/web-app/visualizations/charts-graphs#visualization-configuration-options) * [X/Y-axis Tick and Label formats](https://docs.dune.com/web-app/visualizations/charts-graphs#x%2Fy-axis-tick-and-label-formats) Visualizations make your data come to life. You can create a visualization from any query result to surface trends, compare metrics, and share insights visually. Watch our [visualization tutorial video](https://docs.dune.com/resources/learning/video-tutorials#creating-graphs--charts) to see how to create charts step-by-step. [​](https://docs.dune.com/web-app/visualizations/charts-graphs#chart-types) Chart Types ------------------------------------------------------------------------------------------ Dune supports the following chart types. You can mix multiple types in a single visualization — for example, combining bars and lines — as long as your base chart is not a pie chart. Expand each type below to see an example. Bar Charts ![bar chart example](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/bar-chart-example.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=f209ee6996a68b1bdc71af6478f11f66) Area Charts ![area chart example](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/area-chart.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=4786100cba4f970b4eb6e1671d0e6371) Scatter Charts ![scatter chart example](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/scatter-chart-example.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=0d82ad0597560b3fceab58488a5debed) Line Charts ![line chart example](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/line-chart-example.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=bcfc6e28e1dc0143e02f5922d02cc490) Pie Charts ![pie chart example](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/pie-chart-example.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=04dcb76783d87935521583d923f58702) Mixed Graphs ![mixed graph example](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/mixed-graph-example.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=a2c4ff95a67d66268d0cd677d08c0c85) [​](https://docs.dune.com/web-app/visualizations/charts-graphs#visualization-configuration-options) Visualization Configuration Options ------------------------------------------------------------------------------------------------------------------------------------------ All chart types share a common set of configuration options. Use the tabs below to learn how to customize each aspect of your visualization. ![all visualization configuration options](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/all-visualization-configuration-options.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=2a6dd2b6a60ce366ffbf635c8c033f8b) * Chart options * Result data * X-axis options * Y-axis options * Series options * Pie options This section allows you to define how to display your data.![see explanations below](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/graphs-4.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=eeaf2da596b6bbb8a6380aab6bb1f877)**Title** * The title will appear in all instances of this graph prominently at the top. * The graph will always keep the name of the Query, even if you edit this. **Show chart legend** * Ticking this box will enable or disable the legend for the chart. **Enable stacking** * If applicable, ticking this box will stack the chart values on top of each other based on the x-axis values. * If this is not turned on, the values will be plotted individually on the y-axis. * The calculation underpinning this will always group the value corresponding to one value on the x-axis. Make sure your data is clean in able for this to work (avoid gaps in your data). **Normalize to percentage data** * This will normalize the chart to display percentage values of the chosen data table. * The calculation underpinning this will always group the value corresponding to one value on the x-axis. Make sure your data is clean in able for this to work (avoid gaps in your data). **Show data labels** * Ticking this box leads to the display of the individual datapoints inside of the graph. * This only makes sense in cases where you have few datapoints that are spread out far enough from each other to not overlap. Here you can pick the data points that are to be displayed.![see explanations below](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/graphs-5.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=c3fc9d257717e14ddb9382e021f54155)You can choose one **x-axis** and multiple **y-axis.**Alternatively, you can also choose one data series on the y-axis and choose to group it by a different column of your table (as shown in the example above). Using these options you can influence how your x-axis data gets displayed.![see explanations below](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/graphs-6.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=f9285168bdeff49212ffc9d22cb8f91b)**Axis title** * This field allows you to specify a title for your x-axis. **Sort Values** * by ticking this box you can specify if you want the values in your chart to be ordered. * If your x-axis is a time series, this will automatically happen. **Reverse value** * Ticking this box will reverse the order of the values on the x-axis. **Logarithmic** * Ticking this box will make your x-axis values display \_\_ logarithmically. With these options you can influence how your y-axis data gets displayed.![see explanations below](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/graphs-7.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=5f829a3b44698bb4f2f60897f8f6e17a)**Axis title** * This field allows you to specify a title for your y-axis. **Logarithmic** * Ticking this box will make your y-axis values display logarithmically. **Enable right y-axis** * Ticking this box will enable an additional y-axis that you can plot values on. * You can choose in the [chart series section](https://docs.dune.com/web-app/visualizations/web-app/visualizations/charts-graphs#ordering-your-series) what you want to be displayed on the left and right axis. ![](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/graphs-9.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=a83167f291e3d0b9855cbfdefd6e51ac)In this section of the Visualization editor you can finalize your graph. * You can rename the “series” by simply clicking into the field. * You can change the chart type by clicking into the dropdown. * You can change the colors by clicking into the color box. * Finally you can also change the order of the series. **Picking Colors**You can pick colors with your browser native color selector.This might look slightly different for you depending on which browser you use.![Choose any color you want!](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/graphs-color.gif?s=53484f9452c7189790f0ddaaf726a75e) ![pie options](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/pie-options.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=cf958798caeb861d5bf36f604ac31ecf)**Label format** * This field allows you to define the [tick format](https://docs.dune.com/web-app/visualizations/charts-graphs#xy-axis-tick-and-label-formats) of the data labels in your pie chart. ### [​](https://docs.dune.com/web-app/visualizations/charts-graphs#x/y-axis-tick-and-label-formats) X/Y-axis Tick and Label formats ![image](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/charts-graphs/graphs-8.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=43c573aa100324be68c21de4e34a61fc) Tick formats change how numeric values and axis labels in your graphs are displayed. Here’s how to format them: | Starting Value | Tick/Label format | Output | Description | | --- | --- | --- | --- | | 1256784.3745 | `[blank]` | 1256784.3745000 | Displays the number 7 decimal precision. | | 1256784.3745 | `0` | 1256784 | Displays only the integer. | | 1256784.3745 | `0,0` | 1,256,784 | Only displays the integer with comma separation. | | 1256784.3745 | `0,0.00` | 1,256,784.38 | Displays the number with `[x]` decimal precision, where `[x]` is the number of `0` you add after the decimal point. | | 1256784.3745 | `0.0a` | 1.2M | Displays the number with `[x]` precision and a letter based on the number’s `1e[y]` power (eg “m” for million, “b” for billion) | | 1256784.3745 | `$0.0a` | $1.2M | Adds a ”$” to the number. Works with all formats above though use of the `a` suffix is recommended. Currently the only ”$” is the only supported currency symbol. | Was this page helpful? YesNo [Create your first visualization](https://docs.dune.com/learning/how-tos/create-your-first-visualization) [Counters](https://docs.dune.com/web-app/visualizations/counters) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Teams and Roles - Dune Docs [Skip to main content](https://docs.dune.com/web-app/teams#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Manage Your Team Teams and Roles [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Create a Team](https://docs.dune.com/web-app/teams#create-a-team) * [Invite Members and Assign Roles](https://docs.dune.com/web-app/teams#invite-members-and-assign-roles) * [Team Content](https://docs.dune.com/web-app/teams#team-content) * [Switch Between Contexts](https://docs.dune.com/web-app/teams#switch-between-contexts) * [Manage Subscriptions](https://docs.dune.com/web-app/teams#manage-subscriptions) * [Transfer Ownership](https://docs.dune.com/web-app/teams#transfer-ownership) * [Transfer a Query](https://docs.dune.com/web-app/teams#transfer-a-query) * [Transfer a Dashboard](https://docs.dune.com/web-app/teams#transfer-a-dashboard) * [FAQ](https://docs.dune.com/web-app/teams#faq) Team accounts on Dune provide a shared workspace for collaboration. Teams can be created without a paid plan, but [Plus and Enterprise subscription features](https://dune.com/pricing) are available only to teams, not individual accounts. **Key benefits:** * **Collaborate on shared content.** Multiple team members work on the same queries and dashboards. * **Shared credits and paid features.** All team members can spend credits and access private content. * **Team profile.** Showcase all of your team’s work in one place. * **Role-based access.** Assign viewers, editors, or admins to control permissions. [​](https://docs.dune.com/web-app/teams#create-a-team) Create a Team ----------------------------------------------------------------------- 1. Navigate to the **global context switcher** at the top of the page. 2. Select **“Create new team”** from the dropdown. 3. Complete the team creation process. Every team must have a unique name that has not been used before. [​](https://docs.dune.com/web-app/teams#invite-members-and-assign-roles) Invite Members and Assign Roles ----------------------------------------------------------------------------------------------------------- After creating your team, invite members and assign roles: * **Admin:** Full control over settings, memberships, and content. * **Editor:** Can create and edit queries and dashboards under the team. * **Viewer:** Can view team content and spend credits. Click **“Invite People”** in the team settings or share a direct invitation URL. When you invite a user, they receive an email with a link to join. They can also go to [Settings > Teams](https://dune.com/settings/teams) to accept the invite. [​](https://docs.dune.com/web-app/teams#team-content) Team Content --------------------------------------------------------------------- Team queries and dashboards are created the same way as individual content. The **context** you are in (personal or team) determines who owns the content you create. You can change ownership of any query or dashboard in its Settings page. ![Team content](https://mintcdn.com/dune/cGOHlF0puMR7caG6/web-app/images/teams/query-settings-new.png?w=2500&fit=max&auto=format&n=cGOHlF0puMR7caG6&q=85&s=e7db800bc165b9aac00f737273250653) Once you transfer content to a team, only an Admin can transfer it back out. If you accidentally transfer content, ask a team Admin to transfer it back. [​](https://docs.dune.com/web-app/teams#switch-between-contexts) Switch Between Contexts ------------------------------------------------------------------------------------------- Use the global context switcher to toggle between your personal account and team accounts. The context determines: * Which content appears in “My Creations” * Which credit balance is used for query execution * Who owns newly created content ![](https://mintcdn.com/dune/cGOHlF0puMR7caG6/web-app/images/teams/context-switcher-new.png?w=2500&fit=max&auto=format&n=cGOHlF0puMR7caG6&q=85&s=a575247c1e47cac7838bf4b232ceedee) You can spend team credits on any content regardless of ownership, and edit team content from either context. Version History edits are always attributed to your personal account. [​](https://docs.dune.com/web-app/teams#manage-subscriptions) Manage Subscriptions ------------------------------------------------------------------------------------- Navigate to the team account settings page to: * **Modify your plan:** Change subscription plan or switch to annual billing. * **View usage statistics:** Check credits, CSV uploads, and private content quotas. You can also [export detailed credit usage data](https://docs.dune.com/learning/how-tos/credit-system-on-dune#export-credit-usage-data) . * **Manage additional credits:** Set a maximum dollar amount for pay-as-you-go credits in the “Limit extra credits” field (default is $0). [​](https://docs.dune.com/web-app/teams#transfer-ownership) Transfer Ownership --------------------------------------------------------------------------------- You can transfer ownership of queries and dashboards between team members, teams, or your personal account. ### [​](https://docs.dune.com/web-app/teams#transfer-a-query) Transfer a Query 1. Click the cogwheel button to open query settings. 2. In the “Owner” dropdown, select the new owner — you can transfer to a team member or to a team. ![Transfer query ownership between a user and a team](https://mintcdn.com/dune/njsi6hUWS8fj_Gsl/web-app/images/teams/user-team-dune-data-hub-transfer.png?w=2500&fit=max&auto=format&n=njsi6hUWS8fj_Gsl&q=85&s=333073f810277ff2c15861379cd5114c) ### [​](https://docs.dune.com/web-app/teams#transfer-a-dashboard) Transfer a Dashboard 1. Click **Edit**, then **Settings** to open the modal. 2. Select the new owner in the “Owner” dropdown. You can view ownership changes in the [Version History](https://docs.dune.com/web-app/query-editor/version-history) . [​](https://docs.dune.com/web-app/teams#faq) FAQ --------------------------------------------------- Can I have private content? Private dashboards and queries are available for the team or personal account they belong to. How do I change my role? Ask one of your team admins. Every team must always have at least one admin. Can I remove people from my team? Yes, in the People section of your team’s Settings page. Can I transfer content to another team? Yes, in the Settings page of the query or dashboard you want to transfer. Can I transfer content to another user? Yes, but the target user must be a member of your team. If they are not, invite them first. Can I transfer content to my personal account? Yes, in the Settings page of the query or dashboard you want to transfer. Was this page helpful? YesNo [FAQs](https://docs.dune.com/web-app/decoding/faqs) [Google SSO](https://docs.dune.com/web-app/google-sso-domain-restriction) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Query Templates - Dune Docs [Skip to main content](https://docs.dune.com/learning/how-tos/query-templates#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Write and Run Queries Query Templates [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Tokens](https://docs.dune.com/learning/how-tos/query-templates#tokens) * [Trades](https://docs.dune.com/learning/how-tos/query-templates#trades) * [Contracts](https://docs.dune.com/learning/how-tos/query-templates#contracts) * [Farcaster](https://docs.dune.com/learning/how-tos/query-templates#farcaster) * [How to Use Templates](https://docs.dune.com/learning/how-tos/query-templates#how-to-use-templates) * [Template Categories Explained](https://docs.dune.com/learning/how-tos/query-templates#template-categories-explained) * [Tokens](https://docs.dune.com/learning/how-tos/query-templates#tokens-2) * [Trades](https://docs.dune.com/learning/how-tos/query-templates#trades-2) * [Contracts](https://docs.dune.com/learning/how-tos/query-templates#contracts-2) * [Farcaster](https://docs.dune.com/learning/how-tos/query-templates#farcaster-2) * [Getting Started](https://docs.dune.com/learning/how-tos/query-templates#getting-started) * [Need Help?](https://docs.dune.com/learning/how-tos/query-templates#need-help) Jump start your Dune journey with our collection of pre-built query templates. These templates let you easily select wallets, tokens, and contracts and track their key actions over time. **Need a specific template?** Don’t see what you’re looking for? [Request a new template](https://docs.google.com/forms/d/e/1FAIpQLSeDjR0908lRRroCzRHSD9SnBKSS5hox-_AbLJahH7ZmBuf5hA/viewform?usp=header) and we’ll consider adding it to our collection. [​](https://docs.dune.com/learning/how-tos/query-templates#tokens) Tokens ---------------------------------------------------------------------------- Track token flows, balances, and holder activity across different token standards. Contract Balance and Flow Monitoring - ERC20 Token Track the net flows of an ERC20 token into contracts, over a given time period. [Open in Dune →](https://dune.com/queries/5823843) Wallet Balance and Flow Monitoring - ERC20 Token Track the net flows of top holders (or a list of addresses) for an ERC20 token, over a given time period. [Open in Dune →](https://dune.com/queries/5823857) Contract Balance and Flow Monitoring - NFT Token (721/1155) Track the net flows of an NFT token into contracts, over a given time period. [Open in Dune →](https://dune.com/queries/5823861) Wallet Balance and Flow Monitoring - NFT Token (721/1155) Track the net flows of top holders (or a list of addresses) for an NFT token, over a given time period. [Open in Dune →](https://dune.com/queries/5833534) [​](https://docs.dune.com/learning/how-tos/query-templates#trades) Trades ---------------------------------------------------------------------------- Monitor trading activity across DEXs and NFT marketplaces. DEX Trade Monitoring Track trading volume, price movements, and liquidity patterns for token pairs. [Open in Dune →](https://dune.com/queries/5833536) NFT Trade Monitoring Monitor NFT trading activity, floor prices, and collection performance. [Open in Dune →](https://dune.com/queries/5833538) [​](https://docs.dune.com/learning/how-tos/query-templates#contracts) Contracts ---------------------------------------------------------------------------------- Analyze smart contract interactions and usage patterns. New Wallets Calling a Contract Identify new users interacting with a specific smart contract over time. [Open in Dune →](https://dune.com/queries/5833540) New Contracts Calling Another Contract Track which new contracts are calling a specific contract. [Open in Dune →](https://dune.com/queries/5833541) Trending Contracts Called by Tracked Wallet Discover which contracts a tracked wallet is calling most frequently. [Open in Dune →](https://dune.com/queries/5833544) [​](https://docs.dune.com/learning/how-tos/query-templates#farcaster) Farcaster ---------------------------------------------------------------------------------- Analyze social activity and user behavior on the Farcaster protocol. Identify trending users who hold a token Find Farcaster users who hold specific tokens and are gaining social traction. [Open in Dune →](https://dune.com/queries/5833549) Identify trending channels Discover which Farcaster channels are gaining popularity and activity. [Open in Dune →](https://dune.com/queries/5833553) Track trending users someone has interacted with Analyze the social network of a specific user to find trending connections. [Open in Dune →](https://dune.com/queries/5833555) [​](https://docs.dune.com/learning/how-tos/query-templates#how-to-use-templates) How to Use Templates -------------------------------------------------------------------------------------------------------- 1. **Expand any template** above to see a preview of the query results 2. **Click “Open in Dune”** to open the query in the Dune editor 3. **Customize the parameters** using the template’s input fields: * **Token Symbol**: Choose the token you want to track * **Token Contract**: Paste the contract address if the token isn’t in our database * **Blockchain**: Select the blockchain network * **Time Period**: Set the number of days to analyze * **Filters**: Adjust minimum thresholds and other parameters 4. **Run the query** to see your results 5. **Save and share** your customized query [​](https://docs.dune.com/learning/how-tos/query-templates#template-categories-explained) Template Categories Explained -------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/learning/how-tos/query-templates#tokens-2) **Tokens** Perfect for analyzing token economics, holder behavior, and token flows. Use these templates to understand how tokens move between wallets and contracts. ### [​](https://docs.dune.com/learning/how-tos/query-templates#trades-2) **Trades** Ideal for market analysis, price tracking, and trading pattern identification. Essential for understanding market dynamics and liquidity. ### [​](https://docs.dune.com/learning/how-tos/query-templates#contracts-2) **Contracts** Great for smart contract analytics, user adoption tracking, and protocol interaction analysis. Use these to understand how users interact with specific protocols. ### [​](https://docs.dune.com/learning/how-tos/query-templates#farcaster-2) **Farcaster** Designed for social analytics on the Farcaster protocol. Perfect for understanding community dynamics, influencer identification, and social trends. [​](https://docs.dune.com/learning/how-tos/query-templates#getting-started) Getting Started ---------------------------------------------------------------------------------------------- 1. **Choose your category** based on what you want to analyze 2. **Select a template** that matches your use case 3. **Customize the parameters** to fit your specific needs 4. **Run and iterate** to refine your analysis **Pro Tip**: Start with a template and modify it to create your own unique queries. Templates are designed to be building blocks for more complex analysis. [​](https://docs.dune.com/learning/how-tos/query-templates#need-help) Need Help? ----------------------------------------------------------------------------------- * **Query Editor Guide**: Learn how to use the Dune query editor effectively * **Writing Efficient Queries**: Optimize your queries for better performance * **Data Catalog**: Explore available data sources and tables * **Community**: Join our Discord for help and inspiration * * * **Don’t see what you need?** [Request a new template](https://docs.google.com/forms/d/e/1FAIpQLSeDjR0908lRRroCzRHSD9SnBKSS5hox-_AbLJahH7ZmBuf5hA/viewform?usp=header) and we’ll consider adding it to our collection. Was this page helpful? YesNo [Using Parameters](https://docs.dune.com/web-app/query-editor/parameters) [AI Query Tools](https://docs.dune.com/web-app/dune-ai) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Create your first visualization - Dune Docs [Skip to main content](https://docs.dune.com/learning/how-tos/create-your-first-visualization#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Visualize and Present Results Create your first visualization [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) After executing a query, you’ll be presented with a set of results. The next logical step? Visualize that data for a clearer insight. This guide will show you how to layer a combined bar and line chart atop the data from [Create your first query](https://docs.dune.com/learning/how-tos/create-your-first-query) . Here is a visual click-through version if you are more of a visual learner. Below is a written version. 1. **Begin Visualization**: Click on “New” and select your desired chart type. For this tutorial, initiate with a bar chart and click “Bar Chart.” 2. **Display Data**: By default, the chart will showcase `monthly_gas_spent`. To augment the depth of insights, include the `cumulative_gas_spent` column. 3. **Adjust Chart Type**: Transition the representation of `cumulative_gas_spent` from a bar to a line chart, offering a more nuanced view. 4. **Fine-tune Your Chart**: Customize the display values for a polished look. For detailed formatting guidance, [refer to this resource](https://docs.dune.com/learning/how-tos/web-app/visualizations/charts-graphs) . You can also use the AI Chart Builder to automatically generate the charts for your data. 1. **Click Generate** When you click generate, the AI Chart Builder will suggest a title and chart type based on your data. 2. If you are happy with the recommendation, click **Create** to add the chart to your dashboard. 3. Otherwise, you can edit the title or the chart type and then click **Create** to create the chart. 4. (Optional) **Fine-tune Your Chart**: Customize the display values for a polished look. For detailed formatting guidance, [refer to this resource](https://docs.dune.com/learning/how-tos/web-app/visualizations/charts-graphs) . Was this page helpful? YesNo [AI Query Tools](https://docs.dune.com/web-app/dune-ai) [Charts and Graphs](https://docs.dune.com/web-app/visualizations/charts-graphs) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Create your first query - Dune Docs [Skip to main content](https://docs.dune.com/learning/how-tos/create-your-first-query#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Write and Run Queries Create your first query [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Getting Started](https://docs.dune.com/learning/how-tos/create-your-first-query#getting-started) * [Choosing the Right Table](https://docs.dune.com/learning/how-tos/create-your-first-query#choosing-the-right-table) * [Building Your Query Step by Step](https://docs.dune.com/learning/how-tos/create-your-first-query#building-your-query-step-by-step) * [Understanding the Query Components](https://docs.dune.com/learning/how-tos/create-your-first-query#understanding-the-query-components) * [Making Your Analysis Dynamic with Parameters](https://docs.dune.com/learning/how-tos/create-your-first-query#making-your-analysis-dynamic-with-parameters) * [Visualizing Results](https://docs.dune.com/learning/how-tos/create-your-first-query#visualizing-results) * [Next Steps](https://docs.dune.com/learning/how-tos/create-your-first-query#next-steps) New to Dune? Let’s start your analytics journey by creating an insightful query that analyzes daily DEX trading volumes across different blockchains. This guide will teach you the basics while delivering practical insights about DeFi trading activity. [​](https://docs.dune.com/learning/how-tos/create-your-first-query#getting-started) Getting Started ------------------------------------------------------------------------------------------------------ **Create a New Query**: Head over to [Create New Query](https://dune.com/queries) to begin. Dune uses DuneSQL, a SQL dialect that is compatible with TrinoSQL. It is a fairly vanilla SQL dialect, but there are some nuances you will eventually encounter. If you are not familiar with SQL, you can learn the basics [here](https://www.w3schools.com/sql/) . [​](https://docs.dune.com/learning/how-tos/create-your-first-query#choosing-the-right-table) Choosing the Right Table ------------------------------------------------------------------------------------------------------------------------ Choosing the right table is the first step to creating a successful query. You can find the table you need in the [Data Catalog](https://docs.dune.com/data-catalog) . 1. **Understanding curated data**: Instead of working with complex raw blockchain data, we’ll use Dune’s curated data - a collection of pre-built, analytics-ready tables. Curated data standardizes data across chains and makes analysis much easier. 2. **The Perfect Table**: For DEX trading analysis, we’ll use the [`dex.trades`](https://docs.dune.com/learning/how-tos/data-catalog/curated/dex-trades/evm/dex-trades) table. This table contains standardized trading data across multiple DEXes and blockchains. [​](https://docs.dune.com/learning/how-tos/create-your-first-query#building-your-query-step-by-step) Building Your Query Step by Step ---------------------------------------------------------------------------------------------------------------------------------------- Let’s analyze DEX trading activity across different blockchains. We’ll start simple and build up our analysis: 1. **Select Key Metrics**: For our DEX analysis, we’ll track: * Block date (to see trends over time) * Blockchain (to compare activity across networks) * Trading volume in USD * Number of trades Here’s our query: Copy Ask AI SELECT block_date, blockchain, COUNT(*) as number_of_trades, SUM(amount_usd) as trading_volume_usd FROM dex.trades WHERE block_date >= NOW() - INTERVAL '30' day GROUP BY 1, 2 ORDER BY 1 DESC, 4 DESC [​](https://docs.dune.com/learning/how-tos/create-your-first-query#understanding-the-query-components) Understanding the Query Components -------------------------------------------------------------------------------------------------------------------------------------------- Each part of this query helps us analyze DEX activity: * `block_date`: Groups all trades into daily buckets * `blockchain`: Helps us compare activity across Ethereum, Polygon, Arbitrum, etc. * `COUNT(*)`: Gives us the trading frequency * `SUM(amount_usd)`: Shows the total value traded in USD * `WHERE block_date >= NOW() - INTERVAL '30 days'`: Focuses on recent activity * `GROUP BY 1, 2, 3`: Combines trades by day, blockchain, and DEX * `ORDER BY 1 DESC, 5 DESC`: Shows newest and highest volume trades first [​](https://docs.dune.com/learning/how-tos/create-your-first-query#making-your-analysis-dynamic-with-parameters) Making Your Analysis Dynamic with Parameters ---------------------------------------------------------------------------------------------------------------------------------------------------------------- Want to focus on your favorite DEX? Let’s add the column `project` as a parameter to make the analysis interactive: Copy Ask AI SELECT block_date, blockchain, project, COUNT(*) as number_of_trades, SUM(amount_usd) as trading_volume_usd FROM dex.trades WHERE block_date >= NOW() - INTERVAL '30' day AND project = '{{Project Name}}' -- Try 'uniswap' or 'curve' GROUP BY 1, 2, 3 ORDER BY 1 DESC, 5 DESC To add the parameter: 1. Click “Add Parameter” below the query editor 2. Create a text parameter named “Project Name” 3. Set default value to “Uniswap” Now you can instantly switch between different DEXes to compare their performance! [​](https://docs.dune.com/learning/how-tos/create-your-first-query#visualizing-results) Visualizing Results -------------------------------------------------------------------------------------------------------------- After running your query, you can create powerful visualizations: 1. Click “New Visualization” 2. Choose “Bar Chart” 3. Set X-axis to `trading_day` 4. Set Y-axis to `trading_volume_usd` 5. Group by `blockchain` This will create a stacked bar chart showing daily trading volumes by blockchain! Want to explore more? Try: * Removing the project filter to see all DEXes * Changing the time period to 7 days or 90 days * Adding token filters to focus on specific cryptocurrencies [​](https://docs.dune.com/learning/how-tos/create-your-first-query#next-steps) Next Steps -------------------------------------------------------------------------------------------- Congratulations on creating your first DEX analysis query! 🎉 You can find many more queries related to DEX trading activity in this dashboard: [DEX Trading Activity](https://dune.com/hagaetc/dex-metrics) Save your query by clicking **Save** in the upper right corner. You can revisit and modify it anytime to explore different aspects of DEX trading activity. Ready to create more advanced queries? Check out our other guides to learn more about Dune Was this page helpful? YesNo [Query Editor Overview](https://docs.dune.com/web-app/query-editor) [Writing Queries](https://docs.dune.com/web-app/query-editor/query-window) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # How Contract Decoding Works - Dune Docs [Skip to main content](https://docs.dune.com/web-app/decoding/decoding-contracts#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Decode Smart Contracts How Contract Decoding Works [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [A. The Lifecycle of Decoding](https://docs.dune.com/web-app/decoding/decoding-contracts#a-the-lifecycle-of-decoding) * [Step 1: Submission](https://docs.dune.com/web-app/decoding/decoding-contracts#step-1-submission) * [When do you need Several Instances Options?](https://docs.dune.com/web-app/decoding/decoding-contracts#when-do-you-need-several-instances-options) * [Enable bytecode matching](https://docs.dune.com/web-app/decoding/decoding-contracts#enable-bytecode-matching) * [Decode other contracts created by the same factory](https://docs.dune.com/web-app/decoding/decoding-contracts#decode-other-contracts-created-by-the-same-factory) * [Dynamic vs Factory Decoded](https://docs.dune.com/web-app/decoding/decoding-contracts#dynamic-vs-factory-decoded) * [Other Special Contracts](https://docs.dune.com/web-app/decoding/decoding-contracts#other-special-contracts) * [Proxy contract](https://docs.dune.com/web-app/decoding/decoding-contracts#proxy-contract) * [Diamond proxy contracts](https://docs.dune.com/web-app/decoding/decoding-contracts#diamond-proxy-contracts) * [Resubmissions](https://docs.dune.com/web-app/decoding/decoding-contracts#resubmissions) * [Step 2: Decoding](https://docs.dune.com/web-app/decoding/decoding-contracts#step-2-decoding) * [Step 3: Finding Your Decoded Contract](https://docs.dune.com/web-app/decoding/decoding-contracts#step-3-finding-your-decoded-contract) * [B. Need Help?](https://docs.dune.com/web-app/decoding/decoding-contracts#b-need-help) * [Additional Questions?](https://docs.dune.com/web-app/decoding/decoding-contracts#additional-questions) **Dune’s extensive catalog of decoded smart contracts are driven by our analysts. Our decoding process empowers our community to submit the data and build the tables that they’d like to query on Dune!** But what does decoding mean? Blockchain transaction data starts as bytecode, a low level programming language that can be read by machines. Using the ABI (Application Binary Interface) that is specific to each contract, we translate that bytecode into query-able data tables. [Explore decoded data\ --------------------](https://docs.dune.com/data-catalog/evm/ethereum/decoded/overview) [​](https://docs.dune.com/web-app/decoding/decoding-contracts#a-the-lifecycle-of-decoding) A. The Lifecycle of Decoding ========================================================================================================================== [​](https://docs.dune.com/web-app/decoding/decoding-contracts#step-1-submission) Step 1: Submission ------------------------------------------------------------------------------------------------------ Our decoding process begins with our [contract submission page](https://dune.com/contracts/new) . ![](https://mintcdn.com/dune/SVgi72CZX0mBmKw8/web-app/images/decoding-contracts/submit-contract-03202025.png?w=2500&fit=max&auto=format&n=SVgi72CZX0mBmKw8&q=85&s=8cc926ce172af60d644a464cc115e49f) To successfully submit a contract, you will need four pieces of information: 1. **Blockchain**: Blockchain the contract is deployed on 2. **Contract Address**: The address of the contract you want to decode 3. **Project Name**: The name of the project that the contract originates from (e.g. Tether, Uniswap, Bancor) 4. **Contract Name**: The name of the smart contract as given by the project (ex. USDT, Pair, LiquidityFactory) 5. **ABI**: Unique to each smart contract. Further details can be found [here](https://docs.soliditylang.org/en/latest/abi-spec.html) . Note that for contracts that are verified by a chain’s explorer we will attempt to auto-fetch the ABI. Otherwise the ABI will need to be entered manually. In most cases, the contract name will be pulled directly from a blockchain scanner. We recommend using the name provided. If the name is not automatically provided, please follow our naming conventions to assure the contract is properly assimilated into Dune’s database. ### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#when-do-you-need-several-instances-options) When do you need Several Instances Options? #### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#enable-bytecode-matching) Enable bytecode matching Contract “instances” are contracts on the same chain with the same bytecode (and therefore the same ABI) for **the same project**. If you check this box, Dune can decode all instances of this project on the given blockchain with the same bytecode and ABI, consolidating them into the same tables under one `namespace.project` directory without multiple submissions. To check for other instances of the contract, go to a blockchain explorer and look for “Similar Match Source Code” under the Contract tab. Here is [an example](https://etherscan.io/address/0x58a70c59cb1f0e30c3d7ad84b96170221cbf322f#code) : ![](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/similar-match-source-code.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=734521f8b4531115b879f4a8b2349fcd) **Decoded via dynamic contract detection** Contracts decoded this way are referred to as dynamically decoded by Dune. These are contracts that are decoded automatically because users checked the box “Are there several instances of this contract?” when submitting the contract. Note that Dune only considers a contract a dynamic instance if the bytecode matches 100%. This is done by querying the `_creation_traces` table and matching the `code` field. If the bytecode does not match 100%, we will not decode that instance. For example, [this contract](https://arbiscan.io/address/0x999946a4f40fd2c82d66a68edfefa8430f206c9c#code) is nearly identical to [this other contract](https://arbiscan.io/address/0x692e92da68f9b8445a167b985ee0cb38c3bbe594#code) in terms of bytecode, but Dune currently does not dynamically decode the first contract because we currently require a 100% bytecode match. #### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#decode-other-contracts-created-by-the-same-factory) Decode other contracts created by the same factory A [factory contract](https://betterprogramming.pub/learn-solidity-the-factory-pattern-75d11c3e7d29) is a smart contract that creates other smart contracts. If there are multiple instances of a contract, it might be due to a factory contract. If you check this box, Dune can decode all contracts created by the same factory that use the same ABI, consolidating them into the same tables under one `namespace.project` directory (e.g., [Pair contract from Uniswap V2](https://dune.com/queries?category=decoded_project&blockchain=ethereum&namespace=uniswap_v2&contract=Pair&blockchains=ethereum) ). When you submit a contract as a factory contract, Dune verifies it by checking if the deployer (`from` address) is a contract and not an EOA. This is done by querying the `_creation_traces` table. If the `from` address is a contract, Dune will gather all `address` fields created by it for decoding. To check if a contract is created by a factory, use a blockchain explorer to see if the “From” address in a Contract Creation transaction is a contract or an EOA. For example, this is [a factory-created contract](https://etherscan.io/address/0x5d5ce36e0b328a48539b48d4f22c31f0fe3dc040#internaltx) by [Uniswap V3 factory](https://etherscan.io/address/0x1f98431c8ad98523631ae4a59f267346ea31f984) . ![](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/factory-created-contract.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=1d4a141247b9a9cede439f42945cc4eb) **Decoded via the factory pattern** Contracts decoded this way are referred to as factory decoded by Dune. These contracts are automatically decoded because users checked “Is it created by a factory contract?” when submitting. Dune detects this by querying the `_creation_traces` table and fetching all `address` fields created by the same `from`. #### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#dynamic-vs-factory-decoded) Dynamic vs Factory Decoded Dynamic decoding anchors on the bytecode being the same, while factory decoding also requires the contract to be deployed by another contract (not an EOA) with the same deployer address. **Dynamically Decoded Contracts** share the same bytecode but may have different deployers. For example, [this contract](https://etherscan.io/address/0x58a70c59cb1f0e30c3d7ad84b96170221cbf322f) can be decoded as dynamic because it has the same bytecode as [this contract](https://etherscan.io/address/0x6d396aaff9f438e2f86979d8367cd9deb364b16f) . Both will appear under the same decoded tables in the [SmartTokens for Bancor](https://dune.com/queries?category=decoded_project&blockchain=ethereum&namespace=bancor&contract=SmartToken&blockchains=ethereum) directory but have different deployers (`from` address). **Factory Decoded Contracts** are deployed by a factory contract and share the same deployer address. For example, contracts created by the [Uniswap V3 Factory](https://etherscan.io/address/0x1f98431c8ad98523631ae4a59f267346ea31f984) , such as [this one](https://etherscan.io/address/0xb5925e4c1912e3999891f0e71bd3d9b5492d1486#internaltx) and [this one](https://etherscan.io/address/0x5d5ce36e0b328a48539b48d4f22c31f0fe3dc040#internaltx) , are factory decoded because they share the same bytecode and deployer. These contracts will appear under the same decoded tables in the [Pair for Uniswap V3](https://dune.com/queries?category=decoded_project&blockchain=ethereum&namespace=uniswap_v3&contract=Pair&blockchains=ethereum) directory. ### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#other-special-contracts) Other Special Contracts Other special smart contracts can be decoded as well, following these conventions: #### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#proxy-contract) [Proxy contract](https://info.etherscan.com/what-is-proxy-contract/) Submit using the proxy address but with the ABI of the implementation. You can identify a proxy contract by looking for the “Read as Proxy” tab on a blockchain explorer. This tab will also show the implementation contract. Here is [an example](https://arbiscan.io/address/0x90a664846960aafa2c164605aebb8e9ac338f9a0#readProxyContract) . ![](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/proxy-find-implementation.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=d0e12e9d30802b33b1e20a96a7f5fc04) To decode: 1. Use the address of the [proxy contract](https://arbiscan.io/address/0x90a664846960aafa2c164605aebb8e9ac338f9a0) . 2. Fetch the ABI of the [implementation contract](https://arbiscan.io/address/0x90a664846960aafa2c164605aebb8e9ac338f9a0#readProxyContract) . ![](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/submit-proxy-03202025.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=58ed24ece6a156c3ad81d2fb4c6c9edb) #### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#diamond-proxy-contracts) Diamond proxy contracts Submit all the facets using just the same name for the project and contract and upload all the relevant ABIs. This can be done with one ABI representing all facets or separate ABIs for each facet. **Where can I find this information?**Contract addresses can usually be found in a project’s docs. Once you have the contract address, you can use a blockchain explorer to get the rest of the information. Most blockchain explorers have everything you need! ### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#resubmissions) Resubmissions Sometimes you need to resubmit a contract because the name is originally submitted wrong, or you need to update the ABI. Follow the steps as guided. But if you are resubmitting for other reason not listed in the dropdown, provide as much detail as possible to avoid the resubmission being rejected. ![](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/resubmission-contract.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=c961b8aa843f4e09d00ab3e439c54e5f) [​](https://docs.dune.com/web-app/decoding/decoding-contracts#step-2-decoding) Step 2: Decoding -------------------------------------------------------------------------------------------------- Once the contract has been approved for decoding, you will receive a notification in your email. While the table itself may be visible after approval, it may be empty. No reason to worry! Note that it takes around 24 hours from the time the contract has been approved to be fully decoded and incorporated into the Dune database. At any point you can check the status of your submitted contract under “Contracts” in your settings. [​](https://docs.dune.com/web-app/decoding/decoding-contracts#step-3-finding-your-decoded-contract) Step 3: Finding Your Decoded Contract -------------------------------------------------------------------------------------------------------------------------------------------- One quick tip to find and begin querying your decoded table is to use Dune’s Explorer. When beginning a new query, the Explorer is located to the left side of the Query Editor. From there, follow simple steps: 1. Drop the contract address of your decoded contract in the search bar 2. Pull up the specific function or event you are looking for 3. use the **\>>** button to immediately populate that table in your Query Editor. ![The search bar and >> symbol that will help you get started](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/3.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=cd9439402709f30520cdd0a73cbbd1b9) Then it’s all ready for you to query. Let the data flow! [​](https://docs.dune.com/web-app/decoding/decoding-contracts#b-need-help) B. Need Help? =========================================================================================== For frequently asked questions about decoding contracts, check out our [Decoding FAQs](https://docs.dune.com/web-app/decoding/faqs) . ### [​](https://docs.dune.com/web-app/decoding/decoding-contracts#additional-questions) Additional Questions? Head over to the [#decoding Discord channel](https://discord.com/channels/757637422384283659/850326962152538122) and we’ll be happy to help! Was this page helpful? YesNo [Search and Discover](https://docs.dune.com/web-app/search) [Submission Best Practices](https://docs.dune.com/web-app/decoding/best-practices) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # How Credits Work - Dune Docs [Skip to main content](https://docs.dune.com/resources/credits-billing/how-credits-work#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Credits & Billing How Credits Work [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [How you spend credits on Dune](https://docs.dune.com/resources/credits-billing/how-credits-work#how-you-spend-credits-on-dune) * [How the Credit System Works](https://docs.dune.com/resources/credits-billing/how-credits-work#how-the-credit-system-works) * [Credit Pricing](https://docs.dune.com/resources/credits-billing/how-credits-work#credit-pricing) * [Managing Your Credit Usage](https://docs.dune.com/resources/credits-billing/how-credits-work#managing-your-credit-usage) * [Need Help?](https://docs.dune.com/resources/credits-billing/how-credits-work#need-help) * [FAQ](https://docs.dune.com/resources/credits-billing/how-credits-work#faq) * [Pricing & Plans](https://docs.dune.com/resources/credits-billing/how-credits-work#pricing-%26-plans) * [Usage & Monitoring](https://docs.dune.com/resources/credits-billing/how-credits-work#usage-%26-monitoring) * [Optimization & Support](https://docs.dune.com/resources/credits-billing/how-credits-work#optimization-%26-support) [​](https://docs.dune.com/resources/credits-billing/how-credits-work#how-you-spend-credits-on-dune) How you spend credits on Dune ==================================================================================================================================== Dune uses a usage-based credit system that charges based on actual compute resources consumed, ensuring fair pricing for all users regardless of query complexity. See full blog post announcement [here](https://dune.com/blog/credits-changing) [​](https://docs.dune.com/resources/credits-billing/how-credits-work#how-the-credit-system-works) How the Credit System Works -------------------------------------------------------------------------------------------------------------------------------- Our query engine uses a flexible credit-based pricing model that scales with your actual resource consumption. When you run a query, credits are spent in proportion to the resources used—simple queries cost fewer credits, while complex queries that require more computational resources use more credits. This approach ensures fair pricing across our platform, which spans 100+ chains, complex tables, and multiple ways to consume data through APIs and various connector options. The credit system adapts to your needs: small, efficient queries are economical, while larger, more complex queries can leverage extended timeouts and additional resources as needed. Your credits work seamlessly across all query types and data consumption methods, providing transparent and predictable pricing that scales with your usage. **Key benefits:** * **Usage-based** – Pay in proportion to actual consumption * **Efficiency** – Incentives to write cleaner, optimized queries * **Scalable** – Sustainable future support for larger workloads with longer timeouts and expanded connector options to come in the near future This fair, usage-based model ensures Dune can keep pace with your most ambitious data needs. [​](https://docs.dune.com/resources/credits-billing/how-credits-work#credit-pricing) Credit Pricing ------------------------------------------------------------------------------------------------------ Credits are consumed based on the actual compute resources used for each query execution. The more complex your query, the more credits it consumes, but simple queries cost significantly less. At the moment, we don’t share a single, per-query formula because credit usage depends on real-time factors (the compute your query actually uses, the engine you choose, and current network/data access conditions. To stay in full control, you can set: * a global query cost cap (per-execution ceiling). More info on how to do this [here](https://app.arcade.software/share/C60r4u7ESOp5RXRuzbSN) . * a monthly extra credit limit (account-level ceiling). These controls ensure you never exceed what you’re comfortable spending per run or per month. Learn how to set this up [here](https://app.arcade.software/share/so8QGM4H4MU0OWRWhNe9) . **Credit Pricing = Extra Credit Pricing** Extra credits are charged at the same rate as your plan. The price per 100 credits shown for each plan is what you pay for any usage beyond your included credits, keeping things simple and transparent. **Quick Plan Reference** | Plan | Monthly Price | Annual Price | Credits/Month | Cost per 100 Credits | | --- | --- | --- | --- | --- | | **Free** | Free | \- | 2,500 | $5.00 | | **Analyst** | $75/month | \- | 4,000 | $1.875 | | **Analyst (Annual)** | $65/month billed annually | $780/year | 4,000 | $1.625 | | **Plus** | $399/month | \- | 25,000 | $1.596 | | **Plus (Annual)** | $349/month billed annually | $4,188/year | 25,000 | $1.396 | | **Legacy Premium** | No longer available | \- | Varies | [Contact support](mailto:support@dune.com) | | **Enterprise** | Favorable Custom Pricing | \- | Custom | **Favorable rates** - [Contact sales](https://dune.com/enterprise) | **Save with Enterprise Pricing**: Enterprise plans receive **significantly lower per-credit rates** compared to standard plans, plus customized support and tailored solutions. Whether you’re scaling up or just getting started, [contact our sales team](https://dune.com/enterprise) to discuss custom pricing that fits your needs. **Legacy Premium**: This plan is no longer available for new subscriptions. Existing Premium customers can continue to use their plan. Explore the complete pricing plan with credit limits and features for each tier: [dune.com/pricing](https://dune.com/pricing) [​](https://docs.dune.com/resources/credits-billing/how-credits-work#managing-your-credit-usage) Managing Your Credit Usage ------------------------------------------------------------------------------------------------------------------------------ * **Review your usage.** Check your query volume and costs regularly to stay informed about your credit consumption. * **Optimize your queries.** Efficient queries save credits and run faster. See [here](https://docs.dune.com/query-engine/writing-efficient-queries) for tips. * **Pick the plan that fits.** If you anticipate heavy usage or notice extra credits usage, consider upgrading to Enterprise for **significantly lower per-credit rates**. Contact our sales team at [dune.com/enterprise](http://dune.com/enterprise) to discuss custom pricing and tailored solutions for your needs. * **Cap your query costs.** Control spending by setting a maximum credit limit for individual queries. More info on how to do this [here](https://app.arcade.software/share/C60r4u7ESOp5RXRuzbSN) . * **Set extra credit limits.** Configure your extra credit spending limits to control costs. Learn how to set this up [here](https://app.arcade.software/share/so8QGM4H4MU0OWRWhNe9) . [​](https://docs.dune.com/resources/credits-billing/how-credits-work#need-help) Need Help? --------------------------------------------------------------------------------------------- Have questions or need additional support? [Contact Us](mailto:support@dune.com) [​](https://docs.dune.com/resources/credits-billing/how-credits-work#faq) FAQ -------------------------------------------------------------------------------- ### [​](https://docs.dune.com/resources/credits-billing/how-credits-work#pricing-&-plans) Pricing & Plans How does Dune's credit system work? Dune uses a usage-based credit system that charges based on actual compute resources consumed. This ensures fair pricing where lightweight queries cost less and complex queries cost more based on their actual resource requirements, providing everyone with a fair and flexible experience. Is there a Free plan? Yes. The Free plan includes **2,500 credits per month at no cost**. With the usage-based system, credits are consumed based on actual query resources. Small, efficient queries use fewer credits, allowing you to run more queries within your monthly allowance. Larger or more complex queries will use credits more quickly. If you consistently need more capacity, you can upgrade to a paid plan anytime. Can I run bigger queries if I stay on a Free plan? Yes, but you will be limited to the Small and Medium engine. If you often hit timeout limits, consider the Analyst or Plus plans. How are credits calculated? Credits are based on the actual compute effort measured in CPU-seconds and network resources a query consumes. This means lightweight queries cost fewer credits, while complex, resource-intensive operations require more credits.At the moment, we don’t share a single, per-query formula because credit usage depends on real-time factors (the compute your query actually uses, the engine you choose, and current network/data access conditions).In practice: Credits scale with compute used. Heavier queries consume more credits; lighter ones consume fewer. Engine matters. Large runs complex queries fastest and therefore consumes credits at a higher rate than Medium; Small prioritizes queue time over speed and is most efficient for simple jobs.To stay in full control, you can set: a global query cost cap (per-execution ceiling), and a monthly extra credit limit (account-level ceiling). I run a lot of API queries. Will they cost more? Cost will depend on compute used by those API queries. You can check the usage dashboard in Settings to track API-specific consumption. ### [​](https://docs.dune.com/resources/credits-billing/how-credits-work#usage-&-monitoring) Usage & Monitoring How can I monitor my credit consumption? The usage and billing dashboard shows credits used, extra credits, and historical usage. Will I see the cost before running a query? You’ll see costs after execution. Can I run bigger queries now? Yes more complex queries and higher data volumes with longer timeouts for Enterprise clients. What is a system user? Is that for scheduled jobs? Yes, the system user represents automated executions on the Dune platform. This includes scheduled query runs, materialized view refreshes, and other background jobs that run without direct user interaction. When you see credit usage attributed to a system user, it typically means those credits were consumed by your scheduled queries or automated data refresh processes rather than manual query executions. ### [​](https://docs.dune.com/resources/credits-billing/how-credits-work#optimization-&-support) Optimization & Support How can I lower my credit usage? Write efficient SQL, limit unnecessary joins or scans, and reuse results when possible. Our docs include [query optimization tips](https://docs.dune.com/query-engine/writing-efficient-queries) . What if I consistently exceed my plan credits? You can upgrade to a higher plan or contact our sales team to discuss a custom Enterprise solution. Who do I contact for help? Reach out to [support@dune.com](mailto:support@dune.com) or your Dune account manager for Enterprise plans. Was this page helpful? YesNo [Overview](https://docs.dune.com/resources/credits-billing/overview) [Web3 Data Resources](https://docs.dune.com/resources/web3-data-resources) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Web3 Data Resources - Dune Docs [Skip to main content](https://docs.dune.com/resources/web3-data-resources#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Learning Web3 Data Resources [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Web3 Data Resources](https://docs.dune.com/resources/web3-data-resources#web3-data-resources) * [Dune Tutorials](https://docs.dune.com/resources/web3-data-resources#dune-tutorials) * [Metrics-Driven Analysis](https://docs.dune.com/resources/web3-data-resources#metrics-driven-analysis) * [Analysis Tips](https://docs.dune.com/resources/web3-data-resources#analysis-tips) * [Engage with the Community](https://docs.dune.com/resources/web3-data-resources#engage-with-the-community) [​](https://docs.dune.com/resources/web3-data-resources#web3-data-resources) Web3 Data Resources =================================================================================================== After you’ve gone through the quickstart guide, you’ll be ready to start learning how to navigate the Web3 data analytics space. Analyzing protocols in web3 is both really easy and hard. It’s really easy because everything is transparent and standardized - a deployed contract has a set of functions and events that are pretty much immutable. However, it’s an ever-expanding data arena as new protocols, tokens, and wallets join the fray. To build your reputation as an expert analyst, you must stay centered on what you want to analyze and what metrics you want to present. [​](https://docs.dune.com/resources/web3-data-resources#dune-tutorials) Dune Tutorials ----------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/resources/web3-data-resources#metrics-driven-analysis) Metrics-Driven Analysis **Video Series:** Delve deep with our end-to-end video series guides: * [Uniswap in 12 Days](https://www.youtube.com/playlist?list=PLK3b5d4iK10cIrN8c_au9RrC0_eBCOyR2) (includes metrics like price impact, TVL, MEV volume, liquidity stability) * [Gnosis Safe Point-in-Time](https://www.youtube.com/watch?v=S-cctFmR828) (includes metrics like signers, diversification, and valuations) **Dashboards for Insights:** * To understand token trends and contexts, check out ERC20 and NFT dashboards * To understand wallet/user segments, you’ll need to leverage labels to enhance your analysis Once you have metrics and also understand the underlying tokens and users, it will start to become clear what that real narrative is. Try and pull together a few insights, and then create a compelling dashboard and story around them. Don’t try too hard to capture everything at once - it will become overwhelming for both you and those you share it with. [​](https://docs.dune.com/resources/web3-data-resources#analysis-tips) Analysis Tips --------------------------------------------------------------------------------------- * **Start with a solid foundation.** Master basic SQL and blockchain concepts. * **Scope Your Work:** When looking into a protocol, you’ll need to understand the contract architecture and context. That starts with functions, events, and wallet overviews. Remember that no protocol lives in isolation - there is always some mix of onchain events happening. That could be some new airdrop, a new upstream/downstream protocol integration, large whales making moves, governance changes in protocol parameters, and more. Once you have a solid understanding of protocol history in usage, user, and integration trends, you’re ready to start building some metrics. [​](https://docs.dune.com/resources/web3-data-resources#engage-with-the-community) Engage with the Community --------------------------------------------------------------------------------------------------------------- When you’re done, be sure to share your work in the Discord `#📺︱show-your-work` channel and on Twitter tagging [@dune](https://twitter.com/dune) . We’ll be sure to give great analysts a boost! Web3 is all about connecting with communities - your queries and dashboards will do nothing if you don’t share it around. Was this page helpful? YesNo [How Credits Work](https://docs.dune.com/resources/credits-billing/how-credits-work) [Measuring User Activity](https://docs.dune.com/web-app/user-activity) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Measuring User Activity - Dune Docs [Skip to main content](https://docs.dune.com/web-app/user-activity#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Learning Measuring User Activity [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [How Activity is Measured](https://docs.dune.com/web-app/user-activity#how-activity-is-measured) * [Query Activity](https://docs.dune.com/web-app/user-activity#query-activity) * [Dashboard Activity](https://docs.dune.com/web-app/user-activity#dashboard-activity) * [Contract Activity](https://docs.dune.com/web-app/user-activity#contract-activity) * [Contributions Calculation](https://docs.dune.com/web-app/user-activity#contributions-calculation) [​](https://docs.dune.com/web-app/user-activity#how-activity-is-measured) How Activity is Measured ===================================================================================================== ![Activity heatmap showing user contributions over time](https://mintcdn.com/dune/uyJ-jHeSRFvNrzyu/images/activity-heatmap.png?w=2500&fit=max&auto=format&n=uyJ-jHeSRFvNrzyu&q=85&s=96f38cf446bf2ce133426429892674a7) Activity on Dune is measured by combining different types of contributions: ### [​](https://docs.dune.com/web-app/user-activity#query-activity) Query Activity * Creating new queries (including temp queries) * Updating existing queries * Deleting queries ### [​](https://docs.dune.com/web-app/user-activity#dashboard-activity) Dashboard Activity * Creating new dashboards ### [​](https://docs.dune.com/web-app/user-activity#contract-activity) Contract Activity * Submitting new contracts [​](https://docs.dune.com/web-app/user-activity#contributions-calculation) Contributions Calculation ------------------------------------------------------------------------------------------------------- Each action counts as one contribution for that day. For example, if you: * Create 2 queries * Update 1 query * Create 1 dashboard * Submit 1 contract Your total activity for that day would be 5 contribution. The activity heatmap shows your daily activity over time, helping you track your contributions to the Dune ecosystem. Was this page helpful? YesNo [Web3 Data Resources](https://docs.dune.com/resources/web3-data-resources) [Video Tutorials](https://docs.dune.com/resources/learning/video-tutorials) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Support & Contact - Dune Docs [Skip to main content](https://docs.dune.com/resources/support/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Support Support & Contact [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Support & Contact](https://docs.dune.com/resources/support/overview#support-%26-contact) * [Enterprise Support](https://docs.dune.com/resources/support/overview#enterprise-support) * [Email Support](https://docs.dune.com/resources/support/overview#email-support) * [Additional Resources](https://docs.dune.com/resources/support/overview#additional-resources) * [Community Support](https://docs.dune.com/resources/support/overview#community-support) * [Social](https://docs.dune.com/resources/support/overview#social) [​](https://docs.dune.com/resources/support/overview#support-&-contact) Support & Contact ============================================================================================ Need help with Dune? Here’s how to get support and reach our team. [​](https://docs.dune.com/resources/support/overview#enterprise-support) Enterprise Support ---------------------------------------------------------------------------------------------- Enterprise customers receive dedicated support channels: * **Dedicated Slack channel** — Direct access to the Dune team * **Telegram** — Real-time communication with your account team * **Email** — Priority response from our support team [Learn about Enterprise\ ----------------------\ \ See Enterprise pricing and features →](https://docs.dune.com/enterprise/data-hub/overview) [​](https://docs.dune.com/resources/support/overview#email-support) Email Support ------------------------------------------------------------------------------------ [](mailto:support@dune.com) [](mailto:support@dune.com) [General Support\ ---------------](mailto:support@dune.com) [For general questions and technical issues](mailto:support@dune.com) **[support@dune.com](mailto:support@dune.com) ** [Sales & Enterprise\ ------------------\ \ For Enterprise pricing and custom solutions**Contact Sales →**](https://dune.com/enterprise) [​](https://docs.dune.com/resources/support/overview#additional-resources) Additional Resources -------------------------------------------------------------------------------------------------- [FAQs\ ----\ \ Common questions about pricing, credits, and plans](https://docs.dune.com/learning/how-tos/pricing-faqs) [Video Tutorials\ ---------------\ \ Step-by-step video guides for using Dune](https://docs.dune.com/resources/learning/video-tutorials) [Migrating from Flipside\ -----------------------\ \ Guide for teams moving from Flipside to Dune](https://docs.dune.com/learning/flipside-migration-guide) [Bug Bounty\ ----------\ \ Report security vulnerabilities](https://docs.dune.com/web-app/bug-bounty) [​](https://docs.dune.com/resources/support/overview#community-support) Community Support -------------------------------------------------------------------------------------------- [Discord\ -------\ \ Join our Discord community for real-time help from the community and Dune team\ \ * `#🐥︱beginners` — New to Dune? Start here\ * `#🙋︱query-questions` — Get help with SQL and queries](https://discord.gg/ErrzwBz) [Telegram\ --------\ \ Product updates, announcements, and a direct line for potential customers exploring Dune](https://t.me/dune_updates) Follow us for updates and community content: * **X/Twitter:** [@dune](https://x.com/dune) * **LinkedIn:** [Dune](https://www.linkedin.com/company/dune-analytics) * **YouTube:** [Dune](https://www.youtube.com/@dunecom) * **GitHub:** [duneanalytics](https://github.com/duneanalytics) Was this page helpful? YesNo [Video Tutorials](https://docs.dune.com/resources/learning/video-tutorials) [FAQs](https://docs.dune.com/learning/how-tos/pricing-faqs) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # kalshi.market_report - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/kalshi/market_report#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Kalshi kalshi.market\_report [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Schema](https://docs.dune.com/data-catalog/kalshi/market_report#table-schema) The `kalshi.market_report` table contains market data and information about event contracts on Kalshi. Each row represents market statistics and metrics for a specific event contract ticker. [​](https://docs.dune.com/data-catalog/kalshi/market_report#table-schema) Table Schema ----------------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | block\_volume | double | Trading volume for the block period | | category | string | Category of the event contract (e.g., Politics, Economics, Sports, etc.) | | daily\_volume | double | Total trading volume for the day | | date | string | Date of the market report | | high | double | Highest price reached during the reporting period | | low | double | Lowest price reached during the reporting period | | open\_interest | double | Total number of outstanding contracts | | payout\_type | string | Type of payout for the event contract | | report\_ticker | string | Unique ticker identifier for the market report | | status | string | Current status of the event contract market | | ticker\_name | string | Name or description of the event contract ticker | | \_updated\_at | timestamp | Last update timestamp | | \_ingested\_at | timestamp | Ingestion timestamp | Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/kalshi/overview) [Trade Report](https://docs.dune.com/data-catalog/kalshi/trade_report) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # FAQs - Dune Docs [Skip to main content](https://docs.dune.com/learning/how-tos/pricing-faqs#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Support FAQs [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Frequently Asked Questions](https://docs.dune.com/learning/how-tos/pricing-faqs#frequently-asked-questions) * [General Questions](https://docs.dune.com/learning/how-tos/pricing-faqs#general-questions) * [Credits and Spending](https://docs.dune.com/learning/how-tos/pricing-faqs#credits-and-spending) * [Query Engines & Executions](https://docs.dune.com/learning/how-tos/pricing-faqs#query-engines-%26-executions) * [Features](https://docs.dune.com/learning/how-tos/pricing-faqs#features) * [Teams](https://docs.dune.com/learning/how-tos/pricing-faqs#teams) * [API](https://docs.dune.com/learning/how-tos/pricing-faqs#api) [​](https://docs.dune.com/learning/how-tos/pricing-faqs#frequently-asked-questions) Frequently Asked Questions ================================================================================================================= Find answers to common questions about Dune’s pricing, credits, billing cycles, and subscription plans. [​](https://docs.dune.com/learning/how-tos/pricing-faqs#general-questions) General Questions ----------------------------------------------------------------------------------------------- Where can I see my billing history? Your billing history can be found under “Billing” in your Subscription Settings. Follow the steps below for a complete view: 1. Go to dune.com 2. Sign in to your Dune account 3. Click your avatar in the middle of the top bar where your user or team badge is 4. Click the Settings icon and then “Subscription” How are upgrades and downgrades handled? Upgrading to a new paid tier resets your billing cycle start date. On the date of your upgrade, you will be billed the full new plan price and refunded a prorated amount corresponding to the number of unused days of your current plan. If you upgrade from Analyst to Plus on day 15 of your billing cycle, you will be billed a month of Plus minus 15 days of Analyst (roughly half the monthly Analyst cost).Downgrades to lower tiers are applied at the end of your billing cycle. Benefits from your current tier remain until the end of your billing cycle. At the end of your billing cycle, you will automatically be downgraded to the lower tier of your choice. How do I upgrade, downgrade, or cancel my team's subscription? Only administrators of teams with paid plans can change team subscriptions. To change your team’s subscription: 1. Go to dune.com 2. Sign in to your Dune account 3. Click your avatar in the middle of the top bar where your team badge is 4. Click the Settings icon and then “Subscription” 5. Click the plan you want to upgrade or downgrade to To cancel your subscription, follow these steps: 1. Go to dune.com 2. Sign in to your Dune account 3. Click your avatar in the middle of the top bar where your user or team badge is 4. Click the Settings icon and then “Subscription” 5. Change your plan to Free Your subscription will remain active for 30 days after your last payment. Do you offer paid plans for individuals? If you are a single user with higher requirements than what’s offered in the free tier, you can create a team of one to access paid tiers. Note that we hope to change this in the future, so individuals don’t need to create a plan to upgrade. What if I have more questions? For general info on how to use Dune, please see our [docs](https://docs.dune.com/) . For specific questions on how to do a query, please join our [Discord](https://discord.com/invite/dunecom) . If you have other issues or questions not listed on this page, please contact [support@dune.com](mailto:support@dune.com) . [​](https://docs.dune.com/learning/how-tos/pricing-faqs#credits-and-spending) Credits and Spending ----------------------------------------------------------------------------------------------------- What is a credit? Credits are the measurement unit for usage on Dune. They provide flexibility across query performance, programmatic executions, and API exports. Credits are consumed proportionally to the actual compute resources your queries use—simple queries cost fewer credits while complex ones use more. Can I view my credit usage and balance? To view your credit usage and balance go to Settings and select Subscription; here you will see used and remaining credits. How do credits and billing cycles work with annual plans? Annual billing enables customers to pay for their plan yearly at a reduced rate. Customers on this plan will still have their credits reset on a monthly basis, as well as receive monthly charges for any potential extra credits incurred. How do I calculate my potential monthly credit usage? Credit usage is determined by the actual compute resources your queries consume. Your credit consumption directly reflects each query’s complexity and resource requirements.**Query Execution (App & API)** * Credits are charged based on CPU-seconds and network resources used * Simple, efficient queries use fewer credits * Complex queries with large data scans require more credits * Queries cost the same whether executed manually or programmatically **API Export** * Free and Analyst: 1 credit = 1,000 data points * Plus: 1 credit = 5,000 data points * Legacy Premium: 1 credit = 25,000 data points (no longer available) How can I manage and reduce my credit usage? There are several ways to control and optimize your credit consumption:**Monitor Your Usage** * Check the usage tab regularly to track your credit consumption patterns * Review which queries and users consume the most credits * Set extra credit limits to control how many additional credits can be purchased beyond your plan’s included amount **Control Spending** * Set query cost caps in Settings to limit the maximum credits any single query can consume * Configure team-level caps to prevent accidental high-usage queries * Use these caps while testing new queries or during development **Optimize Your Queries** * Write efficient SQL to dramatically reduce credit consumption * Review our [query optimization guide](https://docs.dune.com/query-engine/writing-efficient-queries) for specific techniques What happens if my credit quota runs out? Once your monthly credit quota runs out, we’ll continue to bill you for additional credits at your plan’s extra credit rate. There’s no separate “extra credit pricing”, you pay the same rate per 100 credits as shown for your plan: * Free: $5.00 per 100 credits * Analyst: 1.875per100credits(monthly)/1.875 per 100 credits (monthly) / 1.875per100credits(monthly)/1.625 per 100 credits (annual) * Plus: 1.596per100credits(monthly)/1.596 per 100 credits (monthly) / 1.596per100credits(monthly)/1.396 per 100 credits (annual) * Legacy Premium: $0.999 per 100 credits (no longer available) * Enterprise: Custom pricing per your agreement You can set query cost caps in Settings to control your credit usage and prevent unexpected charges. Can I purchase extra credits in bulk? No, once your quota runs out, extra credits will be billed on an ongoing basis as you use Dune. Credits are not available to purchase in bulk once you reach your quota. If I have leftover credits at the end of the billing cycle can I use them later? Remaining credits at the end of a billing cycle do not rollover to the next month. Can I 'pay as I go' without upgrading? Yes, you can pay as you go. Both individuals and teams in the free tier can continue using Dune beyond their 2,500 monthly credits by paying $5.00 per 100 additional credits. This allows you to handle occasional larger workloads without committing to a monthly subscription. If you find yourself consistently purchasing additional credits, consider upgrading to a paid plan for better value, paid plans offer significantly lower per-credit rates and additional features like API access and unlimited concurrent executions. How can I limit my spending? To limit monthly spend, go to your subscription page in Settings and set the limit to the desired amount. Setting your limit to $0 will prevent additional usage billing. What if I lower my spend limit below my current spend level? If you lower your spend limit below your current spending level, you will not be charged any additional fees beyond your new spend limit. However, any usage that has accrued does not rollover and will still be billed based on the previous spend limit. [​](https://docs.dune.com/learning/how-tos/pricing-faqs#query-engines-&-executions) Query Engines & Executions ----------------------------------------------------------------------------------------------------------------- How is my query execution usage counted? When you manually trigger an execution by pressing Run in the Query Editor, dashboard, or via the API, we accrue that usage to the user or team account. To ensure you are accruing usage in the correct account, view your selected account in the account switcher located in the middle of the top navigation bar on Dune. What are the differences between query engine sizes? We have three different query engine sizes that you can use on Dune, each consuming credits based on actual compute resources used:**Small Engine (0 credits to run)** * Run simple queries manually in the Dune app for free * Credits consumed from your monthly allowance based on actual usage * 2-minute timeout limit * Maximum of three (3) concurrent executions * No performance guarantees **Medium Engine** * Run queries with a larger timeout, manually or programmatically * Credits consumed based on actual compute resources used * No limit on concurrent executions * Suitable for most standard queries and dashboards **Large Engine** * Optimized for complex workloads requiring more computational power * Credits consumed based on actual compute resources used (more compute and resource than Medium for the same query) * Best for data-intensive queries and complex analytics The Large engine provides approximately 2x the computational capacity of the Medium engine. While both Medium and Large engines charge based on actual usage, the Large engine will typically consume more credits for the same query due to the additional resources allocated, but will complete faster. The Small engine is limited in capacity and has stricter timeout constraints.**Note:** Exact credit consumption varies based on query complexity, data volume scanned, and processing required rather than being a fixed rate per execution. What is a programmatic execution? Programmatic executions are query executions done through the Dune API, scheduled executions, materialized view refreshes, or dashboard runs. Programmatic executions consume credits based on actual compute resources used, just like manual queries. Both manual and programmatic executions are charged based on the complexity and resources required by your query, ensuring consistent and fair pricing across all execution methods. What are the limitations of the Free query engine size? The Free query engine on Dune is available to anyone at no cost, but it does come with limitations. First, there are no performance or queue priority guarantees, which means executions may take longer to run during times of high demand. Additionally, the Free query engine is limited to manual query editor executions only; automated executions (API, scheduling, refreshing) are not available. Lastly, there is a maximum limit of three (3) ongoing executions (executing or queued) at any given time for Free executions, and executions are timed out at 120 seconds. [​](https://docs.dune.com/learning/how-tos/pricing-faqs#features) Features ----------------------------------------------------------------------------- Can I add a private query to a public dashboard? If you add a private query to a public dashboard, other Dune users will be able to see the visualization in the public dashboard, but won’t see your code when they click the query. The results table, other visualizations you might have, and the underlying query are all private. Do archived private queries count towards my limit? No, you can archive private queries that you no longer need to increase your existing private queries quota. Archived queries are not accessible by anyone else and cannot be run. You can unarchive them later if you change your mind. Can I embed private queries on other websites? Yes, anyone visiting the website with the embed can see the visualization you chose to embed and nothing else. As an Enterprise team, what will happen to watermarks? When logged in to the team on Dune, work you’ve created will not have watermarks. Public dashboards URLs always have watermarks. [​](https://docs.dune.com/learning/how-tos/pricing-faqs#teams) Teams ----------------------------------------------------------------------- What is an Editor seat? Owners of editor seats can create and edit content owned by their team, but they cannot access team management features; those are reserved for admins. Viewers have read-only access to the team’s content and can still benefit from their team plan features and quotas. Do my team's benefits apply to all content on Dune? Yes, team benefits apply to all Dune content, as long as your team is in the correctly selected account which is viewable in the middle of the top navigation bar on Dune. How is a team's usage or feature quota applied? Quotas are applied to all team usage. Can I invite unlimited collaborators? Yes, you can invite as many people as you need into your Dune team at no additional cost. All team members will need a Dune account to collaborate with you. Can I create unlimited Free teams? You can create 1 Free team on Dune. [​](https://docs.dune.com/learning/how-tos/pricing-faqs#api) API ------------------------------------------------------------------- What is a datapoint? A datapoint can, in most cases, be thought of as rows \* columns with an additional limit of 100 average bytes per cell in a set of results. This can be expressed as:`datapoints = max(rows * columns, ceil(total_bytes / 100))` Do I get charged data points for every time I read a result? Yes, we accrue the resulting datapoints returned from every request to your credit quota. How do query executions work in the API? Query executions are identical to those triggered on dune.com. Please note: free executions are not supported via the API. Can my team use the API? Yes, the API is included in all Dune plans. This means that all teams and users, including those in the Free plan, can access the API to trigger executions and export data, provided their spend limit has not been exceeded. Please note: credits still apply for API usage, regardless of the plan you are on. Should I link back to the source when using the API? We strongly believe Dune analysts should be credited for their work’s impact. We encourage you to credit the analyst, or perhaps to link to the original query. Linking to transparent data sources like Dune is a great way of building trust. Was this page helpful? YesNo [Support & Contact](https://docs.dune.com/resources/support/overview) [Migrating from Flipside to Dune](https://docs.dune.com/learning/flipside-migration-guide) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Balances - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/balances#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Balances [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/balances#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/initia/balances#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/initia/balances#table-sample) [​](https://docs.dune.com/data-catalog/initia/balances#table-description) Table Description ============================================================================================== This table contains data about account balances in the Initia blockchain, including token holdings and balance snapshots. [​](https://docs.dune.com/data-catalog/initia/balances#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the balance was recorded. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **address** | varchar | The account address. | | **denom** | varchar | The denomination of the token. | | **amount** | decimal(38, 0) | The balance amount. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/initia/balances#table-sample) Table Sample ------------------------------------------------------------------------------------ Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/initia/overview) [Blocks](https://docs.dune.com/data-catalog/initia/blocks) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # kalshi.trade_report - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/kalshi/trade_report#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Kalshi kalshi.trade\_report [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Schema](https://docs.dune.com/data-catalog/kalshi/trade_report#table-schema) The `kalshi.trade_report` table contains trade execution data and transaction information for event contracts on Kalshi. Each row represents a trade execution for a specific event contract ticker. [​](https://docs.dune.com/data-catalog/kalshi/trade_report#table-schema) Table Schema ---------------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | contracts\_traded | double | Number of contracts traded in the transaction | | date | string | Date of the trade report | | price | double | Price at which the contracts were traded | | report\_ticker | string | Unique ticker identifier for the trade report | | ticker\_name | string | Name or description of the event contract ticker | | \_updated\_at | timestamp | Last update timestamp | | \_ingested\_at | timestamp | Ingestion timestamp | Was this page helpful? YesNo [Market Report](https://docs.dune.com/data-catalog/kalshi/market_report) [Overview](https://docs.dune.com/data-catalog/layerzero/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Block Events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/block_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Block Events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/block_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/initia/block_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/initia/block_events#table-sample) [​](https://docs.dune.com/data-catalog/initia/block_events#table-description) Table Description ================================================================================================== This table contains data about block-level events and attributes in the Initia blockchain, including event types, sources, and associated metadata. The schema is modeled after Cosmos block events. [​](https://docs.dune.com/data-catalog/initia/block_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------ | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the event occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the block belongs. | | **event\_index** | bigint | A unique index for events within the block. | | **event\_type** | varchar | The type of event that was triggered. | | **event\_source** | varchar | The source of the event. | | **attribute\_key** | varchar | The key of the event attribute. | | **attribute\_value** | varchar | The value of the event attribute. | | **attribute\_index** | bigint | A unique index for attributes within the event. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/initia/block_events#table-sample) Table Sample ---------------------------------------------------------------------------------------- Was this page helpful? YesNo [Blocks](https://docs.dune.com/data-catalog/initia/blocks) [Bridge Transfers](https://docs.dune.com/data-catalog/initia/bridge_transfers) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Blocks - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/blocks#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Blocks [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/blocks#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/initia/blocks#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/initia/blocks#table-sample) [​](https://docs.dune.com/data-catalog/initia/blocks#table-description) Table Description ============================================================================================ This table contains data about blocks in the Initia blockchain, including block headers, consensus data, and transaction information. [​](https://docs.dune.com/data-catalog/initia/blocks#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------ | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block, a unique identifier for each block. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the block belongs. | | **proposer\_address** | varchar | The address of the validator proposing the block. | | **validators\_hash** | varchar | The hash of the validators set for the block. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/initia/blocks#table-sample) Table Sample ---------------------------------------------------------------------------------- Was this page helpful? YesNo [Balances](https://docs.dune.com/data-catalog/initia/balances) [Block Events](https://docs.dune.com/data-catalog/initia/block_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Message Events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/message_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Message Events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/message_events#table-description) * [Table Schema](https://docs.dune.com/data-catalog/initia/message_events#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/initia/message_events#table-sample) [​](https://docs.dune.com/data-catalog/initia/message_events#table-description) Table Description ==================================================================================================== This table contains data about message-related events in the Initia blockchain, including message types, attributes, and associated metadata. [​](https://docs.dune.com/data-catalog/initia/message_events#table-schema) Table Schema ------------------------------------------------------------------------------------------ | Column name | Description | Type | | --- | --- | --- | | **block\_date** | The date of the block. | date | | **block\_height** | The height of the block where the event occurred. | bigint | | **block\_timestamp** | Timestamp when the block was validated. | timestamp(3) with time zone | | **chain\_id** | The ID of the chain where the block belongs. | varchar | | **tx\_id** | The hash of the transaction where the event occurred. | varchar | | **tx\_index** | The index of the transaction in the block. | bigint | | **message\_index** | The index of the message in the transaction. | bigint | | **event\_index** | A unique index for events within the message. | bigint | | **event\_type** | The type of event that was triggered. | varchar | | **attribute\_key** | The key of the event attribute. | varchar | | **attribute\_value** | The value of the event attribute. | varchar | | **attribute\_index** | A unique index for attributes within the event. | bigint | | **updated\_at** | Timestamp of when the record was last updated. | timestamp(3) with time zone | | **ingested\_at** | Timestamp of when the record was ingested into Dune. | timestamp(3) with time zone | [​](https://docs.dune.com/data-catalog/initia/message_events#table-sample) Table Sample ------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Bridge Transfers](https://docs.dune.com/data-catalog/initia/bridge_transfers) [Swaps](https://docs.dune.com/data-catalog/initia/swaps) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Bridge Transfers - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/bridge_transfers#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Bridge Transfers [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/bridge_transfers#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/initia/bridge_transfers#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/initia/bridge_transfers#table-sample) [​](https://docs.dune.com/data-catalog/initia/bridge_transfers#table-description) Table Description ====================================================================================================== This table contains data about cross-chain bridge transfers in the Initia blockchain, including transfer details, source and destination chains, and transfer status. [​](https://docs.dune.com/data-catalog/initia/bridge_transfers#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the transfer occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **tx\_id** | varchar | The unique ID of the transaction. | | **tx\_index** | bigint | The index of the transaction in the block. | | **message\_index** | bigint | The index of the message in the transaction. | | **event\_index** | bigint | The index of the event in the message. | | **action\_index** | bigint | The index of the action in the event. | | **sender** | varchar | The address of the sender. | | **receiver** | varchar | The address of the receiver. | | **token\_amount** | decimal(38, 0) | The amount of tokens transferred. | | **token\_denom** | varchar | The denomination of the token. | | **src\_domain** | varchar | The source domain of the transfer. | | **dst\_domain** | varchar | The destination domain of the transfer. | | **protocol** | varchar | The protocol used for the transfer. | | **protocol\_metadata** | varchar | Additional metadata related to the protocol. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/initia/bridge_transfers#table-sample) Table Sample -------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Block Events](https://docs.dune.com/data-catalog/initia/block_events) [Message Events](https://docs.dune.com/data-catalog/initia/message_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Bug Bounty Submission - Dune Docs [Skip to main content](https://docs.dune.com/web-app/bug-bounty#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Bug Bounty Bug Bounty Submission [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Bounty Sizes](https://docs.dune.com/web-app/bug-bounty#bounty-sizes) * [Duplicate Submissions Policy](https://docs.dune.com/web-app/bug-bounty#duplicate-submissions-policy) * [Variations and Bypasses of Previously Reported Issues](https://docs.dune.com/web-app/bug-bounty#variations-and-bypasses-of-previously-reported-issues) * [Misuse of Stolen Credentials](https://docs.dune.com/web-app/bug-bounty#misuse-of-stolen-credentials) * [Bug Bounty Rules and Safe Harbor](https://docs.dune.com/web-app/bug-bounty#bug-bounty-rules-and-safe-harbor) If you believe you have discovered a security issue within our web application or API, we highly encourage you to report it to us. We appreciate the efforts of ethical hackers and reward those who responsibly disclose vulnerabilities. Please submit any vulnerability or bug discovered via this form: [https://forms.gle/NTK3FGMYRsAWKkY4A](https://forms.gle/NTK3FGMYRsAWKkY4A) Please note, it is essential to provide a video or script reproducing the issue. This greatly speeds up our understanding of the issue. We do not accept email submissions of vulnerabilities. All reports must go through the form above to ensure they are tracked and processed appropriately. We aim to review and respond to submissions within a month. While we understand your eagerness to hear back, emailing us for updates will not speed up the review process. We appreciate your patience and cooperation as we work through each submission thoroughly. Repeated inquiries for updates via email may result in disqualification of the submission to ensure fairness and efficiency for all participants. We value transparency and will work with you to resolve any legitimate issues found. Your efforts help us maintain the security and trustworthiness of our platform. Thank you for your contribution to our security. ### [​](https://docs.dune.com/web-app/bug-bounty#bounty-sizes) Bounty Sizes Bounty sizes are determined at Dune’s sole discretion. We consider the severity and impact of the vulnerability as well as the quality of the submission. The rubric we use to determine bug bounties is as follows: | Level | Example | Maximum Bug Bounty | | --- | --- | --- | | 6\. Severe | Unauthorized access to any part of the platform - Ability to delete or manipulate user data or analytics | Let’s talk | | 5\. Critical | Unauthorized ability to execute arbitrary code on the server- Exploiting API endpoints to access restricted data | Up to $5,000 | | 4\. High | SQL injection leading to data exfiltration- Bypassing authentication mechanisms | Up to $2,500 | | 3\. Medium | Cross-site scripting (XSS)- CSRF that affects user accounts | Up to $1,000 | | 2\. Low | Security misconfigurations- Information leakage (server info, stack traces) | Up to $250 | | 1\. Info | Suggestions for improvements or best practices | | ### [​](https://docs.dune.com/web-app/bug-bounty#duplicate-submissions-policy) Duplicate Submissions Policy We value all security research, but we do not provide rewards for submissions that cover known issues already reported by other researchers or internally identified by our team. If your report is a duplicate, we will notify you of the status and appreciate your effort, but no bounty will be issued. ### [​](https://docs.dune.com/web-app/bug-bounty#variations-and-bypasses-of-previously-reported-issues) Variations and Bypasses of Previously Reported Issues If you discover a bypass or a variation of a previously reported vulnerability, this will typically be considered part of the same issue and not eligible for an additional full bounty. This applies especially to cases where: * A fix for a previously reported issue was incomplete or could be bypassed * The vulnerability uses a similar technique with minor variations * The vulnerability affects the same endpoint or feature We encourage researchers to thoroughly test our fixes and report bypasses, but these will generally be bundled with the original report for bounty considerations. In some cases, at our discretion, we may offer a smaller reward for significant bypasses that require substantial new techniques. ### [​](https://docs.dune.com/web-app/bug-bounty#misuse-of-stolen-credentials) Misuse of Stolen Credentials We value all security research, but issues stemming from stolen or compromised credentials (e.g., through malware or phishing attacks on user browsers) do not qualify as vulnerabilities in our systems and are therefore not eligible for a bounty. While these reports highlight potential risks, the security of user credentials lies outside the scope of this program. ### [​](https://docs.dune.com/web-app/bug-bounty#bug-bounty-rules-and-safe-harbor) Bug Bounty Rules and Safe Harbor By participating in this program, you agree to abide by the following rules to help us maintain a secure environment for all users. * **Safe Harbor:** We authorize participants to test and report vulnerabilities in our systems, provided they act with due care and in good faith to minimize harm or disruption to our users and services. Actions conducted in compliance with the rules and within the scope of this program are considered authorized, and we will not pursue legal action or report you for such activities. If a third party challenges your research, we will confirm that it was authorized under this program. This protection applies only to our systems and does not extend to third-party property. If you are unsure about the scope or your actions, please contact us for clarification. * **Ethical Conduct:** Participants must adhere to the highest standards of ethical, good-faith behavior. We reserve the right to disqualify submissions from researchers who do not follow these rules or engage in unethical behavior. * **Responsible Reporting:** Report findings directly to us via the designated form and provide sufficient details to reproduce and address the issue. Do not publicly disclose vulnerabilities before we have resolved them. * **No Social Engineering:** Do not engage in social engineering or phishing attack on our users or employees. * **No Unauthorized Access to Data:** Do not access, modify, or delete data that does not belong to you. Use separate test accounts. * **Original Work Only:** All submissions must be the original work of the researcher. Submissions generated by AI or automation tools, or identical to previously submitted reports, will be disqualified. Researchers are responsible for thoroughly verifying their findings before submission to ensure their validity and uniqueness. * **No Partnership:** Participation in this program does not create an employment or partnership relationship. Rewards are discretionary and provided without further obligations or benefits. * **Legal Compliance:** Participation must not violate any applicable laws or regulations. Participants are responsible for reporting and paying any taxes owed on rewards received under this program. We do not withhold taxes or provide tax advice, but upon request, we may provide basic information about payments to assist with tax obligations. * **Sanctions:** Rewards will not be issued to participants located in or associated with countries or regions subject to U.S., EU, or UN sanctions. Was this page helpful? YesNo [Migrating from Flipside to Dune](https://docs.dune.com/learning/flipside-migration-guide) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Transactions - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/transactions#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Transactions [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/transactions#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/initia/transactions#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/initia/transactions#table-sample) [​](https://docs.dune.com/data-catalog/initia/transactions#table-description) Table Description ================================================================================================== This table contains data about transactions in the Initia blockchain, including transaction details, gas usage, and execution status. [​](https://docs.dune.com/data-catalog/initia/transactions#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------ | Column name | Data Type | Description | | --- | --- | --- | | **block\_height** | bigint | The height of the block where the transaction occurred. | | **chain\_id** | varchar | The ID of the chain where the transaction occurred. | | **tx\_id** | varchar | The unique ID of the transaction. | | **tx\_info** | varchar | Information related to the transaction. | | **tx\_log\_message** | varchar | The log message associated with the transaction. | | **memo** | varchar | A memo associated with the transaction. | | **fee** | varchar | The fee associated with the transaction. | | **tx\_code** | bigint | The result code of the transaction. | | **tx\_index** | bigint | The index of the transaction within the block. | | **gas\_used** | bigint | The amount of gas used by the transaction. | | **gas\_wanted** | bigint | The amount of gas requested by the transaction. | | **schema\_version** | bigint | The schema version for the transaction data. | | **fee\_coins** | varchar | The coins used to pay the transaction fee. | | **fee\_granter** | varchar | The address granting the fee for the transaction. | | **fee\_payer** | varchar | The address paying the fee for the transaction. | | **gas\_limit** | bigint | The gas limit set for the transaction. | | **single\_sign\_mode** | bigint | The signing mode for single-signature transactions. | | **multi\_sign\_json** | varchar | JSON structure for multi-signature transactions. | | **timeout\_height** | varchar | The timeout height set for the transaction. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/initia/transactions#table-sample) Table Sample ---------------------------------------------------------------------------------------- Was this page helpful? YesNo [Swaps](https://docs.dune.com/data-catalog/initia/swaps) [Transaction Messages](https://docs.dune.com/data-catalog/initia/tx_messages) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Transaction Messages - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/yominet/tx_messages#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Yominet Transaction Messages [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/yominet/tx_messages#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/yominet/tx_messages#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/yominet/tx_messages#table-sample) [​](https://docs.dune.com/data-catalog/yominet/tx_messages#table-description) Table Description ================================================================================================== This table contains data about messages contained within transactions in the Yominet blockchain, including message types, content, and associated metadata. On execution, transactions from Cosmos emit data in two formats: * Messages (`yominet.tx_messages`): These provide a high-level, readable summary of actions, such as “send money” or “execute contract.” They are easier to understand and track transaction types. * Events (`yominet.message_events`): These capture detailed, low-level changes at the chain level, including underlying blockchain modifications that may not always be directly related to state changes. * Use Messages for a general overview and Events when you need detailed insights. The two tables are complementary. [​](https://docs.dune.com/data-catalog/yominet/tx_messages#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------ | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the message occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the message belongs. | | **tx\_id** | varchar | The hash of the transaction containing the message. | | **tx\_index** | bigint | The index of the transaction in the block. | | **message\_index** | bigint | The index of the message in the transaction. | | **message\_type** | varchar | The type of message. | | **message** | varchar | The value/content of the message. | | **schema\_version** | bigint | The version of the schema in provider database. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/yominet/tx_messages#table-sample) Table Sample ---------------------------------------------------------------------------------------- Was this page helpful? YesNo [Transactions](https://docs.dune.com/data-catalog/yominet/transactions) [Overview](https://docs.dune.com/data-catalog/kalshi/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Transaction Messages - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/tx_messages#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Transaction Messages [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/tx_messages#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/initia/tx_messages#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/initia/tx_messages#table-sample) [​](https://docs.dune.com/data-catalog/initia/tx_messages#table-description) Table Description ================================================================================================= This table contains data about messages contained within transactions in the Initia blockchain, including message types, content, and associated metadata. On execution, transactions from Cosmos emit data in two formats: * Messages (`initia.tx_messages`): These provide a high-level, readable summary of actions, such as “send money” or “execute contract.” They are easier to understand and track transaction types. * Events (`initia.message_events`): These capture detailed, low-level changes at the chain level, including underlying blockchain modifications that may not always be directly related to state changes. * Use Messages for a general overview and Events when you need detailed insights. The two tables are complementary. [​](https://docs.dune.com/data-catalog/initia/tx_messages#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the message occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the message belongs. | | **tx\_id** | varchar | The hash of the transaction containing the message. | | **tx\_index** | bigint | The index of the transaction in the block. | | **message\_index** | bigint | The index of the message in the transaction. | | **message\_type** | varchar | The type of message. | | **message** | varchar | The value/content of the message. | | **schema\_version** | bigint | The version of the schema in provider database. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/initia/tx_messages#table-sample) Table Sample --------------------------------------------------------------------------------------- Was this page helpful? YesNo [Transactions](https://docs.dune.com/data-catalog/initia/transactions) [Validators](https://docs.dune.com/data-catalog/initia/validators) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Swaps - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/swaps#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Swaps [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/swaps#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/initia/swaps#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/initia/swaps#table-sample) [​](https://docs.dune.com/data-catalog/initia/swaps#table-description) Table Description =========================================================================================== This table contains data about token swap transactions in the Initia blockchain, including swap details, token pairs, and execution status. [​](https://docs.dune.com/data-catalog/initia/swaps#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the swap occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **tx\_id** | varchar | The unique ID of the transaction. | | **tx\_index** | bigint | The index of the transaction in the block. | | **message\_index** | bigint | The index of the message in the transaction. | | **event\_index** | bigint | The index of the event in the message. | | **action\_index** | bigint | The index of the action in the event. | | **sender** | varchar | The address of the sender. | | **token\_amount\_in** | decimal(38, 0) | The amount of tokens swapped in. | | **token\_denom\_in** | varchar | The denomination of the token swapped in. | | **token\_amount\_out** | decimal(38, 0) | The amount of tokens swapped out. | | **token\_denom\_out** | varchar | The denomination of the token swapped out. | | **routes** | varchar | The routes used for the swap. | | **fees** | varchar | The fees associated with the swap. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/initia/swaps#table-sample) Table Sample --------------------------------------------------------------------------------- Was this page helpful? YesNo [Message Events](https://docs.dune.com/data-catalog/initia/message_events) [Transactions](https://docs.dune.com/data-catalog/initia/transactions) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Migrating from Flipside to Dune - Dune Docs [Skip to main content](https://docs.dune.com/learning/flipside-migration-guide#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Support Migrating from Flipside to Dune [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Migrating from Flipside to Dune](https://docs.dune.com/learning/flipside-migration-guide#migrating-from-flipside-to-dune) * [Key Differences at a Glance](https://docs.dune.com/learning/flipside-migration-guide#key-differences-at-a-glance) * [Table Mappings: Flipside to Dune](https://docs.dune.com/learning/flipside-migration-guide#table-mappings-flipside-to-dune) * [Migrating Queries: From Snowflake to Dune SQL (Trino)](https://docs.dune.com/learning/flipside-migration-guide#migrating-queries-from-snowflake-to-dune-sql-trino) * [1\. The 0x Prefix and Byte Arrays: A Critical Difference](https://docs.dune.com/learning/flipside-migration-guide#1-the-0x-prefix-and-byte-arrays-a-critical-difference) * [2\. Common Syntax Adjustments](https://docs.dune.com/learning/flipside-migration-guide#2-common-syntax-adjustments) * [Identifier Quoting](https://docs.dune.com/learning/flipside-migration-guide#identifier-quoting) * [Data Type Casting](https://docs.dune.com/learning/flipside-migration-guide#data-type-casting) * [Accessing JSON Data](https://docs.dune.com/learning/flipside-migration-guide#accessing-json-data) * [3\. Key Function and Pattern Changes](https://docs.dune.com/learning/flipside-migration-guide#3-key-function-and-pattern-changes) * [Flattening Arrays with UNNEST](https://docs.dune.com/learning/flipside-migration-guide#flattening-arrays-with-unnest) * [Filtering Window Functions (Replacing QUALIFY)](https://docs.dune.com/learning/flipside-migration-guide#filtering-window-functions-replacing-qualify) * [4\. Common Migration Examples](https://docs.dune.com/learning/flipside-migration-guide#4-common-migration-examples) * [Example 1: Daily DEX Volume Analysis](https://docs.dune.com/learning/flipside-migration-guide#example-1-daily-dex-volume-analysis) * [Example 2: Token Balance Analysis](https://docs.dune.com/learning/flipside-migration-guide#example-2-token-balance-analysis) * [5\. Query Performance Tips](https://docs.dune.com/learning/flipside-migration-guide#5-query-performance-tips) * [Understanding Dune’s Data Platform](https://docs.dune.com/learning/flipside-migration-guide#understanding-dune%E2%80%99s-data-platform) * [Common Migration Challenges and Solutions](https://docs.dune.com/learning/flipside-migration-guide#common-migration-challenges-and-solutions) * [Challenge 1: Missing Convenience Tables](https://docs.dune.com/learning/flipside-migration-guide#challenge-1-missing-convenience-tables) * [Challenge 2: Different Table Schemas](https://docs.dune.com/learning/flipside-migration-guide#challenge-2-different-table-schemas) * [Challenge 3: Cross-Chain Analysis](https://docs.dune.com/learning/flipside-migration-guide#challenge-3-cross-chain-analysis) * [Need More Help?](https://docs.dune.com/learning/flipside-migration-guide#need-more-help) [​](https://docs.dune.com/learning/flipside-migration-guide#migrating-from-flipside-to-dune) Migrating from Flipside to Dune =============================================================================================================================== With the recent shutdown of Flipside Creator Studio, we extend a warm welcome to all Flipside users exploring Dune. We understand that migrating your queries and workflows can be a challenging task. This guide is designed to help you transition smoothly by mapping Flipside’s data tables to Dune’s and highlighting the key differences between their respective SQL query engines. Dune offers a powerful platform for blockchain analytics, powered by a community of thousands of creators. We’re excited to have you join us! [​](https://docs.dune.com/learning/flipside-migration-guide#key-differences-at-a-glance) Key Differences at a Glance ----------------------------------------------------------------------------------------------------------------------- For a quick overview, here are some of the main differences between the Flipside and Dune platforms: | Feature | Flipside | Dune | | --- | --- | --- | | **Query Engine** | Snowflake SQL | Dune SQL (based on Trino) | | **Table Naming** | `database.schema.table` | `schema.table` (e.g., `tokens.transfers`) | | **Data Structure** | mostly raw tables | Layered approach: Raw, Decoded, and Curated Data | | **Community** | \- | Active Discord, DuneCon, Bounties, and a vast library of community-generated queries | | **API Access** | Yes | Yes, with a generous free tier to get you started | * * * [​](https://docs.dune.com/learning/flipside-migration-guide#table-mappings-flipside-to-dune) Table Mappings: Flipside to Dune -------------------------------------------------------------------------------------------------------------------------------- Below is a comprehensive mapping of Flipside’s tables to their Dune equivalents. We’ve done our best to find the closest match. In Dune, data is often more modular, so a single Flipside table might map to multiple Dune tables or require a `JOIN` operation to achieve the same result. Use the search bar in Dune’s data explorer to find these tables. | Flipside Table | Dune Table(s) | Migration Notes | | --- | --- | --- | | `EZ_DEPOSITS` | `beacon.deposits` | Contains beacon chain deposit data. The mapping is straightforward. Both tables serve the same purpose of tracking deposits into the consensus layer. | | `EZ_WITHDRAWALS` | `beacon.withdrawals` | Contains beacon chain withdrawal data. This is a direct one-to-one mapping. | | `FACT_ATTESTATIONS` | `beacon.attestations` | Holds details on validator attestations. This is a direct one-to-one mapping. | | `FACT_BLOB_SIDECARS` | `beacon.blobs` | Contains data on blob sidecars from the beacon chain RPC. This is a direct one-to-one mapping. | | `FACT_BLOCKS` | `beacon.blocks` | Contains consensus layer block data. This is a direct one-to-one mapping for raw block information. | | `FACT_DEPOSITS` | `beacon.deposits` | Contains beacon chain deposit data. This is a direct mapping. | | `FACT_VALIDATORS` | `beacon.validators` | Holds information about consensus layer validators. This is a direct one-to-one mapping. | | `FACT_VALIDATOR_BALANCES` | `beacon.validator_day_summaries` | Provides validator balance information. **Note the difference in granularity:** Flipside’s table offered raw balance data, whereas Dune’s `validator_day_summaries` provides balances aggregated by day, which is more efficient for daily trend analysis. | | `FACT_WITHDRAWALS` | `beacon.withdrawals` | Details withdrawals from the beacon chain. This is a direct one-to-one mapping. | | `DIM_ORACLE_FEEDS` | `chainlink_ethereum.oracle_addresses` | Provides metadata for Chainlink oracles. **Note:** Replace `ethereum` with your target chain (e.g., `chainlink_optimism.oracle_addresses` for Optimism). | | `EZ_ORACLE_FEEDS` | `chainlink.price_feeds` | Contains Chainlink price feed data. Dune’s `chainlink.price_feeds` is a curated table that provides similar data, often with a more standardized schema across different chains. | | `FACT_ORACLE_FEEDS` | `chainlink.price_feeds` | Contains Chainlink price feed data. This maps directly to Dune’s curated `chainlink.price_feeds` table. | | `DIM_CONTRACTS` | `ethereum.contracts` | Contains metadata for deployed contracts. **Note:** Replace `ethereum` with your target chain. Dune also has a cross-chain `evms.contracts` table for multi-chain analysis. | | `DIM_CONTRACT_ABIS` | `ethereum.contracts` | Holds contract ABI data. Flipside had a separate table, but Dune integrates ABI information directly into the contracts table. | | `DIM_EVENT_SIGNATURES` | `abi.signatures`; `decoding.evm_signatures` | Contains event signatures for decoding. Dune provides `abi.signatures` for general signatures and `decoding.evm_signatures` for those actively used in decoding EVM data. | | `DIM_FUNCTION_SIGNATURES` | `abi.signatures`; `decoding.evm_signatures` | Contains function signatures for decoding. Similar to event signatures, Dune separates these into general and EVM-specific tables. | | `DIM_LABELS` | `labels.addresses`; `labels.owner_addresses`; `labels.owner_details` | Contains address labels. **Note the structural difference:** Flipside used a single table, whereas Dune employs a more granular, multi-table structure that separates labels for addresses from labels for entities/owners. You may need to `JOIN` these tables. | | `EZ_BALANCE_DELTAS` | `balances_ethereum.erc20_day`; `ethereum.traces` | Provides token and native asset balance changes. On Dune, you can calculate balance deltas from daily balance tables or derive them from transfer tables like `erc20_ethereum.evt_Transfer` and `ethereum.traces` (`value > 0`). | | `EZ_CURRENT_BALANCES` | `balances_ethereum.erc20_latest` | Provides current wallet balances. Dune’s `balances_ethereum.erc20_latest` table provides the most recent balance for tokens, similar to Flipside’s convenience table. | | `EZ_NATIVE_TRANSFERS` | `tokens.transfers` | This is a direct mapping to the `tokens.transfers` table. | | `EZ_SNAPSHOT` | `dune.shot.dataset_follows`
`dune.shot.dataset_proposals_view`
`dune.shot.dataset_spaces_view`
`dune.shot.dataset_users`
`dune.shot.dataset_votes_view` | Contains off-chain Snapshot voting data. **Note the structural difference:** Flipside aggregated this into a single table. Dune ingests Snapshot’s data into multiple, more granular tables that you will need to `JOIN` using proposal or space IDs. | | `EZ_TOKEN_TRANSFERS` | `erc20_ethereum.evt_Transfer` | Contains ERC-20 token transfer events. Dune’s decoded event tables provide the raw transfer data. For aggregated, cleaned data across all chains, use the curated `tokens.transfers` table. | | `FACT_BLOCKS` | `ethereum.blocks` | Provides execution-layer block data. For raw block data, `ethereum.blocks` is a direct match. For aggregated metrics like daily gas fees, Dune offers pre-computed tables in the `dune` schema. | | `FACT_CONTRACT_READS` | Decoded call tables (e.g., `aave_v3_ethereum.AToken_call_balanceOf`) | Contains data from contract reads. On Dune, this corresponds to decoded call tables for specific protocols. Use the data explorer to find the specific contract and function you need. | | `FACT_DECODED_EVENT_LOGS` | Decoded event tables (e.g., `erc20_ethereum.evt_Transfer`) | Contains decoded event logs. This is a core feature of Dune. Instead of one large table, Dune has individual decoded event tables for popular contracts, which are much more efficient to query. | | `FACT_DECODED_TRACES` | Decoded call tables (e.g., `uniswap_v3_ethereum.Factory_call_createPool`) | Contains decoded trace/call data. Similar to events, Dune provides decoded call tables for specific function calls on popular contracts. | | `FACT_ETH_BALANCES` | `balances_ethereum.native_day` | Contains historical ETH balances. Dune’s daily balance tables offer daily snapshots of balances, which is often more performant than querying raw transfer data to reconstruct balances. | | `FACT_EVENT_LOGS` | `ethereum.logs` | Contains raw, undecoded event logs. This is a direct one-to-one mapping. | | `FACT_TOKEN_BALANCES` | `balances_ethereum.erc20_day` | Contains historical token balances. Dune’s daily balance tables offer daily snapshots, providing a more efficient way to query historical balances than reconstructing from transfers. | | `FACT_TOKEN_TRANSFERS` | `erc20_ethereum.evt_Transfer` | Contains raw ERC-20 token transfer events. This maps to the raw decoded event table on Dune for the `Transfer` event on ERC-20 contracts. | | `FACT_TRANSACTIONS` | `ethereum.transactions` | Contains execution-layer transaction data. This is a direct one-to-one mapping. | | `DIM_DEX_LIQUIDITY_POOLS` | `dex.pools` | Contains information on DEX liquidity pools. Dune’s `dex.pools` curated table aims to provide standardized pool data across a wide variety of DEXs. | | `EZ_BRIDGE_ACTIVITY` | `bridge.flows` | Aggregates bridge deposit and withdrawal activity. Dune’s `bridge.flows` is a comprehensive curated table that covers a wide array of bridging protocols with a standardized schema. | | `EZ_DEX_SWAPS` | `dex.trades` | Contains DEX swap events. **This is a major improvement on Dune.** The `dex.trades` curated table is a powerful dataset that aggregates and standardizes swap data from a much wider range of protocols than Flipside’s table. | | `EZ_LENDING_BORROWS` | `lending.borrows` | Contains asset borrowing events from lending protocols. Dune’s `lending.borrows` curated table aggregates this data across many protocols into a standardized format. | | `EZ_LENDING_DEPOSITS` | `lending.supplies` | Contains asset deposit events into lending protocols. Dune’s `lending.supplies` curated table aggregates this data across many protocols into a standardized format. | | `EZ_LENDING_FLASHLOANS` | `lending.flashloans` | Contains flash loan transactions. Dune’s `lending.flashloans` curated table aggregates this data across protocols that support flash loans. | | `EZ_LENDING_LIQUIDATIONS` | `lending.liquidations` | Contains collateral liquidation events. Dune’s `lending.liquidations` curated table aggregates liquidation data across multiple lending protocols. | | `EZ_LENDING_REPAYMENTS` | `lending.repayments` | Contains loan repayment events. Dune’s `lending.repayments` curated table aggregates this data across multiple lending protocols. | | `EZ_LENDING_WITHDRAWS` | `lending.withdraws` | Contains asset withdrawal events from lending protocols. Dune’s `lending.withdraws` curated table aggregates this data across many protocols. | | `EZ_LIQUID_STAKING_DEPOSITS` | `staking_ethereum.deposits` | Contains liquid staking deposit events. Dune’s liquid staking tables aggregate data from a wide range of liquid staking providers. | | `EZ_LIQUID_STAKING_WITHDRAWALS` | `staking_ethereum.withdrawals` | Contains liquid staking withdrawal events. Dune’s liquid staking tables aggregate data from various liquid staking providers. | | `EZ_ENS_DOMAINS` | `labels.ens` | Contains data on ENS domain registrations. This maps well to Dune’s `labels.ens` table. | | `FACT_DAO_VOTES` | `dao.votes` | Contains DAO voting records. Dune’s `dao.votes` curated table aims to standardize voting data across different DAO frameworks. | | `FACT_REGISTRATIONS` | `ens.view_registrations` | Contains ENS registration records. This is a direct mapping. | | `FACT_RENEWALS` | `ens.view_renewals` | Contains ENS domain renewal records. This is a direct mapping. | | `FACT_TRANSFERS` | `tokens.transfers` | Contains token transfer events. Dune’s `tokens.transfers` is a curated table that provides a standardized format for all token transfers. | | `EZ_GOVERNANCE_VOTES` | `governance.votes` | Contains records of governance votes. Dune’s `governance.votes` curated table covers multiple protocols, including Maker. | | `FACT_CAT_BITE` | `maker_ethereum.cat_evt_bite` | Contains MakerDAO liquidation events. This is a direct mapping to the raw event table in Dune. | | `DIM_NFT_COLLECTION_METADATA` | `nft.collections` | Contains metadata for NFT collections. Dune’s `nft.collections` curated table provides metadata for a vast number of NFT collections. | | `EZ_NFT_MINTS` | `nft.mints` | Contains NFT mint events. Dune’s `nft.mints` is a curated table that identifies and standardizes minting events across various standards. | | `EZ_NFT_SALES` | `nft.trades` | Contains NFT sale events. **This is another major improvement on Dune.** The `nft.trades` curated table is a powerful abstraction that aggregates sales across dozens of marketplaces into a single, clean table. | | `EZ_NFT_TRANSFERS` | `nft.transfers` | Contains NFT transfer events. Dune’s `nft.transfers` curated table is the standard place to find all ERC721 and ERC1155 transfers. | | `EZ_ASSET_METADATA` | `tokens.erc20`, `tokens.nft` | Contains asset metadata. Dune separates metadata for fungible (`tokens.erc20`) and non-fungible (`tokens.nft`) tokens into dedicated, curated tables. | | `EZ_PRICES_HOURLY` | `prices.hour` | Provides hourly token prices. This is a direct mapping to Dune’s hourly prices table. Dune also offers `prices.usd_daily` and `prices.usd_latest`. | | `EZ_SWAPS` | `dex.trades` | Contains DEX swap events. This maps to Dune’s comprehensive `dex.trades` curated table, which covers a much wider array of DEXs. | | `DIM_DATES` | `utils.days`, `utils.hours`, `utils.minutes` | Provides a table of dates for time-series analysis. Dune offers several utility tables for different time granularities to simplify `JOIN` operations. | | `FACT_TRACES` | `ethereum.traces` | Contains raw trace data for internal contract calls. This is a direct one-to-one mapping. | * * * [​](https://docs.dune.com/learning/flipside-migration-guide#migrating-queries-from-snowflake-to-dune-sql-trino) Migrating Queries: From Snowflake to Dune SQL (Trino) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ The most significant adjustment you’ll make when migrating from Flipside is the query engine. Flipside utilized Snowflake’s SQL dialect, whereas Dune is powered by **Dune SQL**, which is based on **Trino** (formerly PrestoSQL). While both are standards-compliant, Trino has its own flavor and functions that differ from Snowflake. Let’s walk through the most common changes you’ll need to make to your queries. ### [​](https://docs.dune.com/learning/flipside-migration-guide#1-the-0x-prefix-and-byte-arrays-a-critical-difference) 1\. The `0x` Prefix and Byte Arrays: A Critical Difference In Dune, blockchain addresses, transaction hashes, and other raw byte data are stored as `VARBINARY` types, not simple strings. When you filter by or insert these values in your queries, you **must** prefix them with `0x`. This is one of the most common tripping points for new users. **Dune SQL (Correct):** Copy Ask AI -- Filtering for transactions to a specific address SELECT * FROM ethereum.transactions WHERE "to" = 0x742d35Cc6634C0532925a3b844Bc454e4438f44e -- Uniswap V2: Router 2 **Flipside/Snowflake (and incorrect in Dune):** Copy Ask AI -- This will fail or return no results in Dune SELECT * FROM ethereum.transactions WHERE "to" = '0x742d35Cc6634C0532925a3b844Bc454e4438f44e' **Pro tip:** When copying addresses from block explorers, they typically include the `0x` prefix. In Dune, simply remove the quotes around the address to use it as a `VARBINARY` literal. ### [​](https://docs.dune.com/learning/flipside-migration-guide#2-common-syntax-adjustments) 2\. Common Syntax Adjustments Here are some of the most frequent syntax adjustments you’ll encounter. #### [​](https://docs.dune.com/learning/flipside-migration-guide#identifier-quoting) Identifier Quoting This should be an easy transition. Both Snowflake and Trino follow the ANSI SQL standard and use double quotes (`"`) to quote identifiers (e.g., column names with spaces or reserved words like `"from"` or `"to"`). Your quoting syntax will likely not need to change. * **Snowflake/Dune SQL (Trino):** `SELECT "from", "to" FROM "my_table";` #### [​](https://docs.dune.com/learning/flipside-migration-guide#data-type-casting) Data Type Casting Snowflake commonly uses `::` for casting. Dune SQL uses the ANSI SQL standard `CAST(column AS TYPE)`. * **Snowflake:** `SELECT '123'::integer, '2023-01-01'::date;` * **Dune SQL:** `SELECT CAST('123' AS integer), CAST('2023-01-01' AS date);` #### [​](https://docs.dune.com/learning/flipside-migration-guide#accessing-json-data) Accessing JSON Data Accessing nested data in JSON objects requires specific functions in Trino. While Snowflake uses a colon (`:`), Trino uses `json_extract_scalar`. * **Snowflake:** `SELECT my_json_column:key::string FROM my_table;` * **Dune SQL (Trino):** `SELECT json_extract_scalar(my_json_column, '$.key') FROM my_table;` ### [​](https://docs.dune.com/learning/flipside-migration-guide#3-key-function-and-pattern-changes) 3\. Key Function and Pattern Changes #### [​](https://docs.dune.com/learning/flipside-migration-guide#flattening-arrays-with-unnest) Flattening Arrays with `UNNEST` To un-nest array elements into their own rows, Snowflake uses `LATERAL FLATTEN()`. The Trino equivalent is `UNNEST`. **Snowflake:** Copy Ask AI SELECT t.id, value:name::string FROM my_table t, LATERAL FLATTEN(input => t.my_json_array); **Dune SQL (Trino):** Copy Ask AI SELECT t.id, item.name FROM my_table t CROSS JOIN UNNEST(t.my_json_array) AS t(item) #### [​](https://docs.dune.com/learning/flipside-migration-guide#filtering-window-functions-replacing-qualify) Filtering Window Functions (Replacing `QUALIFY`) Snowflake’s `QUALIFY` clause is a convenient way to filter the results of a window function. `QUALIFY` is not available in Dune SQL. The standard approach is to use a subquery or a Common Table Expression (CTE), which works perfectly in Trino. **Snowflake:** Copy Ask AI SELECT * FROM my_table QUALIFY ROW_NUMBER() OVER (PARTITION BY id ORDER BY timestamp DESC) = 1; **Dune SQL (Trino):** Copy Ask AI WITH ranked_rows AS ( SELECT *, ROW_NUMBER() OVER (PARTITION BY id ORDER BY timestamp DESC) as rn FROM my_table ) SELECT * FROM ranked_rows WHERE rn = 1; ### [​](https://docs.dune.com/learning/flipside-migration-guide#4-common-migration-examples) 4\. Common Migration Examples Here are some practical examples of migrating common Flipside query patterns to Dune: #### [​](https://docs.dune.com/learning/flipside-migration-guide#example-1-daily-dex-volume-analysis) Example 1: Daily DEX Volume Analysis **Flipside Pattern:** Copy Ask AI SELECT block_timestamp::date as date, SUM(amount_usd) as volume_usd FROM ethereum.core.ez_dex_swaps WHERE block_timestamp >= '2024-01-01'::date GROUP BY 1 ORDER BY 1; **Dune Equivalent:** Copy Ask AI SELECT DATE_TRUNC('day', block_time) as date, SUM(amount_usd) as volume_usd FROM dex.trades WHERE block_time >= CAST('2024-01-01' AS date) AND blockchain = 'ethereum' GROUP BY 1 ORDER BY 1; #### [​](https://docs.dune.com/learning/flipside-migration-guide#example-2-token-balance-analysis) Example 2: Token Balance Analysis **Flipside Pattern:** Copy Ask AI SELECT user_address, symbol, current_bal FROM ethereum.core.ez_current_balances WHERE contract_address = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'::string; **Dune Equivalent:** Copy Ask AI SELECT address as user_address, symbol, amount_raw / POW(10, decimals) as current_bal FROM balances_ethereum.erc20_latest WHERE contract_address = 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48; -- USDC ### [​](https://docs.dune.com/learning/flipside-migration-guide#5-query-performance-tips) 5\. Query Performance Tips Many Flipside tables encouraged filtering by `block_timestamp::date` for performance. In Dune, many raw and curated tables are physically partitioned by date-based columns (like `block_day` or `block_time`). Always add a filter on these partitioned columns where available, as it can dramatically speed up your queries by reducing the amount of data scanned. You can find partition keys in the schema browser in the query editor. **Performance Best Practices:** * Always filter by `block_time` or `block_date` when available * Use the curated tables (like `dex.trades`, `nft.trades`) instead of raw tables when possible * Limit your date ranges to what you actually need for analysis * Use `LIMIT` clauses during development to avoid scanning large datasets * * * [​](https://docs.dune.com/learning/flipside-migration-guide#understanding-dune%E2%80%99s-data-platform) Understanding Dune’s Data Platform --------------------------------------------------------------------------------------------------------------------------------------------- Dune’s approach to data is layered, providing different levels of abstraction to make analysis easier: 1. **Raw Data:** Raw, unprocessed data from the blockchain (e.g., `ethereum.blocks`, `ethereum.transactions`). This is your source of truth. 2. **Decoded Data:** Raw data is decoded into human-readable tables. For example, contract events are decoded into tables like `aave_v3_ethereum.Supply`. This saves you the effort of dealing with logs and topics. 3. **Curated Data:** These are higher-level abstractions built and maintained by the community. Tables like `dex.trades` or `nft.trades` aggregate data across multiple protocols, making cross-platform analysis simple. We encourage you to explore the [data catalog](https://docs.dune.com/data-catalog/overview) in the Dune app to discover the wealth of datasets available. [​](https://docs.dune.com/learning/flipside-migration-guide#common-migration-challenges-and-solutions) Common Migration Challenges and Solutions --------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/learning/flipside-migration-guide#challenge-1-missing-convenience-tables) Challenge 1: Missing Convenience Tables **Issue:** Flipside provided many “EZ\_” convenience tables that aggregated complex data. **Solution:** Dune’s curated tables (like `dex.trades`, `nft.trades`) often provide even better aggregations. If a specific convenience table doesn’t exist, you can often recreate it using raw or decoded data. ### [​](https://docs.dune.com/learning/flipside-migration-guide#challenge-2-different-table-schemas) Challenge 2: Different Table Schemas **Issue:** Column names and data types may differ between platforms. **Solution:** Use Dune’s data explorer to examine table schemas. The `DESCRIBE` command can also help: `DESCRIBE dex.trades;` ### [​](https://docs.dune.com/learning/flipside-migration-guide#challenge-3-cross-chain-analysis) Challenge 3: Cross-Chain Analysis **Issue:** Flipside often had separate databases per chain. **Solution:** Dune’s curated tables often include a `blockchain` column, making cross-chain analysis much easier. Simply add `WHERE blockchain IN ('ethereum', 'polygon')` to your queries. [​](https://docs.dune.com/learning/flipside-migration-guide#need-more-help) Need More Help? ---------------------------------------------------------------------------------------------- We know migrating can be tough, but you’re not alone. Here are some resources to help you on your journey: * **Dune Documentation:** [docs.dune.com](https://dune.com/docs/) * **Dune Discord:** Join our [Discord server](https://discord.gg/dune) to ask questions and connect with thousands of other crypto data analysts. * **Find a Query:** Fork one of the 600,000+ public queries on Dune to get a head start. * **Data Catalog:** Explore our comprehensive [data catalog](https://docs.dune.com/data-catalog/overview) to understand available datasets. * **Query Examples:** Check out our [quickstart guide](https://docs.dune.com/quickstart) for hands-on examples. * \*\*Onboarding: \*\*Fill out this [onboarding form](https://forms.gle/G3x9mWmW3AYauu6FA) and we’ll schedule a live session to help you. Welcome to Dune! We can’t wait to see what you build. Was this page helpful? YesNo [FAQs](https://docs.dune.com/learning/how-tos/pricing-faqs) [Bug Bounty Submission](https://docs.dune.com/web-app/bug-bounty) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Validators - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/initia/validators#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Initia Validators [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/initia/validators#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/initia/validators#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/initia/validators#table-sample) [​](https://docs.dune.com/data-catalog/initia/validators#table-description) Table Description ================================================================================================ This table contains data about validators in the Initia blockchain, including their performance metrics, voting power, and status. [​](https://docs.dune.com/data-catalog/initia/validators#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **operator\_address** | varchar | The operator address of the validator. | | **account\_address** | varchar | The account address of the validator. | | **consensus\_pubkey** | varchar | The consensus public key of the validator. | | **jailed** | boolean | Indicates whether the validator is jailed. | | **status** | varchar | The status of the validator (e.g., active, inactive). | | **tokens** | varchar | The number of tokens held by the validator. | | **moniker** | varchar | The moniker or name of the validator. | | **identity** | varchar | The identity information of the validator. | | **website** | varchar | The website of the validator. | | **security\_contact** | varchar | The security contact information for the validator. | | **details** | varchar | Additional details about the validator. | | **unbonding\_height** | bigint | The block height at which the validator started unbonding. | | **unbonding\_time** | varchar | The time when the validator will complete unbonding. | | **commission\_rate** | double | The commission rate charged by the validator. | | **commission\_max\_rate** | double | The maximum commission rate allowed for the validator. | | **commission\_max\_change\_rate** | double | The maximum rate at which the validator can change its commission. | | **commission\_update\_time** | varchar | The time when the validator last updated its commission. | | **min\_self\_delegation** | varchar | The minimum self-delegation required for the validator. | | **snapshot\_height** | bigint | The block height at which the snapshot was taken. | | **snapshot\_time** | varchar | The time when the snapshot was taken. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/initia/validators#table-sample) Table Sample -------------------------------------------------------------------------------------- Was this page helpful? YesNo [Transaction Messages](https://docs.dune.com/data-catalog/initia/tx_messages) [Overview](https://docs.dune.com/data-catalog/noble/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Web3 Data Resources - Dune Docs [Skip to main content](https://docs.dune.com/learning-resources#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Web3 Data Resources [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Dune Tutorials](https://docs.dune.com/learning-resources#dune-tutorials) * [Metrics-Driven Analysis](https://docs.dune.com/learning-resources#metrics-driven-analysis) * [Analysis Tips](https://docs.dune.com/learning-resources#analysis-tips) * [Engage with the Community](https://docs.dune.com/learning-resources#engage-with-the-community) After you’ve gone through the [quickstart guide](https://docs.dune.com/quickstart) , you’ll be ready to start learning how to navigate the Web3 data analytics space. Analyzing protocols in web3 is both really easy and hard. It’s really easy because everything is transparent and standardized - a deployed contract has a set of functions and events that are pretty much immutable. However, it’s an ever-expanding data arena as new protocols, tokens, and wallets join the fray. To build your reputation as an expert analyst, you must stay centered on what you want to analyze and what metrics you want to present. [​](https://docs.dune.com/learning-resources#dune-tutorials) Dune Tutorials ------------------------------------------------------------------------------ ### [​](https://docs.dune.com/learning-resources#metrics-driven-analysis) Metrics-Driven Analysis * Video Series: Check out our [Video Tutorials](https://docs.dune.com/resources/learning/video-tutorials) for comprehensive guides, including: * [Uniswap in 12 Days](https://docs.dune.com/resources/learning/video-tutorials#uniswap-in-12-days) (includes metrics like price impact, TVL, MEV volume, liquidity stability) * [Gnosis Safe Point-in-Time](https://docs.dune.com/resources/learning/video-tutorials#gnosis-safe-point-in-time-analysis) (includes metrics like signers, diversification, and valuations) * Dashboards for Insights: * To understand token trends and contexts, check out this [ERC20 dashboard](https://dune.com/ilemi/Token-Overview-Metrics) and this [NFT dashboard](https://dune.com/rantum/NFT-Collection-Dashboard) . * To understand wallet/user segments, you’ll need to leverage [labels](https://github.com/duneanalytics/spellbook/tree/main/models/labels/addresses) to enhance your analysis. Once you have metrics and also understand the underlying tokens and users, it will start to become clear what that real narrative is. Try and pull together a few insights, and then create a compelling dashboard and story around them. Don’t try too hard to capture everything at once - it will become overwhelming for both you and those you share it with. [​](https://docs.dune.com/learning-resources#analysis-tips) Analysis Tips ---------------------------------------------------------------------------- * Start with a solid foundation. Master [basic SQL and blockchain concepts](https://web3datadegens.substack.com/p/a-basic-wizard-guide-to-dune-sql) . * Scope Your Work: When looking into a protocol, you’ll need to understand the contract architecture and context. That starts with functions, events, and wallet overviews. There is a [quickstart dashboard](https://dune.com/ilemi/contract-quickstart) built just for this, you can see a walkthrough analyzing Opensea [here](https://read.cryptodatabytes.com/p/how-to-start-analyzing-any-web3-protocol) . Remember that no protocol lives in isolation - there is always some mix of onchain events happening. That could be some new airdrop, a new upstream/downstream protocol integration, large whales making moves, governance changes in protocol parameters, and more. Once you have a solid understanding of protocol history in usage, user, and integration trends, you’re ready to start building some metrics. [​](https://docs.dune.com/learning-resources#engage-with-the-community) Engage with the Community ---------------------------------------------------------------------------------------------------- When you’re done, be sure to share your work [in the Discord](https://discord.com/invite/ErrzwBz) `#📺︱show-your-work` channel and on Twitter tagging [@dune](https://twitter.com/dune) . We’ll be sure to give great analysts a boost! Web3 is all about connecting with communities - your queries and dashboards will do nothing if you don’t share it around. Was this page helpful? YesNo ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Receipts - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/fuel/receipts#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Fuel Receipts [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/fuel/receipts#table-description) * [Column Description](https://docs.dune.com/data-catalog/fuel/receipts#column-description) * [Table Sample](https://docs.dune.com/data-catalog/fuel/receipts#table-sample) [​](https://docs.dune.com/data-catalog/fuel/receipts#table-description) Table Description ============================================================================================ This table contains data about transaction receipts in the Fuel blockchain, including execution results, gas usage, and associated metadata. [​](https://docs.dune.com/data-catalog/fuel/receipts#column-description) Column Description ---------------------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | **block\_time** | bigint | Block creation timestamp | | **block\_height** | bigint | Block height/number | | **block\_version** | string | Block version | | **block\_producer** | binary | Block producer address | | **transaction\_id** | binary | Transaction identifier | | **amount** | bigint | Token amount | | **asset\_id** | binary | Asset identifier | | **contract\_id** | binary | Contract identifier | | **data** | string | Receipt data | | **digest** | binary | Receipt hash | | **gas** | bigint | Gas limit | | **gas\_used** | bigint | Gas consumed | | **id** | string | Receipt identifier | | **is** | bigint | State indicator | | **len** | bigint | Data length | | **nonce** | binary | Transaction nonce | | **param1** | bigint | Parameter 1 | | **param2** | bigint | Parameter 2 | | **ptr** | bigint | Pointer value | | **ra** | bigint | Register A | | **rb** | bigint | Register B | | **rc** | bigint | Register C | | **rd** | bigint | Register D | | **reason\_reason** | int | Failure reason code | | **reason\_instruction** | bigint | Failed instruction | | **receipt\_type** | string | Receipt type | | **recipient** | binary | Recipient address | | **result** | bigint | Execution result | | **sender** | binary | Sender address | | **sub\_id** | binary | Sub-identifier | | **to** | binary | Destination address | | **to\_address** | string | Destination address string | | **val** | bigint | Value amount | | **\_updated\_at** | timestamp | Last update timestamp | | **\_ingested\_at** | timestamp | Ingestion timestamp | [​](https://docs.dune.com/data-catalog/fuel/receipts#table-sample) Table Sample ---------------------------------------------------------------------------------- Was this page helpful? YesNo [Transactions](https://docs.dune.com/data-catalog/fuel/transactions) [Overview](https://docs.dune.com/data-catalog/initia/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Build a Frame with Dune API - Dune Docs [Skip to main content](https://docs.dune.com/learning/how-tos/dune-frames#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Build a Frame with Dune API [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Set up your environment with the example repo](https://docs.dune.com/learning/how-tos/dune-frames#set-up-your-environment-with-the-example-repo) * [Explaining the Dune API function](https://docs.dune.com/learning/how-tos/dune-frames#explaining-the-dune-api-function) This guide provides a step-by-step process on using typescript and Dune API to create a user recommendation frame for Farcaster. You can find a [live example of the frame here](https://warpcast.com/~/conversations/0x62b84d8405fe6e9ff1639055852d98f910b4c595) . [​](https://docs.dune.com/learning/how-tos/dune-frames#set-up-your-environment-with-the-example-repo) Set up your environment with the example repo ------------------------------------------------------------------------------------------------------------------------------------------------------ [Fork this repo](https://github.com/andrewhong5297/dune-frames) and then run `npm install -g frog` and `npm install` to get all your packages. If you don’t have npm set up, then [go download node js first](https://nodejs.org/en/download) . Once installations are finished, try running `npm run dev` and it should take you to a localhost environment at [http://localhost:5173/api](http://localhost:5173/api) . Next, you’ll need to get a Dune API key from [your user settings](https://dune.com/settings/api) and export it. With that done, you’ll be able to run the frame - click “See From Your Followers” in your localhost environment. [​](https://docs.dune.com/learning/how-tos/dune-frames#explaining-the-dune-api-function) Explaining the Dune API function ---------------------------------------------------------------------------------------------------------------------------- We call the Dune API in the `/api/dune.ts` file in the `getRecommendations(fid)` function [defined here](https://github.com/andrewhong5297/dune-frames/blob/main/api/dune.ts#L10) . Below is the main API call, which makes a [FILTER](https://docs.dune.com/api-reference/executions/filtering) call on an [existing result set](https://docs.dune.com/api-reference/executions/endpoint/get-query-result) . Using filters, we get our results in 20-30ms instead of reruning the whole query (which may take 10-20 seconds). Copy Ask AI //schedule the query on a 6-hour interval, and then fetch by filtering for the user fid within the query results //dune query where each row is a unique fid and each column is a recommended set of users: https://dune.com/queries/3509966 const meta = { "x-dune-api-key": DUNE_API_KEY || "" }; const header = new Headers(meta); const latest_response = await fetch(`https://api.dune.com/api/v1/query/3509966/results?&filters=query_fid=${fid}` //filter for single fid , { method: 'GET', headers: header, }); const body = await latest_response.text(); const recs = JSON.parse(body).result.rows[0]; //will only be one row in the result, for the filtered fid You can write your own aggregation queries in the same format, and then use filters to make the API fast enough for app/frame development. Good luck! Was this page helpful? YesNo ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Contract Submission Guide - Dune Docs [Skip to main content](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Decode Smart Contracts Contract Submission Guide [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Why Submit Contracts for Decoding?](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#why-submit-contracts-for-decoding) * [How to Submit Contracts](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#how-to-submit-contracts) * [Submit via UI (Recommended)](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#submit-via-ui-recommended) * [Batch Submission via CSV (Advanced)](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#batch-submission-via-csv-advanced) * [Submission Strategy](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#submission-strategy) * [Special Instructions by Contract Type](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#special-instructions-by-contract-type) * [Proxy Contracts](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#proxy-contracts) * [ERC20, ERC721, ERC1155 Tokens](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#erc20-erc721-erc1155-tokens) * [DEX Contracts](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#dex-contracts) * [NFT Marketplace Contracts](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#nft-marketplace-contracts) * [Unverified Contracts](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#unverified-contracts) [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#why-submit-contracts-for-decoding) Why Submit Contracts for Decoding? --------------------------------------------------------------------------------------------------------------------------------------------------- Decoding creates structured, queryable datasets for your protocol’s smart contracts on Dune. Once decoded, your team and the broader community can build dashboards and analytics using human-readable event and function data instead of raw bytecode. [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#how-to-submit-contracts) How to Submit Contracts ------------------------------------------------------------------------------------------------------------------------------ ### [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#submit-via-ui-recommended) Submit via UI (Recommended) Use the Dune UI for a guided submission process: [https://dune.com/contracts/new](https://dune.com/contracts/new) . ### [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#batch-submission-via-csv-advanced) Batch Submission via CSV (Advanced) If you are looking to submit dozens of protocol contracts, you may submit via CSV. Work with us through Slack or Telegram, ensuring the CSV is formatted correctly for batch submission. Batch submission bypasses UI safeguards, so make sure all flags are accurate, the ABI is formatted correctly, and naming follows Dune standards. Using the UI is preferred, as it includes checks that reduce errors and debugging time. Follow [this Google Sheet template](https://docs.google.com/spreadsheets/d/1yxJqlmSE2yYgXgSIXcPRr5xxP9ck9JZB8_sGOITtYEM/edit?gid=0#gid=0) for exact format, and refer to [Dune’s documentation](https://docs.dune.com/web-app/decoding/decoding-contracts) for guidance on fields like: * **`has_multiple_instances`** is flag for for [dynamic contracts](https://docs.dune.com/web-app/decoding/decoding-contracts#are-there-several-instances-of-this-contract-dynamic-contract) * **`is_created_by_factory`** is flag for [factory contracts](https://docs.dune.com/web-app/decoding/decoding-contracts#is-it-created-by-a-factory-contract-factory-contract) [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#submission-strategy) Submission Strategy ---------------------------------------------------------------------------------------------------------------------- * **For Chains:** Encourage top protocols to submit their key contracts. * **For Protocols:** Collaborate with your developers or data analysts to identify which contracts include the main logic and events. [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#special-instructions-by-contract-type) Special Instructions by Contract Type ---------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#proxy-contracts) Proxy Contracts If using a proxy pattern, submit the **implementation contract’s ABI**. Dune’s pipeline cannot handle dynamic proxies or complex patterns automatically yet. ### [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#erc20-erc721-erc1155-tokens) ERC20, ERC721, ERC1155 Tokens These contracts typically don’t need submission, as Dune already covers standard approvals and transfers. Submit only if custom events are needed. ### [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#dex-contracts) DEX Contracts Look for below sets of contracts: * **Factory Contract**: should emit pool creation events. * **Pair/Pool Contract**: should emit swap events. If decoding is required for additional contracts like routers or position managers, please submit those as well. ### [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#nft-marketplace-contracts) NFT Marketplace Contracts Submit the main marketplace contract with key events, such as: * `ERC721BuyOrderFilled` * `ERC721SellOrderFilled` * `ERC1155BuyOrderFilled` * `ERC1155SellOrderFilled` ### [​](https://docs.dune.com/web-app/decoding/short-guide-contract-submission#unverified-contracts) Unverified Contracts If the contract isn’t verified on the block explorer, contact the protocol developers to obtain the ABI. Was this page helpful? YesNo [Submission Best Practices](https://docs.dune.com/web-app/decoding/best-practices) [Multichain Decoding](https://docs.dune.com/web-app/decoding/multichain-decoding) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Build Dashboards - Dune Docs [Skip to main content](https://docs.dune.com/web-app/dashboards#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Visualize and Present Results Build Dashboards [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Creating a Dashboard](https://docs.dune.com/web-app/dashboards#creating-a-dashboard) * [Add Widgets from the Query Editor](https://docs.dune.com/web-app/dashboards#add-widgets-from-the-query-editor) * [Adding Text Widget](https://docs.dune.com/web-app/dashboards#adding-text-widget) * [Embedding Images and GIFs](https://docs.dune.com/web-app/dashboards#embedding-images-and-gifs) * [Keeping your Dashboard up to date](https://docs.dune.com/web-app/dashboards#keeping-your-dashboard-up-to-date) * [Sharing your Dashboard](https://docs.dune.com/web-app/dashboards#sharing-your-dashboard) Watch our [dashboard tutorial video](https://docs.dune.com/resources/learning/video-tutorials#building-dashboards) to see how to build dashboards step-by-step. Dashboards on Dune consist of widgets. Widgets can either be Visualizations or Text. It is also possible to embed images or GIFs inside of the text widget. You can freely resize every widget to match the layout you want to create. [​](https://docs.dune.com/web-app/dashboards#creating-a-dashboard) Creating a Dashboard ------------------------------------------------------------------------------------------ **To create a dashboard on Dune:** 1. Use the create menu and pick “New Dashboard” 2. Give your Dashboard a name 3. Click on “Save and Open” 4. You are now inside of your Dashboard 5. Enter the edit mode by clicking on the “Edit” button in the top right corner 6. Add widgets by clicking on the “Add Widget” button in the top right corner 7. Pick the widget you want to add 8. You can now resize the widget by dragging the bottom right corner 9. You can also move the widget by dragging it around 10. Click on the “Save” button in the top right corner to save your changes The initial name that you give to your Dashboard will also be the URL slug. You can’t change the URL slug afterwards, so be mindful of the name you choose. Changing the Dashboard’s display name is always possible though. [​](https://docs.dune.com/web-app/dashboards#add-widgets-from-the-query-editor) Add Widgets from the Query Editor -------------------------------------------------------------------------------------------------------------------- You can add widgets directly from the Query Editor. **To add widgets from the query editor:** 1. Navigate to the query Editor 2. Pick the Visualization you want to add to your Dashboard 3. Click on the “Add to Dashboard” button 4. Choose the Dashboard you want to add the Visualization to 5. The Visualization is now added to your Dashboard The widget will be added to the bottom of your Dashboard. You can move it around and resize it as you like. [​](https://docs.dune.com/web-app/dashboards#adding-text-widget) Adding Text Widget -------------------------------------------------------------------------------------- You can add text widgets to your dashboard. Text widgets support a subset of Markdown. You can manipulate text and embed images and GIFs. [​](https://docs.dune.com/web-app/dashboards#embedding-images-and-gifs) Embedding Images and GIFs ---------------------------------------------------------------------------------------------------- Text boxes can also be used to embed images or GIFs into your Dashboard. The Syntax for embedding images is: Copy Ask AI ![alt text](image url) Since you can’t store images locally on our servers, you need to upload your images somewhere else or find the raw file somewhere on the internet. In practice this might look like this: Copy Ask AI ![text](https://pbs.twimg.com/media/FEWVLQwWUAQcqLY?format=jpg&name=medium) You can resize the image by simply resizing the widget it is contained in. You can combine images and text in one widget. [​](https://docs.dune.com/web-app/dashboards#keeping-your-dashboard-up-to-date) Keeping your Dashboard up to date -------------------------------------------------------------------------------------------------------------------- Dashboards on Dune are not updated automatically. You can refresh your Dashboard by clicking on the “Run” button in the top right corner. Alternatively, you can schedule your Dashboard to be refreshed in regular intervals. To schedule a dashboard: 1. Click on the “clock” icon in the top right corner 2. Select the frequency you want your Dashboard to be refreshed 3. Select the execution tier you want to use 4. Click on “Save” You can also schedule individual queries to be refreshed. This is useful if you have a Dashboard with many queries and only want to refresh a few of them. Learn more about scheduling queries [here](https://docs.dune.com/web-app/query-editor/query-scheduler) . [​](https://docs.dune.com/web-app/dashboards#sharing-your-dashboard) Sharing your Dashboard ---------------------------------------------------------------------------------------------- To learn how to share, embed, and control access to your dashboards, visit the [Share and Embed](https://docs.dune.com/web-app/share) page. Was this page helpful? YesNo [Tables](https://docs.dune.com/web-app/visualizations/tables) [Schedule Queries](https://docs.dune.com/web-app/query-editor/query-scheduler) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Find Data Tables with the Data Explorer - Dune Docs [Skip to main content](https://docs.dune.com/web-app/query-editor/data-explorer#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Write and Run Queries Find Data Tables with the Data Explorer [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Searching for Data](https://docs.dune.com/web-app/query-editor/data-explorer#searching-for-data) * [Data Explorer Sections](https://docs.dune.com/web-app/query-editor/data-explorer#data-explorer-sections) * [Curated Data](https://docs.dune.com/web-app/query-editor/data-explorer#curated-data) * [My Data](https://docs.dune.com/web-app/query-editor/data-explorer#my-data) * [Partner Data](https://docs.dune.com/web-app/query-editor/data-explorer#partner-data) * [Decoded Projects](https://docs.dune.com/web-app/query-editor/data-explorer#decoded-projects) * [Raw Blockchain Data](https://docs.dune.com/web-app/query-editor/data-explorer#raw-blockchain-data) * [Inspecting Tables and Columns](https://docs.dune.com/web-app/query-editor/data-explorer#inspecting-tables-and-columns) The Data Explorer is the left-side panel of the [query editor](https://docs.dune.com/web-app/query-editor) . It gives you direct access to Dune’s full [Data Catalog](https://docs.dune.com/data-catalog/overview) — so you can search for tables, inspect schemas, and add columns to your query without leaving the editor. [​](https://docs.dune.com/web-app/query-editor/data-explorer#searching-for-data) Searching for Data ------------------------------------------------------------------------------------------------------ The search bar at the top of the Data Explorer supports a wide range of inputs. You can search by dataset name, contract address, table name, or any relevant keyword. If you already know what you are looking for, this is the fastest way to find it. [​](https://docs.dune.com/web-app/query-editor/data-explorer#data-explorer-sections) Data Explorer Sections -------------------------------------------------------------------------------------------------------------- The Data Explorer organizes Dune’s data into the following sections, from top to bottom: 1. Click on one of the categories in the left sidebar to see the tables available in that category. 2. Filter the tables through the dropdowns in the top right corner. 3. Check out the table preview to see what data is available in that table. 4. Click on the arrow next to the table name to include it in your query. ### [​](https://docs.dune.com/web-app/query-editor/data-explorer#curated-data) Curated Data Curated tables are pre-built, analytics-ready datasets that standardize on-chain activity across hundreds of blockchains. Examples include `dex.trades`, `nft.trades`, `tokens.transfers`, and `prices.usd`. These tables are designed to let you start querying immediately without needing to understand raw blockchain structures. For a full overview of available curated datasets, see the [Curated Data Overview](https://docs.dune.com/data-catalog/curated/overview) . ### [​](https://docs.dune.com/web-app/query-editor/data-explorer#my-data) My Data The My Data section surfaces data that is specific to your account and workspace: * **Favorites** — Tables you have starred for quick access. * **Connected Data** — External data sources you have connected to your workspace. * **Materialized Views** — Query results that you have saved as reusable tables. * **Uploaded Data** — CSV files you have [uploaded](https://docs.dune.com/web-app/upload-data) to Dune. * **This Query** — Tables referenced in the query you currently have open. ### [​](https://docs.dune.com/web-app/query-editor/data-explorer#partner-data) Partner Data Partner datasets are off-chain and specialized data provided by third-party data partners. These include datasets from providers such as Farcaster, Hyperliquid, Reservoir, Snapshot, and others. For the full list, see the [Data Catalog](https://docs.dune.com/data-catalog/overview#community-data) . ### [​](https://docs.dune.com/web-app/query-editor/data-explorer#decoded-projects) Decoded Projects Decoded tables contain smart contract activity that has been translated from raw bytecode into human-readable tables using contract ABIs. You can filter decoded projects by chain, event name, or function name. Tables are only shown for functions and events that have been called on-chain. If you do not see a table you expect, confirm the function or event has been triggered. You can check using [this query](https://dune.com/queries/5261232) by entering your chain and contract address. ### [​](https://docs.dune.com/web-app/query-editor/data-explorer#raw-blockchain-data) Raw Blockchain Data Raw tables contain transaction-level data as ingested directly from each blockchain — including blocks, transactions, logs, and traces. Dune supports hundreds of blockchains, spanning EVM-compatible chains, Solana, Bitcoin, TRON, and many more. For the full list, see the [Data Catalog](https://docs.dune.com/data-catalog/overview) . [​](https://docs.dune.com/web-app/query-editor/data-explorer#inspecting-tables-and-columns) Inspecting Tables and Columns ---------------------------------------------------------------------------------------------------------------------------- Once you locate a table in the Data Explorer, you can interact with it in several ways: * **View table overview** — Click on a table name to expand it and see its columns, data types, and a short description. * **Click a column** — Clicking on a specific column name will automatically insert it into your query in the central editor, saving you from typing it manually. * **Three-dot menu** — Click the three-dot icon (⋯) next to any table name to access additional options: * **Preview table** — View a sample of the table’s data directly in the editor. * **Add to favorites** — Star the table so it appears under My Data for easy access later. * **Find queries** — Discover existing queries on Dune that reference this table — useful for seeing practical examples. * **Copy as markdown** — Copy the full table schema as markdown for use in documentation or prompts. * **Open table page** — Navigate to the table’s dedicated page, where you can find more in-depth information including the full schema, column descriptions, and a data preview. Was this page helpful? YesNo [Writing Queries](https://docs.dune.com/web-app/query-editor/query-window) [Using Parameters](https://docs.dune.com/web-app/query-editor/parameters) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Writing Queries - Dune Docs [Skip to main content](https://docs.dune.com/web-app/query-editor/query-window#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Write and Run Queries Writing Queries [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Toolbar](https://docs.dune.com/web-app/query-editor/query-window#toolbar) * [Editor settings](https://docs.dune.com/web-app/query-editor/query-window#editor-settings) * [Writing and executing queries](https://docs.dune.com/web-app/query-editor/query-window#writing-and-executing-queries) * [Autocomplete](https://docs.dune.com/web-app/query-editor/query-window#autocomplete) * [Running queries](https://docs.dune.com/web-app/query-editor/query-window#running-queries) * [Run selection](https://docs.dune.com/web-app/query-editor/query-window#run-selection) * [Error handling](https://docs.dune.com/web-app/query-editor/query-window#error-handling) * [Keyboard shortcuts](https://docs.dune.com/web-app/query-editor/query-window#keyboard-shortcuts) * [Query results](https://docs.dune.com/web-app/query-editor/query-window#query-results) * [Column formatting](https://docs.dune.com/web-app/query-editor/query-window#column-formatting) The query editor is where your team writes, tests, and iterates on SQL against Dune’s blockchain datasets. Whether you’re building production dashboards, validating on-chain metrics, or exploring data for the first time, the editor provides the tools to move from question to answer without leaving the browser. ![Query editor](https://mintcdn.com/dune/eH6jgnWLnu4e9Ot_/web-app/query-editor/images/query-window/query-window.png?w=2500&fit=max&auto=format&n=eH6jgnWLnu4e9Ot_&q=85&s=22304bba558b755d3a5629de63d99874) The query editor uses **DuneSQL**, a Trino-based engine optimized for blockchain data. For syntax details, supported functions, and data types, see the [SQL Query Engine](https://docs.dune.com/query-engine/overview) documentation. [​](https://docs.dune.com/web-app/query-editor/query-window#toolbar) Toolbar ------------------------------------------------------------------------------- The toolbar sits above the code editor and provides quick access to common actions. | Tool | Description | | --- | --- | | **Edit SQL with prompt** | Type a natural language instruction to generate or modify SQL using AI. See [Dune AI](https://docs.dune.com/web-app/dune-ai)
for details. | | **Add parameter** `{}` | Insert a dynamic parameter into your query. Parameters let dashboard viewers filter data without editing SQL. See [Using Parameters](https://docs.dune.com/web-app/query-editor/parameters)
. | | **Format query** | Auto-format your SQL with standard indentation and spacing for readability. | | **Explain query** | Generate an AI-powered plain-English summary of what your query does. Useful for onboarding teammates or documenting query logic. | | **Hide/Show SQL** | Collapse the code editor to maximize screen space for results and visualizations. Click again to restore it. | [​](https://docs.dune.com/web-app/query-editor/query-window#editor-settings) Editor settings ----------------------------------------------------------------------------------------------- Click the **Settings** (gear icon) in the top-right corner of the editor panel to customize your coding environment. | Setting | Description | | --- | --- | | **Fullscreen mode** | Expand the editor to fill the entire screen. | | **Syntax style** | Change the color theme and syntax highlighting of your SQL code. | | **Tab size** | Set the indentation width (e.g., 2 or 4 spaces). | | **Diff view** | Choose how code changes are displayed (e.g., split view). | | **Enable autocomplete** | Toggle intelligent code completion on or off. | [​](https://docs.dune.com/web-app/query-editor/query-window#writing-and-executing-queries) Writing and executing queries --------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/web-app/query-editor/query-window#autocomplete) Autocomplete The editor provides context-aware autocomplete for DuneSQL keywords, table names, and column aliases already referenced in your query. To manually trigger the autocomplete menu at any time, press `Ctrl/Cmd + Space`. ### [​](https://docs.dune.com/web-app/query-editor/query-window#running-queries) Running queries Click the **Run** button (or press `Ctrl + Enter`) to execute your query. Results appear in the results panel below the editor. The **Try API** button next to Run generates an API endpoint for your query results, making it easy to integrate Dune data into external applications. See the [API documentation](https://docs.dune.com/api-reference/overview/introduction) for more. ### [​](https://docs.dune.com/web-app/query-editor/query-window#run-selection) Run selection You can execute a specific portion of a query instead of the full statement. This is useful for testing subqueries, debugging intermediate results, or validating individual CTEs. Highlight the portion of the query you want to run. The **Run** button updates to **Run selection**, and only the highlighted SQL is executed. ![Run selection](https://mintcdn.com/dune/unSjD8CjtatfrAgj/web-app/query-editor/images/query-window/run-query-selection.png?w=2500&fit=max&auto=format&n=unSjD8CjtatfrAgj&q=85&s=123f7752fecb63b4cc6160df537e1ab4) ### [​](https://docs.dune.com/web-app/query-editor/query-window#error-handling) Error handling When a query fails, a red error banner appears at the top of the editor with details about the failure. Error messages include: * **Error type** — e.g., `COLUMN_NOT_FOUND`, `SYNTAX_ERROR` * **Line and character position** — the exact location of the issue in your SQL * **Description** — a human-readable explanation of the problem This inline feedback allows you to identify and fix issues without leaving the editor. ### [​](https://docs.dune.com/web-app/query-editor/query-window#keyboard-shortcuts) Keyboard shortcuts | Shortcut | Action | | --- | --- | | Ctrl + Enter | Execute the query | | Ctrl + # or / | Comment out selected code | | Ctrl + Space | Open autocomplete menu | | Ctrl + Z | Undo last change | | Ctrl + Y | Redo last change | | Ctrl + F | Find text | | Ctrl + H | Find and replace text | _Shortcuts are based on US/UK keyboard layouts and may vary depending on your device’s language settings._ [​](https://docs.dune.com/web-app/query-editor/query-window#query-results) Query results ------------------------------------------------------------------------------------------- Query results appear in a table below the editor after execution. * **Sort** by clicking any column header. Click once for ascending order, click again for descending. * **Paginate** through results using the page controls. Each page displays 25 rows. * **Search** across all result rows using the search bar below the results table. ![Query results](https://mintcdn.com/dune/YGGGbX8CdbsnZ9Ri/web-app/query-editor/images/query-window/query-results-table.png?w=2500&fit=max&auto=format&n=YGGGbX8CdbsnZ9Ri&q=85&s=08c087b2010b3e8f180bd03ccd707f1d) ### [​](https://docs.dune.com/web-app/query-editor/query-window#column-formatting) Column formatting Each column in the results table can be individually configured without modifying your SQL: | Option | Description | | --- | --- | | **Title** | Rename the display header (e.g., change `transfer_volume_usd` to “Volume”). | | **Align** | Set column alignment to left or right. | | **Format** | Apply number or currency formatting (e.g., `0.00`, `$0.0a`). | | **Hide column** | Toggle column visibility to focus on relevant data. | | **Colored negative values** | Automatically highlight negative numbers in red for easier trend analysis. | For full details on table formatting options, including progress bars and advanced number formats, see the [Formatting Tables](https://docs.dune.com/web-app/visualizations/tables) documentation. Was this page helpful? YesNo [Create your first query](https://docs.dune.com/learning/how-tos/create-your-first-query) [Find Data Tables](https://docs.dune.com/web-app/query-editor/data-explorer) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Using Parameters - Dune Docs [Skip to main content](https://docs.dune.com/web-app/query-editor/parameters#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Write and Run Queries Using Parameters [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Parameters in Query Views](https://docs.dune.com/web-app/query-editor/parameters#parameters-in-query-views) * [Freeform parameters](https://docs.dune.com/web-app/query-editor/parameters#freeform-parameters) * [List parameters](https://docs.dune.com/web-app/query-editor/parameters#list-parameters) * [Manual list](https://docs.dune.com/web-app/query-editor/parameters#manual-list) * [List from query results](https://docs.dune.com/web-app/query-editor/parameters#list-from-query-results) * [Parameters in query descriptions](https://docs.dune.com/web-app/query-editor/parameters#parameters-in-query-descriptions) * [Parameters in dashboards](https://docs.dune.com/web-app/query-editor/parameters#parameters-in-dashboards) Parameters allow you to implement variables in certain parts of your Query. This is useful if you want to create a Query that you can reuse with different parameters. Parameters in Dune are versatile and can be used in many different ways. You can use them to: * filter on a specific token * filter on a specific token pair * filter on a specific address * filter on a specific date range * filter on a specific category * etc. Parameters can be a **single value** or a **list of values** and you can choose **one** or **multiple** values from a pre-defined list of values. This list can be manually defined or populated from a different query. **To use parameters:** 1. choose the spot in your Query where you want to implement a parameter 2. click on the add parameter button or type `{{example_parameter_name}}` 3. open the parameter options 4. configure your parameter’s name, type, and default value Parameters can be text, numbers, a date, a manual list of values or a list of values from a different query. ### [​](https://docs.dune.com/web-app/query-editor/parameters#parameters-in-query-views) Parameters in Query Views Parameters can also be used in [Query Views](https://docs.dune.com/query-engine/query-a-query) , allowing you to pass parameters several levels deep into nested queries. This powerful feature enables you to create complex, reusable query architectures where parameters flow through multiple layers of queries. For example, you can create a base query with parameters, then use that query as a view in another query while passing different parameter values. This allows for modular query design and enables sophisticated dashboard architectures. See the [Query Views documentation](https://docs.dune.com/query-engine/query-a-query) for detailed examples and syntax. Copy Ask AI -- Base query (query_123) with parameters SELECT project, sum(amount_usd) as volume FROM dex.trades WHERE blockchain = '{{blockchain_param}}' AND block_time >= cast('{{start_date}}' as timestamp) GROUP BY project Copy Ask AI -- Query that uses the base query as a view with parameters SELECT project, volume, volume * 0.003 as estimated_fees FROM "query_123(blockchain_param='ethereum', start_date='2024-01-01')" WHERE volume > 1000000 ORDER BY volume DESC ### [​](https://docs.dune.com/web-app/query-editor/parameters#freeform-parameters) Freeform parameters Freeform parameters are useful if you want your users to be able to input any text, number or date value. An example of this would be a parameter that allows users to input an address, a token, or a date. The system will automatically detect the type of the value and insert it into the query as the correct type. You can also manually adjust the type within the query by using the `cast` function. ![freeform parameter](https://mintcdn.com/dune/aF4zRBqDzf2PxRoY/web-app/query-editor/images/parameters/freeform-parameter.jpeg?w=2500&fit=max&auto=format&n=aF4zRBqDzf2PxRoY&q=85&s=625c850df7e40735c4162301b352a680) For example: Copy Ask AI -- freeform varbinary parameter Select * from ethereum.transactions where "from" = {{address_parameter}} Copy Ask AI -- freeform number parameter Select * from dex.trades where amount_usd > {{usd_amount_parameter}} Copy Ask AI -- freeform date parameter Select * from dex.trades where evt_block_time between cast('{{start_date_parameter}}' as timestamp) and cast('{{end_date_parameter}}' as timestamp) ### [​](https://docs.dune.com/web-app/query-editor/parameters#list-parameters) List parameters List parameters are useful if you want your users to be able to choose **one** or **multiple values** from a pre-defined list of values. This list can be manually defined or populated from a different query. Examples of this include parameters that allows users to choose from a list of tokens or a list of token pairs. ![list parameter](https://mintcdn.com/dune/aF4zRBqDzf2PxRoY/web-app/query-editor/images/parameters/list-parameter.jpeg?w=2500&fit=max&auto=format&n=aF4zRBqDzf2PxRoY&q=85&s=4663aecd4b44ea220f10acc47e1c8838) Copy Ask AI --- list parameter allowing single value Select * from dex.trades where token_pair = ({{token_pair_parameter}}) or Copy Ask AI --- list parameter allowing with multiple values Select * from dex.trades where token in (Select token from unnest(split('{{token_list_parameter}}',',')) as c(token)) If you want to allow multiple values, you need to adjust your query for this. Use the `unnest` and `split` functions to turn the columns into useable values. By default, the values will be inserted into the query as individual columns. **Example**: A list of 3 selected values in a parameter called `example_parameter_name` will be inserted into the query like this: Copy Ask AI Select {{example_parameter_name}} /* returns | column1 | column2 | column3 | | --------- | --------- | --------- | | WETH-USDC | WBTC-USDC | DAI-USDC | */ Most of the time, you’ll want to use the values in a `where in` clause. To do this, you need to use the `unnest` and `split` functions to turn the columns into useable values. For example: Copy Ask AI Select * from dex.trades where token_pair in (Select pair from unnest(split('{{example_parameter_name}}',',')) as c(pair)) #### [​](https://docs.dune.com/web-app/query-editor/parameters#manual-list) Manual list When you manually define a list of values, the list can be text values, numbers, dates or even varbinary values. The system attempts to detect the type of the list values, but sometimes you might have to manually adjust the type within the query by using the `cast` function. A very common example of using a manual list is setting the “time granularity” of a dashboard/query. Copy Ask AI Select date_trunc('{{time_granularity_parameter}}', evt_block_time) as time, sum(amount_usd) as amount_usd from dex.trades group by 1 /* parameter options: - default value: day - list values: day, week, month */ #### [​](https://docs.dune.com/web-app/query-editor/parameters#list-from-query-results) List from query results You can use the results of a query as the list of values for a parameter. Doing this allows you to build dynamic dashboards that allow users to choose from a list of values that is populated by a different query. You can choose any query by its query\_id and any column by its name. The column data type will be transferred to the parameter. ![parameter from query results](https://mintcdn.com/dune/aF4zRBqDzf2PxRoY/web-app/query-editor/images/parameters/parameter-query-result.jpeg?w=2500&fit=max&auto=format&n=aF4zRBqDzf2PxRoY&q=85&s=0210d47c92115fcfee5e8141f0f0210b) **Query results**The query that you use to populate the list of values does not update automatically. You need to trigger a refresh of the query results to update the list of values. This can happen by either manually refreshing the query results or by setting up a [query schedule](https://docs.dune.com/web-app/query-editor/web-app/query-editor/query-scheduler) . This feature can be used in all kinds of ways, but here are a few examples: * to choose from a list of tokens * to choose from a list of token pairs * to choose from a list of addresses or labels * to single out specific products or categories All of these examples could be solved with a manual list, but using a query to populate the list of values allows you to build dynamic dashboards that update automatically. It also can simply make it easier to manage a list of values that is shared between multiple queries. **Example 1:** You can use a distinct query on dex.trades to populate a list of all projects currently in dex.trades. This list can then be used in multiple queries. Copy Ask AI Select distinct project from dex.trades [link to dashboard](https://dune.com/dune/query-result-parameter-showcase) **Example 2:** Filter on all available perpeptual futures available on synthetix. The master query for this is query\_3256054. We can use this query to populate a list of all available perps: Copy Ask AI --query 3256054 constructs the daily open interest for all synthetix perps Select distinct perp_name from query_3256054 order by perp_name We can then use this list of perps in query\_3256054 to make filtering on a specific perp possible: Copy Ask AI ... and perp_name in (Select perp_name from unnest(split('{{perp_name}}',',')) as b(perp_name)) [link to query](https://dune.com/queries/3256054/) ### [​](https://docs.dune.com/web-app/query-editor/parameters#parameters-in-query-descriptions) Parameters in query descriptions You can use parameters in the description of a query. This feature is useful to effortlessly report on the current value of a parameter. For example, you can use this to report on the current value of a parameter that is used in a dashboard. You must first [create the parameter in your query](https://docs.dune.com/web-app/query-editor/parameters#using-parameters) before you can reference it in the query description. To use a parameter in a query description: 1. open your query settings 2. add the parameter to the query description by using the `{{example_parameter_name}}` syntax 3. save your query settings 4. your query description will now show the current value of the parameter ### [​](https://docs.dune.com/web-app/query-editor/parameters#parameters-in-dashboards) Parameters in dashboards If you want to use the same parameter between different queries on a dashboard, make sure to use exactly the same settings for the parameter in each query. The parameter will then be shared between the queries and only turn up once in the dashboard’s parameter menu. Exactly the same settings means: * the parameter name is the same * the parameter type is the same * the parameter default value is the same * the parameter list of values is the same * the query id and column name for a list of values from a query is the same Was this page helpful? YesNo [Find Data Tables](https://docs.dune.com/web-app/query-editor/data-explorer) [Query Templates](https://docs.dune.com/learning/how-tos/query-templates) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Set Up Alerts - Dune Docs [Skip to main content](https://docs.dune.com/web-app/alerts#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Automate and Monitor Set Up Alerts [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Setup](https://docs.dune.com/web-app/alerts#setup) * [Accessing Alerts](https://docs.dune.com/web-app/alerts#accessing-alerts) * [Alert Timing](https://docs.dune.com/web-app/alerts#alert-timing) * [Alert Content](https://docs.dune.com/web-app/alerts#alert-content) * [Email Alerts](https://docs.dune.com/web-app/alerts#email-alerts) * [Webhook Alerts](https://docs.dune.com/web-app/alerts#webhook-alerts) * [Integration with Third-Party Apps](https://docs.dune.com/web-app/alerts#integration-with-third-party-apps) * [Slack Support via Webhook](https://docs.dune.com/web-app/alerts#slack-support-via-webhook) * [Zapier Integration](https://docs.dune.com/web-app/alerts#zapier-integration) * [Known Issues and Solutions](https://docs.dune.com/web-app/alerts#known-issues-and-solutions) * [Feedback](https://docs.dune.com/web-app/alerts#feedback) * [Acknowledgement](https://docs.dune.com/web-app/alerts#acknowledgement) Alerts allows users to set notifications for a scheduled query. These notifications are triggered each time the query runs. Supported delivery methods include: * **Email:** Multiple email addresses can be added. * **Webhooks:** Alerts can be sent to a specified callback URL, including Slack. [​](https://docs.dune.com/web-app/alerts#setup) Setup -------------------------------------------------------- ### [​](https://docs.dune.com/web-app/alerts#accessing-alerts) Accessing Alerts To use Alerts, follow these steps: 1. Open a saved query that you own. 2. Click the “Schedule” button. 3. Configure the query schedule. 4. Activate the Alerts option. 5. Configure the alert delivery method. 6. Save the schedule. 7. Every time the query runs, the alert will be triggered. ### [​](https://docs.dune.com/web-app/alerts#alert-timing) Alert Timing Alerts are triggered after query execution. Delays may occur due to factors like query complexity or system queues. Note that retry mechanisms for failed deliveries are not yet implemented. Alerts are not recommended for time-sensitive or critical applications at this stage. [​](https://docs.dune.com/web-app/alerts#alert-content) Alert Content ------------------------------------------------------------------------ ### [​](https://docs.dune.com/web-app/alerts#email-alerts) Email Alerts Email alerts include screenshots of the visualizations you have defined. If you have defined no visualizations, we include a screenshot of the query results by default. Here’s an example: ![Default email alert](https://mintcdn.com/dune/Hc5ctOcgoEcpSDK7/web-app/images/alerts/email_table.png?w=2500&fit=max&auto=format&n=Hc5ctOcgoEcpSDK7&q=85&s=c50cf3041c4628cae24785d1e8bc087e) If you have defined a visualization, we will include it instead of the table, like this: ![Email Alert with visualization](https://mintcdn.com/dune/Hc5ctOcgoEcpSDK7/web-app/images/alerts/email_viz.png?w=2500&fit=max&auto=format&n=Hc5ctOcgoEcpSDK7&q=85&s=3c5871ea168a53d98eed198247c08824) If your query contains multiple visualizations, or table visualizations (outside the default “Query results” table), they will all be included, such as here: ![Email Alert with multiple visualizations](https://mintcdn.com/dune/Hc5ctOcgoEcpSDK7/web-app/images/alerts/email_complex.png?w=2500&fit=max&auto=format&n=Hc5ctOcgoEcpSDK7&q=85&s=9a78f2da545525c3c2d651d21e8acf5c) ### [​](https://docs.dune.com/web-app/alerts#webhook-alerts) Webhook Alerts Webhook alerts adhere to the following schema: Copy Ask AI { message: string, query_result: { execution_id: string; query_id: number; state: string; submitted_at: string; expires_at: string; execution_started_at: string; execution_ended_at: string; result: { data_uri: string; metadata: { column_names: string[]; result_set_bytes: number; total_row_count: number; datapoint_count: number; pending_time_millis: number; execution_time_millis: number; }; }; }, visualizations: [\ {\ title: string;\ image_url: string;\ }\ ] } Here is an example corresponding to the last email example shared earlier: Copy Ask AI { "message": "Query ETH SMA alert was submitted for execution at Wed, 13 Dec 2023 13:42:40 GMT by your query schedule and it was successfully executed with a non-empty result.\nYou can check its latest result here: https://dune.com/queries/3137182?utm_source=webhook&utm_campaign=alerts", "query_result": { "execution_id": "01HHHPMKG6NBY0B04A36TS3AQH", "query_id": 3137182, "state": "QUERY_STATE_COMPLETED", "submitted_at": "2023-12-13T13:42:40Z", "expires_at": "2024-03-12T13:42:48Z", "execution_started_at": "2023-12-13T13:42:40Z", "execution_ended_at": "2023-12-13T13:42:48Z", "result": { "data_uri": "https://api.dune.com/api-referencev1/execution/01HHHPMKG6NBY0B04A36TS3AQH/results", "metadata": { "column_names": [\ "day",\ "avg_price",\ "sma_20",\ "sma_50",\ "sma_100",\ "sma_200"\ ], "result_set_bytes": 10710, "total_row_count": 91, "datapoint_count": 546, "pending_time_millis": 13, "execution_time_millis": 8038 } } }, "visualizations": [\ {\ "title": "SMA",\ "image_url": "https://prod-dune-media.s3.eu-west-1.amazonaws.com/screenshots/3137182/01HHHPMKG6NBY0B04A36TS3AQH/5232261.png"\ },\ {\ "title": "Counter",\ "image_url": "https://prod-dune-media.s3.eu-west-1.amazonaws.com/screenshots/3137182/01HHHPMKG6NBY0B04A36TS3AQH/5451006.png"\ },\ {\ "title": "Last days of data",\ "image_url": "https://prod-dune-media.s3.eu-west-1.amazonaws.com/screenshots/3137182/01HHHPMKG6NBY0B04A36TS3AQH/5451008.png"\ }\ ] } Validation of the webhook format can be done at [Webhook.site](https://webhook.site/) . You can easily test it out by triggering manual deliveries by clicking the Manual trigger link below the URL field. [​](https://docs.dune.com/web-app/alerts#integration-with-third-party-apps) Integration with Third-Party Apps ---------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/web-app/alerts#slack-support-via-webhook) Slack Support via Webhook Following these simple steps you have get query results posted directly in Slack at your desired frequency. 1. Click Create `Create New App` on your [Slack app page](https://api.slack.com/apps) . 2. Choose `From scratch` and give your alert a name, pick the workspace and click `Create App` 3. Then click “Incoming Webhooks” and activate with the top right toggle. 4. Click `Add New Webhook to Workspace` at the bottom of the page. 5. Select the Slack channel you want the alert to go to. 6. Copy the Slack Webhook URL and paste it into the Dune Alert configuration. 7. The help text below the field should indicate that a Slack URL has been detected: ![Slack Setup](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/alerts/slack_setup.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=f465286ffd7f995b287cba634ca339bc) Once saved, you will start receiving messages on Slack. Here is an example of how it looks: ![Slack message](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/alerts/slack_hook.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=1754904ac91acb2a21468394ddbaf826) ### [​](https://docs.dune.com/web-app/alerts#zapier-integration) Zapier Integration [Zapier](https://zapier.com/) is a third party solution that supports building integrations between different software solutions without writing any code. With it you can build advanced workflows that relay data between Dune and your favorite work tools. We currently offer an experimental [Zapier app](https://zapier.com/developer/public-invite/194504/2174c6b998748b657f28dab4097f3e80/) to support connecting Dune with thousands of other tools via Zapier. To set it up, follow these steps: 1. Accept the invite to use our private Zapier app via [this link](https://zapier.com/developer/public-invite/194504/2174c6b998748b657f28dab4097f3e80/) . 2. Create a new zap, with a [Webhook trigger](https://zapier.com/apps/webhook/integrations) . 3. Copy the webhook URL provided by Zapier’s Webhook trigger, and paste it in the Dune webhook URL field. 4. Now, on Zapier you can click Test to test that the webhook works. 5. Trigger a manual hook request from the Alerts configuration form to test it out, and it should show up on Zapier. 1. If you want to relay screenshots to other tools, the screenshots will be in the payload. 2. If you want to relay query results, the Dune Zapier App includes an action to fetch a query’s latest results by query id, which will allow you to easily fetch query results. This is where you can trigger manual hook deliveries: ![Manual hook](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/alerts/manual_hook.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=d1584a3f7d6bc682eed10f8684ef6079) Your setup on Zapier should look something like this: ![Zapier zap](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/web-app/images/alerts/zapier_example.png?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=719e3461e5ecf5e34eb3957c8aa6eb72) [​](https://docs.dune.com/web-app/alerts#known-issues-and-solutions) Known Issues and Solutions -------------------------------------------------------------------------------------------------- 1. **Manual Alert Triggering:** Currently, manual triggering is only available for webhooks. 1. We’re planning to add it to Email and Slack. In the meantime, you can set your query on a 15-minute schedule for quicker testing. 2. **No results in webhook:** Instead of including query results in the callback, the webhook payload includes a URL to fetch the query’s results in case you need to action on them. 1. We do not include datapoints in the hook callback in order to prevent unwanted credit spend on data exports. 2. We’re open to feedback on changing this behavior. If you have thoughts, let us know. [​](https://docs.dune.com/web-app/alerts#feedback) Feedback -------------------------------------------------------------- Feedback can be provided through the Alerts Beta Telegram channel. [Join the channel](https://t.me/+bt5J1QlJ3_FhMDU0) [​](https://docs.dune.com/web-app/alerts#acknowledgement) Acknowledgement ---------------------------------------------------------------------------- Thank you to everyone that participated in our beta testing program. Your feedback has been essential for improving this feature. * * * Was this page helpful? YesNo [Schedule Queries](https://docs.dune.com/web-app/query-editor/query-scheduler) [Query Lineage](https://docs.dune.com/web-app/query-editor/query-lineage) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Version History - Dune Docs [Skip to main content](https://docs.dune.com/web-app/query-editor/version-history#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Automate and Monitor Version History [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Saving and Managing Versions](https://docs.dune.com/web-app/query-editor/version-history#saving-and-managing-versions) * [Comparing and Reverting Versions](https://docs.dune.com/web-app/query-editor/version-history#comparing-and-reverting-versions) All queries come with version history, where you can compare and revert to previous query versions seamlessly. **You can access version history from the query editor toolbar.** **History Length**Everyone gets 30 days by default, you can upgrade your plan for longer history access. ### [​](https://docs.dune.com/web-app/query-editor/version-history#saving-and-managing-versions) Saving and Managing Versions A new version is created each time you save or run your query. The first time you save a query — whether it is forked or freshly created — an initial version is committed to the history. If you’ve forked a query, the version history starts fresh; you won’t have access to the original query’s edit history. Each subsequent run saves a new version automatically. If you leave the page without saving or running, any unsaved changes will be lost. You can also edit the metadata of any saved version — such as adding a title or description — to make it easier to identify later. ### [​](https://docs.dune.com/web-app/query-editor/version-history#comparing-and-reverting-versions) Comparing and Reverting Versions You can compare diffs between any two versions to see exactly what changed, and revert to a previous version if needed. **The reverted query is saved as a new version in the history**, so you never lose your current work. Was this page helpful? YesNo [Query Lineage](https://docs.dune.com/web-app/query-editor/query-lineage) [Share and Embed](https://docs.dune.com/web-app/share) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Tables - Dune Docs [Skip to main content](https://docs.dune.com/web-app/visualizations/tables#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Visualize and Present Results Tables [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Configuring your Table](https://docs.dune.com/web-app/visualizations/tables#configuring-your-table) * [Table options](https://docs.dune.com/web-app/visualizations/tables#table-options) * [”Column \[x\]:” options](https://docs.dune.com/web-app/visualizations/tables#%E2%80%9Dcolumn-x%E2%80%9D-options) * [Numerical Column options](https://docs.dune.com/web-app/visualizations/tables#numerical-column-options) **Tables are the default Visualization whenever you create and run a Query.** ![query results table example](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/other-visualizations/query-results-table-example.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=cd1179257f6fb0bf4fd34729f891086a) You can also make more Tables to display your data differently using the New visualization button and drop down menu: ![new table visualization](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/other-visualizations/new-table-visualization.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=4d673c83e3498b88fd98f13813be3b60) ### [​](https://docs.dune.com/web-app/visualizations/tables#configuring-your-table) Configuring your Table ![table configuration options](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/other-visualizations/table-configuration-options.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=701231ded04fa553aad34f23d8c52c22) #### [​](https://docs.dune.com/web-app/visualizations/tables#table-options) Table options **Title** The Title appears at the top of your Table. Leaving default value (`Table`) or making this blank makes your Table title the same as your Query’s title/name. Adding any other value to this field will add that value first, followed by your Query Name: ![table title example](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/other-visualizations/table-title-example.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=129012bdbac1bfef89a78c44366842f2) Note: the default value for “Query Results” is treated like an added value. #### [​](https://docs.dune.com/web-app/visualizations/tables#%E2%80%9Dcolumn-x%E2%80%9D-options) ”Column `[x]`:” options You can configure the following options for each column in your Table * Title * Align * Format * Hide Column The Title appears at the top of your Table.Leaving this blank makes your column title the same as its Dune database name. This changes the text alignment for the column data and title. Allows you to adjust the numerical format of your data following the [X/Y-axis Tick and Label formats here](https://docs.dune.com/web-app/visualizations/charts-graphs) . Hides this column from your table. #### [​](https://docs.dune.com/web-app/visualizations/tables#numerical-column-options) Numerical Column options Columns that return numerical data have these additional options: * Type * Colored Values * `Normal` simply displays the column’s numerical data. * `Progress bar` shows the column’s numerical data with a progress bar visual that is “full” for the column’s highest value and “nearly empty” for the column’s lowest value, with the rest of the data ranging in between: ![progress bar example](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/other-visualizations/progress-bar-example.gif?s=481294c5eba06cb956adfd072b1c26fe) ![colored values example](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/other-visualizations/colored-values-example.jpeg?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=b68139bd0209c36d18ce6a8ac6600401) Was this page helpful? YesNo [Counters](https://docs.dune.com/web-app/visualizations/counters) [Build Dashboards](https://docs.dune.com/web-app/dashboards) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Query Lineage - Dune Docs [Skip to main content](https://docs.dune.com/web-app/query-editor/query-lineage#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Automate and Monitor Query Lineage [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Overview](https://docs.dune.com/web-app/query-editor/query-lineage#overview) * [Key Features](https://docs.dune.com/web-app/query-editor/query-lineage#key-features) * [How Query Lineage Works](https://docs.dune.com/web-app/query-editor/query-lineage#how-query-lineage-works) * [Accessing Query Lineage](https://docs.dune.com/web-app/query-editor/query-lineage#accessing-query-lineage) ### [​](https://docs.dune.com/web-app/query-editor/query-lineage#overview) Overview The Query Lineage section provides an organized, directed graph view of the tables, views, and [nested queries](https://docs.dune.com/query-engine/query-a-query) involved in your query. This graph, displayed below the query editor, shows all tables, views, and other queries your query directly references. When [a query references another query](https://docs.dune.com/query-engine/query-a-query) , all levels of dependencies within those queries are shown. For views, lineage stops at the first-level reference, offering a streamlined view without tracing further nested dependencies. ![query-lineage](https://mintcdn.com/dune/eH6jgnWLnu4e9Ot_/web-app/query-editor/images/query-lineage/query-lineage.png?w=2500&fit=max&auto=format&n=eH6jgnWLnu4e9Ot_&q=85&s=b1eaff326c1092249d14264ccfe7df4f) This graph allows for an intuitive exploration of data relationships, as you can click on any referenced queries, tables, or views to jump directly to their definitions. ### [​](https://docs.dune.com/web-app/query-editor/query-lineage#key-features) Key Features * **Interactive Graph Navigation:** Click through queries, tables, and views directly from the lineage graph to explore definitions. * **Comprehensive Query Lineage:** Trace all levels of referenced queries to see the full path of data dependencies. * **Simplified View Lineage:** Limit view lineage to the first level, reducing complexity in multi-layered dependencies. ### [​](https://docs.dune.com/web-app/query-editor/query-lineage#how-query-lineage-works) How Query Lineage Works * **Full Query Lineage:** For each query, Query Lineage displays all tables, views, and queries it references. If a referenced query itself references additional queries or tables, those are also shown, providing the complete chain of dependencies. * **Limited View Lineage:** For views, Query Lineage includes only the first-level reference. If a view references another view or table, further dependencies within those views are not displayed, offering a concise overview. ### [​](https://docs.dune.com/web-app/query-editor/query-lineage#accessing-query-lineage) Accessing Query Lineage To view a query’s lineage: 1. Open a query in Dune’s Web App. 2. Navigate to the **Query Lineage** section below the query editor and next to the visualizations. 3. A directed graph of the query’s lineage will appear, with clickable links for each referenced query, table, or view. To view the lineage graph in full-screen mode, click the expand icon in the top-right corner of the graph. Different kinds of objects in the graph are displayed with distinct colors to help you quickly identify them: Dune-defined tables and views are shown in orange, Referenced queries appear in blue and Materialized views are displayed in green. Was this page helpful? YesNo [Set Up Alerts](https://docs.dune.com/web-app/alerts) [Version History](https://docs.dune.com/web-app/query-editor/version-history) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Counters - Dune Docs [Skip to main content](https://docs.dune.com/web-app/visualizations/counters#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Visualize and Present Results Counters [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Counters](https://docs.dune.com/web-app/visualizations/counters#counters) * [Configuring your Counter](https://docs.dune.com/web-app/visualizations/counters#configuring-your-counter) * [Counter options](https://docs.dune.com/web-app/visualizations/counters#counter-options) * [Formatting](https://docs.dune.com/web-app/visualizations/counters#formatting) [​](https://docs.dune.com/web-app/visualizations/counters#counters) Counters ------------------------------------------------------------------------------- Counters are a great way to provide your audience with immediate “on a glance” stats. !["on a glance" stats](https://mintcdn.com/dune/us8IQgUYZXYXIHgq/web-app/images/counters-display.png?w=2500&fit=max&auto=format&n=us8IQgUYZXYXIHgq&q=85&s=71d938ec6826124bcce9d09dc10954f6) ### [​](https://docs.dune.com/web-app/visualizations/counters#configuring-your-counter) Configuring your Counter ![Counter configuration](https://mintcdn.com/dune/us8IQgUYZXYXIHgq/web-app/images/counter-customization.png?w=2500&fit=max&auto=format&n=us8IQgUYZXYXIHgq&q=85&s=be8180f310bdf7bb2fb8a0cfda57774e) #### [​](https://docs.dune.com/web-app/visualizations/counters#counter-options) Counter options In this section you can define what kind of data the counter should display: Display Title * The Title will appear in all instances of this graph prominently at the top. * If left blank, the Query name will be the only thing that is left standing. Column Selection * In this field, you can define which column the counter should show. Row Selection * This field can be used to define which row of the underlying data table you want displayed, e.g., row 1. * Usually, this requires you to sort or limit your Query results in order for row 1 to show the wanted results. #### [​](https://docs.dune.com/web-app/visualizations/counters#formatting) Formatting This section is where you can adjust how your numerical data is displayed. Prefix Setting * This field allows you to define a prefix for your counter value. * e.g.: `$`, `€`, `Ξ`, `฿` Suffix Setting * This field allows you to define a suffix for your counter value. Label Setting * This field allows you to define a label for your counter value. * The label will appear beneath the counter value as text. Decimal Setting * In this field, you can choose how many decimals you want displayed for your counter. ![label](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/other-visualizations/counters-label-1.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=12e480cf7fc145cb6f133c12a63bf886) Was this page helpful? YesNo [Charts and Graphs](https://docs.dune.com/web-app/visualizations/charts-graphs) [Tables](https://docs.dune.com/web-app/visualizations/tables) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # AI Query Tools - Dune Docs [Skip to main content](https://docs.dune.com/web-app/dune-ai#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Write and Run Queries AI Query Tools [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Wand Create](https://docs.dune.com/web-app/dune-ai#wand-create) * [Wand Edit](https://docs.dune.com/web-app/dune-ai#wand-edit) * [Adding statistics to a query](https://docs.dune.com/web-app/dune-ai#adding-statistics-to-a-query) * [Adding a join to a query](https://docs.dune.com/web-app/dune-ai#adding-a-join-to-a-query) * [Reformat Output](https://docs.dune.com/web-app/dune-ai#reformat-output) * [Adding a CTE](https://docs.dune.com/web-app/dune-ai#adding-a-cte) * [Wand Debug](https://docs.dune.com/web-app/dune-ai#wand-debug) **Dune is launching a beta suite of tools for writing SQL queries with the help of large language models.** ### [​](https://docs.dune.com/web-app/dune-ai#wand-create) Wand Create The Wand Create feature allows you to automatically generate SQL queries from natural language questions. It utilizes a suite of Dune-specific few-shot examples and automatically fetches table schemas to include in the prompt. (You must explicitly include the relevant tables in your natural language question to include table schemas.) This feature simplifies the process of writing getting started writing a SQL query, especially for users who may not be familiar with the database structure. Your mileage may vary depending on the complexity of your question and how well the underlying tables are suited to answering it. We recommend using this feature as a starting point and then refining the query using the Wand Edit feature. You can find this feature in the query page below the query editor. ### [​](https://docs.dune.com/web-app/dune-ai#wand-edit) Wand Edit The Wand Edit feature allows you to edit an existing SQL query based on a natural language question. Similar to query generation, any additional tables required should be explicitly included in the natural language edit request to make use of schemas. This feature simplifies the process of refining and fine-tuning SQL queries generated by the system or existing queries in your application. You can find this feature in the query editor and click the wand logo in the top right corner to open the Wand bar. #### [​](https://docs.dune.com/web-app/dune-ai#adding-statistics-to-a-query) Adding statistics to a query Add the remaining components of a five point summary. Original query: Copy Ask AI SELECT date_trunc('day', block_time) AS time , (PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY gas_price))/1e9 AS median_gas , COUNT(*) AS daily_tx FROM ethereum.transactions GROUP BY time Edited query: Copy Ask AI SELECT date_trunc('day', block_time) AS time , MIN(gas_price)/1e9 AS min_gas , (PERCENTILE_CONT(0.25) WITHIN GROUP (ORDER BY gas_price))/1e9 AS lower_quartile_gas , (PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY gas_price))/1e9 AS median_gas , (PERCENTILE_CONT(0.75) WITHIN GROUP (ORDER BY gas_price))/1e9 AS upper_quartile_gas , MAX(gas_price)/1e9 AS max_gas , COUNT(*) AS daily_tx FROM ethereum.transactions GROUP BY time #### [​](https://docs.dune.com/web-app/dune-ai#adding-a-join-to-a-query) Adding a join to a query Join nft.wash\_trades to nft.trades to get the percentage of sellers who have been involved in wash trading. Original query: Copy Ask AI SELECT date_trunc('day', block_time) as day, COUNT(distinct seller) as sellers FROM nft.trades WHERE project = 'blur' GROUP BY 1 Edited query: Copy Ask AI SELECT date_trunc('day', t.block_time) as day, COUNT(distinct t.seller) as sellers, COUNT(distinct wt.seller) as wash_traders, (COUNT(distinct wt.seller) * 100.0 / COUNT(distinct t.seller)) as wash_traders_percentage FROM nft.trades t LEFT JOIN nft.wash_trades wt ON t.seller = wt.seller WHERE t.project = 'blur' GROUP BY 1 #### [​](https://docs.dune.com/web-app/dune-ai#reformat-output) Reformat Output Return monthly volume with each year from 2023 to 2019 as a separate column Original query: Copy Ask AI SELECT DATE_TRUNC('month', block_time), SUM(CAST(amount_usd AS DOUBLE)) AS usd_volume FROM dex.trades AS t WHERE block_time > CAST('2019-01-01' AS TIMESTAMP) GROUP BY 1 Edited query: Copy Ask AI SELECT DATE_TRUNC('month', block_time) AS month, SUM(CASE WHEN EXTRACT(YEAR FROM block_time) = 2019 THEN CAST(amount_usd AS DOUBLE) ELSE 0 END) AS usd_volume_2019, SUM(CASE WHEN EXTRACT(YEAR FROM block_time) = 2020 THEN CAST(amount_usd AS DOUBLE) ELSE 0 END) AS usd_volume_2020, SUM(CASE WHEN EXTRACT(YEAR FROM block_time) = 2021 THEN CAST(amount_usd AS DOUBLE) ELSE 0 END) AS usd_volume_2021, SUM(CASE WHEN EXTRACT(YEAR FROM block_time) = 2022 THEN CAST(amount_usd AS DOUBLE) ELSE 0 END) AS usd_volume_2022, SUM(CASE WHEN EXTRACT(YEAR FROM block_time) = 2023 THEN CAST(amount_usd AS DOUBLE) ELSE 0 END) AS usd_volume_2023 FROM dex.trades AS t WHERE block_time >= CAST('2019-01-01' AS TIMESTAMP) GROUP BY 1 #### [​](https://docs.dune.com/web-app/dune-ai#adding-a-cte) Adding a CTE Add a CTE to calculate the number of mints with nft.mints by day and then return the average number of mints per day and join it to the existing query Original query: Copy Ask AI select date_trunc('day', block_time) as dt ,count(hash) as num_transactions ,count(distinct "from") as users ,sum(gas_used) as gas_used ,avg(gas_used) as avg_gas_used ,avg(gas_price)/1e9 as avg_gas_price from ethereum.transactions where success and block_time >= cast('2022-01-01' as date) and date_trunc('day', block_time) < date_trunc('day', current_timestamp) group by 1 Updated query: Copy Ask AI WITH daily_mints AS ( SELECT date_trunc('day', block_time) as dt, count(*) as num_mints FROM nft.mints WHERE block_time >= cast('2022-01-01' as date) and date_trunc('day', block_time) < date_trunc('day', current_timestamp) GROUP BY 1 ) SELECT et.dt, et.num_transactions, et.users, et.gas_used, et.avg_gas_used, et.avg_gas_price, dm.num_mints, avg(dm.num_mints) over () as avg_daily_mints FROM ( SELECT date_trunc('day', block_time) as dt, count(hash) as num_transactions, count(distinct "from") as users, sum(gas_used) as gas_used, avg(gas_used) as avg_gas_used, avg(gas_price)/1e9 as avg_gas_price FROM ethereum.transactions WHERE success and block_time >= cast('2022-01-01' as date) and date_trunc('day', block_time) < date_trunc('day', current_timestamp) GROUP BY 1 ) et LEFT JOIN daily_mints dm ON et.dt = dm.dt [​](https://docs.dune.com/web-app/dune-ai#wand-debug) Wand Debug ------------------------------------------------------------------- The Wand Debug feature helps fix SQL queries that have syntax errors. When an executed query encounters a syntax error, the Fix Query button should appear in the results/visualization panel. Clicking this button collect your query and the error message and send it to the Wand Debug feature. The Wand Debug feature will then attempt to fix the query and return the fixed query to you. If the Wand Debug feature is unable to fix the query, it will return the updated query with message indicating it is not fully debugged. The query submitted for debugging will be saved in your query history, so you can also recover it. You can find this feature in the results/visualization panel if you’ve executed a query that failed on a syntax error. Was this page helpful? YesNo [Query Templates](https://docs.dune.com/learning/how-tos/query-templates) [Create your first visualization](https://docs.dune.com/learning/how-tos/create-your-first-visualization) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Submission Best Practices - Dune Docs [Skip to main content](https://docs.dune.com/web-app/decoding/best-practices#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Decode Smart Contracts Submission Best Practices [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Dune Contract Decoding Best Practices Guide](https://docs.dune.com/web-app/decoding/best-practices#dune-contract-decoding-best-practices-guide) * [Introduction](https://docs.dune.com/web-app/decoding/best-practices#introduction) * [Before You Begin](https://docs.dune.com/web-app/decoding/best-practices#before-you-begin) * [Quick Reference: Submission Checklist](https://docs.dune.com/web-app/decoding/best-practices#quick-reference-submission-checklist) * [Quick Decision Tree](https://docs.dune.com/web-app/decoding/best-practices#quick-decision-tree) * [Contract Decoding Scenarios](https://docs.dune.com/web-app/decoding/best-practices#contract-decoding-scenarios) * [Single Smart Contract on Single Chain](https://docs.dune.com/web-app/decoding/best-practices#single-smart-contract-on-single-chain) * [Single Contract on Multiple Chains](https://docs.dune.com/web-app/decoding/best-practices#single-contract-on-multiple-chains) * [Factory-Deployed Contracts (Single Chain)](https://docs.dune.com/web-app/decoding/best-practices#factory-deployed-contracts-single-chain) * [Factory-Deployed Contracts (Multiple Chains)](https://docs.dune.com/web-app/decoding/best-practices#factory-deployed-contracts-multiple-chains) * [Contracts with Identical Bytecode (Single Chain)](https://docs.dune.com/web-app/decoding/best-practices#contracts-with-identical-bytecode-single-chain) * [Contracts with Identical Bytecode (Across Multiple Chains)](https://docs.dune.com/web-app/decoding/best-practices#contracts-with-identical-bytecode-across-multiple-chains) * [Proxy Contract Patterns](https://docs.dune.com/web-app/decoding/best-practices#proxy-contract-patterns) * [Basic Proxy Rules](https://docs.dune.com/web-app/decoding/best-practices#basic-proxy-rules) * [Proxy Contract (Single Chain)](https://docs.dune.com/web-app/decoding/best-practices#proxy-contract-single-chain) * [Proxy Contract (Multiple Chains)](https://docs.dune.com/web-app/decoding/best-practices#proxy-contract-multiple-chains) * [Advanced Patterns](https://docs.dune.com/web-app/decoding/best-practices#advanced-patterns) * [Upgradeable Proxies](https://docs.dune.com/web-app/decoding/best-practices#upgradeable-proxies) * [Transparent Upgradeable Proxy](https://docs.dune.com/web-app/decoding/best-practices#transparent-upgradeable-proxy) * [Beacon Proxy](https://docs.dune.com/web-app/decoding/best-practices#beacon-proxy) * [Diamond Proxy (EIP-2535)](https://docs.dune.com/web-app/decoding/best-practices#diamond-proxy-eip-2535) * [Factory Variations](https://docs.dune.com/web-app/decoding/best-practices#factory-variations) * [Multi-Type Factories](https://docs.dune.com/web-app/decoding/best-practices#multi-type-factories) * [Minimal Proxy (EIP-1167)](https://docs.dune.com/web-app/decoding/best-practices#minimal-proxy-eip-1167) * [Version Management](https://docs.dune.com/web-app/decoding/best-practices#version-management) * [Multiple ABI Versions](https://docs.dune.com/web-app/decoding/best-practices#multiple-abi-versions) * [Gradual Cross-Chain Rollouts](https://docs.dune.com/web-app/decoding/best-practices#gradual-cross-chain-rollouts) * [Edge Cases & Special Situations](https://docs.dune.com/web-app/decoding/best-practices#edge-cases-%26-special-situations) * [Self-Destructed and Redeployed Contracts](https://docs.dune.com/web-app/decoding/best-practices#self-destructed-and-redeployed-contracts) * [Factory-Deployed Proxies](https://docs.dune.com/web-app/decoding/best-practices#factory-deployed-proxies) * [Common Mistakes to Avoid](https://docs.dune.com/web-app/decoding/best-practices#common-mistakes-to-avoid) * [Best Practices Summary](https://docs.dune.com/web-app/decoding/best-practices#best-practices-summary) * [Troubleshooting Tips](https://docs.dune.com/web-app/decoding/best-practices#troubleshooting-tips) * [Additional](https://docs.dune.com/web-app/decoding/best-practices#additional) * [Check Your Work](https://docs.dune.com/web-app/decoding/best-practices#check-your-work) * [Check Contract Submissions for Decoding](https://docs.dune.com/web-app/decoding/best-practices#check-contract-submissions-for-decoding) * [Check if Contract is decoded on the specific blockchain](https://docs.dune.com/web-app/decoding/best-practices#check-if-contract-is-decoded-on-the-specific-blockchain) * [Verify the table exists and has data](https://docs.dune.com/web-app/decoding/best-practices#verify-the-table-exists-and-has-data) * [Check all columns are properly decoded](https://docs.dune.com/web-app/decoding/best-practices#check-all-columns-are-properly-decoded) * [Expected Tables and Event Types](https://docs.dune.com/web-app/decoding/best-practices#expected-tables-and-event-types) * [When NOT to Decode](https://docs.dune.com/web-app/decoding/best-practices#when-not-to-decode) * [Remember](https://docs.dune.com/web-app/decoding/best-practices#remember) [​](https://docs.dune.com/web-app/decoding/best-practices#dune-contract-decoding-best-practices-guide) Dune Contract Decoding Best Practices Guide ===================================================================================================================================================== [​](https://docs.dune.com/web-app/decoding/best-practices#introduction) Introduction --------------------------------------------------------------------------------------- This comprehensive guide covers best practices for decoding smart contracts on Dune. Whether you’re dealing with simple single-chain contracts or complex multi-chain factory deployments, this guide will help you submit contracts correctly for optimal decoding. ### [​](https://docs.dune.com/web-app/decoding/best-practices#before-you-begin) Before You Begin * **Reference documentation @** [Dune Docs | Decoding Contracts](https://docs.dune.com/web-app/decoding/decoding-contracts) * **Leverage AI assistance**: Use the “Ask AI” feature throughout Dune documentation for quick help ![Ask AI](https://mintcdn.com/dune/4k6TmTQgIGU3t7r9/web-app/images/ask-ai.png?w=2500&fit=max&auto=format&n=4k6TmTQgIGU3t7r9&q=85&s=3ccb4604750bca8a34be9c0e6dab7af2) [​](https://docs.dune.com/web-app/decoding/best-practices#quick-reference-submission-checklist) Quick Reference: Submission Checklist ---------------------------------------------------------------------------------------------------------------------------------------- Before submitting any contract: * Identify the contract type (single, created by a factory, proxy) * Locate the correct ABI (implementation, not proxy) * For more information, check this [Documentation by OpenZeppelin](https://docs.openzeppelin.com/contracts/4.x/api/proxy) * If submitting for multiple chains use a multichain explorer like [Blockscout](https://www.blockscout.com/) to determine which chains a contract has been deployed on (**Please note:** if an address exists on another chain that doesn’t mean that it is a contract on that chain, so make sure to validate this by ensuring that the address is a contract on that specific chain) * Check for [identical bytecode](https://etherscan.io/find-similar-contracts) across addresses * Document any special patterns or versions **Dune Contract Submission Page:** [https://dune.com/contracts/new](https://dune.com/contracts/new) [​](https://docs.dune.com/web-app/decoding/best-practices#quick-decision-tree) Quick Decision Tree ----------------------------------------------------------------------------------------------------- **How to use this decision tree:** Start at Step 1 and follow the YES/NO paths. Each step will guide you to the correct contract submission method. Use the links and callouts for extra help! Step 1: Is your contract a proxy? [Check using Etherscan Proxy Checker →](https://etherscan.io/proxyContractChecker) **If YES:** * Use implementation ABI at proxy address * Submit the proxy address * Use the implementation contract’s ABI (not the proxy’s ABI) * The implementation contains the actual business logic **If NO:** → Go to Step 2 Step 2: Is it created by a factory? [Check Dune documentation for details →](https://docs.dune.com/web-app/decoding/decoding-contracts) **If YES:** * Enable “Decode other contracts created by the same factory” flags * Submit the ABI for the created contracts, NOT the factory ABI * Mark as factory-deployed in submission * Include sample addresses of created contracts **If NO:** → Go to Step 3 Step 3: Do all instances share identical bytecode? [Verify using Etherscan Similar Contracts →](https://etherscan.io/find-similar-contracts) **If YES:** * Enable bytecode matching * Submit one ABI that covers all instances * Check the “Enable bytecode matching” checkbox * Note the shared bytecode pattern **If NO:** * Standard submission process * Submit the contract’s ABI with the specific contract address and chain * This is the most common scenario * If unsure, always default to Standard Submission [​](https://docs.dune.com/web-app/decoding/best-practices#contract-decoding-scenarios) Contract Decoding Scenarios --------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/web-app/decoding/best-practices#single-smart-contract-on-single-chain) Single Smart Contract on Single Chain **Definition**: One contract deployed to one blockchain **How to Submit:** * Submit the contract’s ABI with the specific contract address and chain * Straightforward process with no special considerations **Example**: Ethereum Name Service (ENS) Registry * Contract: `0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e` (Ethereum only) * Action: Submit ENS Registry ABI for this specific address on Ethereum ### [​](https://docs.dune.com/web-app/decoding/best-practices#single-contract-on-multiple-chains) Single Contract on Multiple Chains **Definition**: Same contract deployed across different blockchains **How to Submit:** * Submit the same ABI once * Specify all chains where it’s deployed * Use the same submission if addresses match across chains **Example**: LayerZero Endpoint * Contract: `0x66A71Dcef29A0fFBDBE3c6a460a3B5BC225Cd675` (multiple chains) * Action: Submit as “Submit as multiple chains” with same ABI for all chains with this address and select the chains Use [Blockscout](https://www.blockscout.com/) to verify deployments. It’s okay if you miss a chain initially—you can always add more chains later. To add more chains later go to the [Contract Submission Page](https://dune.com/contracts/new) . If it is a single chain select the chain, add the address, and submit as normal. If there are multiple chains, select the “Submit on Multiple Chains” in the dropdown and include all the new chains of the contract, and submit the contracts. ### [​](https://docs.dune.com/web-app/decoding/best-practices#factory-deployed-contracts-single-chain) Factory-Deployed Contracts (Single Chain) **Definition**: A factory contract creates multiple instances of the same contract type **How to Submit:** * Submit the ABI for the **created contracts**, NOT the factory ABI * Mark as factory-deployed in submission * Include sample addresses of created contracts **Example**: Uniswap V2 Pairs on Ethereum * Factory: `0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f` * Sample Pair: `0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc` (USDC/ETH) * Action: Submit UniswapV2Pair contract & ABI (not factory ABI) * **Tip:** If an ABI isn’t verified for certain addresses, the ABI will be the same across chains in the same project (ie., UniswapV2Pair ABI is going to be the same on all EVM chains regardless of the address) ### [​](https://docs.dune.com/web-app/decoding/best-practices#factory-deployed-contracts-multiple-chains) Factory-Deployed Contracts (Multiple Chains) **Definition:** Factory pattern deployed across multiple chains **How to Submit:** * Submit the created contract’s ABI once * Select all chains where factories exist * Check the “Decode other contracts deployed by the same factory” checkbox * The submission will detect factory-created instances on each selected chain **Example:** Uniswap V2 Factory Pattern * Ethereum Factory: `0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f` * Polygon Factory: `0x5757371414417b8C6CAad45bAeF941aBc7d3Ab32` * Arbitrum Factory: `0xf1D7CC64Fb4452F05c498126312eBE29f30Fbcf9` * Action: Submit UniswapV2Pair ABI once, select all three chains, enable factory flag **Note:** Dune will automatically find all pairs created by each chain’s factory ### [​](https://docs.dune.com/web-app/decoding/best-practices#contracts-with-identical-bytecode-single-chain) Contracts with Identical Bytecode (Single Chain) **Definition**: Multiple contracts with identical bytecode but different addresses **How to Submit:** * Submit one ABI that covers all instances * Check the “Enable bytecode matching” checkbox * Note the shared bytecode pattern **Example**: Compound V2 cToken Contracts * cUSDC: `0x39AA39c021dfbaE8faC545936693aC917d5E7563` * cETH: `0x4Ddc2D193948926D02f9B1fE9e1daa0718270ED5` * Action: One cToken ABI submission covers all ### [​](https://docs.dune.com/web-app/decoding/best-practices#contracts-with-identical-bytecode-across-multiple-chains) Contracts with Identical Bytecode (Across Multiple Chains) **Definition**: Same bytecode deployed across multiple chains Use bytecode matching with extreme caution when submitting across multiple chains! This feature can produce many false positives, as different contracts may have identical bytecode but have completely different purposes or contexts. Only use when you’re certain the contracts are truly identical implementations. **How to Submit:** * Submit one ABI specifying all chains and addresses * Check the “Enable bytecode matching” checkbox **Example**: Safe Singleton 1.3.0 * Address: `0xd9Db270c1B5E3Bd161E8c8503c55cEABeE709552` (multiple chains) * Action: One Safe ABI submission for all chains [​](https://docs.dune.com/web-app/decoding/best-practices#proxy-contract-patterns) Proxy Contract Patterns ------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/web-app/decoding/best-practices#basic-proxy-rules) Basic Proxy Rules **Critical**: Always use the **implementation contract’s ABI**, not the proxy’s ABI * Submit the proxy address * Decode using the implementation’s functions * The implementation contains the actual business logic * To check if your contract is a proxy, you can visit a block explorer like [etherscan.io](http://etherscan.io/) and click into the “Contract” section. If you see “Read as Proxy” and “Write as Proxy” as the image below then select the ABI of the implementation contract. * For more resources: * [https://info.etherscan.com/what-is-proxy-contract/](https://info.etherscan.com/what-is-proxy-contract/) * [https://etherscan.io/proxyContractChecker](https://etherscan.io/proxyContractChecker) ![](https://mintcdn.com/dune/kuKkfe7NiZRF86tb/proxycontract.jpeg?w=2500&fit=max&auto=format&n=kuKkfe7NiZRF86tb&q=85&s=a9a5f8ac3ffb2a727286f50ef90025c2) ### [​](https://docs.dune.com/web-app/decoding/best-practices#proxy-contract-single-chain) Proxy Contract (Single Chain) **Definition**: Proxy that delegates calls to an implementation **Example**: USDC Token on Ethereum * Proxy: `0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48` * Action: Use implementation ABI, submit proxy address ### [​](https://docs.dune.com/web-app/decoding/best-practices#proxy-contract-multiple-chains) Proxy Contract (Multiple Chains) **Definition**: Same proxy pattern across chains **How to Submit:** * Use implementation ABI * Specify all proxy addresses across chains * Include implementation addresses in notes [​](https://docs.dune.com/web-app/decoding/best-practices#advanced-patterns) Advanced Patterns ------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/web-app/decoding/best-practices#upgradeable-proxies) Upgradeable Proxies #### [​](https://docs.dune.com/web-app/decoding/best-practices#transparent-upgradeable-proxy) Transparent Upgradeable Proxy **Challenge**: Implementation changes over time. More info [here](https://www.rareskills.io/post/transparent-upgradeable-proxy) . **How to Submit:** * **Use the Proxy Contract Address:** Submit using the proxy contract’s address (not the implementation contract address) * **Use the Implementation Contract’s ABI:** You must provide the ABI of the implementation contract (not the proxy contract’s ABI) * Submit Initial implementation then it is best to: * Resubmit each implementation version as “upgrade the ABI of a contract” with the new implementation ABI each time. * Use the same name for all implementations (e.g., just “uniswap\_v3” for all versions) * The system will handle merging and version tracking automatically * Track upgrade events if needed **Example**: Uniswap V3 Upgradeable Proxy * Proxy: `0xEe6A57eC80ea46401049E92587E52f5Ec1c24785` * Implementation V1: `0x0882477e7895bdc5cea7cb1552ed914ab157fe56` #### [​](https://docs.dune.com/web-app/decoding/best-practices#beacon-proxy) Beacon Proxy **Definition**: Multiple proxies point to a beacon holding the implementation. More info [here](https://www.rareskills.io/post/beacon-proxy) . **How to Submit:** * **Contract Address:** Use the Beacon proxy contract address (the actual proxy that users interact with) * **Submit beacon’s implementation ABI**: Use the implementation contract’s ABI (not the beacon or proxy ABI) * For additional beacon proxies with the same implementation: * Use the same project name and contract name * Check “Are there several instances of this contract?” if they have identical bytecode * This will consolidate them into the same decoded tables * All proxies decode using same ABI * Note the beacon pattern in comments #### [​](https://docs.dune.com/web-app/decoding/best-practices#diamond-proxy-eip-2535) Diamond Proxy (EIP-2535) **Definition**: Modular proxy with multiple implementation contracts (facets), more info [here](https://eips.ethereum.org/EIPS/eip-2535) . **How to Submit:** * **Option A**: Submit each facet’s ABI separately as upgrades * Submit the first facet ABI as a new contract * Submit additional facet ABIs as “upgrades” to the same contract * Use the same project name and contract name for all submissions * Dune will merge the ABIs in the background * **Option B**: Create one combined ABI with all facet functions * Merge all facet ABIs into a single file before submission * Submit once as a new contract **Important Notes:** * Each facet typically has its own purpose (e.g., deposits, payments, lending) * Even though facets have distinct names, submit all under the **same contract name** * Query by event/function name to distinguish between facets * Facets can be updated independently - submit new versions as upgrades * **Contact Dune support** via Slack (For Enterprise Customers), Telegram (Paid Customers), [Discord](https://discord.com/invite/ErrzwBz) , or email [support@dune.com](mailto:support@dune.com) if you have questions about the submission process ### [​](https://docs.dune.com/web-app/decoding/best-practices#factory-variations) Factory Variations #### [​](https://docs.dune.com/web-app/decoding/best-practices#multi-type-factories) Multi-Type Factories **Definition**: Factory deploys different contract types **How to Submit:** * Submit separate contracts individually, in this case **do NOT check “is created by factory”** * Submit separate ABIs for each contract type * TLDR; you will need to submit each contract individually * Clear naming convention for each type * Document the factory’s capabilities * Reach out to Dune Support if you have any questions #### [​](https://docs.dune.com/web-app/decoding/best-practices#minimal-proxy-eip-1167) Minimal Proxy (EIP-1167) **Definition**: This standard specifies a minimal bytecode implementation that delegates all calls to a known, fixed address, more info [here](https://eips.ethereum.org/EIPS/eip-1167) . **How to Submit:** * **Address:** Use minimal proxy contract address * **ABI:** Submit implementation (master/template) contract ABI * For EIP-1167 minimal proxies that have multiple clones deployed from the same factory: * Check the “Are there several instances of this contract?” box during submission * Dune only considers a contract a dynamic instance if the bytecode matches 100% * Note the clone pattern **Example**: Gnosis Safe Clones * Master: `0xd9Db270c1B5E3Bd161E8c8503c55cEABeE709552` * All clones use master’s ABI ### [​](https://docs.dune.com/web-app/decoding/best-practices#version-management) Version Management #### [​](https://docs.dune.com/web-app/decoding/best-practices#multiple-abi-versions) Multiple ABI Versions **Challenge**: Different versions active simultaneously **How to Submit:** * Submit each version separately * First submission, submit normally, then each submission afterwards would need to be a resubmission with the upgraded ABI * Document version differences #### [​](https://docs.dune.com/web-app/decoding/best-practices#gradual-cross-chain-rollouts) Gradual Cross-Chain Rollouts **Challenge**: Slight ABI differences across chains **How to Submit:** * Start with latest/most complete ABI * Add chains as they deploy * Note any chain-specific differences [​](https://docs.dune.com/web-app/decoding/best-practices#edge-cases-&-special-situations) Edge Cases & Special Situations ----------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/web-app/decoding/best-practices#self-destructed-and-redeployed-contracts) Self-Destructed and Redeployed Contracts **Situation**: Same address, different bytecode **How to Submit:** * Resubmit new ABI with updated deployment info * Clearly note the redeployment * Include destruction/redeployment dates ### [​](https://docs.dune.com/web-app/decoding/best-practices#factory-deployed-proxies) Factory-Deployed Proxies **Situation**: Factory creates proxies, not implementations **How to Submit:** * The address to use would be the address of one of the created proxies * Submit the proxy’s implementation ABI * Note both factory and proxy patterns * Clear documentation is crucial [​](https://docs.dune.com/web-app/decoding/best-practices#common-mistakes-to-avoid) Common Mistakes to Avoid --------------------------------------------------------------------------------------------------------------- 1. **Submitting Factory ABIs**: Always submit the created contract’s ABI, not the factory’s 2. **Using Proxy ABIs**: Always use implementation ABIs for proxy contracts 3. **Missing Chains**: Use tools like Blockscout to find all deployments 4. **Poor Naming**: Use descriptive names that include version/type info 5. **Incomplete Documentation**: Always note special patterns or deployment methods [​](https://docs.dune.com/web-app/decoding/best-practices#best-practices-summary) Best Practices Summary ----------------------------------------------------------------------------------------------------------- 1. **Start Simple**: Begin with one chain, expand gradually 2. **Focus on Logic**: Always decode using the contract with actual business logic 3. **Document Everything**: Use submission comments for complex patterns 4. **Version Clearly**: Use descriptive naming for different versions/types 5. **Verify Thoroughly**: Double-check addresses and bytecode matches 6. **Think User-First**: Make contract interactions readable regardless of complexity [​](https://docs.dune.com/web-app/decoding/best-practices#troubleshooting-tips) Troubleshooting Tips ------------------------------------------------------------------------------------------------------- * **Can’t find all deployments?** Start with what you have—you can add more chains later * **Unsure about bytecode?** Use Etherscan’s “Similar Contracts” feature * **Complex proxy pattern?** Focus on the final implementation that executes * **Factory creating variants?** Submit separate ABIs for each variant type Remember: The goal is to make contract interactions readable and queryable. When in doubt, prioritize clarity and usability over technical perfection. You can always refine your submission later! [​](https://docs.dune.com/web-app/decoding/best-practices#additional) Additional ----------------------------------------------------------------------------------- [​](https://docs.dune.com/web-app/decoding/best-practices#check-your-work) Check Your Work --------------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/web-app/decoding/best-practices#check-contract-submissions-for-decoding) Check Contract Submissions for Decoding Use this Dune query to verify your contract submissions and check decoding status: [Contract Submission Checker](https://dune.com/queries/4093792) ### [​](https://docs.dune.com/web-app/decoding/best-practices#check-if-contract-is-decoded-on-the-specific-blockchain) Check if Contract is decoded on the specific blockchain Copy Ask AI select * from {blockchain}.contracts where address = 0x... ### [​](https://docs.dune.com/web-app/decoding/best-practices#verify-the-table-exists-and-has-data) Verify the table exists and has data Copy Ask AI /* Verify the table exists and has data */ SELECT COUNT(*) AS total_rows, MIN(evt_block_time) AS first_event, MAX(evt_block_time) AS latest_event FROM eigenlayer_ethereum.DelegationManager_evt_OperatorSharesIncreased -- replace above line with {your_project_ethereum.yourcontract_evt_yourevent}; **Please note:** We display the full list of tables to be created in the submission form ### [​](https://docs.dune.com/web-app/decoding/best-practices#check-all-columns-are-properly-decoded) Check all columns are properly decoded Copy Ask AI -- Check all columns are properly decoded DESCRIBE eigenlayer_ethereum.DelegationManager_evt_OperatorSharesIncreased; -- replace above line with {your_project_ethereum.yourcontract_evt_yourevent}; -- Or get column info -- Ethereum SELECT 'ethereum' as chain, column_name, data_type FROM information_schema.columns WHERE table_name = 'factory_evt_poolcreated' AND table_schema = 'uniswap_v3_ethereum' UNION ALL -- Add other chains as needed SELECT 'worldchain' as chain, column_name, data_type FROM information_schema.columns WHERE table_name = 'uniswapv3factory_evt_poolcreated' AND table_schema = 'uniswap_worldchain'; ### [​](https://docs.dune.com/web-app/decoding/best-practices#expected-tables-and-event-types) Expected Tables and Event Types * Search the contract in the data explorer to view both the tables and events related to the contract ### [​](https://docs.dune.com/web-app/decoding/best-practices#when-not-to-decode) When NOT to Decode **Skip These Contracts:** * Pure libraries (no deployable bytecode) * Contracts with only view functions * Simple forwarder/relay contracts * Contracts that only emit standard ERC20/721 events * Test/deprecated contracts with no usage * Contracts with no transactions are not needed to decode **Consider Carefully:** * Governance contracts (usually low activity) * Admin/owner contracts (minimal events) * Price oracle contracts (mostly reads) [​](https://docs.dune.com/web-app/decoding/best-practices#remember) Remember ------------------------------------------------------------------------------- * One ABI can decode thousands of contracts * Namespaces can’t be merged or moved * 100% bytecode match is strict * Factory pattern and bytecode finds future contracts too * Plan namespace structure before submitting Was this page helpful? YesNo [How Decoding Works](https://docs.dune.com/web-app/decoding/decoding-contracts) [Contract Submission Guide](https://docs.dune.com/web-app/decoding/short-guide-contract-submission) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Multichain Decoding - Dune Docs [Skip to main content](https://docs.dune.com/web-app/decoding/multichain-decoding#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Decode Smart Contracts Multichain Decoding [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Prerequisites](https://docs.dune.com/web-app/decoding/multichain-decoding#prerequisites) * [Submitting Contracts](https://docs.dune.com/web-app/decoding/multichain-decoding#submitting-contracts) * [Querying Multichain Tables](https://docs.dune.com/web-app/decoding/multichain-decoding#querying-multichain-tables) * [Naming Convention](https://docs.dune.com/web-app/decoding/multichain-decoding#naming-convention) * [Schema](https://docs.dune.com/web-app/decoding/multichain-decoding#schema) * [Finding Tables in the Data Explorer](https://docs.dune.com/web-app/decoding/multichain-decoding#finding-tables-in-the-data-explorer) * [Examples](https://docs.dune.com/web-app/decoding/multichain-decoding#examples) Multichain Decoding consolidates decoded contract data across all supported EVM chains into a single table per contract. Instead of maintaining separate `UNION ALL` queries for every chain your protocol operates on, you submit once and query one table — with a `chain` column to filter or aggregate by network. This eliminates the most common sources of broken cross-chain queries: missing a newly supported chain, inconsistent table naming across deployments, or schema drift between separate submissions. Multichain contract submissions require a **paid team plan**. See [pricing](https://dune.com/pricing) for details. Multichain tables have the same data freshness and latency as single-chain decoded tables. See [data freshness](https://docs.dune.com/data-catalog/data-freshness) for SLA details. [​](https://docs.dune.com/web-app/decoding/multichain-decoding#prerequisites) Prerequisites ---------------------------------------------------------------------------------------------- Before submitting a multichain contract, ensure the following: | Requirement | Details | | --- | --- | | **Identical ABI** | Contracts must share the exact same ABI across all chains. | | **Consistent naming** | Contracts must use the same project namespace and contract name (e.g., `uniswap_v3` / `UniswapV3Pool`). | | **Paid team plan** | Multichain submissions are only available to teams on a paid subscription. [Compare plans →](https://dune.com/pricing) | Dune uses this standardized labeling to merge data from different chains into a single cross-chain table. [​](https://docs.dune.com/web-app/decoding/multichain-decoding#submitting-contracts) Submitting Contracts ------------------------------------------------------------------------------------------------------------ To submit a multichain contract, use the [contract submission page](https://dune.com/contracts/new) . Select **Submit on Multiple Chains**, provide the ABI, and select all target chains. When contracts with the same ABI are submitted across multiple chains, Dune combines them into a single table — no additional configuration needed. For detailed submission instructions — including factory contracts, proxy patterns, and bytecode matching — see the [Contract Decoding Best Practices Guide](https://docs.dune.com/web-app/decoding/best-practices) . [​](https://docs.dune.com/web-app/decoding/multichain-decoding#querying-multichain-tables) Querying Multichain Tables ------------------------------------------------------------------------------------------------------------------------ ### [​](https://docs.dune.com/web-app/decoding/multichain-decoding#naming-convention) Naming Convention Multichain decoded tables follow the naming pattern: Copy Ask AI {project}_multichain.{ContractName}_{evt|call}_{EventOrFunctionName} For example: * `gnosis_safe_multichain.Safe_v1_4_1_call_execTransaction` * `zora_multichain.ZoraTimedSaleStrategy_evt_SaleSet` ### [​](https://docs.dune.com/web-app/decoding/multichain-decoding#schema) Schema Each multichain table includes a `chain` column identifying the source network, alongside all standard decoded columns (`evt_block_time`, `evt_tx_hash`, `call_block_time`, etc.). Copy Ask AI -- All execTransaction calls on Ethereum SELECT chain, call_block_time, call_tx_hash FROM gnosis_safe_multichain.Safe_v1_4_1_call_execTransaction WHERE chain = 'ethereum' ### [​](https://docs.dune.com/web-app/decoding/multichain-decoding#finding-tables-in-the-data-explorer) Finding Tables in the Data Explorer Multichain decoded tables are accessible in the Data Explorer alongside regular decoded tables. They display a distinct multichain icon and list all supported chains. ![Multichain table in Data Explorer](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/multichain_object_in_de.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=b8b8bddef6555ce508f7c8055d002efc) [​](https://docs.dune.com/web-app/decoding/multichain-decoding#examples) Examples ------------------------------------------------------------------------------------ The following examples compare multichain queries against the equivalent manual `UNION ALL` approach. In each case, multichain tables reduce query complexity and eliminate the need to track per-chain table names.Finding Zora Uniswap Collections * Multichain table * Manual UNION ALL (per-chain) Copy Ask AI SELECT * FROM ( SELECT --this event is emitted on sale set updates too so we take distinct distinct l.blockchain , l.collection as nft_address , l.erc20zAddress as erc20_address , l.tokenId as token_id , nft.name as nft_collection_name , nft.defaultAdmin as creator , json_value(salesConfig, 'strict $.name') as nft_name , json_value(salesConfig, 'strict $.symbol') as nft_symbol , COALESCE(try(from_unixtime(cast(json_value(salesConfig, 'strict $.saleStart') as bigint))),timestamp '1970-01-01') as start_time , COALESCE(try(from_unixtime(cast(json_value(salesConfig, 'strict $.saleEnd') as bigint))),timestamp '2050-01-01') as end_time , l.poolAddress as uni_pool , l.evt_block_time , row_number() over (partition by collection, erc20zAddress, tokenId order by evt_block_time desc) as last_sale_set FROM ( SELECT collection, erc20zAddress, tokenId, salesConfig, evt_block_time, poolAddress, chain AS blockchain FROM zora_multichain.ZoraTimedSaleStrategy_evt_SaleSet ) l LEFT JOIN ( SELECT name, defaultAdmin, newContract, chain AS blockchain FROM zora_multichain.ZoraCreator1155FactoryImpl_evt_SetupNewContract ) nft ON l.collection = nft.newContract AND l.blockchain = nft.blockchain ) WHERE last_sale_set = 1 Copy Ask AI SELECT * FROM ( SELECT --this event is emitted on sale set updates too so we take distinct distinct l.blockchain , l.collection as nft_address , l.erc20zAddress as erc20_address , l.tokenId as token_id , nft.name as nft_collection_name , nft.defaultAdmin as creator , json_value(salesConfig, 'strict $.name') as nft_name , json_value(salesConfig, 'strict $.symbol') as nft_symbol , COALESCE(try(from_unixtime(cast(json_value(salesConfig, 'strict $.saleStart') as bigint))),timestamp '1970-01-01') as start_time , COALESCE(try(from_unixtime(cast(json_value(salesConfig, 'strict $.saleEnd') as bigint))),timestamp '2050-01-01') as end_time , l.poolAddress as uni_pool , l.evt_block_time , row_number() over (partition by collection, erc20zAddress, tokenId order by evt_block_time desc) as last_sale_set FROM ( SELECT collection, erc20zAddress, tokenId, salesConfig, evt_block_time, poolAddress, 'zora' as blockchain FROM zora_zora.ZoraTimedSaleStrategy_evt_SaleSet UNION ALL SELECT collection, erc20zAddress, tokenId, salesConfig, evt_block_time, poolAddress, 'base' as blockchain FROM zora_base.ZoraTimedSaleStrategy_evt_SaleSet UNION ALL SELECT collection, erc20zAddress, tokenId, salesConfig, evt_block_time, poolAddress, 'optimism' as blockchain FROM zora_optimism.ZoraTimedSaleStrategy_evt_SaleSet UNION ALL SELECT collection, erc20zAddress, tokenId, salesConfig, evt_block_time, poolAddress, 'arbitrum' as blockchain FROM zora_arbitrum.ZoraTimedSaleStrategy_evt_SaleSet UNION ALL SELECT collection, erc20zAddress, tokenId, salesConfig, evt_block_time, poolAddress, 'blast' as blockchain FROM zora_blast.ZoraTimedSaleStrategy_evt_SaleSet ) l LEFT JOIN ( SELECT name, defaultAdmin, newContract, 'zora' as blockchain FROM zora_zora.ZoraCreator1155_evt_SetupNewContract UNION ALL SELECT name, defaultAdmin, newContract, 'base' as blockchain FROM zora_base.ZoraCreator1155FactoryImpl_evt_SetupNewContract UNION ALL SELECT name, defaultAdmin, newContract, 'optimism' as blockchain FROM zora_optimism.ZoraCreator1155FactoryImpl_evt_SetupNewContract UNION ALL SELECT name, defaultAdmin, newContract, 'arbitrum' as blockchain FROM zora_arbitrum.ZoraCreator1155Factory_evt_SetupNewContract UNION ALL SELECT name, defaultAdmin, newContract, 'blast' as blockchain FROM zora_blast.ZoraCreator1155FactoryImpl_evt_SetupNewContract ) nft ON l.collection = nft.newContract AND l.blockchain = nft.blockchain ) WHERE last_sale_set = 1 Gnosis Safe \`execTransaction\` Calls * Multichain table * Manual UNION ALL (per-chain) Copy Ask AI select chain, date_trunc('day', call_block_time) AS block_date, count(*) as cnt from gnosis_safe_multichain.Safe_v1_4_1_call_execTransaction group by 1, 2 Copy Ask AI select chain, date_trunc('day', call_block_time) AS block_date, count(*) as cnt from ( SELECT 'arbitrum' AS chain, call_block_time FROM gnosis_safe_arbitrum.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'avalanche_c' AS chain, call_block_time FROM gnosis_safe_avalanche_c.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'blast' AS chain, call_block_time FROM gnosis_safe_blast.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'base' AS chain, call_block_time FROM gnosis_safe_base.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'bnb' AS chain, call_block_time FROM gnosis_safe_bnb.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'celo' AS chain, call_block_time FROM gnosis_safe_celo.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'ethereum' AS chain, call_block_time FROM gnosis_safe_ethereum.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'gnosis' AS chain, call_block_time FROM gnosis_safe_gnosis.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'linea' AS chain, call_block_time FROM gnosis_safe_linea.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'optimism' AS chain, call_block_time FROM gnosis_safe_optimism.Safe_v1_4_1_call_execTransaction UNION ALL SELECT 'polygon' AS chain, call_block_time FROM gnosis_safe_polygon.Safe_v1_4_1_call_execTransaction ) group by 1,2 Was this page helpful? YesNo [Contract Submission Guide](https://docs.dune.com/web-app/decoding/short-guide-contract-submission) [FAQs](https://docs.dune.com/web-app/decoding/faqs) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Decoding FAQs - Dune Docs [Skip to main content](https://docs.dune.com/web-app/decoding/faqs#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Decode Smart Contracts Decoding FAQs [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Frequently Asked Questions](https://docs.dune.com/web-app/decoding/faqs#frequently-asked-questions) * [General FAQs](https://docs.dune.com/web-app/decoding/faqs#general-faqs) * [Duplicate Data & Namespace Issues](https://docs.dune.com/web-app/decoding/faqs#duplicate-data-%26-namespace-issues) * [Rejection & Missing Data Issues](https://docs.dune.com/web-app/decoding/faqs#rejection-%26-missing-data-issues) * [Bytecode Matching & Instance Detection](https://docs.dune.com/web-app/decoding/faqs#bytecode-matching-%26-instance-detection) * [Complex Namespace Management](https://docs.dune.com/web-app/decoding/faqs#complex-namespace-management) * [Performance & Query Optimization](https://docs.dune.com/web-app/decoding/faqs#performance-%26-query-optimization) * [Special Cases & Edge Scenarios](https://docs.dune.com/web-app/decoding/faqs#special-cases-%26-edge-scenarios) * [Submission-Related FAQs](https://docs.dune.com/web-app/decoding/faqs#submission-related-faqs) * [Decoding Process FAQs](https://docs.dune.com/web-app/decoding/faqs#decoding-process-faqs) * [Query-Related FAQs](https://docs.dune.com/web-app/decoding/faqs#query-related-faqs) * [Troubleshooting FAQs](https://docs.dune.com/web-app/decoding/faqs#troubleshooting-faqs) * [Best Practices FAQs](https://docs.dune.com/web-app/decoding/faqs#best-practices-faqs) * [Additional Questions?](https://docs.dune.com/web-app/decoding/faqs#additional-questions) [​](https://docs.dune.com/web-app/decoding/faqs#frequently-asked-questions) Frequently Asked Questions ========================================================================================================= [​](https://docs.dune.com/web-app/decoding/faqs#general-faqs) General FAQs ----------------------------------------------------------------------------- How do I figure out if my contract has been decoded? There are two main ways to find out if your contract has been decoded.First: Account SettingsInformation on submitted contracts can be found in your account settings under “Contracts”. The status of the contract will reflect one of the following: 1. Pending 2. Approved/Rejected\* Note that once a contract has been approved, it takes around 24 hours for the data to be fully decoded and populated into our database.\*If the contract is rejected, hover your mouse over the status to see the reason for the rejection.Second: Our [Contract Decoding Dashboard](https://dune.com/dune/is-my-contract-decoded-yet-v2) ![](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/4.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=80a7c5584f4448f09de375eebf287fb5)Built by our decoding team, this dashboard gives you information on the status of any submitted contract. Input the contract address in the box at the top of the dashboard and if the contract has been decoded, the contract information will populate the box along with where it is located in the Dune database. I see data on Dune but it doesn't match or is missing what I expected to see Unfortunately, Dune only has access to contract data in circumstances that the contract performed an event that left a trace. Our recommendation is to check out the .traces table to see what information is available for a particular contract.Alternatively, some contracts are upgradeable (ie., the smart contract code can be modified). In this case we may not have all of the ABIs. ABIs can be checked in the ABI column of the .contracts tables. A contract can always be resubmitted with missing ABIs so we can update our data. How do I submit contract information manually? If the contract being manually submitted is a Proxy contract, we recommend you to move on to the next section. Although we try to fetch contract information such as the ABI, sometimes this information might not be available through our sources.In those instances, you will need to manually input the contract’s name and its ABI.If the contract has been verified by the chain’s block explorer, you should be able to find this information there. How do I submit a proxy contract? In order to properly decode transactions for contracts that fit the [Proxy pattern](https://blog.openzeppelin.com/proxy-patterns/) , Dune needs to map the Proxy contract’s address with the implementation contract’s ABI.We avoid monitoring the implementation contract’s address because its logic is accessed in transactions via the [`DelegateCall` function](https://medium.com/coinmonks/delegatecall-calling-another-contract-function-in-solidity-b579f804178c) .If we did monitor the implementation contract’s address directly, we would miss out on any event logs in its logic since these are actually fired by the caller (the Proxy in this case) when calling a function through `DelegateCall`. When submitting Proxy-patterned contracts to Dune, you should input the Proxy contract’s address and, if you have it, the Implementation contract’s ABI. If the Proxy has a new implementation upgraded that you wish to decode, use the same project name + contract name and select **‘NO’** for several instances! ![new proxy implementation submission](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/5.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=8cde434f25120fee680e859e49e0b6f1)When you submit the Proxy contract’s address, we’ll attempt to fetch the proxy’s contract name and the implementation address it’s pointing towards to source the Implementation contract’s ABI.If we can’t find the Implementation contract’s ABI, you’ll need to find it using the relevant chain’s blockchain explorer and input it manually.You can use the [Etherscan Proxy Contract Checker](https://etherscan.io/proxyContractChecker) to help verify and link proxy contracts with their implementation ABIs. How do I submit Diamond Proxy contracts? Similar to vanilla Proxy contracts, [EIP-2535](https://eips.ethereum.org/EIPS/eip-2535) contracts can be supported by passing in the address of the Diamond Proxy as well as **a single ABI representing the totality of all the facets interfaces**. My submission got rejected, why? The most common reason that your submission got rejected is because it has already been decoded! You can make use of [this dashboard](https://dune.com/dune/is-my-contract-decoded-yet-v2) to check whether the contract have been decoded.**Enter the contract that you wish to decode and hit enter to run:**![check if contract is decoded](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/check_decoding_input_address.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=16722fa98a5bb200f68595962e43c6c4)**Viewing results:**![query results to determine whether contract is decoded](https://mintcdn.com/dune/6vWXO_JiAjw4C8nz/web-app/images/decoding-contracts/check_decoding_result_output.png?w=2500&fit=max&auto=format&n=6vWXO_JiAjw4C8nz&q=85&s=10d85819be0e356638732b62615f0394)If you see results after running the query, that means the contract is already decoded! You’ll be able to find the decoded tables under ‘Decoded Projects’ in the data explorer.In the interest of data quality, we reject duplicative, incorrect or low quality submissions. To avoid rejection, be sure to submit accurate contract information! Submissions can be rejected for a number of reasons, including not following the naming conventions, not providing clear data at submission, etc. The particular reason for a contract submission being rejected can be found in account settings under “Contracts” by hovering the mouse over the “Rejected” status. Why am I missing historical data for my contract? It may take up to six hours from the time of contract approval for the contract to be fully decoded along with its historical data. If you still can’t see the data after this period, please reach out to us through our [#decoding Discord channel](https://discord.com/channels/757637422384283659/850326962152538122) . I'm waiting for my data to fully decode. What can I do in the meantime? Need some data urgently but the contract have yet to be fully decoded? You can refer to these queries that utilizes the logs table to get the events: * [Querying Synthetix’s PerpsTracking Event](https://dune.com/queries/2743182) * [Querying USDT’s AddedBlackList Event](https://dune.com/queries/3250843) [​](https://docs.dune.com/web-app/decoding/faqs#duplicate-data-&-namespace-issues) Duplicate Data & Namespace Issues ----------------------------------------------------------------------------------------------------------------------- My contracts are being decoded under multiple folders/namespaces, causing duplicate records. How do I fix this? This happens when the same contract is submitted multiple times under different names, across different blockchains. To resolve: 1. **Identify the duplicate submissions** in your contracts list 2. **Choose which namespace to keep** (e.g., LiFiDiamond\_v2 vs LiFiDiamond) 3. **Resubmit the contract** and select “Rename a contract” as the reason for resubmission !\[Resubmission UI example\](/web-app/images/alerts/Contract resubmission sc.png) 4. **Contact Dune support** via Slack (For Enterprise Customers), Telegram (Paid Customers), [Discord](https://discord.com/invite/ErrzwBz) , or email ([support@dune.com](mailto:support@dune.com) ) to remove the duplicate namespace **Going forward: Before submitting, [search](https://dune.com/dune/is-my-contract-decoded-yet-v2) if the contract already exists under your project**To prevent this: * Check existing decoded contracts before submitting * Use consistent naming conventions across your team * Document which contracts are already decoded Can I move contracts from one namespace to another without losing data? **No**, you cannot move contracts between namespaces after decoding. You would need to: 1. Resubmit under the correct namespace 2. Wait for new decoding to complete 3. Migrate your queries to use the new tables 4. Submit a request to Dune support via Slack (For Enterprise Customers), Telegram (Paid Customers), [Discord](https://discord.com/invite/ErrzwBz) , or email ([support@dune.com](mailto:support@dune.com) ) to remove the old namespace **Plan your namespace structure carefully before submission.** [​](https://docs.dune.com/web-app/decoding/faqs#rejection-&-missing-data-issues) Rejection & Missing Data Issues ------------------------------------------------------------------------------------------------------------------- My contract was rejected with no explanation. What happened? When a contract is rejected without a detailed explanation, it’s often for one of these common reasons: * **Duplicate submission**: Contract is already decoded under another name * **Invalid ABI**: ABI doesn’t match the deployed bytecode * **Wrong contract type**: Submitted a library or abstract contract To debug: Find a specific transaction hash where your event/function was called and include it in your resubmission notes. I see the contract on Etherscan but functions/events are missing on Dune. Why? Dune only displays functions and events that have actual onchain data:✅ **Visible**: Events/functions that have been called at least once ❌ **Hidden**: Events/functions with zero onchain activity ❌ **Hidden**: View/pure functions (read-only, no on-chain traces)**Most common cause**: This often happens when a proxy contract’s implementation is upgraded. The new functions/events won’t appear until: 1. They’re actually called onchain, AND 2. The new ABI is submitted to Dune for decoding (requires manual approval, which can take some time) **To verify**: 1. Find a transaction that calls the missing function/event 2. Check if it appears in `ethereum.traces` or `ethereum.logs` raw tables **To check**: Copy Ask AI -- Check if tx hash exists in traces SELECT 'traces' as table_name, COUNT(*) as record_count FROM ethereum.traces WHERE tx_hash = 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef; OR Copy Ask AI -- Check if tx hash exists in logs SELECT 'logs' as table_name, COUNT(*) as record_count FROM ethereum.logs WHERE tx_hash = 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef; If yes but not in decoded tables, contact Dune support with the tx hash [​](https://docs.dune.com/web-app/decoding/faqs#bytecode-matching-&-instance-detection) Bytecode Matching & Instance Detection --------------------------------------------------------------------------------------------------------------------------------- I enabled bytecode matching but other instances aren't appearing. How long should I wait? **Bytecode matching timeline**: * **Initial contract**: Typically decodes within 24 hours * **Bytecode matching scan**: Additional 24-48 hours * **Status remains “Pending”**: This is normal during scanning * **All instances appear**: Usually within 48-72 hours total **To verify it’s working**: Copy Ask AI -- Check if other instances are detected SELECT DISTINCT contract_address FROM namespace.contractname_evt_YourEvent If after 72 hours only one address appears, verify: * Other contracts have 100% identical bytecode * You enabled “bytecode matching” during submission * Contracts aren’t variations (even slight differences prevent matching) How do I know if bytecode matching actually found other instances? After decoding completes, you can check: 1. **Query the decoded tables for multiple contract addresses** 2. **Can use [dune.com/agent](https://dune.com/agent) **: Copy Ask AI -- Find all contracts with the same bytecode as a specific contract SELECT * FROM contracts.contract_mapping WHERE code = ( SELECT code FROM contracts.contract_mapping WHERE contract_address = 0x7ac96180C4d6b2A328D3a19ac059D0E7Fc3C6d41 AND blockchain = 'ethereum' -- or your target chain ) ORDER BY code_deploy_rank_by_chain, created_time [​](https://docs.dune.com/web-app/decoding/faqs#complex-namespace-management) Complex Namespace Management ------------------------------------------------------------------------------------------------------------- How do I ensure specific contracts fall under the right namespace when using bytecode matching? You cannot selectively include/exclude contracts with bytecode matching. Options:**If contracts should be in different namespaces**: * Submit them separately * Don’t enable bytecode matching * Manually submit each address **If you need selective grouping**: * Submit the main contract with bytecode matching * Create a view filtering only desired addresses: Copy Ask AI CREATE VIEW my_filtered_events AS SELECT * FROM namespace.contract_evt_Event WHERE contract_address IN ( '0xAddress1', '0xAddress2' ) **For different versions under same namespace**: * For upgradeable contracts (e.g., proxy pattern), submit only the proxy contract address with the current implementation’s ABI. * Use the same project and contract names for consistency. * When a new implementation is deployed, resubmit the proxy contract with the updated ABI and the same names (select ‘NO’ for several instances). * Do not submit multiple versions as separate contracts; just update the ABI as needed via resubmission. Multiple teams deployed our contracts. How do we organize the data? **Best practices for shared contract code**: * **Coordinate namespace ownership**: Decide who “owns” the namespace * **Use project-specific namespaces**: teamA\_token vs teamB\_token * **Create cross-project views**: Combine data post-decoding * **Document deployment addresses**: Maintain a registry of who deployed what **Note**: Dune cannot always determine exactly what onchain data passes through a given project. This limitation applies broadly, but is especially relevant for aggregators, interfaces, or infrastructure layers that interact with data indirectly. As a result, usage and attribution metrics may be incomplete or ambiguous. [​](https://docs.dune.com/web-app/decoding/faqs#performance-&-query-optimization) Performance & Query Optimization --------------------------------------------------------------------------------------------------------------------- How do I efficiently query factory contracts with thousands of instances? **Optimize your queries by**:**Filter early and specifically**: Copy Ask AI -- Good: Filter by contract_address first SELECT * FROM uniswap_v2.Pair_evt_Swap WHERE contract_address = 0xSpecificPair AND evt_block_time > now() - interval '1 day' -- Bad: Scan all pairs first SELECT * FROM uniswap_v2.Pair_evt_Swap WHERE evt_block_time > now() - interval '1 day' AND token0 = 0xSpecificToken **Identify relevant contracts upfront**: * Before querying, determine which token pairs or contract instances matter to your analysis * You can do this by: * Looking them up on a block explorer or the project’s official documentation/site * Querying Dune itself to find pairs involving a specific token of interest * Use materialized views for common filters * Partition by time when querying historical data * Index on contract\_address in downstream tables My decoded tables are huge. How do I find specific contract instances? **Use these strategies**:**Create a contract registry view**: Copy Ask AI WITH my_protocol_contracts AS ( SELECT contract_address, MIN(evt_block_time) as first_seen, COUNT(*) as event_count FROM uniswap_v2_multichain.uniswapv2factory_evt_paircreated GROUP BY contract_address ) SELECT * FROM my_protocol_contracts ORDER BY event_count DESC * Use Dune’s search in Data Explorer with specific addresses * Filter by deployment block for newer contracts * Maintain an off-chain registry of your contract deployments [​](https://docs.dune.com/web-app/decoding/faqs#special-cases-&-edge-scenarios) Special Cases & Edge Scenarios ----------------------------------------------------------------------------------------------------------------- How do I handle contracts deployed by CREATE2 with identical addresses across chains? **For deterministic deployments**: * Submit once per chain (multichain decoding handles this automatically if criteria are met) * Use consistent naming across all chains * Note in submission: “CREATE2 deterministic deployment” **Query efficiently**: Copy Ask AI -- Query all chains at once SELECT * FROM namespace.contract_evt_Event WHERE chain IN ('ethereum', 'polygon', 'arbitrum') [​](https://docs.dune.com/web-app/decoding/faqs#submission-related-faqs) Submission-Related FAQs --------------------------------------------------------------------------------------------------- I submitted the wrong ABI type (proxy instead of implementation). How do I fix this? You’ll need to resubmit the contract with the correct implementation ABI. Use the resubmission process and select “Upgrade the ABI of a contract” as the reason. In the notes, clearly state you’re switching from proxy to implementation ABI. The original submission will be replaced once approved.**Please note**: You will need to wait until the original submission has completed the decoding process to resubmit. Submitting back to back will result in both submissions getting rejected. How do I know if I should use bytecode matching vs factory pattern? * **Use bytecode matching when**: Multiple contracts have identical code but different deployers (e.g., token contracts deployed by different teams) * **Use factory pattern when**: All contracts are created by the same factory contract (e.g., Uniswap pairs) * **Use both when**: A factory creates contracts with identical bytecode Check the “From” address in the creation transaction - if it is a contract (not EOA), consider the factory pattern. My contract has been upgraded multiple times. Should I submit all versions? **Handling Upgraded Contracts on Dune**When your contract has been upgraded multiple times, you don’t need to submit all versions. Here’s what you should do:**For Proxy Contracts (Most Common Upgrade Pattern)** If your contract uses a proxy pattern for upgrades: * Submit only the proxy contract address with the current implementation’s ABI * Use the same project name and contract name for consistency * When you have a new implementation that you want to decode, resubmit the contract with: * Same proxy address * Updated ABI from the new implementation * Same project and contract names * Select ‘NO’ for “several instances” option **Resubmission Process** The documentation specifically mentions resubmissions for cases like yours: > Sometimes you need to resubmit a contract because the name is originally submitted wrong, or you need to update the ABI. When resubmitting: * Go to the contract submission page * Select the resubmission reason from the dropdown * If your reason isn’t listed, provide detailed information about why you’re resubmitting to avoid rejection **Key Points About Contract Upgrades** * Dune handles upgradeable contracts by allowing ABI updates through resubmission * The documentation notes: “some contracts are upgradeable (i.e., the smart contract code can be modified). In this case we may not have all of the ABIs. ABIs can be checked in the ABI column of the .contracts tables. A contract can always be resubmitted with missing ABIs so we can update our data.” * You only need to submit the current/latest version that you want decoded **What NOT to Do** * Don’t submit multiple versions of the same contract as separate submissions * Don’t submit implementation contract addresses directly (for proxy patterns) The most efficient approach is to submit your current proxy contract with the latest implementation’s ABI, and resubmit when you have significant upgrades that require new decoding. [​](https://docs.dune.com/web-app/decoding/faqs#decoding-process-faqs) Decoding Process FAQs ----------------------------------------------------------------------------------------------- Why does my decoded table show data from other contracts I didn't submit? This happens when you enabled bytecode matching or factory pattern detection. Your submission automatically decoded all contracts with: * Same bytecode (if bytecode matching enabled) * Same factory deployer (if factory pattern enabled) This is a feature, not a bug - it gives you comprehensive protocol data. How long does decoding take for factory contracts with thousands of instances? Factory contracts with many instances (like Uniswap pairs) can take 24-48 hours to fully decode. The table appears immediately but populates gradually. Large factories may take longer due to the volume of historical data. [​](https://docs.dune.com/web-app/decoding/faqs#query-related-faqs) Query-Related FAQs ----------------------------------------------------------------------------------------- How do I identify which specific contract instance generated an event in factory-decoded tables? Use the `contract_address` column present in all decoded tables. This shows which specific instance (e.g., which Uniswap pair) generated each event. Why can't I find my multichain decoded tables? Multichain views require: 1. Identical ABIs across chains 2. Same project namespace and contract name 3. Contracts submitted on multiple chains Check that all three criteria are met. Look for the multichain symbol in the Data Explorer.**Please Note**: There are sometimes delays that occur before the decoded tables show up in the multichain tables after they are decoded. [​](https://docs.dune.com/web-app/decoding/faqs#troubleshooting-faqs) Troubleshooting FAQs --------------------------------------------------------------------------------------------- I see similar contracts on Etherscan but bytecode matching isn't working. Why? Dune requires 100% bytecode match. Even minor differences (like constructor parameters stored in bytecode) prevent matching. Check if contracts were compiled with different: * Solidity versions * Optimizer settings * Constructor parameters embedded in bytecode You can use [Etherscan’s Find Similar Contracts tool](https://etherscan.io/find-similar-contracts) to check for bytecode similarity and see if your contract matches others on-chain.You may need to submit contracts individually. [​](https://docs.dune.com/web-app/decoding/faqs#best-practices-faqs) Best Practices FAQs ------------------------------------------------------------------------------------------- Should I decode every contract in my protocol? **No**, focus on contracts that emit important events or have a queryable state:✅ **Core protocol contracts with business logic** ✅ **Contracts emitting analytical events** ❌ **Simple ownership or access control contracts** ❌ **Libraries (can’t be decoded directly)** When should I resubmit vs. submit a new contract? **New submission when**: * Different contract address * New version with different address * Different contract type in protocol * Adding missed chains **Resubmit when**: * Updating ABI for the same contract * Fixing naming errors * Request contract deletion * Submitting for another reason ### [​](https://docs.dune.com/web-app/decoding/faqs#additional-questions) Additional Questions? Head over to the [#decoding Discord channel](https://discord.com/channels/757637422384283659/850326962152538122) and we’ll be happy to help! Was this page helpful? YesNo [Multichain Decoding](https://docs.dune.com/web-app/decoding/multichain-decoding) [Teams and Roles](https://docs.dune.com/web-app/teams) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Yominet Data - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/yominet/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Yominet Yominet Data [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [What is Yominet?](https://docs.dune.com/data-catalog/yominet/overview#what-is-yominet) * [Key Features](https://docs.dune.com/data-catalog/yominet/overview#key-features) * [Yominet Data on Dune](https://docs.dune.com/data-catalog/yominet/overview#yominet-data-on-dune) [​](https://docs.dune.com/data-catalog/yominet/overview#what-is-yominet) What is Yominet? -------------------------------------------------------------------------------------------- Yominet is a blockchain network that serves as the foundation for applications like Kamigotchi and other decentralized applications. Yominet uses ETH as gas, making it easy for users familiar with Ethereum to interact with the network. Users can bridge $ETH to Yominet using Initia’s official bridge or gas.zip. Yominet features a flat 0.005 gwei gas fee, providing predictable and low-cost transactions. The network supports popular wallets including Metamask and Rabby, making it accessible to a wide range of users. [​](https://docs.dune.com/data-catalog/yominet/overview#key-features) Key Features ------------------------------------------------------------------------------------- * **Ethereum-Compatible Gas**: Uses $ETH as gas, familiar to Ethereum users * **Low Gas Fees**: Flat 0.005 gwei gas fee for predictable transaction costs * **Wallet Support**: Compatible with Metamask and Rabby wallets * **Easy Bridging**: Bridge $ETH using Initia’s official bridge or gas.zip * **Application Platform**: Supports various decentralized applications including gaming platforms like Kamigotchi [​](https://docs.dune.com/data-catalog/yominet/overview#yominet-data-on-dune) Yominet Data on Dune ----------------------------------------------------------------------------------------------------- Yominet blockchain data is organized into several key tables that capture different aspects of on-chain activity: [Blocks\ ------\ \ Contains each validated block in the chain](https://docs.dune.com/data-catalog/yominet/blocks) [Block Events\ ------------\ \ Contains all block-level events and attributes in the chain, partitioned by event\_index](https://docs.dune.com/data-catalog/yominet/block_events) [Message Events\ --------------\ \ Contains all events and their corresponding attributes partitioned by message\_index](https://docs.dune.com/data-catalog/yominet/message_events) [Transactions\ ------------\ \ Contains relevant data associated with each transaction](https://docs.dune.com/data-catalog/yominet/transactions) [Transaction Messages\ --------------------\ \ Contains all messages submitted to the blockchain](https://docs.dune.com/data-catalog/yominet/tx_messages) Was this page helpful? YesNo [TRC721 Transfers](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers) [Blocks](https://docs.dune.com/data-catalog/yominet/blocks) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Blocks - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/yominet/blocks#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Yominet Blocks [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/yominet/blocks#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/yominet/blocks#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/yominet/blocks#table-sample) [​](https://docs.dune.com/data-catalog/yominet/blocks#table-description) Table Description ============================================================================================= This table contains data about blocks in the Yominet blockchain, including block headers, consensus data, and transaction information. [​](https://docs.dune.com/data-catalog/yominet/blocks#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block, a unique identifier for each block. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the block belongs. | | **proposer\_address** | varchar | The address of the validator proposing the block. | | **validators\_hash** | varchar | The hash of the validators set for the block. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/yominet/blocks#table-sample) Table Sample ----------------------------------------------------------------------------------- Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/yominet/overview) [Block Events](https://docs.dune.com/data-catalog/yominet/block_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # LayerZero - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/layerzero/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation LayerZero LayerZero [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Key Features](https://docs.dune.com/data-catalog/layerzero/overview#key-features) * [LayerZero Data on Dune](https://docs.dune.com/data-catalog/layerzero/overview#layerzero-data-on-dune) LayerZero is a cross-chain messaging protocol that enables the transfer of messages and assets between different blockchain networks. It provides a secure and efficient way for applications to communicate and transfer value across chains. [​](https://docs.dune.com/data-catalog/layerzero/overview#key-features) Key Features --------------------------------------------------------------------------------------- * **Omnichain Interoperability**: Enables seamless communication between different blockchain networks * **Security**: Uses a decentralized network of oracles and validators * **Efficiency**: Optimized for gas efficiency and fast message delivery * **Developer-Friendly**: Simple integration with existing applications * **Wide Chain Support**: Compatible with major EVM and non-EVM chains [​](https://docs.dune.com/data-catalog/layerzero/overview#layerzero-data-on-dune) LayerZero Data on Dune ----------------------------------------------------------------------------------------------------------- [Messages\ --------\ \ Contains all cross-chain messages sent through the LayerZero protocol](https://docs.dune.com/data-catalog/layerzero/messages) [Transfers\ ---------\ \ Contains all cross-chain transfers executed through the LayerZero protocol](https://docs.dune.com/data-catalog/layerzero/transfers) [LayerZero Documentation\ -----------------------\ \ The official documentation for LayerZero, providing detailed information on the protocol, architecture, and developer resources](https://docs.layerzero.network/v2) Was this page helpful? YesNo [Trade Report](https://docs.dune.com/data-catalog/kalshi/trade_report) [Messages](https://docs.dune.com/data-catalog/layerzero/messages) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Block Events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/yominet/block_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Yominet Block Events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/yominet/block_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/yominet/block_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/yominet/block_events#table-sample) [​](https://docs.dune.com/data-catalog/yominet/block_events#table-description) Table Description =================================================================================================== This table contains data about block-level events and attributes in the Yominet blockchain, including event types, sources, and associated metadata. The schema is modeled after Cosmos block events. [​](https://docs.dune.com/data-catalog/yominet/block_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the event occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the block belongs. | | **event\_index** | bigint | A unique index for events within the block. | | **event\_type** | varchar | The type of event that was triggered. | | **event\_source** | varchar | The source of the event. | | **attribute\_key** | varchar | The key of the event attribute. | | **attribute\_value** | varchar | The value of the event attribute. | | **attribute\_index** | bigint | A unique index for attributes within the event. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/yominet/block_events#table-sample) Table Sample ----------------------------------------------------------------------------------------- Was this page helpful? YesNo [Blocks](https://docs.dune.com/data-catalog/yominet/blocks) [Message Events](https://docs.dune.com/data-catalog/yominet/message_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Transactions - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/fuel/transactions#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Fuel Transactions [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/fuel/transactions#table-description) * [Column Description](https://docs.dune.com/data-catalog/fuel/transactions#column-description) * [Table Sample](https://docs.dune.com/data-catalog/fuel/transactions#table-sample) [​](https://docs.dune.com/data-catalog/fuel/transactions#table-description) Table Description ================================================================================================ This table contains data about transactions in the Fuel blockchain, including transaction details, inputs, outputs, and associated metadata. Fuel transactions can be of different types: Script, Create, Mint, or Upgrade transactions. [​](https://docs.dune.com/data-catalog/fuel/transactions#column-description) Column Description -------------------------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | **block\_height** | bigint | The height of the block containing this transaction | | **block\_time** | bigint | The timestamp when the block was created | | **block\_id** | binary | The unique identifier of the block | | **block\_version** | string | The version of the block | | **block\_producer** | binary | The address of the block producer | | **status** | string | The status of the transaction (Success/Failure) | | **id** | binary | The unique identifier of the transaction | | **type** | string | The type of transaction (Script/Create/Mint/Upgrade) | | **tx\_pointer\_block\_height** | bigint | Block height for UTXO validation | | **tx\_pointer\_tx\_index** | int | Transaction index for UTXO validation | | **tx\_pointer** | struct | Reference to previous transaction in UTXO model | | **bytecode\_root** | binary | Root hash of script bytecode | | **bytecode\_witness\_index** | bigint | Index in witnesses array | | **blob\_id** | binary | Identifier for blob transactions | | **maturity** | bigint | Minimum block height for execution | | **mint\_amount** | bigint | Amount of tokens to mint | | **mint\_asset\_id** | binary | Asset identifier for minting | | **mint\_gas\_price** | bigint | Gas price for minting | | **receipts\_root** | binary | Merkle root of transaction receipts | | **salt** | binary | Unique value for transaction | | **script\_gas\_limit** | bigint | Maximum gas for script execution | | **subsection\_index** | bigint | Index in multi-section transaction | | **subsections\_number** | bigint | Total sections in transaction | | **input\_asset\_ids** | array(binary) | Asset IDs used as inputs | | **proof\_set** | array(binary) | Zero-knowledge proofs for validation | | **input\_contract** | struct | Input contract data (balances, state, UTXO) | | **output\_contract** | struct | Output contract data (new balances, state) | | **policies** | struct | Transaction policies (maturity, fees, limits) | | **raw\_payload** | binary | Raw transaction data | | **script** | binary | Compiled script bytecode | | **script\_data** | binary | Script input data | | **storage\_slots** | array(struct) | Contract storage updates | | **upgrade\_purpose** | struct | Contract upgrade details | | **witnesses** | array(binary) | Transaction validation data | | **script\_length** | bigint | Script bytecode length | | **script\_data\_length** | bigint | Script input data length | | **storage\_slots\_count** | bigint | Number of storage updates | | **proof\_set\_count** | bigint | Number of validation proofs | | **witnesses\_count** | bigint | Number of witnesses | | **inputs\_count** | bigint | Number of inputs | | **outputs\_count** | bigint | Number of outputs | | **is\_create** | boolean | Contract creation flag | | **is\_mint** | boolean | Minting transaction flag | | **is\_script** | boolean | Script transaction flag | | **is\_upgrade** | boolean | Contract upgrade flag | | **is\_upload** | boolean | Bytecode upload flag | | **is\_blob** | boolean | Blob transaction flag | | **\_updated\_at** | timestamp | Last update timestamp | | **\_ingested\_at** | timestamp | Ingestion timestamp | [​](https://docs.dune.com/data-catalog/fuel/transactions#table-sample) Table Sample -------------------------------------------------------------------------------------- Was this page helpful? YesNo [Blocks](https://docs.dune.com/data-catalog/fuel/blocks) [Receipts](https://docs.dune.com/data-catalog/fuel/receipts) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Transactions - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/yominet/transactions#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Yominet Transactions [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/yominet/transactions#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/yominet/transactions#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/yominet/transactions#table-sample) [​](https://docs.dune.com/data-catalog/yominet/transactions#table-description) Table Description =================================================================================================== This table contains data about transactions in the Yominet blockchain, including transaction details, gas usage, and execution status. [​](https://docs.dune.com/data-catalog/yominet/transactions#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_height** | bigint | The height of the block where the transaction occurred. | | **chain\_id** | varchar | The ID of the chain where the transaction occurred. | | **tx\_id** | varchar | The unique ID of the transaction. | | **tx\_info** | varchar | Information related to the transaction. | | **tx\_log\_message** | varchar | The log message associated with the transaction. | | **memo** | varchar | A memo associated with the transaction. | | **fee** | varchar | The fee associated with the transaction. | | **tx\_code** | bigint | The result code of the transaction. | | **tx\_index** | bigint | The index of the transaction within the block. | | **gas\_used** | bigint | The amount of gas used by the transaction. | | **gas\_wanted** | bigint | The amount of gas requested by the transaction. | | **schema\_version** | bigint | The schema version for the transaction data. | | **fee\_coins** | varchar | The coins used to pay the transaction fee. | | **fee\_granter** | varchar | The address granting the fee for the transaction. | | **fee\_payer** | varchar | The address paying the fee for the transaction. | | **gas\_limit** | bigint | The gas limit set for the transaction. | | **single\_sign\_mode** | bigint | The signing mode for single-signature transactions. | | **multi\_sign\_json** | varchar | JSON structure for multi-signature transactions. | | **timeout\_height** | varchar | The timeout height set for the transaction. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/yominet/transactions#table-sample) Table Sample ----------------------------------------------------------------------------------------- Was this page helpful? YesNo [Message Events](https://docs.dune.com/data-catalog/yominet/message_events) [Transaction Messages](https://docs.dune.com/data-catalog/yominet/tx_messages) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Blocks - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/fuel/blocks#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Fuel Blocks [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/fuel/blocks#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/fuel/blocks#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/fuel/blocks#table-sample) [​](https://docs.dune.com/data-catalog/fuel/blocks#table-description) Table Description ========================================================================================== This table contains data about blocks in the Fuel blockchain, including block headers, consensus data, and transaction information. [​](https://docs.dune.com/data-catalog/fuel/blocks#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | **block\_time** | bigint | Block creation timestamp | | **block\_date** | date | Block creation date | | **height** | bigint | Block height/number | | **time** | bigint | Unix timestamp | | **transactions\_count** | bigint | Number of transactions | | **transactions\_root** | binary | Merkle root of transactions | | **application\_hash** | binary | Application state hash | | **consensus\_parameters\_version** | bigint | Consensus parameters version | | **da\_height** | bigint | Data availability height | | **event\_inbox\_root** | binary | Event inbox Merkle root | | **id** | binary | Block identifier | | **message\_outbox\_root** | binary | Message outbox Merkle root | | **message\_receipt\_count** | bigint | Number of message receipts | | **prev\_root** | binary | Previous block root | | **state\_transition\_bytecode\_version** | bigint | State transition version | | **version** | string | Block version | | **consensus\_type** | string | Consensus mechanism type | | **poa\_consensus\_data\_signature** | binary | PoA consensus signature | | **producer** | binary | Block producer address | | **\_updated\_at** | timestamp | Last update timestamp | | **\_ingested\_at** | timestamp | Ingestion timestamp | [​](https://docs.dune.com/data-catalog/fuel/blocks#table-sample) Table Sample -------------------------------------------------------------------------------- Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/fuel/overview) [Transactions](https://docs.dune.com/data-catalog/fuel/transactions) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Message Events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/yominet/message_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Yominet Message Events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/yominet/message_events#table-description) * [Table Schema](https://docs.dune.com/data-catalog/yominet/message_events#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/yominet/message_events#table-sample) [​](https://docs.dune.com/data-catalog/yominet/message_events#table-description) Table Description ===================================================================================================== This table contains data about message-related events in the Yominet blockchain, including message types, attributes, and associated metadata. Because block events run on initia, this table just has a few entries by design at this point. [​](https://docs.dune.com/data-catalog/yominet/message_events#table-schema) Table Schema ------------------------------------------------------------------------------------------- | Column name | Description | Type | | --- | --- | --- | | **block\_date** | The date of the block. | date | | **block\_height** | The height of the block where the event occurred. | bigint | | **block\_timestamp** | Timestamp when the block was validated. | timestamp(3) with time zone | | **chain\_id** | The ID of the chain where the block belongs. | varchar | | **tx\_id** | The hash of the transaction where the event occurred. | varchar | | **tx\_index** | The index of the transaction in the block. | bigint | | **message\_index** | The index of the message in the transaction. | bigint | | **event\_index** | A unique index for events within the message. | bigint | | **event\_type** | The type of event that was triggered. | varchar | | **attribute\_key** | The key of the event attribute. | varchar | | **attribute\_value** | The value of the event attribute. | varchar | | **attribute\_index** | A unique index for attributes within the event. | bigint | | **updated\_at** | Timestamp of when the record was last updated. | timestamp(3) with time zone | | **ingested\_at** | Timestamp of when the record was ingested into Dune. | timestamp(3) with time zone | [​](https://docs.dune.com/data-catalog/yominet/message_events#table-sample) Table Sample ------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Block Events](https://docs.dune.com/data-catalog/yominet/block_events) [Transactions](https://docs.dune.com/data-catalog/yominet/transactions) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Fuel Data - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/fuel/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Fuel Fuel Data [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [What is Fuel?](https://docs.dune.com/data-catalog/fuel/overview#what-is-fuel) * [Key Features](https://docs.dune.com/data-catalog/fuel/overview#key-features) * [Fuel Data on Dune](https://docs.dune.com/data-catalog/fuel/overview#fuel-data-on-dune) [​](https://docs.dune.com/data-catalog/fuel/overview#what-is-fuel) What is Fuel? ----------------------------------------------------------------------------------- Fuel is an operating system purpose built for Ethereum Rollups. It implements improvements suggested to the Ethereum VM (EVM) for many years that couldn’t be implemented due to the need to maintain backward compatibility, including parallel transaction execution and multiple native assets. Fuel delivers unmatched processing capacity through its ability to execute transactions in parallel by using strict state access lists in the form of a UTXO model. With the FuelVM, Fuel full nodes identify the accounts a transaction touches, mapping out dependencies before execution. [​](https://docs.dune.com/data-catalog/fuel/overview#key-features) Key Features ---------------------------------------------------------------------------------- * **Parallel Transaction Execution**: Fuel can execute transactions in parallel, significantly increasing throughput * **UTXO Model**: Uses a strict state access list model for efficient transaction processing * **Multiple Native Assets**: Supports multiple native assets natively * **FuelVM**: A purpose-built virtual machine that improves upon the EVM * **Sway Language**: A domain-specific language based on Rust for smart contract development [​](https://docs.dune.com/data-catalog/fuel/overview#fuel-data-on-dune) Fuel Data on Dune -------------------------------------------------------------------------------------------- Fuel blockchain data is organized into several key tables that capture different aspects of on-chain activity: [Blocks\ ------\ \ Core block data including block headers, validators, and block statistics.](https://docs.dune.com/data-catalog/fuel/blocks) [Transactions\ ------------\ \ Detailed transaction data including computation, actions, and state changes.](https://docs.dune.com/data-catalog/fuel/transactions) [Receipts\ --------\ \ Transaction receipts containing execution results and event logs.](https://docs.dune.com/data-catalog/fuel/receipts) Was this page helpful? YesNo [Transaction Messages](https://docs.dune.com/data-catalog/echelon/tx_messages) [Blocks](https://docs.dune.com/data-catalog/fuel/blocks) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Noble Data - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Noble Data [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [What is Noble?](https://docs.dune.com/data-catalog/noble/overview#what-is-noble) * [Key Features](https://docs.dune.com/data-catalog/noble/overview#key-features) * [Noble Data on Dune](https://docs.dune.com/data-catalog/noble/overview#noble-data-on-dune) [​](https://docs.dune.com/data-catalog/noble/overview#what-is-noble) What is Noble? -------------------------------------------------------------------------------------- Noble is a Cosmos application-specific blockchain purpose-built for native asset issuance. It brings the efficiency and interoperability of native assets to the wider Cosmos ecosystem, starting with USDC. Noble’s vision is to be the world’s premier issuance hub for digital assets that connect to other blockchains seamlessly. [​](https://docs.dune.com/data-catalog/noble/overview#key-features) Key Features ----------------------------------------------------------------------------------- * **Native Asset Issuance**: Purpose-built for efficient and secure token issuance * **Cosmos Integration**: Built on Cosmos-SDK for seamless interoperability * **Smart Contract Capabilities**: Industry-standard asset issuance functionality * **IBC Compatibility**: Permissionless connection to other Cosmos chains * **Proof of Authority**: Currently uses a trusted validator set with economic security [​](https://docs.dune.com/data-catalog/noble/overview#noble-data-on-dune) Noble Data on Dune ----------------------------------------------------------------------------------------------- Noble blockchain data is organized into several key tables that capture different aspects of on-chain activity: [Blocks\ ------\ \ Contains each validated block in the chain](https://docs.dune.com/data-catalog/noble/blocks) [Block Events\ ------------\ \ Contains all block-level events and attributes in the chain, partitioned by event\_index](https://docs.dune.com/data-catalog/noble/block_events) [Bridge Transfers\ ----------------\ \ Cross-chain bridge transfer data](https://docs.dune.com/data-catalog/noble/bridge_transfers) [CCTP Transactions\ -----------------\ \ Cross-Chain Transfer Protocol transactions](https://docs.dune.com/data-catalog/noble/cctp_transactions) [Message Events\ --------------\ \ Contains all events and their corresponding attributes partitioned by message\_index](https://docs.dune.com/data-catalog/noble/message_events) [Swaps\ -----\ \ Token swap and liquidity pool data](https://docs.dune.com/data-catalog/noble/swaps) [Transactions\ ------------\ \ Contains relevant data associated with each transaction](https://docs.dune.com/data-catalog/noble/transactions) [Transaction Messages\ --------------------\ \ Contains all messages submitted to the blockchain](https://docs.dune.com/data-catalog/noble/tx_messages) [Validators\ ----------\ \ Maps validator addresses to monikers (human-readable description) and other metadata](https://docs.dune.com/data-catalog/noble/validators) Was this page helpful? YesNo [Validators](https://docs.dune.com/data-catalog/initia/validators) [Blocks](https://docs.dune.com/data-catalog/noble/blocks) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # TRC721 Transfers - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Tokens TRC721 Transfers [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers#table-description) * [Table Schema](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers#table-sample) [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers#table-description) Table description --------------------------------------------------------------------------------------------------------------------- The `TRC721 Transfers` table captures all `Transfer` event logs for TRC721 token transfers on the Tron blockchain. This log is usually emitted when a `transfer` or `TransferFrom` function is called successfully on a TRC721 token contract. [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers#table-schema) Table Schema ----------------------------------------------------------------------------------------------------------- | Column | Type | Description | | --- | --- | --- | | contract\_address | varbinary | Address of the TRC721 (NFT) token contract that emitted this transfer event | | evt\_tx\_hash | varbinary | Hash of the transaction containing this transfer event | | evt\_tx\_from | varbinary | Address of the account that initiated the parent transaction | | evt\_tx\_to | varbinary | Address of the recipient of the parent transaction | | evt\_tx\_index | integer | Position of the parent transaction within its containing block | | evt\_index | bigint | Index position of this event log within the transaction | | evt\_block\_time | timestamp(3) | Timestamp of the block containing this event | | evt\_block\_number | bigint | The block number containing this event | | evt\_block\_date | date | The UTC date of the block containing this event | | from | varbinary | Address sending the TRC721 NFT | | to | varbinary | Address receiving the TRC721 NFT | | tokenid | uint256 | Unique identifier of the specific NFT being transferred | [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers#table-sample) Table Sample ----------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [TRC20 Transfers](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers) [Overview](https://docs.dune.com/data-catalog/yominet/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # layerzero.messages - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/layerzero/messages#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation LayerZero layerzero.messages [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Schema](https://docs.dune.com/data-catalog/layerzero/messages#table-schema) * [Sample Query](https://docs.dune.com/data-catalog/layerzero/messages#sample-query) The `layerzero.messages` table contains all cross-chain messages sent through the LayerZero protocol. Each message represents a cross-chain communication event between source and destination chains. [​](https://docs.dune.com/data-catalog/layerzero/messages#table-schema) Table Schema --------------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | timestampUpdated | timestamp | Timestamp of the last update | | primary\_key | string | Unique identifier for the message | | transfer\_foreign\_key | string | Foreign key reference to the transfer | | tx\_hash\_source | string | Transaction hash on the source chain | | tx\_hash\_destination | string | Transaction hash on the destination chain | | ts\_source | timestamp | Timestamp of the message on source chain | | ts\_destination | timestamp | Timestamp of the message on destination chain | | block\_number\_source | decimal(38,0) | Block number on the source chain | | block\_number\_destination | decimal(38,0) | Block number on the destination chain | | addr\_from | string | Address of the message sender | | usd\_dvn\_fee | double | USD value of the DVN fee | | usd\_executor\_fee | double | USD value of the executor fee | | usd\_value | double | Total USD value of the message | | source\_contract | string | Contract address on the source chain | | source\_chain | string | Source chain identifier | | source\_chain\_key | string | Source chain key | | source\_layer | string | Source chain layer | | destination\_contract | string | Contract address on the destination chain | | destination\_chain | string | Destination chain identifier | | destination\_chain\_key | string | Destination chain key | | destination\_layer | string | Destination chain layer | | project | string | Project identifier | | state | string | Current state of the message | | layerzero\_version | string | Version of LayerZero protocol used | | uln\_version | string | Version of ULN used | | \_updated\_at | timestamp | Last update timestamp | | \_ingested\_at | timestamp | Ingestion timestamp | [​](https://docs.dune.com/data-catalog/layerzero/messages#sample-query) Sample Query --------------------------------------------------------------------------------------- Copy Ask AI -- Get the total number of messages and total value transferred per chain pair SELECT source_chain, destination_chain, COUNT(*) as message_count, SUM(usd_value) as total_value_usd FROM layerzero.messages WHERE ts_source >= NOW() - INTERVAL '7' DAY GROUP BY source_chain, destination_chain ORDER BY total_value_usd DESC LIMIT 10; Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/layerzero/overview) [Transfers](https://docs.dune.com/data-catalog/layerzero/transfers) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # layerzero.transfers - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/layerzero/transfers#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation LayerZero layerzero.transfers [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Schema](https://docs.dune.com/data-catalog/layerzero/transfers#table-schema) * [Sample Query](https://docs.dune.com/data-catalog/layerzero/transfers#sample-query) The `layerzero.transfers` table contains all cross-chain transfers executed through the LayerZero protocol. Each transfer represents a value transfer event between source and destination chains. [​](https://docs.dune.com/data-catalog/layerzero/transfers#table-schema) Table Schema ---------------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | timestampUpdated | timestamp | Timestamp of the last update | | primary\_key | string | Unique identifier for the transfer | | messages\_foreign\_key | string | Foreign key reference to the associated message | | addr\_to | string | Recipient address | | type\_transfer | string | Type of transfer | | symbol | string | Token symbol | | token | string | Token address | | usd\_value | double | USD value of the transfer | | \_updated\_at | timestamp | Last update timestamp | | \_ingested\_at | timestamp | Ingestion timestamp | [​](https://docs.dune.com/data-catalog/layerzero/transfers#sample-query) Sample Query ---------------------------------------------------------------------------------------- Copy Ask AI -- Get the top tokens by volume transferred in the last 24 hours SELECT symbol, COUNT(*) as transfer_count, SUM(usd_value) as total_volume_usd FROM layerzero.transfers WHERE timestampUpdated >= NOW() - INTERVAL '24' HOUR GROUP BY symbol ORDER BY total_volume_usd DESC LIMIT 10; Was this page helpful? YesNo [Messages](https://docs.dune.com/data-catalog/layerzero/messages) [Overview](https://docs.dune.com/data-catalog/succinct/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Blocks - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/blocks#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Blocks [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/blocks#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/noble/blocks#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/noble/blocks#table-sample) [​](https://docs.dune.com/data-catalog/noble/blocks#table-description) Table Description =========================================================================================== This table contains data about blocks in the Noble blockchain, including block headers, consensus data, and transaction information. [​](https://docs.dune.com/data-catalog/noble/blocks#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block, a unique identifier for each block. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the block belongs. | | **proposer\_address** | varchar | The address of the validator proposing the block. | | **validators\_hash** | varchar | The hash of the validators set for the block. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/noble/blocks#table-sample) Table Sample --------------------------------------------------------------------------------- Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/noble/overview) [Block Events](https://docs.dune.com/data-catalog/noble/block_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Block Events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/block_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Block Events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/block_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/noble/block_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/noble/block_events#table-sample) [​](https://docs.dune.com/data-catalog/noble/block_events#table-description) Table Description ================================================================================================= This table contains data about block-level events and attributes in the Noble blockchain, including event types, sources, and associated metadata. The schema is modeled after Sei’s Cosmos block events but adapted for Noble’s context. [​](https://docs.dune.com/data-catalog/noble/block_events#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the event occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the block belongs. | | **event\_index** | bigint | A unique index for events within the block. | | **event\_type** | varchar | The type of event that was triggered. | | **event\_source** | varchar | The source of the event. | | **attribute\_key** | varchar | The key of the event attribute. | | **attribute\_value** | varchar | The value of the event attribute. | | **attribute\_index** | bigint | A unique index for attributes within the event. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/noble/block_events#table-sample) Table Sample --------------------------------------------------------------------------------------- Was this page helpful? YesNo [Blocks](https://docs.dune.com/data-catalog/noble/blocks) [Bridge Transfers](https://docs.dune.com/data-catalog/noble/bridge_transfers) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Bridge Transfers - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/bridge_transfers#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Bridge Transfers [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/bridge_transfers#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/noble/bridge_transfers#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/noble/bridge_transfers#table-sample) [​](https://docs.dune.com/data-catalog/noble/bridge_transfers#table-description) Table Description ===================================================================================================== This table contains data about cross-chain bridge transfers in the Noble blockchain, including transfer details, source and destination chains, and transfer status. [​](https://docs.dune.com/data-catalog/noble/bridge_transfers#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the transfer occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **tx\_id** | varchar | The unique ID of the transaction. | | **tx\_index** | bigint | The index of the transaction in the block. | | **message\_index** | bigint | The index of the message in the transaction. | | **event\_index** | bigint | The index of the event in the message. | | **action\_index** | bigint | The index of the action in the event. | | **sender** | varchar | The address of the sender. | | **receiver** | varchar | The address of the receiver. | | **token\_amount** | decimal(38, 0) | The amount of tokens transferred. | | **token\_denom** | varchar | The denomination of the token. | | **src\_domain** | varchar | The source domain of the transfer. | | **dst\_domain** | varchar | The destination domain of the transfer. | | **protocol** | varchar | The protocol used for the transfer. | | **protocol\_metadata** | varchar | Additional metadata related to the protocol. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/noble/bridge_transfers#table-sample) Table Sample ------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Block Events](https://docs.dune.com/data-catalog/noble/block_events) [CCTP Transactions](https://docs.dune.com/data-catalog/noble/cctp_transactions) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # CCTP Transactions - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/cctp_transactions#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble CCTP Transactions [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/cctp_transactions#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/noble/cctp_transactions#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/noble/cctp_transactions#table-sample) [​](https://docs.dune.com/data-catalog/noble/cctp_transactions#table-description) Table Description ====================================================================================================== This table contains data about Cross-Chain Transfer Protocol (CCTP) transactions in the Noble blockchain, including token transfers, source and destination chains, and transfer status. [​](https://docs.dune.com/data-catalog/noble/cctp_transactions#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the transaction occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **tx\_id** | varchar | The unique ID of the transaction. | | **tx\_index** | bigint | The index of the transaction in the block. | | **message\_index** | bigint | The index of the message in the transaction. | | **event\_index** | bigint | The index of the event in the message. | | **action\_index** | bigint | The index of the action in the event. | | **sender** | varchar | The address of the sender. | | **receiver** | varchar | The address of the receiver. | | **token\_amount** | decimal(38, 0) | The amount of tokens transferred. | | **token\_denom** | varchar | The denomination of the token. | | **src\_domain** | varchar | The source domain of the transaction. | | **dst\_domain** | varchar | The destination domain of the transaction. | | **authorized\_caller** | varchar | The address of the authorized caller. | | **contract** | varchar | The contract address involved in the transaction. | | **nonce** | varchar | The nonce associated with the transaction. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/noble/cctp_transactions#table-sample) Table Sample -------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Bridge Transfers](https://docs.dune.com/data-catalog/noble/bridge_transfers) [Message Events](https://docs.dune.com/data-catalog/noble/message_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Transaction Messages - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/tx_messages#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Transaction Messages [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/tx_messages#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/noble/tx_messages#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/noble/tx_messages#table-sample) [​](https://docs.dune.com/data-catalog/noble/tx_messages#table-description) Table Description ================================================================================================ This table contains data about messages contained within transactions in the Noble blockchain, including message types, content, and associated metadata. On execution, transactions from Cosmos emit data in two formats: * Messages (`noble.tx_messages`): These provide a high-level, readable summary of actions, such as “send money” or “execute contract.” They are easier to understand and track transaction types. * Events (`noble.message_events`): These capture detailed, low-level changes at the chain level, including underlying blockchain modifications that may not always be directly related to state changes. * Use Messages for a general overview and Events when you need detailed insights. The two tables are complementary. [​](https://docs.dune.com/data-catalog/noble/tx_messages#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the message occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **chain\_id** | varchar | The ID of the chain where the message belongs. | | **tx\_id** | varchar | The hash of the transaction containing the message. | | **tx\_index** | bigint | The index of the transaction in the block. | | **message\_index** | bigint | The index of the message in the transaction. | | **message\_type** | varchar | The type of message. | | **message** | varchar | The value/content of the message. | | **schema\_version** | bigint | The version of the schema in provider database. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/noble/tx_messages#table-sample) Table Sample -------------------------------------------------------------------------------------- Was this page helpful? YesNo [Transactions](https://docs.dune.com/data-catalog/noble/transactions) [Validators](https://docs.dune.com/data-catalog/noble/validators) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Message Events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/message_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Message Events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/message_events#table-description) * [Table Schema](https://docs.dune.com/data-catalog/noble/message_events#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/noble/message_events#table-sample) [​](https://docs.dune.com/data-catalog/noble/message_events#table-description) Table Description =================================================================================================== This table contains data about message-related events in the Noble blockchain, including message types, attributes, and associated metadata. [​](https://docs.dune.com/data-catalog/noble/message_events#table-schema) Table Schema ----------------------------------------------------------------------------------------- | Column name | Description | Type | | --- | --- | --- | | **block\_date** | The date of the block. | date | | **block\_height** | The height of the block where the event occurred. | bigint | | **block\_timestamp** | Timestamp when the block was validated. | timestamp(3) with time zone | | **chain\_id** | The ID of the chain where the block belongs. | varchar | | **tx\_id** | The hash of the transaction where the event occurred. | varchar | | **tx\_index** | The index of the transaction in the block. | bigint | | **message\_index** | The index of the message in the transaction. | bigint | | **event\_index** | A unique index for events within the message. | bigint | | **event\_type** | The type of event that was triggered. | varchar | | **attribute\_key** | The key of the event attribute. | varchar | | **attribute\_value** | The value of the event attribute. | varchar | | **attribute\_index** | A unique index for attributes within the event. | bigint | | **updated\_at** | Timestamp of when the record was last updated. | timestamp(3) with time zone | | **ingested\_at** | Timestamp of when the record was ingested into Dune. | timestamp(3) with time zone | [​](https://docs.dune.com/data-catalog/noble/message_events#table-sample) Table Sample ----------------------------------------------------------------------------------------- Was this page helpful? YesNo [CCTP Transactions](https://docs.dune.com/data-catalog/noble/cctp_transactions) [Swaps](https://docs.dune.com/data-catalog/noble/swaps) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Validators - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/validators#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Validators [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/validators#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/noble/validators#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/noble/validators#table-sample) [​](https://docs.dune.com/data-catalog/noble/validators#table-description) Table Description =============================================================================================== This table contains data about validators in the Noble blockchain, including their performance metrics, voting power, and status. [​](https://docs.dune.com/data-catalog/noble/validators#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **operator\_address** | varchar | The operator address of the validator. | | **account\_address** | varchar | The account address of the validator. | | **consensus\_pubkey** | varchar | The consensus public key of the validator. | | **jailed** | boolean | Indicates whether the validator is jailed. | | **status** | varchar | The status of the validator (e.g., active, inactive). | | **tokens** | varchar | The number of tokens held by the validator. | | **moniker** | varchar | The moniker or name of the validator. | | **identity** | varchar | The identity information of the validator. | | **website** | varchar | The website of the validator. | | **security\_contact** | varchar | The security contact information for the validator. | | **details** | varchar | Additional details about the validator. | | **unbonding\_height** | bigint | The block height at which the validator started unbonding. | | **unbonding\_time** | varchar | The time when the validator will complete unbonding. | | **commission\_rate** | double | The commission rate charged by the validator. | | **commission\_max\_rate** | double | The maximum commission rate allowed for the validator. | | **commission\_max\_change\_rate** | double | The maximum rate at which the validator can change its commission. | | **commission\_update\_time** | varchar | The time when the validator last updated its commission. | | **min\_self\_delegation** | varchar | The minimum self-delegation required for the validator. | | **snapshot\_height** | bigint | The block height at which the snapshot was taken. | | **snapshot\_time** | varchar | The time when the snapshot was taken. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/noble/validators#table-sample) Table Sample ------------------------------------------------------------------------------------- Was this page helpful? YesNo [Transaction Messages](https://docs.dune.com/data-catalog/noble/tx_messages) [Overview](https://docs.dune.com/data-catalog/peaq/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Swaps - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/swaps#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Swaps [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/swaps#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/noble/swaps#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/noble/swaps#table-sample) [​](https://docs.dune.com/data-catalog/noble/swaps#table-description) Table Description ========================================================================================== This table contains data about token swap transactions in the Noble blockchain, including swap details, token pairs, and execution status. [​](https://docs.dune.com/data-catalog/noble/swaps#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_date** | date | The date of the block. | | **block\_height** | bigint | The height of the block where the swap occurred. | | **block\_timestamp** | timestamp(3) with time zone | Timestamp when the block was validated. | | **tx\_id** | varchar | The unique ID of the transaction. | | **tx\_index** | bigint | The index of the transaction in the block. | | **message\_index** | bigint | The index of the message in the transaction. | | **event\_index** | bigint | The index of the event in the message. | | **action\_index** | bigint | The index of the action in the event. | | **sender** | varchar | The address of the sender. | | **token\_amount\_in** | decimal(38, 0) | The amount of tokens swapped in. | | **token\_denom\_in** | varchar | The denomination of the token swapped in. | | **token\_amount\_out** | decimal(38, 0) | The amount of tokens swapped out. | | **token\_denom\_out** | varchar | The denomination of the token swapped out. | | **routes** | varchar | The routes used for the swap. | | **fees** | varchar | The fees associated with the swap. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/noble/swaps#table-sample) Table Sample -------------------------------------------------------------------------------- Was this page helpful? YesNo [Message Events](https://docs.dune.com/data-catalog/noble/message_events) [Transactions](https://docs.dune.com/data-catalog/noble/transactions) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Transactions - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/noble/transactions#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Noble Transactions [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/noble/transactions#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/noble/transactions#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/noble/transactions#table-sample) [​](https://docs.dune.com/data-catalog/noble/transactions#table-description) Table Description ================================================================================================= This table contains data about transactions in the Noble blockchain, including transaction details, gas usage, and execution status. [​](https://docs.dune.com/data-catalog/noble/transactions#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------- | Column name | Data Type | Description | | --- | --- | --- | | **block\_height** | bigint | The height of the block where the transaction occurred. | | **chain\_id** | varchar | The ID of the chain where the transaction occurred. | | **tx\_id** | varchar | The unique ID of the transaction. | | **tx\_info** | varchar | Information related to the transaction. | | **tx\_log\_message** | varchar | The log message associated with the transaction. | | **memo** | varchar | A memo associated with the transaction. | | **fee** | varchar | The fee associated with the transaction. | | **tx\_code** | bigint | The result code of the transaction. | | **tx\_index** | bigint | The index of the transaction within the block. | | **gas\_used** | bigint | The amount of gas used by the transaction. | | **gas\_wanted** | bigint | The amount of gas requested by the transaction. | | **schema\_version** | bigint | The schema version for the transaction data. | | **fee\_coins** | varchar | The coins used to pay the transaction fee. | | **fee\_granter** | varchar | The address granting the fee for the transaction. | | **fee\_payer** | varchar | The address paying the fee for the transaction. | | **gas\_limit** | bigint | The gas limit set for the transaction. | | **single\_sign\_mode** | bigint | The signing mode for single-signature transactions. | | **multi\_sign\_json** | varchar | JSON structure for multi-signature transactions. | | **timeout\_height** | varchar | The timeout height set for the transaction. | | **updated\_at** | timestamp(3) with time zone | Timestamp of when the record was last updated. | | **ingested\_at** | timestamp(3) with time zone | Timestamp of when the record was ingested into Dune. | [​](https://docs.dune.com/data-catalog/noble/transactions#table-sample) Table Sample --------------------------------------------------------------------------------------- Was this page helpful? YesNo [Swaps](https://docs.dune.com/data-catalog/noble/swaps) [Transaction Messages](https://docs.dune.com/data-catalog/noble/tx_messages) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Tokens - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/tokens/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Tokens Tokens [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Data Catalog](https://docs.dune.com/data-catalog/tron/tokens/overview#data-catalog) Tron adheres to the Ethereum Virtual Machine (EVM) standards for token creation and management. These standards define the rules and interfaces that smart contracts must follow in order to create and manage tokens on the blockchain. The most common token standards include: * [ERC20](https://eips.ethereum.org/EIPS/eip-20) * [ERC721](https://eips.ethereum.org/EIPS/eip-721) * [ERC1155](https://eips.ethereum.org/EIPS/eip-1155) ERC20 tokens are fungible, meaning that each token is identical to every other token. ERC721 tokens are non-fungible, meaning that each token is unique. ERC1155 tokens are a hybrid of the two, allowing for both fungible and non-fungible tokens to be created. On Tron, these standards are called **TRC20**, **TRC721**, and **TRC1155**, respectively. Additionally, there is also the native asset of the TVM, `TRX`, which is used to pay for transaction fees. TRX is not an ERC20 token, but it is still a digital asset that can be transferred and owned by users. [​](https://docs.dune.com/data-catalog/tron/tokens/overview#data-catalog) Data Catalog ----------------------------------------------------------------------------------------- The following datasets are available for exploring the landscape of digital assets on the blockchain: [TRC20\ -----\ \ All TRC20 token transfers that have occurred on the network.](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers) [TRC721\ ------\ \ All TRC721 token transfers that have occurred on the network.](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers) [TRC1155\ -------\ \ All TRC1155 token transfers that have occurred on the network.](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers) Was this page helpful? YesNo [Tether](https://docs.dune.com/data-catalog/tron/tether) [TRC1155 Transfers](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # USDT on tron - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/tether#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Tron USDT on tron [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Data Overview](https://docs.dune.com/data-catalog/tron/tether#data-overview) * [Example queries](https://docs.dune.com/data-catalog/tron/tether#example-queries) * [Daily transfer count of USDT on Tron.](https://docs.dune.com/data-catalog/tron/tether#daily-transfer-count-of-usdt-on-tron) * [Daily transfer volume of USDT on Tron.](https://docs.dune.com/data-catalog/tron/tether#daily-transfer-volume-of-usdt-on-tron) USDT is a stablecoin pegged to the US dollar. It is issued by Tether, a company that has issued several stablecoins on different blockchains. USDT on Tron is a TRC-20 token, which means it is issued on the Tron network. USDT on Tron is the most popular stablecoin that is used in the real world. It is used by traders, investors, and businesses to transfer value across the world. On Dune, you can explore USDT on Tron data, including the number of transactions, the number of holders, and the total supply. technically, Tether belongs to the [decoded category](https://docs.dune.com/data-catalog/tron/decoded) , but Tether is >90% of activity on Tron, so we decided to give it its own page [​](https://docs.dune.com/data-catalog/tron/tether#data-overview) Data Overview ---------------------------------------------------------------------------------- The [USDT smart contract](https://tronscan.org/#/token20/TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t) on the Tron network is a TRC-20 token contract. It is used to issue and manage USDT tokens on the Tron network. The contract has several functions that allow users to transfer, issue, and manage USDT tokens. The contract also has several events that are logged when certain actions are performed. These events can be used to track the history of the contract and the USDT tokens that are issued by it. These are the events that are logged by the USDT contract on the Tron network and their respective descriptions: * `tether_tron.tether_usd_evt_addedblacklist`: Records events where addresses are added to the blacklist by the contract. This could imply restrictions on transactions for the addresses involved. * `tether_tron.tether_usd_evt_approval`: Logs approval events, indicating when a user has allowed another account to withdraw a certain amount of USDT on their behalf. * `tether_tron.tether_usd_evt_deprecate`: Captures instances where the contract has been deprecated, which might happen when a contract is upgraded or migrated. * `tether_tron.tether_usd_evt_destroyedblackfunds`: Details events where funds from blacklisted addresses are destroyed or removed from circulation by the contract. * `tether_tron.tether_usd_evt_issue`: Contains records of issue events, where new USDT tokens are created and issued within the ecosystem. * `tether_tron.tether_usd_evt_ownershipttransferred`: Logs the transfer of contract ownership events, which indicates a change in who can execute administrative functions on the contract. * `tether_tron.tether_usd_evt_params`: Stores data related to changes in the contract’s operational parameters, which could include things like fees, transaction limits, or other configuration settings. * `tether_tron.tether_usd_evt_pause`: Details when the contract has been paused, which prevents all transfers, issuances, and blacklisting until it is unpaused. * `tether_tron.tether_usd_evt_removedblacklist`: Logs events where addresses are removed from the blacklist, usually re-enabling their ability to execute transactions. * `tether_tron.tether_usd_evt_transfer`: Tracks transfer events between addresses, a core functionality for a token contract, logging the sender, receiver, and amount. * `tether_tron.tether_usd_evt_unpause`: Captures the moments when the contract’s pause is lifted, thereby resuming normal operations and transactions. You can query all of these tables in the `tether_tron` schema in the Dune database. [​](https://docs.dune.com/data-catalog/tron/tether#example-queries) Example queries -------------------------------------------------------------------------------------- ### [​](https://docs.dune.com/data-catalog/tron/tether#daily-transfer-count-of-usdt-on-tron) Daily transfer count of USDT on Tron. Copy Ask AI SELECT date_trunc('day', evt_block_time) as day, count(*) as transfer_count FROM tether_tron.Tether_USD_evt_transfer where evt_block_time > now() - interval '10' day group by 1 ### [​](https://docs.dune.com/data-catalog/tron/tether#daily-transfer-volume-of-usdt-on-tron) Daily transfer volume of USDT on Tron. Copy Ask AI SELECT date_trunc('day', evt_block_time) as day, sum(value/1e6) as transfer_volume FROM tether_tron.Tether_USD_evt_transfer where evt_block_time > now() - interval '10' day group by 1 Was this page helpful? YesNo [Transactions](https://docs.dune.com/data-catalog/tron/raw/transactions) [Overview](https://docs.dune.com/data-catalog/tron/tokens/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # TRC20 Transfers - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Tokens TRC20 Transfers [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers#table-description) * [Table Schema](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers#table-sample) [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers#table-description) Table description -------------------------------------------------------------------------------------------------------------------- The `TRC20 Transfers` table captures all `Transfer` event logs for TRC20 token transfers on the Tron blockchain. This log is usually emitted when a `transfer` or `TransferFrom` function is called successfully on a TRC20 token contract. [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers#table-schema) Table Schema ---------------------------------------------------------------------------------------------------------- | Column | Type | Description | | --- | --- | --- | | contract\_address | varbinary | Address of the TRC20 token contract that emitted this transfer event | | evt\_tx\_hash | varbinary | Hash of the transaction containing this transfer event | | evt\_tx\_from | varbinary | Address of the account that initiated the parent transaction | | evt\_tx\_to | varbinary | Address of the recipient of the parent transaction | | evt\_tx\_index | integer | Position of the parent transaction within its containing block | | evt\_index | bigint | Index position of this event log within the transaction | | evt\_block\_time | timestamp(3) | Timestamp of the block containing this event | | evt\_block\_number | bigint | The block number containing this event | | evt\_block\_date | date | The UTC date of the block containing this event | | from | varbinary | Address sending the TRC20 tokens | | to | varbinary | Address receiving the TRC20 tokens | | value | uint256 | Amount of TRC20 tokens transferred, in the token’s smallest unit | [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers#table-sample) Table Sample ---------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [TRC1155 Transfers](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers) [TRC721 Transfers](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc721-transfers) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # TRON Overview - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Tron TRON Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Data Catalog](https://docs.dune.com/data-catalog/tron/overview#data-catalog) TRON is an EVM-compatible Layer1 blockchain that uses a Delegated Proof of Stake (DPoS) consensus mechanism, where 27 Super Representatives are elected to validate transactions and produce blocks. The TRON network has a native token called TRX, which is used to pay for transactions and smart contract execution. TRON also supports the creation of custom tokens, which can be used for various purposes such as fundraising and governance. TRON’s smart contract platform is compatible with the Ethereum Virtual Machine (EVM), which allows developers to deploy Solidity smart contracts on TRON. Dune provides raw, decoded and aggregated data for the TRON network, including event logs, blocks, transactions, tokens and Tether on TRON. The datasets are similar to our EVM chains, but without internal transactions and traces as the TRON clients do not provide this data. [​](https://docs.dune.com/data-catalog/tron/overview#data-catalog) Data Catalog ---------------------------------------------------------------------------------- [Logs\ ----\ \ Event logs from smart contracts](https://docs.dune.com/data-catalog/tron/raw/logs) [Blocks\ ------\ \ Block information and statistics](https://docs.dune.com/data-catalog/tron/raw/blocks) [Transactions\ ------------\ \ Transaction details](https://docs.dune.com/data-catalog/tron/raw/transactions) [decoded\ -------\ \ Human readable smart contract activity](https://docs.dune.com/data-catalog/tron/decoded) [Tokens\ ------\ \ Data for TRC tokens](https://docs.dune.com/data-catalog/tron/tokens/overview) [Tether\ ------\ \ Data for Tether on TRON](https://docs.dune.com/data-catalog/tron/tether) Was this page helpful? YesNo [Aggregated Metrics Daily](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily) [Decoded Contracts](https://docs.dune.com/data-catalog/tron/decoded/contracts) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # TRC1155 Transfers - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Tokens TRC1155 Transfers [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers#table-description) * [Table Schema](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers#table-sample) [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers#table-description) Table description ---------------------------------------------------------------------------------------------------------------------- The `TRC1155 Transfers` table captures all `Transfer` event logs for TRC1155 token transfers on the Tron blockchain. This log is emitted when a `transfer` or `TransferFrom` function is called successfully on a TRC1155 token contract. [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers#table-schema) Table Schema ------------------------------------------------------------------------------------------------------------ | Column | Type | Description | | --- | --- | --- | | contract\_address | varbinary | Address of the TRC1155 token contract that emitted this transfer event | | evt\_tx\_hash | varbinary | Hash of the transaction containing this transfer event | | evt\_tx\_from | varbinary | Address of the account that initiated the parent transaction | | evt\_tx\_to | varbinary | Address of the recipient of the parent transaction | | evt\_tx\_index | integer | Position of the parent transaction within its containing block | | evt\_index | bigint | Index position of this event log within the transaction | | evt\_block\_time | timestamp(3) | Timestamp of the block containing this event | | evt\_block\_number | bigint | The block number containing this event | | evt\_block\_date | date | The UTC date of the block containing this event | | from | varbinary | Address sending the TRC1155 tokens | | id | uint256 | Token type identifier for the specific TRC1155 token being transferred | | operator | varbinary | Address approved to execute the transfer on behalf of the sender | | to | varbinary | Address receiving the TRC1155 tokens | | value | uint256 | Quantity of the specified token type transferred | [​](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc1155-transfers#table-sample) Table Sample ------------------------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/tron/tokens/overview) [TRC20 Transfers](https://docs.dune.com/data-catalog/tron/tokens/transfers/erc20-transfers) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Succinct - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/succinct/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Succinct Succinct [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Key Features](https://docs.dune.com/data-catalog/succinct/overview#key-features) * [Protocol Architecture](https://docs.dune.com/data-catalog/succinct/overview#protocol-architecture) * [Succinct Data on Dune](https://docs.dune.com/data-catalog/succinct/overview#succinct-data-on-dune) Succinct is a protocol on Ethereum that proves the world’s software. It coordinates hardware teams, infrastructure operators, and application developers to facilitate the generation of zero knowledge proofs. Application developers send programs in normal code that are wrapped with SP1 to the Succinct Network, allowing infrastructure and hardware teams (jointly called provers) to compete to generate proofs of the programs’ execution. [​](https://docs.dune.com/data-catalog/succinct/overview#key-features) Key Features -------------------------------------------------------------------------------------- * **Decentralized Prover Network**: The world’s first decentralized protocol for ZK proving, enabling permissionless participation * **High Performance Architecture**: Verifiable application (vApp) that settles to Ethereum with off-chain auctioneer service and on-chain settlement contracts * **Competitive Pricing**: Auction-based mechanism where provers compete to generate proofs at the lowest cost * **PROVE Token**: Native token enabling payments, incentivizing provers, and securing the network through staking and governance * **Universal Compatibility**: Supports ZK rollups, bridges, games, oracles, AI agents, and more [​](https://docs.dune.com/data-catalog/succinct/overview#protocol-architecture) Protocol Architecture -------------------------------------------------------------------------------------------------------- The Succinct Network operates as a global, two-sided marketplace composed of provers and requesters. Provers compete to generate ZK proofs of programs submitted by requesters through an auction mechanism called proof contests. The network is architected as a verifiable application that settles to Ethereum, providing high performance while maintaining verifiability. [​](https://docs.dune.com/data-catalog/succinct/overview#succinct-data-on-dune) Succinct Data on Dune -------------------------------------------------------------------------------------------------------- [Bids\ ----\ \ Contains all proof generation bids submitted by provers in the network](https://docs.dune.com/data-catalog/succinct/bids) [Requests\ --------\ \ Contains all proof requests submitted by application developers](https://docs.dune.com/data-catalog/succinct/requests) [Succinct Documentation\ ----------------------\ \ The official documentation for Succinct, providing detailed information on the protocol, architecture, and developer resources](https://docs.succinct.xyz/docs/protocol/what-is-succinct) Was this page helpful? YesNo [Transfers](https://docs.dune.com/data-catalog/layerzero/transfers) [Bids](https://docs.dune.com/data-catalog/succinct/bids) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Peaq Overview - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/peaq/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Peaq Peaq Overview [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [What is Peaq?](https://docs.dune.com/data-catalog/peaq/overview#what-is-peaq) * [Peaq Data on Dune](https://docs.dune.com/data-catalog/peaq/overview#peaq-data-on-dune) [​](https://docs.dune.com/data-catalog/peaq/overview#what-is-peaq) What is Peaq? ----------------------------------------------------------------------------------- Peaq is a layer-1 blockchain purpose-built and optimized to power the Machine Economy. The platform enables: DePINs ------ Decentralized Physical Infrastructure Networks DePAI ----- Decentralized Physical AI Machine DeFi ------------ Decentralized Finance based on machines’ on-chain economic value and activity Machine RWAs ------------ Tokenized machines bringing real-world economic value on-chain By leveraging parallelized block production, asynchronous backing, and agile core time, peaq currently handles up to 10,000 transactions per second (TPS). It is set to scale beyond 100,000 TPS after future upgrades, all while maintaining a minimum transaction cost of approximately $0.00025. peaq leverages the world’s environmentally-friendliest blockchain architecture and leverages one of the highest Nakamoto Coefficients in the industry to ensure censorship resistance. peaq offers a comprehensive suite of ready-to-use Modular DePIN and DePAI Functions, granting builders and machines essential core functionalities to leverage for seamless deployment. These include self-sovereign machine IDs, role-based access control, data verification, universal machine time, seamless machine payment processing, data storage, data indexing, AI agents, and more. All functions are accessible via the peaq SDK, allowing developers to deploy them with just ~15 lines of code. [​](https://docs.dune.com/data-catalog/peaq/overview#peaq-data-on-dune) Peaq Data on Dune -------------------------------------------------------------------------------------------- Peaq blockchain data is organized into several key tables that capture different aspects of on-chain activity: [Blocks\ ------\ \ Core block data including block headers, validators, and block statistics.](https://docs.dune.com/data-catalog/peaq/blocks) [Extrinsics\ ----------\ \ Detailed transaction data, encompassing both signed and unsigned operations, directly invoking pallet functions.](https://docs.dune.com/data-catalog/peaq/extrinsics) [Events\ ------\ \ All events emitted by the runtime, including system events, and events from all pallets.](https://docs.dune.com/data-catalog/peaq/events) [Calls\ -----\ \ Comprehensive info on function calls, expanding top-level extrinsics with internal calls.](https://docs.dune.com/data-catalog/peaq/calls) [Transfers\ ---------\ \ Complete ledger of asset transfers across the network, capturing the movement of tokens between accounts.](https://docs.dune.com/data-catalog/peaq/transfers) [Balances\ --------\ \ Daily snapshots capturing the state of user assets, reflecting the end-of-day balances.](https://docs.dune.com/data-catalog/peaq/balances) [Peaq Documentation\ ------------------\ \ Official documentation for developers building on Peaq](https://docs.peaq.xyz/build/introduction) Was this page helpful? YesNo [Validators](https://docs.dune.com/data-catalog/noble/validators) [Blocks](https://docs.dune.com/data-catalog/peaq/blocks) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # tron.logs - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/raw/logs#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Raw tron.logs [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/tron/raw/logs#table-description) * [Table Schema](https://docs.dune.com/data-catalog/tron/raw/logs#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/tron/raw/logs#table-sample) * [Examples](https://docs.dune.com/data-catalog/tron/raw/logs#examples) * [Filter the logs for a specific contract](https://docs.dune.com/data-catalog/tron/raw/logs#filter-the-logs-for-a-specific-contract) * [Filter the logs for a specific topic](https://docs.dune.com/data-catalog/tron/raw/logs#filter-the-logs-for-a-specific-topic) * [Show the logs of a specific block](https://docs.dune.com/data-catalog/tron/raw/logs#show-the-logs-of-a-specific-block) [​](https://docs.dune.com/data-catalog/tron/raw/logs#table-description) Table Description -------------------------------------------------------------------------------------------- The `tron.logs` table represents the logs generated by the Tron Virtual Machine (TVM) when a contract is executed. Logs are a way to store data on the blockchain. Logs originate from events that occur during the execution of a smart contract. A log consists of: * topic list: a list of 0 to 4 32-byte data topics. `Topic0` is the hash of the signature of the event (indexed), and the remaining topics are indexed parameters of the event. * data: contains non-indexed data. While working with raw logs is possible, we recommend to work with [decoded logs](https://docs.dune.com/data-catalog/tron/decoded/event-logs) for a more user-friendly experience. [​](https://docs.dune.com/data-catalog/tron/raw/logs#table-schema) Table Schema ---------------------------------------------------------------------------------- | Column | Type | Description | | --- | --- | --- | | block\_time | timestamp(3) | The exact UTC timestamp when the block containing this log was added to the chain | | block\_number | bigint | The sequential number of the block containing this log | | block\_hash | varbinary | Unique identifier (hash) of the block containing this log | | contract\_address | varbinary | Address of the smart contract that emitted this log | | topic0 | varbinary | First 32-byte topic, typically the keccak256 hash of the event signature | | topic1 | varbinary | Second 32-byte topic, containing the first indexed event parameter | | topic2 | varbinary | Third 32-byte topic, containing the second indexed event parameter | | topic3 | varbinary | Fourth 32-byte topic, containing the third indexed event parameter | | data | varbinary | ABI-encoded data containing non-indexed event parameters | | tx\_hash | varbinary | Unique identifier (hash) of the transaction that generated this log | | index | integer | Position of this log within the block | | tx\_index | integer | Position of the parent transaction within its containing block | | block\_date | date | The UTC date of the block in which this log was included | | tx\_from | varbinary | Address of the account that initiated the transaction containing this log | | tx\_to | varbinary | Address of the recipient account or contract for the transaction containing this log | [​](https://docs.dune.com/data-catalog/tron/raw/logs#table-sample) Table Sample ---------------------------------------------------------------------------------- [​](https://docs.dune.com/data-catalog/tron/raw/logs#examples) Examples -------------------------------------------------------------------------- ### [​](https://docs.dune.com/data-catalog/tron/raw/logs#filter-the-logs-for-a-specific-contract) Filter the logs for a specific contract Copy Ask AI select * from tron.logs where contract_address = 0x06012c8cf97bead5deae237070f9587f8e7a266d limit 10 ### [​](https://docs.dune.com/data-catalog/tron/raw/logs#filter-the-logs-for-a-specific-topic) Filter the logs for a specific topic Copy Ask AI select * from tron.logs where topic0 = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef ### [​](https://docs.dune.com/data-catalog/tron/raw/logs#show-the-logs-of-a-specific-block) Show the logs of a specific block Copy Ask AI SELECT * FROM tron.logs WHERE evt_block_number = 1000000 Was this page helpful? YesNo [Blocks](https://docs.dune.com/data-catalog/tron/raw/blocks) [Transactions](https://docs.dune.com/data-catalog/tron/raw/transactions) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # tron.transactions - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/raw/transactions#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Raw tron.transactions [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/tron/raw/transactions#table-description) * [Table Schema](https://docs.dune.com/data-catalog/tron/raw/transactions#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/tron/raw/transactions#table-sample) * [Examples](https://docs.dune.com/data-catalog/tron/raw/transactions#examples) * [Show all transactions sent by a specific address](https://docs.dune.com/data-catalog/tron/raw/transactions#show-all-transactions-sent-by-a-specific-address) * [Count the number of transactions per block](https://docs.dune.com/data-catalog/tron/raw/transactions#count-the-number-of-transactions-per-block) * [Show the top 10 transactions with the highest gas price](https://docs.dune.com/data-catalog/tron/raw/transactions#show-the-top-10-transactions-with-the-highest-gas-price) [​](https://docs.dune.com/data-catalog/tron/raw/transactions#table-description) Table Description ---------------------------------------------------------------------------------------------------- The `tron.transactions` table contains information about all transactions on the Tron blockchain. Each row represents a single transaction and includes information such as block number, hash, timestamp, sender, recipient, value, gas, gas price, and more. Transactions are the fundamental unit of interaction with the Tron blockchain. Transactions are created by users and are used to send value, deploy smart contracts, and interact with smart contracts. [​](https://docs.dune.com/data-catalog/tron/raw/transactions#table-schema) Table Schema ------------------------------------------------------------------------------------------ | Column | Type | Description | | --- | --- | --- | | block\_time | timestamp(3) | The exact UTC timestamp when the block containing this transaction was added to the chain | | block\_number | bigint | The sequential number of the block containing this transaction | | value | uint256 | Amount of TRX sent from sender to recipient, measured in sun (1 TRX = 10^6 sun) | | gas\_limit | bigint | Maximum number of energy units this transaction can consume | | gas\_price | bigint | Price per unit of energy for this transaction, denominated in sun | | gas\_used | bigint | Actual amount of energy units consumed by this transaction’s execution | | max\_fee\_per\_gas | bigint | Maximum total amount per energy unit the initiator is willing to pay | | max\_priority\_fee\_per\_gas | bigint | Maximum additional fee per energy unit the initiator is willing to pay as a tip | | priority\_fee\_per\_gas | bigint | Actual additional fee per energy unit paid as a tip | | nonce | bigint | Sequential number representing the count of transactions sent from the sender’s address | | index | bigint | Position of this transaction within its containing block | | success | boolean | Whether the transaction executed successfully (true) or failed (false) | | from | varbinary | Address of the account that initiated and signed this transaction | | to | varbinary | Address of the recipient account or contract for this transaction | | block\_hash | varbinary | Unique identifier (hash) of the block containing this transaction | | data | varbinary | Input data for the transaction, which may include function calls or contract interaction data | | hash | varbinary | Unique identifier (hash) of this specific transaction | | type | varchar | Type of transaction indicating its structure and fee mechanism | | access\_list | array(row(address varbinary, storagekeys array(varbinary))) | List of addresses and storage keys the transaction plans to access, used for energy optimization | | block\_date | date | The UTC date of the block in which this transaction was included | [​](https://docs.dune.com/data-catalog/tron/raw/transactions#table-sample) Table Sample ------------------------------------------------------------------------------------------ [​](https://docs.dune.com/data-catalog/tron/raw/transactions#examples) Examples ---------------------------------------------------------------------------------- ### [​](https://docs.dune.com/data-catalog/tron/raw/transactions#show-all-transactions-sent-by-a-specific-address) Show all transactions sent by a specific address Copy Ask AI select * from tron.transactions where "from" = 0x50A1b5c358F8D34F0d35aA2f10742c46054E247e ### [​](https://docs.dune.com/data-catalog/tron/raw/transactions#count-the-number-of-transactions-per-block) Count the number of transactions per block Copy Ask AI SELECT block_number, COUNT(*) FROM tron.transactions GROUP BY 1 ORDER BY 1 DESC LIMIT 10 ### [​](https://docs.dune.com/data-catalog/tron/raw/transactions#show-the-top-10-transactions-with-the-highest-gas-price) Show the top 10 transactions with the highest gas price Copy Ask AI SELECT hash, gas_price FROM tron.transactions ORDER BY gas_price DESC LIMIT 10 Was this page helpful? YesNo [Logs](https://docs.dune.com/data-catalog/tron/raw/logs) [Tether](https://docs.dune.com/data-catalog/tron/tether) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # tron.blocks - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/raw/blocks#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Raw tron.blocks [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/tron/raw/blocks#table-description) * [Table Schema](https://docs.dune.com/data-catalog/tron/raw/blocks#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/tron/raw/blocks#table-sample) * [Examples](https://docs.dune.com/data-catalog/tron/raw/blocks#examples) * [Show the most recent blocks](https://docs.dune.com/data-catalog/tron/raw/blocks#show-the-most-recent-blocks) * [Show the number of blocks produced each day](https://docs.dune.com/data-catalog/tron/raw/blocks#show-the-number-of-blocks-produced-each-day) * [Show the number of transactions in each block](https://docs.dune.com/data-catalog/tron/raw/blocks#show-the-number-of-transactions-in-each-block) [​](https://docs.dune.com/data-catalog/tron/raw/blocks#table-description) Table Description ---------------------------------------------------------------------------------------------- The `tron.blocks` table contains information about blocks in the Tron blockchain. A block is a collection of transactions that are hashed and added to the blockchain. Each block contains a reference to the previous block, known as the parent hash, and a timestamp. The table contains information about each block, such as the block number, the block hash, the block size, the number of transactions, and the gas used. [​](https://docs.dune.com/data-catalog/tron/raw/blocks#table-schema) Table Schema ------------------------------------------------------------------------------------ | Column | Type | Description | | --- | --- | --- | | time | timestamp(3) | Timestamp when this block was added to the chain | | number | bigint | Sequential position of this block in the blockchain | | gas\_limit | decimal(38,0) | Maximum amount of energy that can be used by all transactions in this block | | gas\_used | decimal(38,0) | Total amount of energy actually consumed by all transactions in this block | | difficulty | bigint | Measure of how difficult it was to produce this block | | total\_difficulty | decimal(38,0) | Total chain difficulty up to this block | | size | bigint | Size of this block in bytes | | base\_fee\_per\_gas | bigint | Minimum fee per energy unit required for transaction inclusion in this block | | hash | varbinary | Unique identifier (hash) of this block | | parent\_hash | varbinary | Hash of the previous block in the blockchain | | miner | varbinary | Address of the block producer (super representative) who produced this block | | nonce | varbinary | Block nonce value used in the consensus mechanism | | date | date | The UTC date when this block was added to the chain | [​](https://docs.dune.com/data-catalog/tron/raw/blocks#table-sample) Table Sample ------------------------------------------------------------------------------------ [​](https://docs.dune.com/data-catalog/tron/raw/blocks#examples) Examples ---------------------------------------------------------------------------- ### [​](https://docs.dune.com/data-catalog/tron/raw/blocks#show-the-most-recent-blocks) Show the most recent blocks Copy Ask AI SELECT number, hash, size, gas_used FROM tron.blocks ORDER BY number DESC LIMIT 10 ### [​](https://docs.dune.com/data-catalog/tron/raw/blocks#show-the-number-of-blocks-produced-each-day) Show the number of blocks produced each day Copy Ask AI SELECT date_trunc('day', time) AS day, count(distinct number) FROM tron.blocks GROUP BY day ORDER BY day DESC ### [​](https://docs.dune.com/data-catalog/tron/raw/blocks#show-the-number-of-transactions-in-each-block) Show the number of transactions in each block Copy Ask AI SELECT number, count(*) FROM tron.blocks group by 1 LIMIT 10 Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/tron/decoded/overview) [Logs](https://docs.dune.com/data-catalog/tron/raw/logs) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # tron.contracts - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/decoded/contracts#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Decoded tron.contracts [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/tron/decoded/contracts#table-description) * [Table Schema](https://docs.dune.com/data-catalog/tron/decoded/contracts#table-schema) * [Table Sample](https://docs.dune.com/data-catalog/tron/decoded/contracts#table-sample) [​](https://docs.dune.com/data-catalog/tron/decoded/contracts#table-description) Table Description ----------------------------------------------------------------------------------------------------- The `tron.contracts` table contains information about the contracts Dune has decoded on the Tron blockchain. You can use this table to find information about the contracts that have been decoded by Dune. [​](https://docs.dune.com/data-catalog/tron/decoded/contracts#table-schema) Table Schema ------------------------------------------------------------------------------------------- | Column | Type | Description | | --- | --- | --- | | abi\_id | varchar | Unique identifier for the contract’s ABI definition | | abi | array(varchar) | The full ABI (Application Binary Interface) of the contract as an array of function/event definitions | | address | varbinary | The contract’s deployment address on the Tron blockchain | | from | varbinary | Address of the account that deployed this contract | | code | varbinary | The bytecode of the deployed contract | | name | varchar | Human-readable name of the contract (e.g. “SunswapV2Router”) | | namespace | varchar | Project or protocol namespace the contract belongs to (e.g. “sunswapv2”) | | dynamic | boolean | Whether the contract was dynamically decoded via ABI matching | | base | boolean | Whether this is a base contract (not created by a factory) | | factory | boolean | Whether this contract was created by a factory contract | | detection\_source | varchar | How the contract was detected and added to Dune’s decoded set (e.g. “base”, “factory”) | | created\_at | timestamp(3) | Timestamp when this record was created in Dune’s database | [​](https://docs.dune.com/data-catalog/tron/decoded/contracts#table-sample) Table Sample ------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/tron/overview) [Event Logs](https://docs.dune.com/data-catalog/tron/decoded/event-logs) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # xrpl.aggregated_metrics_daily - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation XRPL xrpl.aggregated\_metrics\_daily [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily#table-sample) [​](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily#table-description) Table Description ------------------------------------------------------------------------------------------------------------ The `xrpl.aggregated_metrics_daily` table contains daily aggregated metrics and statistics for XRP Ledger network activity and performance. [​](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------------------- | **Column** | **type** | **Description** | | --- | --- | --- | | **date** | date | The date for which metrics are aggregated | | **issuers\_count\_daily** | integer | Number of unique token issuers active on this date | | **tokens\_count\_daily** | integer | Number of unique tokens active on this date | | **xrp\_txn\_volume\_xrp** | decimal(38,6) | Total XRP transaction volume for the day | | **xrp\_payment\_volume\_xrp** | decimal(38,6) | Total XRP payment volume for the day | | **dex\_traded\_tokens\_count\_daily** | integer | Number of unique tokens traded on DEX on this date | | **dex\_traders\_count\_daily** | integer | Number of unique traders on DEX on this date | | **dex\_pairs\_count\_daily** | integer | Number of trading pairs on DEX on this date | | **dex\_xrp\_pairs\_count\_daily** | integer | Number of XRP trading pairs on DEX on this date | | **dex\_xrp\_pair\_volume\_xrp** | decimal(38,6) | Total volume of XRP pairs traded on DEX for the day | | **amm\_pools\_count\_daily** | integer | Number of AMM (Automated Market Maker) pools on this date | | **amm\_xrp\_pools\_count\_daily** | integer | Number of AMM pools containing XRP on this date | | **amm\_tvl\_xrp** | decimal(38,6) | Total Value Locked (TVL) in AMM pools in XRP | | **amm\_users\_count\_daily** | integer | Number of unique users interacting with AMM on this date | | **amm\_xrp\_volume\_xrp** | decimal(38,6) | Total XRP volume traded through AMM for the day | | **\_ingested\_at** | timestamp | Data ingestion timestamp | [​](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily#table-sample) Table Sample -------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Ledger](https://docs.dune.com/data-catalog/xrpl/ledger) [Overview](https://docs.dune.com/data-catalog/tron/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # succinct.bids - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/succinct/bids#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Succinct succinct.bids [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Schema](https://docs.dune.com/data-catalog/succinct/bids#table-schema) * [Sample Query](https://docs.dune.com/data-catalog/succinct/bids#sample-query) The `succinct.bids` table contains all proof generation bids submitted by provers in the Succinct Network. Each bid represents a prover’s offer to generate a ZK proof for a specific request at a given price, participating in the auction-based proof contest mechanism. [​](https://docs.dune.com/data-catalog/succinct/bids#table-schema) Table Schema ---------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | id | long | Unique identifier for the bid | | tx\_hash | binary | Transaction hash of the bid submission | | prover | binary | Address of the prover submitting the bid | | request\_id | binary | Unique identifier for the proof request | | amount | bigint | Amount of PROVE tokens bid for the proof generation | | created\_at | timestamp | Timestamp when the bid was submitted | | stake | decimal(38,0) | Amount of PROVE tokens staked by the prover | | date | date | Date when the bid was submitted | | \_updated\_at | timestamp | Last update timestamp | | \_ingested\_at | timestamp | Ingestion timestamp | [​](https://docs.dune.com/data-catalog/succinct/bids#sample-query) Sample Query ---------------------------------------------------------------------------------- Copy Ask AI -- Get the total number of bids and total amount bid per prover SELECT prover, COUNT(*) as bid_count, SUM(amount) as total_bid_amount FROM succinct.bids WHERE created_at >= NOW() - INTERVAL '7' DAY GROUP BY prover ORDER BY total_bid_amount DESC LIMIT 10; Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/succinct/overview) [Requests](https://docs.dune.com/data-catalog/succinct/requests) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # succinct.requests - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/succinct/requests#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Succinct succinct.requests [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Schema](https://docs.dune.com/data-catalog/succinct/requests#table-schema) * [Sample Query](https://docs.dune.com/data-catalog/succinct/requests#sample-query) * [Sample Query](https://docs.dune.com/data-catalog/succinct/requests#sample-query-2) The `succinct.requests` table contains all proof requests submitted by application developers to the Succinct Network. Each request represents a demand for ZK proof generation, which provers can then bid on through the auction mechanism. [​](https://docs.dune.com/data-catalog/succinct/requests#table-schema) Table Schema -------------------------------------------------------------------------------------- | Column Name | Data Type | Description | | --- | --- | --- | | vk\_hash | binary | Verification key hash for the proof request | | requester | binary | Address of the application developer submitting the request | | fulfiller\_address | binary | Address of the prover that fulfilled the request | | gas\_price | bigint | Gas price for the request transaction | | max\_price\_per\_gas | bigint | Maximum price per gas unit the requester is willing to pay | | gas\_used | bigint | Gas used for the request transaction | | gas\_limit | bigint | Gas limit for the request transaction | | cycles | bigint | Number of computational cycles required for the proof | | created\_at | timestamp | Timestamp when the request was submitted | | fulfilled\_at | timestamp | Timestamp when the request was fulfilled | | deadline | timestamp | Deadline by which the proof must be generated | | date | date | Date when the request was submitted | | tx\_hash | binary | Transaction hash of the request submission | | id | binary | Unique identifier for the proof request | | sender | binary | Address of the sender (may be different from requester) | | base\_fee | decimal(38,0) | Base fee for the transaction | | min\_auction\_period | bigint | Minimum auction period in seconds | | \_updated\_at | timestamp | Last update timestamp | | \_ingested\_at | timestamp | Ingestion timestamp | [​](https://docs.dune.com/data-catalog/succinct/requests#sample-query) Sample Query -------------------------------------------------------------------------------------- Copy Ask AI -- Get the total number of requests and fulfillment rates by requester SELECT requester, COUNT(*) as total_requests, COUNT(CASE WHEN fulfiller_address IS NOT NULL THEN 1 END) as fulfilled_requests, COUNT(CASE WHEN fulfiller_address IS NOT NULL THEN 1 END) * 100.0 / COUNT(*) as fulfillment_rate FROM succinct.requests WHERE created_at >= NOW() - INTERVAL '30' DAY GROUP BY requester ORDER BY total_requests DESC LIMIT 10; [​](https://docs.dune.com/data-catalog/succinct/requests#sample-query-2) Sample Query ---------------------------------------------------------------------------------------- Copy Ask AI -- Get request activity and gas usage over time SELECT DATE_TRUNC('day', created_at) as day, COUNT(*) as total_requests, AVG(gas_used) as avg_gas_used, SUM(gas_used) as total_gas_used FROM succinct.requests WHERE created_at >= NOW() - INTERVAL '7' DAY GROUP BY DATE_TRUNC('day', created_at) ORDER BY day DESC; Was this page helpful? YesNo [Bids](https://docs.dune.com/data-catalog/succinct/bids) [Overview](https://docs.dune.com/data-catalog/evm/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # peaq.evm_blocks - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/peaq/blocks#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Peaq peaq.evm\_blocks [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/peaq/blocks#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/peaq/blocks#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/peaq/blocks#table-sample) [​](https://docs.dune.com/data-catalog/peaq/blocks#table-description) Table description ------------------------------------------------------------------------------------------ The `peaq.evm_blocks` table stores basic information about Peaq blocks, with one record per block, including the block hash and statistics on the number of extrinsics, events, and transfers contained in each block. This table is partitioned by `year`, `month`, and `day` for efficient querying. Each block record includes metadata such as block number, specification version, relay chain block number, block hashes (hash, parent hash, state root, extrinsics root), block author information, and counts of various operations (extrinsics, events, transfers, traces). [​](https://docs.dune.com/data-catalog/peaq/blocks#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------- | **Column** | **Description** | **Type** | | --- | --- | --- | | **year** | The year when the block was created, used for partitioning. | int | | **month** | The month when the block was created, used for partitioning. | int | | **day** | The day when the block was created, used for partitioning. | int | | **block\_time** | The timestamp when the block was created. | timestamp | | **number** | The block number (sequence number) of the block. | long | | **spec\_version** | The specification version of the runtime when this block was created. | long | | **relay\_block\_number** | The block number of the relay chain block associated with this block. | long | | **hash** | The hash of the current block, in binary format. | binary | | **parent\_hash** | The hash of the parent block, in binary format. | binary | | **state\_root** | The Merkle root of the state trie after applying all transactions in this block. | binary | | **extrinsics\_root** | The Merkle root of the extrinsics included in this block. | binary | | **author\_ss58** | The SS58-encoded address of the block author (validator) in human-readable format. | string | | **author\_pub\_key** | The public key of the block author (validator) in binary format. | binary | | **relay\_state\_root** | The state root of the relay chain associated with this block. | binary | | **extrinsic\_count** | The number of extrinsics (transactions) included in this block. | long | | **event\_count** | The number of events emitted in this block. | long | | **transfer\_count** | The number of transfers executed in this block. | long | | **trace\_count** | The number of traces generated in this block. | long | | **\_updated\_at** | The time when the block record was last updated. | timestamp | | **\_ingested\_at** | The time when the block data was ingested into the system. | timestamp | [​](https://docs.dune.com/data-catalog/peaq/blocks#table-sample) Table Sample -------------------------------------------------------------------------------- Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/peaq/overview) [Extrinsics](https://docs.dune.com/data-catalog/peaq/extrinsics) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # peaq.extrinsics - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/peaq/extrinsics#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Peaq peaq.extrinsics [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/peaq/extrinsics#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/peaq/extrinsics#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/peaq/extrinsics#table-sample) [​](https://docs.dune.com/data-catalog/peaq/extrinsics#table-description) Table description ---------------------------------------------------------------------------------------------- Extrinsics (aka “transactions”) normally contain a signature, some data to describe if the extrinsic has passed some validity checks and a reference to the pallet and call that it is intended for. Extrinsics may be signed or unsigned. Some extrinsics have a complex structure, e.g. when using proxy or utility pallets, resulting in the top-level call initiating other calls involving other pallets. The `peaq.extrinsics` table is partitioned by `year`, `month`, `section`, and `method` for efficient querying. Common queries on the `extrinsics` table will typically filter on `block_time`, `section` and `method` and extract JSON encoded information from `params`. In many cases, an initial query on the `extrinsics` table is best developed on the calls table instead to properly capture how users often use proxy and utility constructs to interact with the Peaq chain. Each extrinsic record includes the top-level call information (section and method), block and hash information, signer details, fee and weight, execution status, and call parameters. [​](https://docs.dune.com/data-catalog/peaq/extrinsics#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------- | **Column** | **Description** | **Type** | | --- | --- | --- | | **year** | The year when the extrinsic was executed, used for partitioning. | int | | **month** | The month when the extrinsic was executed, used for partitioning. | int | | **section** | The pallet section (module) of the top-level call (e.g., “balances”, “system”). | string | | **method** | The method name of the top-level call within the pallet section. | string | | **block\_time** | The timestamp when the block containing this extrinsic was created. | timestamp | | **block\_number** | The block number where this extrinsic was executed. | long | | **extrinsic\_id** | The unique identifier for the extrinsic record. | string | | **hash** | The hash of the extrinsic, in binary format. | binary | | **block\_hash** | The hash of the block containing this extrinsic, in binary format. | binary | | **lifetime** | The lifetime or validity period of the extrinsic, if applicable. | string | | **params** | The call parameters in JSON format, containing the arguments passed to the call. | string | | **fee** | The fee charged for executing this extrinsic, in processed format. | double | | **weight** | The computational weight consumed by this extrinsic. | long | | **signed** | Indicates whether the extrinsic was signed by an account. | boolean | | **signer\_ss58** | The SS58-encoded address of the account that signed the extrinsic, in human-readable format. | string | | **signer\_pub\_key** | The public key of the account that signed the extrinsic, in binary format. | binary | | **status** | Indicates whether the extrinsic execution was successful. | boolean | | **\_updated\_at** | The time when the extrinsic record was last updated. | timestamp | | **\_ingested\_at** | The time when the extrinsic data was ingested into the system. | timestamp | [​](https://docs.dune.com/data-catalog/peaq/extrinsics#table-sample) Table Sample ------------------------------------------------------------------------------------ Was this page helpful? YesNo [Blocks](https://docs.dune.com/data-catalog/peaq/blocks) [Events](https://docs.dune.com/data-catalog/peaq/events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # peaq.balances - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/peaq/balances#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Peaq peaq.balances [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/peaq/balances#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/peaq/balances#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/peaq/balances#table-sample) [​](https://docs.dune.com/data-catalog/peaq/balances#table-description) Table description -------------------------------------------------------------------------------------------- The `peaq.balances` table tracks account balance snapshots on the Peaq network, capturing the state of user assets at specific timestamps. This table is partitioned by `year`, `month`, and `day` for efficient querying. Each record includes balance information in both processed (double) and raw (string) formats, allowing for precise balance tracking. The table tracks multiple balance types including free balances, reserved balances, and various frozen balance states (misc\_frozen and frozen). Accounts are identified using SS58 addresses (`address_ss58`) and public keys (`address_pubkey`), supporting both human-readable and binary address formats. The table also includes chain and asset metadata such as `symbol`, `chain_name`, `asset`, and `para_id` for multi-chain support. [​](https://docs.dune.com/data-catalog/peaq/balances#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------ | **Column** | **Description** | **Type** | | --- | --- | --- | | **year** | The year when the balance snapshot was taken, used for partitioning. | int | | **month** | The month when the balance snapshot was taken, used for partitioning. | int | | **day** | The day when the balance snapshot was taken, used for partitioning. | int | | **ts** | The timestamp when the balance snapshot was taken. | timestamp | | **symbol** | The symbol of the asset (e.g., “PEAQ”). | string | | **address\_ss58** | The SS58-encoded address of the account in human-readable format. | string | | **address\_pubkey** | The public key of the account in binary format. | binary | | **id** | The unique identifier for the balance record. | string | | **chain\_name** | The name of the chain where the balance exists. | string | | **asset** | The asset identifier or symbol. | string | | **para\_id** | The parachain ID associated with the balance, if applicable. | long | | **free** | The free balance available to the account, in processed format. | double | | **reserved** | The reserved balance that is locked but still owned by the account. | double | | **misc\_frozen** | The miscellaneous frozen balance that cannot be used for certain operations. | double | | **frozen** | The total frozen balance that cannot be used. | double | | **nonce** | The account nonce, representing the number of transactions from this account. | long | | **free\_raw** | The free balance in raw string format, preserving full precision. | string | | **reserved\_raw** | The reserved balance in raw string format, preserving full precision. | string | | **misc\_frozen\_raw** | The miscellaneous frozen balance in raw string format, preserving full precision. | string | | **frozen\_raw** | The frozen balance in raw string format, preserving full precision. | string | | **flags\_raw** | The raw flags associated with the account balance state. | string | | **\_updated\_at** | The time when the balance record was last updated. | timestamp | | **\_ingested\_at** | The time when the balance data was ingested into the system. | timestamp | [​](https://docs.dune.com/data-catalog/peaq/balances#table-sample) Table Sample ---------------------------------------------------------------------------------- Was this page helpful? YesNo [Transfers](https://docs.dune.com/data-catalog/peaq/transfers) [Overview](https://docs.dune.com/data-catalog/near/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # peaq.transfers - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/peaq/transfers#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Peaq peaq.transfers [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/peaq/transfers#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/peaq/transfers#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/peaq/transfers#table-sample) [​](https://docs.dune.com/data-catalog/peaq/transfers#table-description) Table description --------------------------------------------------------------------------------------------- The `peaq.transfers` table stores complete ledger of asset transfers across the Peaq network, capturing the movement of tokens between accounts. This table is partitioned by `year`, `month`, and `day` for efficient querying. Each transfer record includes information about the sender and recipient (in both SS58 and public key formats), the asset being transferred, the amount in both processed (double) and raw (decimal) formats, and the event and extrinsic that triggered the transfer. [​](https://docs.dune.com/data-catalog/peaq/transfers#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------- | **Column** | **Description** | **Type** | | --- | --- | --- | | **year** | The year when the transfer occurred, used for partitioning. | int | | **month** | The month when the transfer occurred, used for partitioning. | int | | **day** | The day when the transfer occurred, used for partitioning. | int | | **block\_time** | The timestamp when the block containing this transfer was created. | timestamp | | **block\_number** | The block number where this transfer occurred. | long | | **event\_id** | The unique identifier of the event that represents this transfer. | string | | **extrinsic\_id** | The unique identifier of the extrinsic that triggered this transfer. | string | | **section** | The pallet section (module) that emitted the transfer event. | string | | **method** | The method name within the pallet section that identifies the transfer type. | string | | **extrinsic\_hash** | The hash of the extrinsic that triggered this transfer, in binary format. | binary | | **block\_hash** | The hash of the block containing this transfer, in binary format. | binary | | **from\_ss58** | The SS58-encoded address of the sender account, in human-readable format. | string | | **from\_pub\_key** | The public key of the sender account, in binary format. | binary | | **to\_ss58** | The SS58-encoded address of the recipient account, in human-readable format. | string | | **to\_pub\_key** | The public key of the recipient account, in binary format. | binary | | **asset** | The asset identifier or address being transferred. | string | | **symbol** | The symbol of the asset being transferred (e.g., “PEAQ”). | string | | **decimals** | The number of decimal places for the asset. | long | | **amount** | The transfer amount in processed format (double). | double | | **raw\_amount** | The transfer amount in raw format, preserving full precision (decimal 38,9). | decimal(38,9) | | **\_updated\_at** | The time when the transfer record was last updated. | timestamp | | **\_ingested\_at** | The time when the transfer data was ingested into the system. | timestamp | [​](https://docs.dune.com/data-catalog/peaq/transfers#table-sample) Table Sample ----------------------------------------------------------------------------------- Was this page helpful? YesNo [Calls](https://docs.dune.com/data-catalog/peaq/calls) [Balances](https://docs.dune.com/data-catalog/peaq/balances) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # peaq.events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/peaq/events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Peaq peaq.events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/peaq/events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/peaq/events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/peaq/events#table-sample) [​](https://docs.dune.com/data-catalog/peaq/events#table-description) Table description ------------------------------------------------------------------------------------------ The `peaq.events` table holds all events that occur on the Peaq chain, including their pallet `section` and `method`, as well as the decoded data involved in the event. This table is partitioned by `year`, `month`, `section`, and `method` for efficient querying. Events are emitted by the runtime and pallets to signal state changes, transaction results, and other important occurrences on the chain. Each event record includes the pallet section and method that emitted it, the block and extrinsic it belongs to, and event data in both raw and decoded formats. Common queries on the `events` table will typically filter on `block_time`, `section` and `method` and extract JSON encoded information from `data` or `data_decoded`. [​](https://docs.dune.com/data-catalog/peaq/events#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------- | **Column** | **Description** | **Type** | | --- | --- | --- | | **year** | The year when the event was emitted, used for partitioning. | int | | **month** | The month when the event was emitted, used for partitioning. | int | | **section** | The pallet section (module) that emitted the event (e.g., “balances”, “system”). | string | | **method** | The method name within the pallet section that identifies the event type. | string | | **block\_time** | The timestamp when the block containing this event was created. | timestamp | | **block\_number** | The block number where this event was emitted. | bigint | | **extrinsic\_id** | The unique identifier of the extrinsic that triggered this event. | string | | **event\_id** | The unique identifier for the event record. | string | | **data** | The raw event data in JSON format. | string | | **extrinsic\_hash** | The hash of the extrinsic that triggered this event, in binary format. | binary | | **block\_hash** | The hash of the block containing this event, in binary format. | binary | | **data\_decoded** | The decoded event data with type information and human-readable values. | string | | **\_updated\_at** | The time when the event record was last updated. | timestamp | | **\_ingested\_at** | The time when the event data was ingested into the system. | timestamp | [​](https://docs.dune.com/data-catalog/peaq/events#table-sample) Table Sample -------------------------------------------------------------------------------- Was this page helpful? YesNo [Extrinsics](https://docs.dune.com/data-catalog/peaq/extrinsics) [Calls](https://docs.dune.com/data-catalog/peaq/calls) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # peaq.calls - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/peaq/calls#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Peaq peaq.calls [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table description](https://docs.dune.com/data-catalog/peaq/calls#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/peaq/calls#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/peaq/calls#table-sample) [​](https://docs.dune.com/data-catalog/peaq/calls#table-description) Table description ----------------------------------------------------------------------------------------- Compared to the `extrinsics` table, which only has a top-level call, the `calls` table represents _internal_ calls, including recursive internal calls of `proxy` and `utility` (batch) pallets, and provides detailed call arguments at each level of the call tree. The `peaq.calls` table is partitioned by `year`, `month`, `call_section`, and `call_method` for efficient querying. Common queries on the `calls` table will typically filter on `block_time`, `call_section` and `call_method` and extract JSON encoded information from `call_args` or `call_args_def`. Each call record includes information about the pallet section and method being called, the extrinsic it belongs to, call hierarchy (root/leaf), fee and weight information, signer details, and call arguments in both raw and decoded formats. [​](https://docs.dune.com/data-catalog/peaq/calls#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------- | **Column** | **Description** | **Type** | | --- | --- | --- | | **year** | The year when the call was executed, used for partitioning. | int | | **month** | The month when the call was executed, used for partitioning. | int | | **call\_section** | The pallet section (module) where the call originates (e.g., “balances”, “system”). | string | | **call\_method** | The method name within the pallet section being called. | string | | **block\_number** | The block number where this call was executed. | bigint | | **block\_time** | The timestamp when the block containing this call was created. | timestamp | | **extrinsic\_id** | The unique identifier of the extrinsic that contains this call. | string | | **relay\_chain** | The name of the relay chain associated with this call. | string | | **para\_id** | The parachain ID associated with this call, if applicable. | long | | **id** | The unique identifier for the call record. | string | | **block\_hash** | The hash of the block containing this call, in binary format. | binary | | **extrinsic\_hash** | The hash of the extrinsic containing this call, in binary format. | binary | | **extrinsic\_section** | The pallet section of the top-level extrinsic. | string | | **extrinsic\_method** | The method name of the top-level extrinsic. | string | | **call\_id** | The unique identifier for this specific call within the call tree. | string | | **call\_index** | The index of this call within the call hierarchy, in binary format. | binary | | **call\_args** | The raw call arguments in JSON format. | string | | **call\_args\_def** | The decoded call arguments definition with type information. | string | | **root** | Indicates whether this is a root-level call (top of the call tree). | boolean | | **leaf** | Indicates whether this is a leaf-level call (bottom of the call tree). | boolean | | **fee** | The fee charged for executing this call, in processed format. | double | | **weight** | The computational weight consumed by this call. | long | | **signed** | Indicates whether the extrinsic containing this call was signed. | boolean | | **signer\_ss58** | The SS58-encoded address of the account that signed the extrinsic, in human-readable format. | string | | **signer\_pub\_key** | The public key of the account that signed the extrinsic, in binary format. | binary | | **lifetime** | The lifetime or validity period of the call, if applicable. | string | | **\_updated\_at** | The time when the call record was last updated. | timestamp | | **\_ingested\_at** | The time when the call data was ingested into the system. | timestamp | [​](https://docs.dune.com/data-catalog/peaq/calls#table-sample) Table Sample ------------------------------------------------------------------------------- Was this page helpful? YesNo [Events](https://docs.dune.com/data-catalog/peaq/events) [Transfers](https://docs.dune.com/data-catalog/peaq/transfers) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Event Logs - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/decoded/event-logs#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Decoded Event Logs [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Overview](https://docs.dune.com/data-catalog/tron/decoded/event-logs#overview) * [Event Logs in Dune](https://docs.dune.com/data-catalog/tron/decoded/event-logs#event-logs-in-dune) [​](https://docs.dune.com/data-catalog/tron/decoded/event-logs#overview) Overview ------------------------------------------------------------------------------------ Smart contracts emit event logs when certain predefined actions are completed. The emitted event logs are stored on the blockchain and are publicly accessible. Event logs are an important tool for smart contract developers to communicate with the outside world, as well as for data analysts to keep track of what happens inside of a smart contract. For example, the TRC20 standard defines the `Transfer` event, which is emitted every time a token transfer occurs. The event log contains the sender, the recipient and the amount of tokens transferred. Copy Ask AI event Transfer(address indexed from, address indexed to, uint256 value); Decoded event logs always originate from the fields `topic0`, `topic1`, `topic2`, `topic3` and `data` in the `logs` table. [​](https://docs.dune.com/data-catalog/tron/decoded/event-logs#event-logs-in-dune) Event Logs in Dune -------------------------------------------------------------------------------------------------------- In Dune, we store all event logs of decoded smart contracts in separate tables. The structure published in these logs is predefined by the developer of the smart contract, the content is dynamically created during the transaction. Logs are useful for monitoring, alerting and in general keeping track of what happens inside of a smart contract. Logs are your best friend as a data analyst since they reliably present you with data that is intended to be analyzed post factum. If you ever want to see which logs _can_ be emitted by a smart contract, you can simply search for the keyword `emit` in the source code of the smart contract. We will decode all event logs for smart contracts into tables named accordingly to this schema: `[projectname_blockchain].[contractName]_evt_[eventName]` [Submit any contract for decoding\ --------------------------------](https://docs.dune.com/web-app/decoding/decoding-contracts) [Explore already decoded contracts\ ---------------------------------](https://docs.dune.com/data-catalog/tron/decoded/contracts) Was this page helpful? YesNo [Decoded Contracts](https://docs.dune.com/data-catalog/tron/decoded/contracts) [Overview](https://docs.dune.com/data-catalog/tron/decoded/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # Decoded Tron data - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/tron/decoded/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation Decoded Decoded Tron data [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Overview of Dune’s Decoded Data Approach](https://docs.dune.com/data-catalog/tron/decoded/overview#overview-of-dune%E2%80%99s-decoded-data-approach) * [Which contracts have decoded data?](https://docs.dune.com/data-catalog/tron/decoded/overview#which-contracts-have-decoded-data) * [How does decoding work?](https://docs.dune.com/data-catalog/tron/decoded/overview#how-does-decoding-work) ### [​](https://docs.dune.com/data-catalog/tron/decoded/overview#overview-of-dune%E2%80%99s-decoded-data-approach) Overview of Dune’s Decoded Data Approach Dune uses the ABI (Application Binary Interface) of smart contracts to decode blockchain transactions into structured tables. Each event log and function call from the ABI are parsed into their own tables. This decoding process transforms the raw, encoded data on the blockchain into human-readable tables, simplifying the analysis of smart contract data. Dune’s decoded data approach offers several benefits: * **Enhanced Readability:** The decoded data tables provide a clear and intuitive representation of smart contract activities * **Efficient Analysis:** The structured tables enable efficient querying and analysis of smart contract data * **Handling Multiple Contract Instances:** For smart contracts with multiple instances, Dune aggregates the data from these instances into a single table, simplifying the analysis process. * **Collaborative Mapping:** Dune’s smart contract library is continuously expanded through the active participation of the Dune community, ensuring that the decoding coverage remains comprehensive and current. [Explore decoded logs\ --------------------](https://docs.dune.com/data-catalog/tron/decoded/event-logs) [​](https://docs.dune.com/data-catalog/tron/decoded/overview#which-contracts-have-decoded-data) Which contracts have decoded data? ------------------------------------------------------------------------------------------------------------------------------------- Contract submissions on Dune are driven by the community. Usually, the odds are good that the contract you are looking at is already decoded, but especially for new projects or new contracts, it might be that the contract is not decoded yet. In those cases, you can submit the contract to be decoded. Decoding usually takes about 24 hours, in special cases it might take longer. You can check if contracts are already decoded by querying [`[blockchain].contracts`](https://docs.dune.com/data-catalog/tron/decoded/contracts) tables, the [data explorer](https://docs.dune.com/web-app/query-editor/data-explorer) or use [this dashboard](https://dune.com/dune/is-my-contract-decoded-yet-v2) . [Submit any contract for decoding\ --------------------------------](https://docs.dune.com/web-app/decoding/decoding-contracts) [Explore already decoded contracts\ ---------------------------------](https://docs.dune.com/data-catalog/tron/decoded/contracts) [​](https://docs.dune.com/data-catalog/tron/decoded/overview#how-does-decoding-work) How does decoding work? --------------------------------------------------------------------------------------------------------------- Smart Contracts on the TVM blockchain are mostly written in high level languages like [Solidity](https://docs.soliditylang.org/en/v0.8.2) or [Vyper](https://vyper.readthedocs.io/en/stable) . For them to be able to be deployed to a TVM execution environment, they need to be compiled to TVM executable bytecode. Once deployed, the bytecode gets associated with an address on the respective chain and is permanently stored in this chain’s state storage. To be able to interact with this smart contract, which is now just bytecode, we need a guide to be able to call the functions that are defined in the high-level languages. This translation of names and arguments into byte representation is done using an **Application Binary Interface (ABI)**. The ABI documents names, types, and arguments precisely which allows us to interact with the smart contract using a somewhat human-readable format. The ABI can be compiled using the high-level language source code. **The ABI is used to call a smart contract or interpret the data it emits.** ![source: https://hackernoon.com/hn-images/1*Sz1a7G2pQ62UnkHoieve4w.jpeg](https://mintcdn.com/dune/uyJ-jHeSRFvNrzyu/data-catalog/images/decoding.png?w=2500&fit=max&auto=format&n=uyJ-jHeSRFvNrzyu&q=85&s=86196121f08c742c3ab82cd84a3df23a) Was this page helpful? YesNo [Event Logs](https://docs.dune.com/data-catalog/tron/decoded/event-logs) [Blocks](https://docs.dune.com/data-catalog/tron/raw/blocks) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # XRPL Data - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/xrpl/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation XRPL XRPL Data [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [What is XRPL?](https://docs.dune.com/data-catalog/xrpl/overview#what-is-xrpl) * [Key Concepts of XRPL](https://docs.dune.com/data-catalog/xrpl/overview#key-concepts-of-xrpl) * [Consensus Protocol](https://docs.dune.com/data-catalog/xrpl/overview#consensus-protocol) * [Built-in Decentralized Exchange (DEX)](https://docs.dune.com/data-catalog/xrpl/overview#built-in-decentralized-exchange-dex) * [Tokenization and Issued Currencies](https://docs.dune.com/data-catalog/xrpl/overview#tokenization-and-issued-currencies) * [Multi-Signing and Security](https://docs.dune.com/data-catalog/xrpl/overview#multi-signing-and-security) * [Escrow and Time-Delayed Payments](https://docs.dune.com/data-catalog/xrpl/overview#escrow-and-time-delayed-payments) * [Payment Channels](https://docs.dune.com/data-catalog/xrpl/overview#payment-channels) * [Transaction Types and Use Cases](https://docs.dune.com/data-catalog/xrpl/overview#transaction-types-and-use-cases) * [XRPL Data on Dune](https://docs.dune.com/data-catalog/xrpl/overview#xrpl-data-on-dune) [​](https://docs.dune.com/data-catalog/xrpl/overview#what-is-xrpl) What is XRPL? ----------------------------------------------------------------------------------- The XRP Ledger (XRPL) is a decentralized, open-source blockchain technology that enables fast, energy-efficient, and reliable digital asset transfers. Developed by Ripple, XRPL is designed to be a sustainable blockchain for payments and financial services, capable of processing 1,500 transactions per second with settlement times of 3-5 seconds. XRPL operates on a unique consensus protocol that doesn’t require mining, making it significantly more energy-efficient than proof-of-work blockchains. The network is maintained by a global community of validators who work together to validate transactions and maintain the integrity of the ledger. This consensus mechanism ensures fast finality while maintaining decentralization and security. [​](https://docs.dune.com/data-catalog/xrpl/overview#key-concepts-of-xrpl) Key Concepts of XRPL -------------------------------------------------------------------------------------------------- XRPL’s infrastructure is built on several key components that ensure its efficiency, security, and scalability for financial applications. These components work together to provide a robust platform for payments, tokenization, and decentralized finance. ### [​](https://docs.dune.com/data-catalog/xrpl/overview#consensus-protocol) **Consensus Protocol** XRPL uses a unique consensus mechanism called the XRP Ledger Consensus Protocol, which doesn’t rely on mining or proof-of-work. Instead, validators work together to agree on the order and validity of transactions. This approach provides fast finality (3-5 seconds), high throughput (1,500 TPS), and energy efficiency while maintaining decentralization. ### [​](https://docs.dune.com/data-catalog/xrpl/overview#built-in-decentralized-exchange-dex) **Built-in Decentralized Exchange (DEX)** XRPL includes a native decentralized exchange that allows users to trade any issued tokens directly on the ledger without requiring smart contracts. This built-in DEX supports limit orders, offers, and automatic market making, enabling efficient token trading and liquidity provision. ### [​](https://docs.dune.com/data-catalog/xrpl/overview#tokenization-and-issued-currencies) **Tokenization and Issued Currencies** XRPL supports the creation of custom tokens (called “issued currencies” or “IOUs”) by any account. These tokens can represent fiat currencies, cryptocurrencies, or any other asset. Each token is identified by a currency code and issuer, allowing for flexible tokenization of real-world assets. ### [​](https://docs.dune.com/data-catalog/xrpl/overview#multi-signing-and-security) **Multi-Signing and Security** XRPL provides advanced security features including multi-signing capabilities, allowing accounts to require multiple signatures for transactions. This feature is essential for institutional use cases and provides enhanced security for high-value transactions. ### [​](https://docs.dune.com/data-catalog/xrpl/overview#escrow-and-time-delayed-payments) **Escrow and Time-Delayed Payments** XRPL includes built-in escrow functionality that allows for time-delayed payments and conditional transactions. This feature enables complex financial instruments like time-locked payments, conditional releases, and automated financial agreements. ### [​](https://docs.dune.com/data-catalog/xrpl/overview#payment-channels) **Payment Channels** XRPL supports payment channels for high-frequency, low-latency payments. Payment channels allow parties to conduct numerous off-ledger payments that can be settled on the ledger later, reducing transaction costs and improving performance for micro-payments. ### [​](https://docs.dune.com/data-catalog/xrpl/overview#transaction-types-and-use-cases) **Transaction Types and Use Cases** XRPL supports various transaction types including: * **Payment**: Transfer XRP or issued currencies between accounts * **OfferCreate/OfferCancel**: Create or cancel trading offers on the DEX * **TrustSet**: Establish trust lines for issued currencies * **AccountSet**: Configure account settings and flags * **EscrowCreate/EscrowFinish/EscrowCancel**: Manage escrow transactions * **PaymentChannelCreate/PaymentChannelFund/PaymentChannelClaim**: Manage payment channels [XRP Ledger documentation\ ------------------------\ \ Explore comprehensive documentation on XRP Ledger, detailing its architecture, protocol, and resources for developers.](https://xrpl.org/docs) [​](https://docs.dune.com/data-catalog/xrpl/overview#xrpl-data-on-dune) XRPL Data on Dune -------------------------------------------------------------------------------------------- XRP Ledger data is organized into several key tables that capture different aspects of on-chain activity, from individual transactions to daily aggregated metrics. These tables provide comprehensive insights into network activity, trading patterns, and ecosystem health. [Transactions\ ------------\ \ Detailed transaction data including payment types, account changes, and transaction metadata. Contains all transaction types from payments to DEX trades and account modifications.](https://docs.dune.com/data-catalog/xrpl/transactions) [Ledger\ ------\ \ Core ledger data including ledger headers, consensus information, and validation details. Provides insights into network consensus and ledger-level statistics.](https://docs.dune.com/data-catalog/xrpl/ledger) [Aggregated Metrics Daily\ ------------------------\ \ Daily aggregated metrics and statistics for network activity and performance. Includes token issuance, trading volume, DEX activity, and AMM metrics.](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily) Was this page helpful? YesNo [Validator Request Leave Events](https://docs.dune.com/data-catalog/thorchain/gov_validator_request_leave_events) [Transactions](https://docs.dune.com/data-catalog/xrpl/transactions) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # xrpl.ledger - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/xrpl/ledger#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation XRPL xrpl.ledger [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/xrpl/ledger#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/xrpl/ledger#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/xrpl/ledger#table-sample) [​](https://docs.dune.com/data-catalog/xrpl/ledger#table-description) Table Description ------------------------------------------------------------------------------------------ The `xrpl.ledger` table contains core ledger data from the XRP Ledger including ledger headers, consensus information, and validation details. [​](https://docs.dune.com/data-catalog/xrpl/ledger#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------- | **Column** | **type** | **Description** | | --- | --- | --- | | **ledger\_hash** | string | Unique hash identifier for the ledger | | **ledger\_index** | bigint | Sequential index number of the ledger | | **validated** | boolean | Whether the ledger has been validated by consensus | | **account\_hash** | string | Hash of the account state tree | | **close\_flags** | bigint | Flags indicating how the ledger was closed | | **close\_time** | bigint | Unix timestamp when the ledger was closed | | **close\_time\_human** | string | Human-readable timestamp when the ledger was closed | | **close\_time\_resolution** | bigint | Resolution of the close time in seconds | | **close\_time\_iso** | string | ISO 8601 formatted close time | | **parent\_close\_time** | bigint | Close time of the parent ledger | | **parent\_hash** | string | Hash of the parent ledger | | **total\_coins** | string | Total XRP supply in the ledger | | **transaction\_hash** | string | Hash of the transaction tree | | **closed** | boolean | Whether the ledger is closed | | **transaction\_count** | bigint | Number of transactions included in this ledger | | **event\_created\_at** | timestamp | Timestamp when the ledger event was created | | **ledger\_close\_date** | date | Date when the ledger was closed | | **\_inserted\_at** | timestamp | Record insertion timestamp | | **\_ingested\_at** | timestamp | Data ingestion timestamp | [​](https://docs.dune.com/data-catalog/xrpl/ledger#table-sample) Table Sample -------------------------------------------------------------------------------- Was this page helpful? YesNo [Transactions](https://docs.dune.com/data-catalog/xrpl/transactions) [Aggregated Metrics Daily](https://docs.dune.com/data-catalog/xrpl/aggregated_metrics_daily) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # xrpl.transactions - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/xrpl/transactions#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation XRPL xrpl.transactions [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/xrpl/transactions#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/xrpl/transactions#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/xrpl/transactions#table-sample) [​](https://docs.dune.com/data-catalog/xrpl/transactions#table-description) Table Description ------------------------------------------------------------------------------------------------ The `xrpl.transactions` table contains all transaction data from the XRP Ledger including payment types, account changes, and transaction metadata. [​](https://docs.dune.com/data-catalog/xrpl/transactions#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------- | **Column** | **type** | **Description** | | --- | --- | --- | | **account** | string | The account that initiated the transaction | | **account\_txn\_id** | string | Unique identifier for the transaction from the account’s perspective | | **amount** | struct(currency: string, issuer: string, value: string) | The amount being transferred (for payment transactions) | | **amount2** | struct(currency: string, issuer: string, value: string) | Secondary amount field for complex transactions | | **asset** | struct(currency: string, issuer: string) | Asset information for token-related transactions | | **asset2** | struct(currency: string, issuer: string) | Secondary asset information | | **asset\_class** | string | Classification of the asset being traded | | **auth\_accounts** | array(struct(authaccount: struct(account: string))) | Accounts authorized for this transaction | | **authorize** | string | Account to be authorized | | **balance** | struct(currency: string, value: string) | Balance information | | **bid\_max** | struct(currency: string, issuer: string, value: string) | Maximum bid amount for auction transactions | | **bid\_min** | struct(currency: string, issuer: string, value: string) | Minimum bid amount for auction transactions | | **cancel\_after** | long | Timestamp after which the transaction should be cancelled | | **channel** | string | Payment channel identifier | | **check\_id** | string | Unique identifier for a check | | **clear\_flag** | long | Flag to be cleared from the account | | **condition** | string | Condition for conditional transactions | | **deliver\_max** | struct(currency: string, issuer: string, value: string) | Maximum amount to deliver in a payment | | **deliver\_min** | struct(currency: string, issuer: string, value: string) | Minimum amount to deliver in a payment | | **destination** | string | Destination account for the transaction | | **destination\_tag** | long | Tag for the destination account | | **domain** | string | Domain associated with the account | | **email\_hash** | string | Hash of the email address | | **expiration** | long | Expiration timestamp for the transaction | | **fee** | string | Transaction fee in drops | | **finish\_after** | long | Timestamp after which the transaction should be finished | | **flags** | long | Transaction flags | | **fulfillment** | string | Fulfillment condition for conditional transactions | | **invoice\_id** | string | Invoice identifier | | **issuer** | string | Issuer of the token | | **lp\_token\_in** | struct(currency: string, issuer: string, value: string) | Liquidity pool token input amount | | **lp\_token\_out** | struct(currency: string, value: string) | Liquidity pool token output amount | | **last\_ledger\_sequence** | long | Last ledger sequence number | | **last\_update\_time** | long | Last update timestamp | | **ledger\_sequence** | long | Ledger sequence number | | **limit\_amount** | struct(currency: string, issuer: string, value: string) | Limit amount for trust lines | | **memos** | array(struct(Memo: struct(MemoData: string, MemoFormat: string, MemoType: string))) | Transaction memos | | **metadata** | string | Transaction metadata in JSON format | | **nf\_token\_broker\_fee** | struct(currency: string, issuer: string, value: string) | NFT broker fee | | **nf\_token\_buy\_offer** | string | NFT buy offer identifier | | **nf\_token\_id** | string | NFT token identifier | | **nf\_token\_minter** | string | NFT token minter | | **nf\_token\_offers** | array(string) | NFT token offers | | **nf\_token\_sell\_offer** | string | NFT sell offer identifier | | **nf\_token\_taxon** | long | NFT token taxon | | **offer\_sequence** | long | Offer sequence number | | **operation\_limit** | long | Operation limit | | **oracle\_document\_id** | long | Oracle document identifier | | **owner** | string | Owner of the account or asset | | **paths** | string | Payment paths for cross-currency payments | | **previous\_txn\_id** | string | Previous transaction identifier | | **price\_data\_series** | array(struct(PriceData: struct(AssetPrice: string, BaseAsset: String, QuoteAsset: string, Scale: long))) | Price data series | | **provider** | string | Provider information | | **public\_key** | string | Public key of the account | | **quality\_in** | long | Quality in for exchange transactions | | **quality\_out** | long | Quality out for exchange transactions | | **regular\_key** | string | Regular key for the account | | **send\_max** | struct(currency: string, issuer: string, value: string) | Maximum amount to send | | **sequence** | long | Account sequence number | | **set\_flag** | long | Flag to be set on the account | | **settle\_delay** | long | Settlement delay | | **signature** | string | Transaction signature | | **signer\_entries** | array(struct(SignerEntry: struct(Account: String, SignerWeight: long))) | Signer entries for multi-signing | | **signer\_quorum** | long | Signer quorum | | **signers** | array(struct(Signer: struct(Account: string, SigningPubKey: string, TxnSignature: string))) | Transaction signers | | **signing\_pub\_key** | string | Signing public key | | **source\_tag** | long | Source tag | | **taker\_gets** | struct(currency: string, issuer: string, value: string) | Amount the taker gets in an offer | | **taker\_pays** | struct(currency: string, issuer: string, value: string) | Amount the taker pays in an offer | | **tick\_size** | long | Tick size for trading | | **ticket\_count** | long | Number of tickets | | **ticket\_sequence** | long | Ticket sequence number | | **trading\_fee** | long | Trading fee | | **transaction\_type** | string | Type of transaction | | **transfer\_fee** | long | Transfer fee | | **transfer\_rate** | long | Transfer rate | | **txn\_signature** | string | Transaction signature | | **unl\_modify\_disabling** | long | UNL modify disabling flag | | **unl\_modify\_validator** | string | UNL modify validator | | **uri** | string | URI associated with the account | | **hash** | string | Transaction hash | | **ledger\_index** | long | Ledger index | | **\_event\_created\_at** | timestamp | Event creation timestamp | | **\_ledger\_close\_time\_human** | string | Human-readable ledger close time | | **ledger\_close\_date** | date | Date when the ledger closed | | **\_inserted\_at** | timestamp | Record insertion timestamp | | **message\_key** | string | Message key | | **e\_price** | struct(currency: string, value: string) | Exchange price | | **unauthorize** | string | Account to be unauthorized | | **amendment** | string | Amendment identifier | | **\_ingested\_at** | timestamp | Data ingestion timestamp | [​](https://docs.dune.com/data-catalog/xrpl/transactions#table-sample) Table Sample -------------------------------------------------------------------------------------- Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/xrpl/overview) [Ledger](https://docs.dune.com/data-catalog/xrpl/ledger) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.gov_validator_request_leave_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/gov_validator_request_leave_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.gov\_validator\_request\_leave\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/gov_validator_request_leave_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/gov_validator_request_leave_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/gov_validator_request_leave_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/gov_validator_request_leave_events#table-description) Table Description --------------------------------------------------------------------------------------------------------------------------- The `thorchain.gov_validator_request_leave_events` table event data for validator request leave on THORChain. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/gov_validator_request_leave_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx** | varchar | Tx | | **from\_addr** | varchar | From Addr | | **node\_addr** | varchar | Node Addr | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **tx\_id** | bigint | Transaction ID | | **from\_address** | varchar | Source address | | **node\_address** | varchar | Address | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_validator\_request\_leave\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/gov_validator_request_leave_events#table-sample) Table Sample ----------------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Slash Points Events](https://docs.dune.com/data-catalog/thorchain/gov_slash_points_events) [Overview](https://docs.dune.com/data-catalog/xrpl/overview) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # THORChain Data - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/overview#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain THORChain Data [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [What is THORChain?](https://docs.dune.com/data-catalog/thorchain/overview#what-is-thorchain) * [Key Features](https://docs.dune.com/data-catalog/thorchain/overview#key-features) * [THORChain’s Financial Offerings](https://docs.dune.com/data-catalog/thorchain/overview#thorchain%E2%80%99s-financial-offerings) * [THORChain Data on Dune](https://docs.dune.com/data-catalog/thorchain/overview#thorchain-data-on-dune) * [Network Specifications](https://docs.dune.com/data-catalog/thorchain/overview#network-specifications) * [Resources](https://docs.dune.com/data-catalog/thorchain/overview#resources) [​](https://docs.dune.com/data-catalog/thorchain/overview#what-is-thorchain) What is THORChain? -------------------------------------------------------------------------------------------------- THORChain is an independent, cross-chain liquidity protocol that operates as a Layer 1 decentralised exchange (DEX). Built on the Cosmos SDK, it utilises the CometBFT consensus engine, the Cosmos-SDK state machine, and the GG20 Threshold Signature Scheme (TSS) to execute its purpose, which is to allow users to swap native assets across multiple chains with zero reliance on centralised third parties. In doing so, it stands as one of the few exchanges that verifiably ensures transparent and fair prices for cross-chain swaps of native assets. THORChain’s design renders no need for wrapped or pegged assets. Instead, the protocol deploys what are called continuous liquidity pools (CLPs), which—with highly complex algorithms—maximise the efficiency of its transactions. These CLPs allow for THORChain to manage funds directly in on-chain vaults, and it secures those funds via an economic security model. For all this, THORChain might be best described as a “cross-chain automated market maker (AMM), like Uniswap”, or even a “decentralised Binance”. ### [​](https://docs.dune.com/data-catalog/thorchain/overview#key-features) Key Features * **Native Cross-Chain Swaps**: Swap native assets across multiple chains without wrapped or pegged tokens * **Continuous Liquidity Pools (CLPs)**: Advanced AMM mechanism that maximizes transaction efficiency * **Economic Security Model**: Secures funds through bonded RUNE and validator economics * **THORNodes**: Anonymous validators who bond RUNE to provide validation services * **Permissionless Network**: Anyone with required funds can become a validator ### [​](https://docs.dune.com/data-catalog/thorchain/overview#thorchain%E2%80%99s-financial-offerings) THORChain’s Financial Offerings THORChain pursues two important financial primitives: 1. Allow a user to **Swap** Asset X on Chain A to Asset Y on Chain B. 2. Allow a user to **Pool** RUNE across liquidity pools. [​](https://docs.dune.com/data-catalog/thorchain/overview#thorchain-data-on-dune) THORChain Data on Dune ----------------------------------------------------------------------------------------------------------- THORChain blockchain data is organized into several key tables that capture different aspects of on-chain activity: [Blocks\ ------\ \ Core block data including block headers, timestamps, and block statistics.](https://docs.dune.com/data-catalog/thorchain/core_block) [Transfers\ ---------\ \ Native asset transfers between addresses on THORChain.](https://docs.dune.com/data-catalog/thorchain/core_transfers) [Swaps\ -----\ \ Cross-chain native asset swaps executed on THORChain.](https://docs.dune.com/data-catalog/thorchain/defi_swaps) [Daily Pool Stats\ ----------------\ \ Daily statistics for Continuous Liquidity Pools (CLPs) including liquidity, swaps, and fees.](https://docs.dune.com/data-catalog/thorchain/defi_daily_pool_stats) [Liquidity Actions\ -----------------\ \ Add and remove liquidity actions across THORChain pools.](https://docs.dune.com/data-catalog/thorchain/defi_liquidity_actions) [Swap Events\ -----------\ \ Event-level data for swaps including amounts, fees, and slippage.](https://docs.dune.com/data-catalog/thorchain/defi_swap_events) [​](https://docs.dune.com/data-catalog/thorchain/overview#network-specifications) Network Specifications ----------------------------------------------------------------------------------------------------------- * **Consensus**: CometBFT (Tendermint) * **State Machine**: Cosmos SDK * **Security**: GG20 Threshold Signature Scheme (TSS) * **Validator Model**: THORNodes with bonded RUNE * **Churn Schedule**: Every three days, rotating validators to prevent centralization [​](https://docs.dune.com/data-catalog/thorchain/overview#resources) Resources --------------------------------------------------------------------------------- * [THORChain Documentation](https://docs.thorchain.org/) * [THORChain Developer Documentation](https://docs.thorchain.org/developers) Was this page helpful? YesNo [Assets prices](https://docs.dune.com/data-catalog/ton/prices_daily) [Instantiate Events](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_instantiate_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_instantiate\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events#table-description) Table Description ---------------------------------------------------------------------------------------------------------------- The `thorchain.core_instantiate_events` table event data for contract instantiation events on THORChain. This table tracks when smart contracts are instantiated on the network. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **contract\_address** | varchar | Address | | **admin\_address** | varchar | Address | | **code\_id** | bigint | Identifier | | **sender** | varchar | Sender | | **label** | varchar | Label | | **msg** | varchar | Msg | | **funds** | varchar | Funds | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_instantiate\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Overview](https://docs.dune.com/data-catalog/thorchain/overview) [Network Version Events](https://docs.dune.com/data-catalog/thorchain/core_network_version_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_block - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_block#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_block [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_block#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_block#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_block#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_block#table-description) Table Description --------------------------------------------------------------------------------------------------- The `thorchain.core_block` table contains block-level data from the THORChain blockchain including block headers, timestamps, and block statistics. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/core_block#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **block\_id** | bigint | Identifier | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_date** | timestamp | Date of when the block was created | | **block\_hour** | timestamp | Block Hour | | **block\_week** | timestamp | Block Week | | **block\_month** | timestamp | Block Month | | **block\_quarter** | timestamp | Block Quarter | | **block\_year** | timestamp | Block Year | | **block\_dayofmonth** | timestamp | Block Dayofmonth | | **block\_dayofweek** | timestamp | Block Dayofweek | | **block\_dayofyear** | timestamp | Block Dayofyear | | **timestamp** | timestamp | Timestamp of the record | | **hash** | varchar | Hash | | **agg\_state** | varchar | Agg State | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_block#table-sample) Table Sample ----------------------------------------------------------------------------------------- Was this page helpful? YesNo [Wasm Contracts Events](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events) [Transfers](https://docs.dune.com/data-catalog/thorchain/core_transfers) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_tss_keygen_success_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_tss\_keygen\_success\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events#table-description) Table Description ----------------------------------------------------------------------------------------------------------------------- The `thorchain.core_tss_keygen_success_events` table event data for tss keygen success on THORChain. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **pub\_key** | varchar | Pub Key | | **members** | varchar | Members | | **height** | varchar | Height | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_tss\_keygen\_success\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Tss Keygen Failure Events](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events) [Wasm Contracts Events](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_wasm_contracts_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_wasm\_contracts\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events#table-description) Table Description ------------------------------------------------------------------------------------------------------------------- The `thorchain.core_wasm_contracts_events` table event data for wasm contracts on THORChain. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **contract\_address** | varchar | Address | | **contract\_type** | varchar | Contract Type | | **sender** | varchar | Sender | | **attributes** | varchar | Attributes | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_wasm\_contracts\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_wasm_contracts_events#table-sample) Table Sample --------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Tss Keygen Success Events](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events) [Block](https://docs.dune.com/data-catalog/thorchain/core_block) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_tss_keygen_failure_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_tss\_keygen\_failure\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events#table-description) Table Description ----------------------------------------------------------------------------------------------------------------------- The `thorchain.core_tss_keygen_failure_events` table event data for tss keygen failure on THORChain. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **fail\_reason** | varchar | Fail Reason | | **is\_unicast** | varchar | Is Unicast | | **blame\_nodes** | varchar | Blame Nodes | | **round** | varchar | Round | | **height** | varchar | Height | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_tss\_keygen\_failure\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Transfer Events](https://docs.dune.com/data-catalog/thorchain/core_transfer_events) [Tss Keygen Success Events](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_success_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_set_mimir_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_set\_mimir\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events#table-description) Table Description -------------------------------------------------------------------------------------------------------------- The `thorchain.core_set_mimir_events` table event data for set mimir on THORChain. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **key** | varchar | Key | | **value** | varchar | Value | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_set\_mimir\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Network Version Events](https://docs.dune.com/data-catalog/thorchain/core_network_version_events) [Thorname Change Events](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_transfers - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_transfers#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_transfers [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_transfers#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_transfers#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_transfers#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_transfers#table-description) Table Description ------------------------------------------------------------------------------------------------------- The `thorchain.core_transfers` table records all native asset transfers on THORChain. This table tracks RUNE and other asset transfers between addresses on the THORChain network. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/core_transfers#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **block\_id** | bigint | Identifier | | **from\_address** | varchar | Source address | | **to\_address** | varchar | Destination address | | **asset** | varchar | Asset identifier | | **rune\_amount** | decimal(38,0) | Amount in RUNE | | **rune\_amount\_usd** | decimal(20,6) | USD value of RUNE amount | | **\_unique\_key** | varchar | Unique Key | | **\_INSERTED\_TIMESTAMP** | timestamp | Timestamp of the record | | **fact\_transfers\_id** | bigint | Surrogate key for the fact record | | **day** | timestamp | Date of the record | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_transfers#table-sample) Table Sample --------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Block](https://docs.dune.com/data-catalog/thorchain/core_block) [Active Vault Events](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_thorname_change_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_thorname\_change\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events#table-description) Table Description -------------------------------------------------------------------------------------------------------------------- The `thorchain.core_thorname_change_events` table event data for thorname change on THORChain. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **owner** | varchar | Owner | | **chain** | varchar | Chain | | **address** | varchar | Address | | **expire** | varchar | Expire | | **name** | varchar | Name | | **fund\_amount\_e8** | bigint | Amount value | | **registration\_fee\_e8** | bigint | Registration Fee E8 | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_thorname\_change\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Set Mimir Events](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events) [Transfer Events](https://docs.dune.com/data-catalog/thorchain/core_transfer_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_active_vault_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_active\_vault\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events#table-description) Table Description ----------------------------------------------------------------------------------------------------------------- The `thorchain.defi_active_vault_events` table event data for active vault on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **add\_asgard\_addr** | varchar | Add Asgard Addr | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_active\_vault\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Transfers](https://docs.dune.com/data-catalog/thorchain/core_transfers) [Add Events](https://docs.dune.com/data-catalog/thorchain/defi_add_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_transfer_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_transfer_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_transfer\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_transfer_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_transfer_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_transfer_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_transfer_events#table-description) Table Description ------------------------------------------------------------------------------------------------------------- The `thorchain.core_transfer_events` table event data for native asset transfers on THORChain. This table captures transfer events between addresses. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/core_transfer_events#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **from\_address** | varchar | Source address | | **to\_address** | varchar | Destination address | | **asset** | varchar | Asset identifier | | **amount\_e8** | bigint | Amount in e8 units (1e8 = 1 unit) | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_transfer\_events\_id** | bigint | Surrogate key for the transfer event record | | **day** | timestamp | Date of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_transfer_events#table-sample) Table Sample --------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Thorname Change Events](https://docs.dune.com/data-catalog/thorchain/core_thorname_change_events) [Tss Keygen Failure Events](https://docs.dune.com/data-catalog/thorchain/core_tss_keygen_failure_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_add_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_add_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_add\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_add_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_add_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_add_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_add_events#table-description) Table Description -------------------------------------------------------------------------------------------------------- The `thorchain.defi_add_events` table event data for liquidity addition actions on THORChain. This table captures events when users add liquidity to pools. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_add_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **fact\_add\_events\_id** | bigint | Surrogate key for the add liquidity event record | | **day** | timestamp | Date of the record | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **tx\_id** | bigint | Transaction ID | | **rune\_e8** | bigint | RUNE amount in e8 units | | **blockchain** | varchar | Source blockchain identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **pool\_name** | varchar | Name of the liquidity pool | | **memo** | varchar | Transaction memo | | **to\_address** | varchar | Destination address | | **from\_address** | varchar | Source address | | **asset** | varchar | Asset identifier | | **\_TX\_TYPE** | varchar | Tx Type | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_add_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Active Vault Events](https://docs.dune.com/data-catalog/thorchain/defi_active_vault_events) [Affiliate Fee Events](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_affiliate_fee_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_affiliate\_fee\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events#table-description) Table Description ------------------------------------------------------------------------------------------------------------------ The `thorchain.defi_affiliate_fee_events` table event data for affiliate fee on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **fee\_amt** | varchar | Fee Amt | | **gross\_amt** | varchar | Gross Amt | | **fee\_bps** | varchar | Fee Bps | | **memo** | varchar | Transaction memo | | **asset** | varchar | Asset identifier | | **rune\_address** | varchar | Address | | **thorname** | varchar | Thorname | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_affiliate\_fee\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events#table-sample) Table Sample -------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Add Events](https://docs.dune.com/data-catalog/thorchain/defi_add_events) [Asgard Fund Yggdrasil Events](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.core_network_version_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/core_network_version_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.core\_network\_version\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/core_network_version_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/core_network_version_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/core_network_version_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/core_network_version_events#table-description) Table Description -------------------------------------------------------------------------------------------------------------------- The `thorchain.core_network_version_events` table event data for network version on THORChain. This table is partitioned by block\_month. [​](https://docs.dune.com/data-catalog/thorchain/core_network_version_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **version** | varchar | Version | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/core_network_version_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Instantiate Events](https://docs.dune.com/data-catalog/thorchain/core_instantiate_events) [Set Mimir Events](https://docs.dune.com/data-catalog/thorchain/core_set_mimir_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_daily_tvl - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_daily\_tvl [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl#table-description) Table Description ------------------------------------------------------------------------------------------------------- The `thorchain.defi_daily_tvl` table daily total value locked (TVL) statistics for THORChain. This table tracks the total value locked across all pools on a daily basis. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **day** | date | Date of the record | | **total\_value\_pooled** | varchar | Total Value Pooled | | **total\_value\_pooled\_usd** | decimal(20,6) | Total Value Pooled Usd | | **total\_value\_bonded** | varchar | Total Value Bonded | | **total\_value\_bonded\_usd** | decimal(20,6) | Total Value Bonded Usd | | **total\_value\_locked** | varchar | Total Value Locked | | **total\_value\_locked\_usd** | decimal(20,6) | Total Value Locked Usd | | **fact\_daily\_tvl\_id** | bigint | Surrogate key for the fact record | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl#table-sample) Table Sample --------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Daily Earnings](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings) [Errata Events](https://docs.dune.com/data-catalog/thorchain/defi_errata_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_block_pool_depths - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_block\_pool\_depths [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths#table-description) Table Description --------------------------------------------------------------------------------------------------------------- The `thorchain.defi_block_pool_depths` table block-level data for block pool depths on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **pool\_name** | varchar | Name of the liquidity pool | | **asset\_e8** | bigint | Asset amount in e8 units | | **rune\_e8** | bigint | RUNE amount in e8 units | | **synth\_e8** | bigint | Synth E8 | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths#table-sample) Table Sample ----------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Asgard Fund Yggdrasil Events](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events) [Block Rewards](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_fee_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_fee_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_fee\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_fee_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_fee_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_fee_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_fee_events#table-description) Table Description -------------------------------------------------------------------------------------------------------- The `thorchain.defi_fee_events` table event data for fee events on THORChain. This table captures fee-related events including pool deductions and asset fees. [​](https://docs.dune.com/data-catalog/thorchain/defi_fee_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_date** | date | Date of when the block was created | | **block\_month** | timestamp | Month of when the block was created | | **block\_height** | bigint | Block height | | **tx\_id** | varchar | Transaction ID | | **event\_id** | varchar | Event identifier | | **asset** | varchar | Asset identifier | | **pool\_deduct** | varchar | Pool deduction information | | **asset\_e8** | bigint | Asset amount in e8 units | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_fee_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Failed Deposit Messages](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages) [Gas Events](https://docs.dune.com/data-catalog/thorchain/defi_gas_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_bond_actions - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_bond\_actions [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions#table-description) Table Description ---------------------------------------------------------------------------------------------------------- The `thorchain.defi_bond_actions` table records of bond actions on THORChain. This table tracks bonding and unbonding actions for validators and includes asset amounts and USD values. [​](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **fact\_bond\_actions\_id** | varchar | Surrogate key for the bond action record | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **dim\_block\_id** | varchar | Reference to the block dimension table | | **tx\_id** | varchar | Transaction ID | | **from\_address** | varchar | Source address | | **to\_address** | varchar | Destination address | | **asset** | varchar | Asset identifier | | **blockchain** | varchar | Source blockchain identifier | | **bond\_type** | varchar | Type of bond action | | **asset\_amount** | decimal(38,0) | Amount of asset | | **asset\_usd** | decimal(20,6) | USD value of asset amount | | **memo** | varchar | Transaction memo | | **\_TX\_TYPE** | varchar | Transaction type | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions#table-sample) Table Sample ------------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Block Rewards](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards) [Bond Events](https://docs.dune.com/data-catalog/thorchain/defi_bond_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_inactive_vault_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_inactive\_vault\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events#table-description) Table Description ------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_inactive_vault_events` table event data for inactive vault on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **add\_asgard\_addr** | varchar | Add Asgard Addr | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **add\_asgard\_address** | varchar | Address | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_inactive\_vault\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events#table-sample) Table Sample --------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Gas Events](https://docs.dune.com/data-catalog/thorchain/defi_gas_events) [Loan Open Events](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_block_rewards - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_block\_rewards [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards#table-description) Table Description ----------------------------------------------------------------------------------------------------------- The `thorchain.defi_block_rewards` table block-level data for block rewards on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **day** | date | Date of the record | | **liquidity\_fee** | varchar | Identifier | | **block\_rewards** | varchar | Block Rewards | | **earnings** | varchar | Earnings | | **bonding\_earnings** | varchar | Bonding Earnings | | **liquidity\_earnings** | varchar | Identifier | | **avg\_node\_count** | varchar | Avg Node Count | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_block_rewards#table-sample) Table Sample ------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Block Pool Depths](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths) [Bond Actions](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_daily_earnings - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_daily\_earnings [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings#table-description) Table Description ------------------------------------------------------------------------------------------------------------ The `thorchain.defi_daily_earnings` table daily earnings statistics for THORChain. This table tracks liquidity fees, block rewards, and total earnings distributed to nodes and pools. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **day** | date | Date of the record | | **liquidity\_fees** | varchar | Identifier | | **liquidity\_fees\_usd** | decimal(20,6) | Identifier | | **block\_rewards** | varchar | Block Rewards | | **block\_rewards\_usd** | decimal(20,6) | Block Rewards Usd | | **total\_earnings** | varchar | Total Earnings | | **total\_earnings\_usd** | decimal(20,6) | Total Earnings Usd | | **earnings\_to\_nodes** | varchar | Earnings To Nodes | | **earnings\_to\_nodes\_usd** | decimal(20,6) | Earnings To Nodes Usd | | **earnings\_to\_pools** | varchar | Earnings To Pools | | **earnings\_to\_pools\_usd** | decimal(20,6) | Earnings To Pools Usd | | **avg\_node\_count** | varchar | Avg Node Count | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_daily\_earnings\_id** | bigint | Surrogate key for the fact record | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings#table-sample) Table Sample -------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Bond Events](https://docs.dune.com/data-catalog/thorchain/defi_bond_events) [Daily Tvl](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_failed_deposit_messages - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_failed\_deposit\_messages [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages#table-description) Table Description --------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_failed_deposit_messages` table contains data for failed deposit messages on THORChain. [​](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **amount\_e8** | bigint | Amount in e8 units (1e8 = 1 unit) | | **asset** | varchar | Asset identifier | | **from\_addr** | varchar | From Addr | | **memo** | varchar | Transaction memo | | **code** | varchar | Code | | **reason** | varchar | Reason | | **tx\_id** | bigint | Transaction ID | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **from\_address** | varchar | Source address | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_failed\_deposit\_messages\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages#table-sample) Table Sample ----------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Errata Events](https://docs.dune.com/data-catalog/thorchain/defi_errata_events) [Fee Events](https://docs.dune.com/data-catalog/thorchain/defi_fee_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_gas_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_gas_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_gas\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_gas_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_gas_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_gas_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_gas_events#table-description) Table Description -------------------------------------------------------------------------------------------------------- The `thorchain.defi_gas_events` table event data for gas on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_gas_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **rune\_e8** | bigint | RUNE amount in e8 units | | **tx\_count** | varchar | Tx Count | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | varchar | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_gas\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_gas_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Fee Events](https://docs.dune.com/data-catalog/thorchain/defi_fee_events) [Inactive Vault Events](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_errata_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_errata_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_errata\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_errata_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_errata_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_errata_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_errata_events#table-description) Table Description ----------------------------------------------------------------------------------------------------------- The `thorchain.defi_errata_events` table event data for errata on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_errata_events#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **in\_tx** | varchar | In Tx | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **rune\_e8** | bigint | RUNE amount in e8 units | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_errata\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_errata_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Daily Tvl](https://docs.dune.com/data-catalog/thorchain/defi_daily_tvl) [Failed Deposit Messages](https://docs.dune.com/data-catalog/thorchain/defi_failed_deposit_messages) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_asgard_fund_yggdrasil_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_asgard\_fund\_yggdrasil\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events#table-description) Table Description -------------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_asgard_fund_yggdrasil_events` table event data for asgard fund yggdrasil on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx** | varchar | Tx | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **vault\_key** | varchar | Vault Key | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **tx\_id** | bigint | Transaction ID | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_asgard\_fund\_yggdrasil\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_asgard_fund_yggdrasil_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Affiliate Fee Events](https://docs.dune.com/data-catalog/thorchain/defi_affiliate_fee_events) [Block Pool Depths](https://docs.dune.com/data-catalog/thorchain/defi_block_pool_depths) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_bond_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_bond_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_bond\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_bond_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_bond_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_bond_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_bond_events#table-description) Table Description --------------------------------------------------------------------------------------------------------- The `thorchain.defi_bond_events` table event data for bond actions on THORChain. This table tracks bonding and unbonding events for validators. [​](https://docs.dune.com/data-catalog/thorchain/defi_bond_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **blockchain** | varchar | Source blockchain identifier | | **from\_address** | varchar | Source address | | **to\_address** | varchar | Destination address | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **memo** | varchar | Transaction memo | | **bond\_type** | varchar | Bond Type | | **e8** | varchar | E8 | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **\_tx\_type** | varchar | Tx Type | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_bond\_events\_id** | bigint | Surrogate key for the bond event record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_bond_events#table-sample) Table Sample ----------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Bond Actions](https://docs.dune.com/data-catalog/thorchain/defi_bond_actions) [Daily Earnings](https://docs.dune.com/data-catalog/thorchain/defi_daily_earnings) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_outbound_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_outbound\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events#table-description) Table Description ------------------------------------------------------------------------------------------------------------- The `thorchain.defi_outbound_events` table event data for outbound on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **blockchain** | varchar | Source blockchain identifier | | **from\_address** | varchar | Source address | | **to\_address** | varchar | Destination address | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **asset\_amount** | decimal(38,0) | Amount of asset | | **memo** | varchar | Transaction memo | | **in\_tx** | varchar | In Tx | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | varchar | Block Month | | **\_tx\_type** | varchar | Tx Type | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_outbound\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events#table-sample) Table Sample --------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Mint Burn Events](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events) [Pending Liquidity Events](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_loan_open_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_loan\_open\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events#table-description) Table Description -------------------------------------------------------------------------------------------------------------- The `thorchain.defi_loan_open_events` table event data for loan open on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **owner** | varchar | Owner | | **collateralization\_ratio** | varchar | Collateralization Ratio | | **collateral\_asset** | varchar | Collateral Asset | | **target\_asset** | varchar | Target Asset | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **collateral\_deposited** | varchar | Collateral Deposited | | **debt\_issued** | varchar | Debt Issued | | **tx\_id** | bigint | Transaction ID | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | varchar | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Inactive Vault Events](https://docs.dune.com/data-catalog/thorchain/defi_inactive_vault_events) [Loan Repayment Events](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_pending_liquidity_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_pending\_liquidity\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events#table-description) Table Description ---------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_pending_liquidity_events` table event data for pending liquidity on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **pool\_name** | varchar | Name of the liquidity pool | | **asset\_tx\_id** | bigint | Identifier | | **asset\_blockchain** | varchar | Asset Blockchain | | **asset\_address** | varchar | Address | | **asset\_e8** | bigint | Asset amount in e8 units | | **asset\_amount** | decimal(38,0) | Amount of asset | | **rune\_tx\_id** | bigint | Identifier | | **rune\_address** | varchar | Address | | **rune\_e8** | bigint | RUNE amount in e8 units | | **rune\_amount** | decimal(38,0) | Amount in RUNE | | **pending\_type** | varchar | Pending Type | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | varchar | Block Month | | **pool\_chain** | varchar | Pool Chain | | **pool\_asset** | varchar | Pool Asset | | **fact\_pending\_liquidity\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Outbound Events](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events) [Pool Balance Change Events](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_loan_repayment_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_loan\_repayment\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events#table-description) Table Description ------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_loan_repayment_events` table event data for loan repayment on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **owner** | varchar | Owner | | **collateral\_asset** | varchar | Collateral Asset | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **collateral\_withdrawn** | varchar | Collateral Withdrawn | | **debt\_repaid** | varchar | Identifier | | **tx\_id** | bigint | Transaction ID | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | varchar | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events#table-sample) Table Sample --------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Loan Open Events](https://docs.dune.com/data-catalog/thorchain/defi_loan_open_events) [Mint Burn Events](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_mint_burn_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_mint\_burn\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events#table-description) Table Description -------------------------------------------------------------------------------------------------------------- The `thorchain.defi_mint_burn_events` table event data for mint burn on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **supply** | varchar | Supply | | **reason** | varchar | Reason | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_mint_burn_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Loan Repayment Events](https://docs.dune.com/data-catalog/thorchain/defi_loan_repayment_events) [Outbound Events](https://docs.dune.com/data-catalog/thorchain/defi_outbound_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_pool_balance_change_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_pool\_balance\_change\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events#table-description) Table Description ------------------------------------------------------------------------------------------------------------------------ The `thorchain.defi_pool_balance_change_events` table event data for pool balance change on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **asset** | varchar | Asset identifier | | **rune\_amt** | varchar | Rune Amt | | **rune\_add** | varchar | Rune Add | | **asset\_amt** | varchar | Asset Amt | | **asset\_add** | varchar | Asset Add | | **reason** | varchar | Reason | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **rune\_amount** | decimal(38,0) | Amount in RUNE | | **asset\_amount** | decimal(38,0) | Amount of asset | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_pool\_balance\_change\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events#table-sample) Table Sample -------------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Pending Liquidity Events](https://docs.dune.com/data-catalog/thorchain/defi_pending_liquidity_events) [Pool Block Balances](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_pool_block_statistics - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_pool\_block\_statistics [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics#table-description) Table Description ------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_pool_block_statistics` table block-level data for pool statistics on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **day** | date | Date of the record | | **add\_asset\_liquidity\_volume** | varchar | Identifier | | **add\_liquidity\_count** | varchar | Identifier | | **add\_liquidity\_volume** | varchar | Identifier | | **add\_rune\_liquidity\_volume** | varchar | Identifier | | **asset** | varchar | Asset identifier | | **asset\_depth** | varchar | Asset Depth | | **asset\_price** | varchar | Asset Price | | **asset\_price\_usd** | decimal(20,6) | Asset Price Usd | | **average\_slip** | varchar | Average Slip | | **impermanent\_loss\_protection\_paid** | varchar | Identifier | | **rune\_depth** | varchar | Rune Depth | | **status** | varchar | Status | | **swap\_count** | varchar | Swap Count | | **swap\_volume** | varchar | Swap Volume | | **to\_asset\_average\_slip** | varchar | To Asset Average Slip | | **to\_asset\_count** | varchar | To Asset Count | | **to\_asset\_fees** | varchar | To Asset Fees | | **to\_asset\_volume** | varchar | To Asset Volume | | **to\_rune\_average\_slip** | varchar | To Rune Average Slip | | **to\_rune\_count** | varchar | To Rune Count | | **to\_rune\_fees** | varchar | To Rune Fees | | **to\_rune\_volume** | varchar | To Rune Volume | | **totalfees** | varchar | Totalfees | | **unique\_member\_count** | varchar | Unique Member Count | | **unique\_swapper\_count** | varchar | Unique Swapper Count | | **units** | varchar | Units | | **withdraw\_asset\_volume** | varchar | Withdraw Asset Volume | | **withdraw\_count** | varchar | Withdraw Count | | **withdraw\_rune\_volume** | varchar | Withdraw Rune Volume | | **withdraw\_volume** | varchar | Withdraw Volume | | **total\_stake** | varchar | Total Stake | | **depth\_product** | varchar | Depth Product | | **synth\_units** | varchar | Synth Units | | **pool\_units** | varchar | Pool Units | | **liquidity\_unit\_value\_index** | varchar | Identifier | | **prev\_liquidity\_unit\_value\_index** | varchar | Identifier | | **\_unique\_key** | varchar | Unique Key | | **fact\_pool\_block\_statistics\_id** | bigint | Surrogate key for the fact record | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics#table-sample) Table Sample --------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Pool Block Fees](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees) [Pool Events](https://docs.dune.com/data-catalog/thorchain/defi_pool_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_pool_block_fees - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_pool\_block\_fees [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees#table-description) Table Description ------------------------------------------------------------------------------------------------------------- The `thorchain.defi_pool_block_fees` table block-level data for pool fees on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **DAY** | date | Date of the record | | **pool\_name** | varchar | Name of the liquidity pool | | **rewards** | varchar | Rewards | | **total\_liquidity\_fees\_rune** | varchar | Identifier | | **asset\_liquidity\_fees** | varchar | Identifier | | **rune\_liquidity\_fees** | varchar | Identifier | | **earnings** | varchar | Earnings | | **\_unique\_key** | varchar | Unique Key | | **\_INSERTED\_TIMESTAMP** | timestamp | Timestamp of the record | | **fact\_pool\_block\_fees\_id** | bigint | Surrogate key for the fact record | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees#table-sample) Table Sample --------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Pool Block Balances](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances) [Pool Block Statistics](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_pool_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_pool_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_pool\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_pool_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_pool_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_pool_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_events#table-description) Table Description --------------------------------------------------------------------------------------------------------- The `thorchain.defi_pool_events` table event data for pool-related events on THORChain. This table captures various pool events including balance changes and pool operations. [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **asset** | varchar | Asset identifier | | **status** | varchar | Status | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **fact\_pool\_events\_id** | bigint | Surrogate key for the fact record | | **day** | timestamp | Date of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_events#table-sample) Table Sample ----------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Pool Block Statistics](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_statistics) [Refund Events](https://docs.dune.com/data-catalog/thorchain/defi_refund_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_pool_block_balances - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_pool\_block\_balances [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances#table-description) Table Description ----------------------------------------------------------------------------------------------------------------- The `thorchain.defi_pool_block_balances` table block-level balances for Continuous Liquidity Pools (CLPs) on THORChain. This table tracks RUNE, asset, and synthetic asset balances in pools at each block. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **fact\_pool\_block\_balances\_id** | varchar | Surrogate key for the pool block balance record | | **day** | date | Date of the record | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **dim\_block\_id** | varchar | Reference to the block dimension table | | **pool\_name** | varchar | Name of the liquidity pool | | **rune\_amount** | decimal(38,0) | RUNE balance in the pool | | **rune\_amount\_usd** | decimal(20,6) | USD value of RUNE balance | | **asset\_amount** | decimal(38,0) | Asset balance in the pool | | **asset\_amount\_usd** | decimal(20,6) | USD value of asset balance | | **synth\_amount** | decimal(38,0) | Synthetic asset amount in the pool | | **synth\_amount\_usd** | decimal(20,6) | USD value of synthetic asset amount | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_balances#table-sample) Table Sample ------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Pool Balance Change Events](https://docs.dune.com/data-catalog/thorchain/defi_pool_balance_change_events) [Pool Block Fees](https://docs.dune.com/data-catalog/thorchain/defi_pool_block_fees) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_refund_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_refund_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_refund\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_refund_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_refund_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_refund_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_refund_events#table-description) Table Description ----------------------------------------------------------------------------------------------------------- The `thorchain.defi_refund_events` table event data for refund on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_refund_events#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **blockchain** | varchar | Source blockchain identifier | | **from\_address** | varchar | Source address | | **to\_address** | varchar | Destination address | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **asset\_2nd** | varchar | Asset 2Nd | | **asset\_2nd\_e8** | bigint | Asset 2Nd E8 | | **memo** | varchar | Transaction memo | | **code** | varchar | Code | | **reason** | varchar | Reason | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | varchar | Block Month | | **\_tx\_type** | varchar | Tx Type | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | [​](https://docs.dune.com/data-catalog/thorchain/defi_refund_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Pool Events](https://docs.dune.com/data-catalog/thorchain/defi_pool_events) [Reserve Events](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_reserve_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_reserve\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events#table-description) Table Description ------------------------------------------------------------------------------------------------------------ The `thorchain.defi_reserve_events` table event data for reserve on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events#column-descriptions) Column Descriptions ---------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **blockchain** | varchar | Source blockchain identifier | | **from\_address** | varchar | Source address | | **to\_address** | varchar | Destination address | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **memo** | varchar | Transaction memo | | **address** | varchar | Address | | **e8** | varchar | E8 | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **\_tx\_type** | varchar | Tx Type | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_reserve\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events#table-sample) Table Sample -------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Refund Events](https://docs.dune.com/data-catalog/thorchain/defi_refund_events) [Rewards Event Entries](https://docs.dune.com/data-catalog/thorchain/defi_rewards_event_entries) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_rewards_event_entries - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_rewards_event_entries#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_rewards\_event\_entries [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_rewards_event_entries#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_rewards_event_entries#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_rewards_event_entries#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_rewards_event_entries#table-description) Table Description ------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_rewards_event_entries` table contains individual reward distribution entries on THORChain. [​](https://docs.dune.com/data-catalog/thorchain/defi_rewards_event_entries#column-descriptions) Column Descriptions ----------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **pool\_name** | varchar | Name of the liquidity pool | | **rune\_e8** | bigint | RUNE amount in e8 units | | **saver\_e8** | bigint | Saver E8 | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_rewards\_event\_entries\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_rewards_event_entries#table-sample) Table Sample --------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Reserve Events](https://docs.dune.com/data-catalog/thorchain/defi_reserve_events) [Rewards Events](https://docs.dune.com/data-catalog/thorchain/defi_rewards_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_tcy_unstake_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_tcy\_unstake\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events#table-description) Table Description ---------------------------------------------------------------------------------------------------------------- The `thorchain.defi_tcy_unstake_events` table event data for tcy unstake on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **amount** | decimal(38,0) | Amount value | | **rune\_address** | varchar | Address | | **memo** | varchar | Transaction memo | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_tcy\_unstake\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Tcy Stake Events](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events) [Total Block Rewards](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_tcy_distribution_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_tcy\_distribution\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events#table-description) Table Description --------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_tcy_distribution_events` table event data for tcy distribution on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **rune\_address** | varchar | Address | | **rune\_amt** | varchar | Rune Amt | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_tcy\_distribution\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events#table-sample) Table Sample ----------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Tcy Claim Events](https://docs.dune.com/data-catalog/thorchain/defi_tcy_claim_events) [Tcy Stake Events](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_send_messages - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_send_messages#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_send\_messages [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_send_messages#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_send_messages#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_send_messages#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_send_messages#table-description) Table Description ----------------------------------------------------------------------------------------------------------- The `thorchain.defi_send_messages` table contains outgoing send messages on THORChain. [​](https://docs.dune.com/data-catalog/thorchain/defi_send_messages#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **amount\_e8** | bigint | Amount in e8 units (1e8 = 1 unit) | | **asset** | varchar | Asset identifier | | **from\_address** | varchar | Source address | | **to\_address** | varchar | Destination address | | **memo** | varchar | Transaction memo | | **tx\_id** | bigint | Transaction ID | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_send\_messages\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_send_messages#table-sample) Table Sample ------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Secure Asset Withdraw Events](https://docs.dune.com/data-catalog/thorchain/defi_secure_asset_withdraw_events) [Stake Events](https://docs.dune.com/data-catalog/thorchain/defi_stake_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_rune_pool_withdraw_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_rune\_pool\_withdraw\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events#table-description) Table Description ----------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_rune_pool_withdraw_events` table event data for rune pool withdraw on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **rune\_addr** | varchar | Rune Addr | | **amount\_e8** | bigint | Amount in e8 units (1e8 = 1 unit) | | **units** | varchar | Units | | **basis\_points** | int | Basis Points | | **affiliate\_basis\_pts** | varchar | Affiliate Basis Pts | | **affiliate\_amount\_e8** | bigint | Amount value | | **affiliate\_addr** | varchar | Affiliate Addr | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **rune\_address** | varchar | Address | | **affiliate\_basis\_points** | int | Affiliate Basis Points | | **affiliate\_address** | varchar | Address | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Rune Pool Deposit Events](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_deposit_events) [Scheduled Outbound Events](https://docs.dune.com/data-catalog/thorchain/defi_scheduled_outbound_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_tcy_claim_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_tcy_claim_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_tcy\_claim\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_tcy_claim_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_tcy_claim_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_tcy_claim_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_claim_events#table-description) Table Description -------------------------------------------------------------------------------------------------------------- The `thorchain.defi_tcy_claim_events` table event data for tcy claim on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_claim_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **rune\_address** | varchar | Address | | **l1\_address** | varchar | Address | | **asset** | varchar | Asset identifier | | **tcy\_amt** | varchar | Tcy Amt | | **memo** | varchar | Transaction memo | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_tcy\_claim\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_claim_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Switch Events](https://docs.dune.com/data-catalog/thorchain/defi_switch_events) [Tcy Distribution Events](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_stake_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_stake_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_stake\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_stake_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_stake_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_stake_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_stake_events#table-description) Table Description ---------------------------------------------------------------------------------------------------------- The `thorchain.defi_stake_events` table event data for stake on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_stake_events#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **pool\_name** | varchar | Name of the liquidity pool | | **asset\_tx\_id** | bigint | Identifier | | **asset\_blockchain** | varchar | Asset Blockchain | | **asset\_address** | varchar | Address | | **asset\_e8** | bigint | Asset amount in e8 units | | **stake\_units** | varchar | Pool units (LP tokens) received or burned | | **rune\_tx\_id** | bigint | Identifier | | **rune\_address** | varchar | Address | | **rune\_e8** | bigint | RUNE amount in e8 units | | **\_ASSET\_IN\_RUNE\_E8** | bigint | Asset In Rune E8 | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **\_INSERTED\_TIMESTAMP** | timestamp | Timestamp of the record | | **fact\_stake\_events\_id** | bigint | Surrogate key for the fact record | | **day** | timestamp | Date of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_stake_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Send Messages](https://docs.dune.com/data-catalog/thorchain/defi_send_messages) [Streaming Swap Details Events](https://docs.dune.com/data-catalog/thorchain/defi_streaming_swap_details_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_rune_pool_deposit_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_deposit_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_rune\_pool\_deposit\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_deposit_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_deposit_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_deposit_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_deposit_events#table-description) Table Description ---------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_rune_pool_deposit_events` table event data for rune pool deposit on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_deposit_events#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **rune\_addr** | varchar | Rune Addr | | **amount\_e8** | bigint | Amount in e8 units (1e8 = 1 unit) | | **units** | varchar | Units | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **rune\_address** | varchar | Address | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_deposit_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Rewards Events](https://docs.dune.com/data-catalog/thorchain/defi_rewards_events) [Rune Pool Withdraw Events](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_tcy_stake_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_tcy\_stake\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events#table-description) Table Description -------------------------------------------------------------------------------------------------------------- The `thorchain.defi_tcy_stake_events` table event data for tcy stake on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events#column-descriptions) Column Descriptions ------------------------------------------------------------------------------------------------------------------ | **Column** | **Type** | **Description** | | --- | --- | --- | | **tx\_id** | bigint | Transaction ID | | **amount** | decimal(38,0) | Amount value | | **rune\_address** | varchar | Address | | **memo** | varchar | Transaction memo | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | timestamp | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_tcy\_stake\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_tcy_stake_events#table-sample) Table Sample ---------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Tcy Distribution Events](https://docs.dune.com/data-catalog/thorchain/defi_tcy_distribution_events) [Tcy Unstake Events](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_scheduled_outbound_events - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_scheduled_outbound_events#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_scheduled\_outbound\_events [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_scheduled_outbound_events#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_scheduled_outbound_events#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_scheduled_outbound_events#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_scheduled_outbound_events#table-description) Table Description ----------------------------------------------------------------------------------------------------------------------- The `thorchain.defi_scheduled_outbound_events` table event data for scheduled outbound on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_scheduled_outbound_events#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **blockchain** | varchar | Source blockchain identifier | | **to\_address** | varchar | Destination address | | **asset** | varchar | Asset identifier | | **asset\_e8** | bigint | Asset amount in e8 units | | **asset\_decimals** | decimal(38,0) | Asset Decimals | | **gas\_rate** | varchar | Gas Rate | | **memo** | varchar | Transaction memo | | **in\_hash** | varchar | In Hash | | **out\_hash** | varchar | Out Hash | | **max\_gas\_amount** | decimal(38,0) | Amount value | | **max\_gas\_decimals** | decimal(38,0) | Max Gas Decimals | | **max\_gas\_asset** | varchar | Max Gas Asset | | **module\_name** | varchar | Module Name | | **vault\_pub\_key** | varchar | Vault Pub Key | | **event\_id** | bigint | Event identifier | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **block\_time** | timestamp | Timestamp of when the block was created | | **block\_month** | varchar | Block Month | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_scheduled\_outbound\_events\_id** | bigint | Surrogate key for the fact record | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_scheduled_outbound_events#table-sample) Table Sample ------------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Rune Pool Withdraw Events](https://docs.dune.com/data-catalog/thorchain/defi_rune_pool_withdraw_events) [Secure Asset Deposit Events](https://docs.dune.com/data-catalog/thorchain/defi_secure_asset_deposit_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_total_block_rewards - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_total\_block\_rewards [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards#table-description) Table Description ----------------------------------------------------------------------------------------------------------------- The `thorchain.defi_total_block_rewards` table block-level data for total rewards on THORChain. This table is partitioned by day. [​](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards#column-descriptions) Column Descriptions --------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **block\_id** | bigint | Identifier | | **reward\_entity** | varchar | Reward Entity | | **rune\_amount** | decimal(38,0) | Amount in RUNE | | **rune\_amount\_usd** | decimal(20,6) | USD value of RUNE amount | | **\_unique\_key** | varchar | Unique Key | | **\_INSERTED\_TIMESTAMP** | timestamp | Timestamp of the record | | **fact\_total\_block\_rewards\_id** | bigint | Surrogate key for the fact record | | **block\_timestamp** | timestamp | Timestamp of when the block was created | | **dim\_block\_id** | bigint | Reference to the block dimension table | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards#table-sample) Table Sample ------------------------------------------------------------------------------------------------------- Was this page helpful? YesNo [Tcy Unstake Events](https://docs.dune.com/data-catalog/thorchain/defi_tcy_unstake_events) [Total Value Locked](https://docs.dune.com/data-catalog/thorchain/defi_total_value_locked) ⌘I Assistant Responses are generated using AI and may contain mistakes. --- # thorchain.defi_total_value_locked - Dune Docs [Skip to main content](https://docs.dune.com/data-catalog/thorchain/defi_total_value_locked#content-area) [Dune Docs home page![light logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=6fec71d5070d0923eb2924321131b1c2)![dark logo](https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max&auto=format&n=zh-3B8LgVmyrKOaG&q=85&s=2501750983cc95aa72d40acc6f005bd9)](https://docs.dune.com/) Search... ⌘KAsk AI Search... Navigation THORChain thorchain.defi\_total\_value\_locked [Docs](https://docs.dune.com/) [Data Catalog](https://docs.dune.com/data-catalog/overview) [API Reference](https://docs.dune.com/api-reference/overview/introduction) [SQL Query Engine](https://docs.dune.com/query-engine/overview) [Resources](https://docs.dune.com/resources/credits-billing/overview) On this page * [Table Description](https://docs.dune.com/data-catalog/thorchain/defi_total_value_locked#table-description) * [Column Descriptions](https://docs.dune.com/data-catalog/thorchain/defi_total_value_locked#column-descriptions) * [Table Sample](https://docs.dune.com/data-catalog/thorchain/defi_total_value_locked#table-sample) [​](https://docs.dune.com/data-catalog/thorchain/defi_total_value_locked#table-description) Table Description ---------------------------------------------------------------------------------------------------------------- The `thorchain.defi_total_value_locked` table tracks total value locked (TVL) across THORChain pools. [​](https://docs.dune.com/data-catalog/thorchain/defi_total_value_locked#column-descriptions) Column Descriptions -------------------------------------------------------------------------------------------------------------------- | **Column** | **Type** | **Description** | | --- | --- | --- | | **day** | date | Date of the record | | **total\_value\_pooled** | varchar | Total Value Pooled | | **total\_value\_bonded** | varchar | Total Value Bonded | | **total\_value\_locked** | varchar | Total Value Locked | | **\_inserted\_timestamp** | timestamp | Timestamp of the record | | **fact\_total\_value\_locked\_id** | bigint | Surrogate key for the fact record | | **inserted\_timestamp** | timestamp | Time when the record was inserted | | **modified\_timestamp** | timestamp | Time when the record was last modified | [​](https://docs.dune.com/data-catalog/thorchain/defi_total_value_locked#table-sample) Table Sample ------------------------------------------------------------------------------------------------------ Was this page helpful? YesNo [Total Block Rewards](https://docs.dune.com/data-catalog/thorchain/defi_total_block_rewards) [Trade Account Deposit Events](https://docs.dune.com/data-catalog/thorchain/defi_trade_account_deposit_events) ⌘I Assistant Responses are generated using AI and may contain mistakes. ---