GET
/
v1
/
marketshare
/
{market}
/
{chain}
  • Query can be found here
  • Chains included are: all EVM chains on Dune
  • Scheduled to update every day (23:30 UTC)
  • You can apply filters like WHERE, IN, AND/OR upon results

Use Cases

  • Recommend trending or emerging marketplaces by tracking shifts in the market share over time.
  • Feed into a marketing ROI tracker to assess campaign impacts on marketplace market share.
  • Build a competive analysis tool to monitor marketplaces and sectors’ market share over time.

Column Descriptions

ColumnDescriptionType
timeDate of the marketshare datastring
marketSector identifier: ‘dex’ or ‘nft’string
blockchainThe blockchain where the marketplace operates onstring
projectSpecific DEX or NFT marketplace namestring
versionContract version of the marketplace protocol, e.g. ‘v2’string
volume_usdUSD volume traded on the marketplacedouble
tradesNumber of trades on the marketplaceint

Headers

X-Dune-Api-Key
string
required

API Key for the service

Path Parameters

market
string
required

Sector of the marketshare, either 'dex' or 'nft'

chain
string
required

Chain name (use Dune namespace, i.e. ethereum, solana, bnb, polygon, optimsm, etc)

Query Parameters

api_key
string

API Key, alternative to using the HTTP header X-Dune-Api-Key

allow_partial_results
boolean

This enables returning a query result that was too large and only a partial result is available. By default allow_partial_results is set to false and a failed state is returned.

columns
string

Specifies a comma-separated list of column names to return. If omitted, all columns are included. Tip: use this to limit the result to specific columns, reducing datapoints cost of the call.

filters
string

Expression to filter out rows from the results to return. This expression is similar to a SQL WHERE clause. More details about it in the Filtering section of the doc. This parameter is incompatible with sample_count.

ignore_max_datapoints_per_request
boolean

There is a default 250,000 datapoints limit to make sure you don't accidentally spend all your credits in one call. To ignore the max limit, you can add ignore_max_datapoints_per_request=true

limit
integer

Limit number of rows to return. This together with 'offset' allows easy pagination through results in an incremental and efficient way. This parameter is incompatible with sampling (sample_count).

offset
integer

Offset row number to start (inclusive, first row means offset=0) returning results from. This together with 'limit' allows easy pagination through results in an incremental and efficient way. This parameter is incompatible with sampling (sample_count).

queryID
integer
required
sample_count
integer

Number of rows to return from the result by sampling the data. This is useful when you want to get a uniform sample instead of the entire result. If the result has less than the sample count, the entire result is returned. Note that this will return a randomized sample, so not every call will return the same result. This parameter is incompatible with offset, limit, and filters parameters.

sort_by
string

Expression to define the order in which the results should be returned. This expression is similar to a SQL ORDER BY clause. More details about it in the Sorting section of the doc.

Response

200 - application/json
cancelled_at
string

Timestamp of when the query execution was cancelled, if applicable.

execution_ended_at
string

Timestamp of when the query execution ended.

execution_id
string

Unique identifier for the execution of the query.

execution_started_at
string

Timestamp of when the query execution started.

expires_at
string

Timestamp of when the query result expires.

is_execution_finished
boolean

Whether the state of the query execution is terminal. This can be used for polling purposes.

next_offset
integer

Offset that can be used to retrieve the next page of results.

next_uri
string

URI that can be used to fetch the next page of results.

query_id
integer

Unique identifier of the query.

result
object

The object containing the results and metadata of the query execution

state
string

The state of the query execution.

submitted_at
string

Timestamp of when the query was submitted.