Skip to main content
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"
          }
        }
      ]
    }
  ]
}