POST
/
v1
/
table
/
create
curl --request POST \
  --url https://api.dune.com/api/v1/table/create \
  --header 'X-DUNE-API-KEY: <x-dune-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "namespace":"my_user",
  "table_name":"interest_rates",
  "description": "10 year daily interest rates, sourced from https://fred.stlouisfed.org/series/DGS10",
  "is_private": false,
  "schema": [{"name": "date", "type": "timestamp"}, {"name": "dgs10", "type": "double"}]
}'

{
  "namespace": "my_user",
  "table_name": "my_data",
  "full_name": "dune.my_user.my_data",
  "example_query": "select * from dune.my_user.my_data"
}

This endpoint is currently in beta, and may change without warning.

The resulting table will be empty, and can be inserted into with the /insert endpoint.

  • If a table already exists with the same name, the request will fail.
  • Column names in the table can’t start with a special character or a digit.
  • Each successful table creation consumes 100 credits.
  • To delete a table, you can go to user settings (dune.com) -> data -> delete or use the /delete endpoint.
curl --request POST \
  --url https://api.dune.com/api/v1/table/create \
  --header 'X-DUNE-API-KEY: <x-dune-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "namespace":"my_user",
  "table_name":"interest_rates",
  "description": "10 year daily interest rates, sourced from https://fred.stlouisfed.org/series/DGS10",
  "is_private": false,
  "schema": [{"name": "date", "type": "timestamp"}, {"name": "dgs10", "type": "double"}]
}'

Authorizations

​
x-dune-api-key
string
header
required

The API key of your team or user.

Body

application/json

Create a new Dune Table for uploads

The body is of type object.

Response

201
application/json

The Dune table namespace.table_name was created successfully.

The response is of type object.