From 436b56a68cfefa2e22ef971430fbb5b34d3b5a5d Mon Sep 17 00:00:00 2001 From: Karim Hassan Date: Mon, 30 Jun 2025 16:15:28 -0400 Subject: [PATCH 1/3] Update API query pricing: change Plus plan to Analyst plan --- api-reference/queries/endpoint/archive.mdx | 2 +- api-reference/queries/endpoint/create.mdx | 2 +- api-reference/queries/endpoint/private.mdx | 2 +- api-reference/queries/endpoint/read.mdx | 2 +- api-reference/queries/endpoint/unarchive.mdx | 2 +- api-reference/queries/endpoint/unprivate.mdx | 2 +- api-reference/queries/endpoint/update.mdx | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/api-reference/queries/endpoint/archive.mdx b/api-reference/queries/endpoint/archive.mdx index b5273e37..542dfd0a 100644 --- a/api-reference/queries/endpoint/archive.mdx +++ b/api-reference/queries/endpoint/archive.mdx @@ -8,7 +8,7 @@ In Dune context, delete action is replaced by archive as deletion of queries is -To access Query endpoints, a [Plus plan](https://dune.com/pricing) or higher is required. +To access Query endpoints, an [Analyst plan](https://dune.com/pricing) or higher is required. diff --git a/api-reference/queries/endpoint/create.mdx b/api-reference/queries/endpoint/create.mdx index 5a0801be..f6bf6c0a 100644 --- a/api-reference/queries/endpoint/create.mdx +++ b/api-reference/queries/endpoint/create.mdx @@ -4,7 +4,7 @@ openapi: 'POST /v1/query' --- -To access Query endpoints, a [Plus plan](https://dune.com/pricing) or higher is required. +To access Query endpoints, an [Analyst plan](https://dune.com/pricing) or higher is required. diff --git a/api-reference/queries/endpoint/private.mdx b/api-reference/queries/endpoint/private.mdx index 7516385c..36d53289 100644 --- a/api-reference/queries/endpoint/private.mdx +++ b/api-reference/queries/endpoint/private.mdx @@ -4,7 +4,7 @@ openapi: 'POST /v1/query/{queryId}/private' --- -To access Query endpoints, a [Plus plan](https://dune.com/pricing) or higher is required. +To access Query endpoints, an [Analyst plan](https://dune.com/pricing) or higher is required. diff --git a/api-reference/queries/endpoint/read.mdx b/api-reference/queries/endpoint/read.mdx index 3be0d98f..edcb6910 100644 --- a/api-reference/queries/endpoint/read.mdx +++ b/api-reference/queries/endpoint/read.mdx @@ -4,7 +4,7 @@ openapi: 'GET /v1/query/{queryId}' --- -To access Query endpoints, a [Plus plan](https://dune.com/pricing) or higher is required. +To access Query endpoints, an [Analyst plan](https://dune.com/pricing) or higher is required. diff --git a/api-reference/queries/endpoint/unarchive.mdx b/api-reference/queries/endpoint/unarchive.mdx index 2369705f..75fbef93 100644 --- a/api-reference/queries/endpoint/unarchive.mdx +++ b/api-reference/queries/endpoint/unarchive.mdx @@ -4,7 +4,7 @@ openapi: 'POST /v1/query/{queryId}/unarchive' --- -To access Query endpoints, a [Plus plan](https://dune.com/pricing) or higher is required. +To access Query endpoints, an [Analyst plan](https://dune.com/pricing) or higher is required. diff --git a/api-reference/queries/endpoint/unprivate.mdx b/api-reference/queries/endpoint/unprivate.mdx index 8a2cc4db..6e7ccdb0 100644 --- a/api-reference/queries/endpoint/unprivate.mdx +++ b/api-reference/queries/endpoint/unprivate.mdx @@ -4,7 +4,7 @@ openapi: 'POST /v1/query/{queryId}/unprivate' --- -To access Query endpoints, a [Plus plan](https://dune.com/pricing) or higher is required. +To access Query endpoints, an [Analyst plan](https://dune.com/pricing) or higher is required. diff --git a/api-reference/queries/endpoint/update.mdx b/api-reference/queries/endpoint/update.mdx index cb3cb314..99b11bf4 100644 --- a/api-reference/queries/endpoint/update.mdx +++ b/api-reference/queries/endpoint/update.mdx @@ -4,7 +4,7 @@ openapi: 'PATCH /v1/query/{queryId}' --- -To access Query endpoints, a [Plus plan](https://dune.com/pricing) or higher is required. +To access Query endpoints, an [Analyst plan](https://dune.com/pricing) or higher is required. From f6c0a6ecd5d97f21284a9f7314641303ee9a03d7 Mon Sep 17 00:00:00 2001 From: Karim Hassan Date: Wed, 2 Jul 2025 14:34:54 -0400 Subject: [PATCH 2/3] chore: improve formatting for datapoint and credits formula in billing section --- api-reference/overview/billing.mdx | 36 ++++++++++++++++++++++++++---- 1 file changed, 32 insertions(+), 4 deletions(-) diff --git a/api-reference/overview/billing.mdx b/api-reference/overview/billing.mdx index 7cce759c..07d16eda 100644 --- a/api-reference/overview/billing.mdx +++ b/api-reference/overview/billing.mdx @@ -17,10 +17,38 @@ If your execution fails, then no credits are charged. If you execute a query but | Queries Endpoint | Available on Plus and Premium | | Webhooks (Alerts) | 1 on Free

5 on Plus

50 on Premium | -A datapoint applies to query results after the query is run, and can in most cases be thought of `rows * columns` with an additional limit of 100 avg bytes per cell in a set of results. This can be expressed as: +A datapoint applies to query results after the query is run, and can in most cases be thought of `rows * columns` with an additional limit of 100 avg bytes per cell in a set of results. This can be expressed as: -```math -Credits = Datapoints/1000 = max(rows*columns, ceil(totalbytes/100))/1000 +$$ +Credits = \frac{Datapoints}{1000} = \frac{\max(\text{rows} * \text{columns}, \lceil \frac{\text{totalbytes}}{100} \rceil)}{1000} +$$ + +**Byte-Based Calculation Details** + +When calculating datapoints based on total bytes, cells that exceed 100 bytes will "spill over" into additional cells. Here's how this works: + +**Example Table:** +``` ++-----+-----+-----+ +| A1 | B1 | C1 | ++-----+-----+-----+ +| A2 | B2 | C2 | ++-----+-----+-----+ +| A3 | B3 | C3 | ++-----+-----+-----+ ``` -Any API usage billing will be based on what account the API key is associated with. If you use your team api key to call a public query belonging to yourself, the billing will be associated to the team (and vice versa). +**Spillover Calculation:** +If one cell contains 175 bytes, that cell effectively counts as 2 cells in the datapoint calculation: + +- First 100 bytes = 1 cell +- Remaining 75 bytes = 1 additional cell + +**Example breakdown:** +- 8 cells of 100 bytes each = 8 cells +- 1 cell of 175 bytes = 2 cells (100 + 75) +- Total: 10 cells + +**API Usage Billing** + +Any API usage billing will be based on what account the API key is associated with. If you use your team API key to call a public query belonging to yourself, the billing will be associated to the team (and vice versa). From 172f96c258be05deef8d5b4d14176096edaa9d06 Mon Sep 17 00:00:00 2001 From: Karim Hassan Date: Wed, 2 Jul 2025 15:08:51 -0400 Subject: [PATCH 3/3] Update billing page with clarified datapoint and spillover calculation section --- api-reference/overview/billing.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/api-reference/overview/billing.mdx b/api-reference/overview/billing.mdx index 07d16eda..a0800ac3 100644 --- a/api-reference/overview/billing.mdx +++ b/api-reference/overview/billing.mdx @@ -38,8 +38,7 @@ When calculating datapoints based on total bytes, cells that exceed 100 bytes wi +-----+-----+-----+ ``` -**Spillover Calculation:** -If one cell contains 175 bytes, that cell effectively counts as 2 cells in the datapoint calculation: +**Spillover Calculation:** If one cell contains 175 bytes, that cell effectively counts as 2 cells in the datapoint calculation: - First 100 bytes = 1 cell - Remaining 75 bytes = 1 additional cell