Skip to main content
POST
/
v1
/
uploads
/
csv
curl --request POST \
  --url https://api.dune.com/api/v1/uploads/csv \
  --header 'Content-Type: application/json' \
  --header 'X-DUNE-API-KEY: <x-dune-api-key>' \
  --data '{
  "data": "DATE,DGS10,\n2023-12-04,4.28,\n2023-12-05,4.18,\n2023-12-06,4.12,\n2023-12-07,4.14,\n2023-12-08,4.23,\n2023-12-11,4.23",
  "description": "10 year daily interest rates, sourced from https://fred.stlouisfed.org/series/DGS10",
  "table_name": "ten_year_us_interest_rates",
  "is_private": false
}'

{
  "full_name": "dune.my_team.dataset_ten_year_us_interest_rates",
  "success": true,
  "table_name": "ten_year_us_interest_rates"
}
Consider using the /create and /insert endpoints if you want more flexibility, performance, and the ability to append.
You can also upload CSV through the Dune UI by pressing the “create” dropdown.Migrating from the old API? See the Migration Guide for help updating your code.
For working with uploads, keep in mind that:
  • File has to be < 500 MB
  • Column names in the table can’t start with a special character or digits.
  • Consumes credits based on the size of data uploaded.
    • Free, Analyst, Plus: 3 credits per GB written, minimum charge is 1 credit
  • If you upload to an existing table name, it will delete the old data and overwite it with your new data. Appends are only supported for the /create, /insert endpoints.
  • To delete an upload table, you must go to user settings (dune.com) -> data -> delete.
If you have larger datasets you want to upload, please contact us here
curl --request POST \
  --url https://api.dune.com/api/v1/uploads/csv \
  --header 'Content-Type: application/json' \
  --header 'X-DUNE-API-KEY: <x-dune-api-key>' \
  --data '{
  "data": "DATE,DGS10,\n2023-12-04,4.28,\n2023-12-05,4.18,\n2023-12-06,4.12,\n2023-12-07,4.14,\n2023-12-08,4.23,\n2023-12-11,4.23",
  "description": "10 year daily interest rates, sourced from https://fred.stlouisfed.org/series/DGS10",
  "table_name": "ten_year_us_interest_rates",
  "is_private": false
}'

​
Upload via google sheet

To automate the upload of a Google Sheet’s contents to Dune via API, use the following Google Apps Script: 
function uploadToDune() {
  var apiKey = "YOUR_DUNE_API_KEY"; // Replace with your actual Dune API key, keep the quotes
  var tableName = "example_table"; // Update with your desired table name
  var description = "Example table description";

  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var range = sheet.getDataRange();
  var values = range.getValues();

  // Convert data to CSV format
  var csvData = "";
  for (var i = 0; i < values.length; i++) {
    csvData += values[i].join(",") + "\n";
  }

  var payload = {
    data: csvData.trim(),
    description: description,
    table_name: tableName,
    is_private: false
  };

  var options = {
    method: "post",
    contentType: "application/json",
    headers: {
      "X-DUNE-API-KEY": apiKey
    },
    payload: JSON.stringify(payload)
  };

  var response = UrlFetchApp.fetch("https://api.dune.com/api/v1/uploads/csv", options);
  Logger.log(response.getContentText());
}
Steps to Use:
  1. Open your Google Sheet
  2. Navigate to Extensions → Apps Script
  3. Replace the script with the code above
  4. Save and run uploadToDune
  5. (Optional) For easier execution, you can assign this script to a button in your Google Sheet:
    • Click “Insert” in the Google Sheets menu
    • Select “Drawing”
    • Create a button shape and add text like “Upload to Dune”
    • Click “Save and Close”
    • Right-click the button and select “Assign script”
    • Enter “uploadToDune” as the function name
  6. Clicking the button will now upload your active sheet’s data to Dune!

Headers

​
X-Dune-Api-Key
string
required

API Key for the service

Query Parameters

​
api_key
string

Alternative to using the X-Dune-Api-Key header

Body

*/*

payload

​
data
string

The data to be uploaded in CSV format.

​
description
string

Description of the upload.

​
is_private
boolean

Indicates if the upload is private.

​
table_name
string

The name of the table to store the data.

Response

OK

​
full_name
string

the full name of the table that was created

Example:

"dune.my_team.dataset_ten_year_us_interest_rates"

​
success
boolean

Indicator if the request was successful

​
table_name
string

The name of the table that was created

Example:

"ten_year_us_interest_rates"