Skip to content
Closed
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
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
8 changes: 4 additions & 4 deletions api-reference/dex/endpoint/dex_ohlc.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ openapi: 'GET /v1/dex/ohlc/{token}/{chain}'
---

<Note>
- You must pass in `token` address in all lower cased string
- You must pass in `token` address in all lowercase string
- Query can be found [here](https://dune.com/queries/3582296)
- Chains included are: all [EVM chains on Dune](/data-catalog/evm/overview)
- Scheduled to update every 30 minutes
Expand All @@ -24,10 +24,10 @@ openapi: 'GET /v1/dex/ohlc/{token}/{chain}'
| period | Date of the pricing data | string |
| token_contract_address| Token's blockchain contract address | string |
| token_symbol | Token symbol | string |
| blockchain | Blockchain where the token is deployed on | string |
| blockchain | Blockchain where the token is deployed | string |
| median_price | The median trading price of the token for the period | double |
| high_price | The highest trading price of the token during the period, calculated by taking the 99th percentile of day's trades if there are more than 1000 trades for the token on that day, else 95th percentile to account for edge cases | double |
| low_price | The lowest trading price of the token during the period, calculated by taking the 1st percentile of day's trades if there are more than 1000 trades for the token on that day, else 5th percentile to account for edge cases | double |
| high_price | The highest trading price of the token during the period, calculated by taking the 99th percentile of the day's trades if there are more than 1000 trades for the token on that day, else 95th percentile to account for edge cases | double |
| low_price | The lowest trading price of the token during the period, calculated by taking the 1st percentile of the day's trades if there are more than 1000 trades for the token on that day, else 5th percentile to account for edge cases | double |
| opening_price | The price of the token at the start of the period, calculated by taking the first 10 trades of the day | double |
| closing_price | The price of the token at the end of the period, calculated by taking the last 10 trades of the day | double |
| sample_size | The number of trades sampled to calculate the prices | int |
Expand Down
2 changes: 1 addition & 1 deletion api-reference/dex/endpoint/dex_pair.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,4 @@ openapi: 'GET /v1/dex/pairs/{chain}'
| thirty_day_volume | 30-day USD trading volume for the token pair across all pools on all DEXes | double |
| all_time_volume | Total USD trading volume for the token pair since inception across all pools on all DEXes | double |
| usd_liquidity | Current USD liquidity available in all pools for the token pair on all DEXes | double |
| seven_day_volume_liquidity_ratio| 7-day trading volume to liquidity ratio for the token pair across all pools on all DEXes | double |
| seven_day_volume_liquidity_ratio| 7-day trading volume to liquidity ratio for the token pair across all pools on all DEXes | double |
2 changes: 1 addition & 1 deletion api-reference/eigenlayer/endpoint/avs_metadata.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ openapi: 'GET /v1/eigenlayer/avs-metadata'

<Note>
- Query powering this endpoint can be found [here](https://dune.com/queries/3682939)
- Scheduled to update daily (_AVS registration happen once every few days normally_)
- Scheduled to update daily (_AVS registrations happen once every few days normally_)
</Note>


Expand Down
2 changes: 1 addition & 1 deletion api-reference/eigenlayer/endpoint/avs_metrics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ openapi: 'GET /v1/eigenlayer/avs-stats'
| ------------------------- | ------------------------------------------------------------------- | ---------- |
| avs_name | Name of the Actively Validated Service (AVS) | string |
| avs_contract_address | Ethereum contract address of the AVS | string |
| num_operators | Number of operators resgistered to the AVS | integer |
| num_operators | Number of operators registered to the AVS | integer |
| total_TVL | Total value locked across all strategies in the AVS | double |
| num_stakers | Number of stakers currently staking to the AVS (via operators) | integer |
| cbETH_TVL | Total value locked in cbETH strategy in the AVS | double |
Expand Down
2 changes: 1 addition & 1 deletion api-reference/eigenlayer/endpoint/operator_metadata.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ openapi: 'GET /v1/eigenlayer/operator-metadata'

<Note>
- Query powering this endpoint can be found [here](https://dune.com/queries/3685760)
- Scheduled to update 15 minutes
- Scheduled to update every 15 minutes
- Apply [filters](../../executions/filtering) like WHERE, IN, AND/OR upon results
- Use a combination of `sort_by` and `limit` to grab a subset of results, see [pagination](../../executions/pagination) and [sorting](../../executions/sorting) for more info
</Note>
Expand Down
4 changes: 2 additions & 2 deletions api-reference/eigenlayer/endpoint/operator_metrics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ openapi: 'GET /v1/eigenlayer/operator-stats'

<Note>
- Query powering this endpoint can be found [here](https://dune.com/queries/3685928)
- Scheduled to update 15 minutes
- Scheduled to update every 15 minutes
- Apply [filters](../../executions/filtering) like WHERE, IN, AND/OR upon results
- Use a combination of `sort_by` and `limit` to grab a subset of results, see [pagination](../../executions/pagination) and [sorting](../../executions/sorting) for more info
</Note>
Expand All @@ -31,4 +31,4 @@ openapi: 'GET /v1/eigenlayer/operator-stats'
| lsETH_TVL | Total value locked in lsETH strategy in the operator | double |
| mETH_TVL | Total value locked in mETH strategy in the operator | double |
| beacon_chain_ETH_TVL | Total value locked in Beacon Chain ETH strategy in the operator | double |
| EIGEN_TVL | Total value locked in EIGEN strategy in the AVS | double |
| EIGEN_TVL | Total value locked in EIGEN strategy in the operator | double |
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ openapi: 'GET /v1/eigenlayer/operator-to-avs-mapping'

<Note>
- Query powering this endpoint can be found [here](https://dune.com/queries/3685583)
- Scheduled to update 15 minutes
- Scheduled to update every 15 minutes
- Apply [filters](../../executions/filtering) like WHERE, IN, AND/OR upon results
- Use a combination of `sort_by` and `limit` to grab a subset of results, see [pagination](../../executions/pagination) and [sorting](../../executions/sorting) for more info
</Note>
Expand Down
2 changes: 1 addition & 1 deletion api-reference/eigenlayer/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Leverage Dune's API for direct access to [EigenLayer](https://www.eigenlayer.xyz

- **JSON Format**: All endpoints deliver JSON-formatted data for straightforward integration.
- **Instant Access**: Begin immediately by [creating a free account](https://dune.com/auth/register) and [obtain an API key](.././overview/authentication).
- **Expansive Data Ecosystem**: Enhance your projects by connecting with an extensive range of on-chain and off-chain data, from [Farcaster](.././farcaster/introduction) to [DEX](../dex/endpoint/dex_pair.mdx) and more. Build alongside with our vibrant community.
- **Expansive Data Ecosystem**: Enhance your projects by connecting with an extensive range of on-chain and off-chain data, from [Farcaster](.././farcaster/introduction) to [DEX](../dex/endpoint/dex_pair.mdx) and more. Build alongside our vibrant community.


<CardGroup cols={2}>
Expand Down
4 changes: 2 additions & 2 deletions api-reference/evm/endpoint/contracts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ openapi: 'GET /v1/trends/evm/contracts/{chain}'
# Use Cases

- Feed into a CRM of developers and projects based on contract popularity
- Build an explorer page of top trending contracts, with basic metadata to support.
- Build an explorer page of top trending contracts with basic metadata support.
- Track trending contracts by value and type (user facing, contract facing, token, router, safes, etc.)

# Column Descriptions
Expand All @@ -26,7 +26,7 @@ openapi: 'GET /v1/trends/evm/contracts/{chain}'
| contract_name | Name of the contract | string |
| created_time | Time when the contract was created | string |
| deployed_days_ago | Number of days since deployment | integer |
| token_standard | Standard of the token (ERC20,ERC721,ERC1155) if applicable | string |
| token_standard | Standard of the token (ERC20, ERC721, ERC1155) if applicable | string |
| usd_value_received | Value received in USD in ETH and ERC20 tokens in last 30 days | integer |
| transaction_calls | Number of transaction calls (top level transactions) in last 30 days | integer |
| unique_callers | Number of unique callers (tx from) in last 30 days | integer |
Expand Down
2 changes: 1 addition & 1 deletion api-reference/executions/endpoint/cancel-execution.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ openapi: 'POST /v1/execution/{execution_id}/cancel'

You must pass the `execution_id` obtained from making an [execute query](/api-reference/executions/endpoint/execute-query) POST request.

Result returns a boolean for whether the execution is successfully canceled.
The result returns a boolean for whether the execution is successfully canceled.

<RequestExample>

Expand Down
2 changes: 1 addition & 1 deletion api-reference/executions/endpoint/execute-query.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ openapi: 'POST /v1/query/{query_id}/execute'
---

<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>
<Tip> If you are using the [Python SDK](https://github.com/duneanalytics/dune-client/tree/d2195b2a9577e2dcae5d2600cb3eddce20987f38), you can directly execute and fetch result in one function call, like below: </Tip>

Use `run_query` to get result in JSON,
`run_query_csv` to get result in CSV format,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Result returns the status, metadata, and query results (in CSV) from a query exe
</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>
<Tip> If you are using the [Python SDK](https://github.com/duneanalytics/dune-client/tree/d2195b2a9577e2dcae5d2600cb3eddce20987f38), you can directly execute and fetch result in one function call, like below: </Tip>

``` python Python SDK

Expand Down
2 changes: 1 addition & 1 deletion api-reference/executions/endpoint/get-execution-status.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Once an execution is triggered, it can be in one of the following states:
- `QUERY_STATE_COMPLETED`: The query execution completed successfully. You can retrieve the query result for this execution_id.
- `QUERY_STATE_CANCELED`: The query execution was canceled by the user.
- `QUERY_STATE_EXPIRED`: The query execution expired, and the result is no longer available.
- `QUERY_STATE_COMPLETED_PARTIAL`: The query execution was successful, but the result was truncated because it was too large. To receive the truncated result, set the `allow_partial_results` flag to `true` in the API request to fetch result.
- `QUERY_STATE_COMPLETED_PARTIAL`: The query execution was successful, but the result was truncated because it was too large. To receive the truncated result, set the `allow_partial_results` flag to `true` in the API request to fetch the result.

<RequestExample>

Expand Down
4 changes: 2 additions & 2 deletions api-reference/executions/endpoint/get-query-result-csv.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ The query specified must either be public or a query you have ownership of (you
</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>
<Tip> If you are using the [Python SDK](https://github.com/duneanalytics/dune-client/tree/d2195b2a9577e2dcae5d2600cb3eddce20987f38), you can directly execute and fetch result in one function call, like below: </Tip>

``` python Python SDK

Expand All @@ -39,7 +39,7 @@ The query specified must either be public or a query you have ownership of (you
```
Use `run_query` to get result in JSON,
`run_query_csv` to get result in CSV format,
and `run_query_dataframe` to get result in Pandas dataframe
and `run_query_dataframe` to get result in Pandas dataframe.
```

result = dune.run_query(
Expand Down
2 changes: 1 addition & 1 deletion api-reference/executions/endpoint/get-query-result.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ The query specified must either be public or a query you have ownership of (you
</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>
<Tip> If you are using the [Python SDK](https://github.com/duneanalytics/dune-client/tree/d2195b2a9577e2dcae5d2600cb3eddce20987f38), you can directly execute and fetch result in one function call, like below: </Tip>

``` python Python SDK

Expand Down
2 changes: 1 addition & 1 deletion api-reference/executions/execution-object.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Below is an overview of each endpoint, providing a high-level understanding of t
|--------------------------|-----------------------------------|-----------------------------------------------------------------------------------------------|
| [Cancel Execution](./endpoint/cancel-execution) | `POST /v1/execution/{execution_id}/cancel` | Cancels an ongoing query execution. Requires the `execution_id`. Returns a success boolean. |
| [Execute Query](./endpoint/execute-query) | `POST /v1/query/{query_id}/execute` | Triggers an execution based on the `query_id`. Returns a `execution_id`. |
| [Get Execution Status](./endpoint/get-execution-status) | `GET /v1/execution/{execution_id}/status` | Provides the status of a query execution give an `execution_id`. |
| [Get Execution Status](./endpoint/get-execution-status) | `GET /v1/execution/{execution_id}/status` | Provides the status of a query execution given an `execution_id`. |
| [Get Execution Result in CSV](./endpoint/get-execution-result-csv) | `GET /v1/execution/{execution_id}/results/csv` | Retrieves the status, metadata, and results in CSV format. Includes data retention and limit information. |
| [Get Execution Result](./endpoint/get-execution-result) | `GET /v1/execution/{execution_id}/results` | Fetches the execution status, metadata, and results in JSON format. Similar data handling as CSV endpoint. |
| [Get Latest Query Result in CSV](./endpoint/get-query-result-csv) | `GET /v1/query/{query_id}/results/csv` | Returns the latest results of a query in CSV format, irrespective of the execution method. Queries must be public or owned. |
Expand Down
4 changes: 2 additions & 2 deletions api-reference/executions/filtering.mdx
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this stays as 10

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The reviewer's comment is incorrect. In Go, the url.Values.Set()method signature isSet(key, value string), which requires both parameters to be strings. The change from 10to"10"was actually a bug fix, not a typo. The code withparams.Set("limit", 10) would not compile in Go.

Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Filtering can be effectively used in conjunction with [pagination](./pagination)
from dune_client.client import DuneClient
from dune_client.query import QueryBase

os.chdir("<path_to_your_dotevn_file>")
os.chdir("<path_to_your_dotenv_file>")

# load .env file
dotenv.load_dotenv(".env")
Expand Down Expand Up @@ -112,7 +112,7 @@ Filtering can be effectively used in conjunction with [pagination](./pagination)

// Create query parameters
params := url.Values{}
params.Set("limit", 10)
params.Set("limit", "10")
params.Set("filters", "block_time > '2024-03-01'")
params.Set("columns", "tx_from,tx_to,tx_hash,amount_usd")
params.Set("sort_by", "amount_usd desc, block_time")
Expand Down
4 changes: 2 additions & 2 deletions api-reference/executions/pagination.mdx
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as this one stays as 1000

Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Pagination can be effectively combined with [filtering](./filtering) and [sortin
from dune_client.client import DuneClient
from dune_client.query import QueryBase

os.chdir("<path_to_your_dotevn_file>")
os.chdir("<path_to_your_dotenv_file>")

# load .env file
dotenv.load_dotenv(".env")
Expand Down Expand Up @@ -126,7 +126,7 @@ Pagination can be effectively combined with [filtering](./filtering) and [sortin

// Create query parameters
params := url.Values{}
params.Set("limit", 1000)
params.Set("limit", "1000")

// Add parameters to URL
fullURL := fmt.Sprintf("%s?%s", url, params.Encode())
Expand Down
2 changes: 1 addition & 1 deletion api-reference/executions/sampling.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Our API supports sampling on all `/results` endpoints to provide a uniform sampl
from dune_client.client import DuneClient
from dune_client.query import QueryBase

os.chdir("<path_to_your_dotevn_file>")
os.chdir("<path_to_your_dotenv_file>")

# load .env file
dotenv.load_dotenv(".env")
Expand Down
2 changes: 1 addition & 1 deletion api-reference/executions/sorting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Sorting can be effectively combined with [pagination](./pagination), [filtering]
from dune_client.client import DuneClient
from dune_client.query import QueryBase

os.chdir("<path_to_your_dotevn_file>")
os.chdir("<path_to_your_dotenv_file>")

# load .env file
dotenv.load_dotenv(".env")
Expand Down
4 changes: 2 additions & 2 deletions api-reference/farcaster/endpoint/farcaster_channels.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,8 +28,8 @@ openapi: 'GET /v1/farcaster/trends/channels'
| influential_casters | top casters by engagement in channel| array(string) |
| top_domains | top domains in casts in channel | array(string) |
| top_casters | top casters by number of casts in channel | array(string) |
| casters | number of casts in channels in the last week | integer |
| wow_cast | week over week change in number of casts | integer |
| casters | number of casters in channels in the last week | integer |
| wow_casters | week over week change in number of casters | integer |
| got_casts | number of casts in channels in the last week | integer |
| wow_cast | week over week change in number of casts | integer |
| engagement | engagement on channel casts in the last week | integer |
Expand Down
4 changes: 2 additions & 2 deletions api-reference/farcaster/endpoint/farcaster_memecoins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,13 +21,13 @@ Learn more about the score and methodology [in this article](https://read.crypto
| Column | Description | Type |
| --------------------- | --------------------------------------------------------------------- | ------- |
| word_raw | Ticker symbol of the token | string |
| related_symbol | any symbol or word that is related to the token (i.e. the degen hat or higher arrow) | string |
| related_symbol | Any symbol or word that is related to the token (i.e. the degen hat or higher arrow) | string |
| token_contract_address| Contract address of the token | string |
| blockchain | Blockchain on which the token is deployed | string |
| deployed_days_ago | Number of days since the token was deployed | integer |
| social_score | Social score of the token | integer |
| financial_score | Financial score of the token | integer |
| meme_category | category of meme based off of social and financial score values | string |
| meme_category | Category of meme based off of social and financial score values | string |
| casters | Number of users who have casted the token ticker | integer |
| casters_wow | Change in the number of casters week over week | integer |
| percent_recipient_casters | Percentage of casters this week that have received the token before | integer |
Expand Down
Loading