Skip to main content
GET
/
v1
/
tables
curl -X GET "https://api.dune.com/api/v1/tables?limit=10&offset=0" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY"

{
  "tables": [
    {
      "full_name": "dune.dune.ai_contract_tags",
      "is_private": true,
      "table_size_bytes": "1152622",
      "created_at": "2024-05-15T20:34:58.585Z",
      "updated_at": "2024-05-16T21:19:02.459Z",
      "purged_at": null,
      "owner": {
        "handle": "dune",
        "type": "team"
      },
      "columns": [
        {
          "name": "blockchain",
          "type": "string",
          "nullable": false,
          "metadata": {
            "description": "Blockchain associated with the record",
            "filtering_column": true
          }
        },
        {
          "name": "contract_address",
          "type": "string",
          "nullable": false,
          "metadata": {
            "description": "Address of the smart contract"
          }
        }
      ]
    }
  ]
}

​
Description

Retrieves a paginated list of tables uploaded by the user or their team.

​
Pagination

Use the limit and offset parameters to paginate through large result sets:
  • To get the first 20 tables: ?limit=20&offset=0
  • To get the next 20 tables: ?limit=20&offset=20
  • Continue incrementing offset by limit to get subsequent pages

​
Pricing

This is a metadata endpoint and does not consume credits. 
curl -X GET "https://api.dune.com/api/v1/tables?limit=10&offset=0" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY"

{
  "tables": [
    {
      "full_name": "dune.dune.ai_contract_tags",
      "is_private": true,
      "table_size_bytes": "1152622",
      "created_at": "2024-05-15T20:34:58.585Z",
      "updated_at": "2024-05-16T21:19:02.459Z",
      "purged_at": null,
      "owner": {
        "handle": "dune",
        "type": "team"
      },
      "columns": [
        {
          "name": "blockchain",
          "type": "string",
          "nullable": false,
          "metadata": {
            "description": "Blockchain associated with the record",
            "filtering_column": true
          }
        },
        {
          "name": "contract_address",
          "type": "string",
          "nullable": false,
          "metadata": {
            "description": "Address of the smart contract"
          }
        }
      ]
    }
  ]
}

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 tables to return on a page. Default: 50, max: 10000

​
offset
integer

Offset used for pagination. Negative values are treated as 0

Response

OK

​
next_offset
integer

Offset for next page of results

​
tables
object[]