Skip to main content
GET
/
v1
/
datasets
/
{slug}
Get a dataset by slug
curl --request GET \
  --url https://api.dune.com/api/v1/datasets/{slug} \
  --header 'X-Dune-Api-Key: <x-dune-api-key>'
{
  "columns": [
    {
      "metadata": {
        "description": "<string>",
        "filtering_column": true
      },
      "name": "<string>",
      "nullable": true,
      "type": "<string>"
    }
  ],
  "created_at": "<string>",
  "full_name": "<string>",
  "is_private": true,
  "metadata": "<unknown>",
  "owner": {
    "handle": "<string>",
    "type": "<string>"
  },
  "type": "<string>",
  "updated_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.dune.com/llms.txt

Use this file to discover all available pages before exploring further.

Minimum required API key scope: Read
  • 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

​
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

​
X-Dune-Api-Key
string
required

API Key for the service

Path Parameters

​
slug
string
required

Dataset slug (e.g., 'dex.trades')

Query Parameters

​
api_key
string

API Key, alternative to using the HTTP header X-Dune-Api-Key

Response

OK

​
columns
object[]
​
created_at
string
​
full_name
string
​
is_private
boolean
​
metadata
any
​
owner
object
​
type
string
​
updated_at
string