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

​
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 spells, 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

​
X-Dune-Api-Key
string
required

API Key for the service

Query Parameters

​
api_key
string

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

​
limit
integer

Number of results to return (default 50, max 250)

​
offset
integer

Offset for pagination

​
owner_handle
string

Filter by owner handle

​
type
string

Filter by dataset types (comma-separated: transformation_view, transformation_table, uploaded_table, decoded_table, spell, dune_table)

Response

OK

​
datasets
object[]
​
total
integer