Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
419 changes: 419 additions & 0 deletions api-reference/overview/pagination.mdx

Large diffs are not rendered by default.

4 changes: 1 addition & 3 deletions api-reference/overview/rate-limits.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,4 @@ For example, on the Free plan, you have a low limit of 15 requests per minute an

**Data Return Limit**

Currently, each API result call is limited to returning a maximum of 1GB of data.

_Once we implement pagination, we plan to increase this data return limit._
Dune imposes a 1GB data limit on query results for each query execution. If your query yields more than 1GB of data, the result will be truncated in storage. In such cases, pulling the result data with `allow_partial_results` set to false (the default) will trigger an error message: "error": "Partial Result, please request with 'allows_partial_results=true'". To retrieve partial results, you must pass the parameter `allow_partial_results=true`.
10 changes: 8 additions & 2 deletions api-reference/query-api/endpoint/get-execution-result-csv.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,15 @@ You must pass the `execution_id` obtained from making an [execute query](execute

Result returns the status, metadata, and query results (in CSV) from a query execution.

<Info> Results data from an execution are currently stored for 2 years. We may reduce this to something closer to 90 days in the future. This is visible on the API response on the “expires_at” field in the execution status and results body. </Info>
<Info>

<Info> There is currently a 1GB limit in how much data a single API result call can return, but there is a chance we reduce this overall or based on varying paid plan types. </Info>
- Results data from an execution are currently stored for 90 days. This is visible on the API response on the “expires_at” field in the execution status and results body.

- There is currently a 1GB limit in how much data a single API result call can return, but there is a chance we reduce this overall or based on varying paid plan types.

- To paginate query results, please visit the [pagination page](../../overview/pagination) to get more info.

</Info>

<Accordion title="Execute query and get result in one call">
<Tip> If you are using the [Python SDK](https://github.com/duneanalytics/dune-client/tree/d2195b2a9577e2dcae5d2600cb3eddce20987f38), you can directly executes and fetches result in one function call, like below: </Tip>
Expand Down
7 changes: 5 additions & 2 deletions api-reference/query-api/endpoint/get-execution-result.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,12 @@ You must pass the `execution_id` obtained from making an [execute query](execute
Result returns the status, metadata, and query results (in JSON) from a query execution.


<Info> Results data from an execution are currently stored for 2 years. We may reduce this to something closer to 90 days in the future. This is visible on the API response on the “expires_at” field in the execution status and results body. </Info>
<Info>
- Results data from an execution are stored for 90 days. This is visible on the API response on the “expires_at” field in the execution status and results body.
- There is currently a 1GB limit in how much data a single API result call can return, but there is a chance we reduce this overall or based on varying paid plan types.
- To paginate query results, please visit the [pagination page](../../overview/pagination) to get more info.

<Info> There is currently a 1GB limit in how much data a single API result call can return, but there is a chance we reduce this overall or based on varying paid plan types. </Info>
</Info>

<Accordion title="Execute query and get result in one call">
<Tip> If you are using the [Python SDK](https://github.com/duneanalytics/dune-client/tree/d2195b2a9577e2dcae5d2600cb3eddce20987f38), you can directly executes and fetches result in one function call, like below: </Tip>
Expand Down
7 changes: 5 additions & 2 deletions api-reference/query-api/endpoint/get-query-result-csv.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,12 @@ Returns the latest execution id and results (in CSV) of that latest run, regardl

The query specified must either be public or a query you have ownership of (you or a team you belong to have ownership).

<Note> This endpoint does NOT trigger execution but does [consume credits through datapoints](https://dune.com/pricing). </Note>
<Tip> This endpoint does NOT trigger an execution but does [consume credits through datapoints](https://dune.com/pricing). </Tip>

<Info> There is currently a 1GB limit in how much data a single API result call can return, but there is a chance we reduce this overall or based on varying paid plan types. </Info>
<Info>
- There is currently a 1GB limit in how much data a single API result call can return, but there is a chance we reduce this overall or based on varying paid plan types.
- To paginate query results, please visit the [pagination page](../../overview/pagination) to get more info.
</Info>

<Accordion title="Execute query and get result in one call">
<Tip> If you are using the [Python SDK](https://github.com/duneanalytics/dune-client/tree/d2195b2a9577e2dcae5d2600cb3eddce20987f38), you can directly executes and fetches result in one function call, like below: </Tip>
Expand Down
7 changes: 5 additions & 2 deletions api-reference/query-api/endpoint/get-query-result.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,12 @@ Returns the latest execution id and results (in JSON) of that latest run, regard

The query specified must either be public or a query you have ownership of (you or a team you belong to have ownership).

<Note> This endpoint does NOT trigger execution but does [consume credits through datapoints](https://dune.com/pricing). </Note>
<Tip> This endpoint does NOT trigger an execution but does [consume credits through datapoints](https://dune.com/pricing). </Tip>

<Info> There is currently a 1GB limit in how much data a single API result call can return, but there is a chance we reduce this overall or based on varying paid plan types. </Info>
<Info>
- There is currently a 1GB limit in how much data a single API result call can return, but there is a chance we reduce this overall or based on varying paid plan types.
- To paginate query results, please visit the [pagination page](../../overview/pagination) to get more info.
</Info>

<Accordion title="Execute query and get result in one call">
<Tip> If you are using the [Python SDK](https://github.com/duneanalytics/dune-client/tree/d2195b2a9577e2dcae5d2600cb3eddce20987f38), you can directly executes and fetches result in one function call, like below: </Tip>
Expand Down
2 changes: 1 addition & 1 deletion api-reference/query-api/query-openapi.json
Original file line number Diff line number Diff line change
Expand Up @@ -1041,7 +1041,7 @@
"is_execution_finished": {
"type": "boolean",
"description": "Whether the state of the query execution is terminal. This can be used for polling purposes.",
"example": "QUERY_STATE_COMPLETED"
"example": true
},
"submitted_at": {
"type": "string",
Expand Down
4 changes: 4 additions & 0 deletions api-reference/quickstart/query-eg.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,10 @@ You can choose to either get the latest query result without triggering an execu
</Tab>
</Tabs>

<Note>
To paginate query results, please visit the [pagination page](../overview/pagination) to get more info.
</Note>

<Accordion title="Putting it all together">

```python
Expand Down
1 change: 1 addition & 0 deletions mint.json
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@
"api-reference/overview/query-parameters",
"api-reference/overview/what-is-execution-id",
"api-reference/overview/rate-limits",
"api-reference/overview/pagination",
"api-reference/overview/troubleshooting",
"api-reference/overview/billing",
"api-reference/overview/faq"
Expand Down