> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dune.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketplace Market Share

> Given a chain, get the market share in terms of USD transacting volume and number of trades for either `dex` or `nft` sector.

<Note>
  * Query can be found [here](https://dune.com/queries/3575029)
  * Chains included are: all [EVM chains on Dune](data-catalog/evm/overview)
  * Scheduled to update every day (23:30 UTC)
  * You can apply [filters](../../executions/filtering) like WHERE, IN, AND/OR upon results
</Note>

# 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 competitive analysis tool to monitor marketplaces and sectors' market share over time.

# Column Descriptions

| Column      | Description                                             | Type   |
| ----------- | ------------------------------------------------------- | ------ |
| time        | Date of the marketshare data                            | string |
| market      | Sector identifier: 'dex' or 'nft'                       | string |
| blockchain  | The blockchain where the marketplace operates on        | string |
| project     | Specific DEX or NFT marketplace name                    | string |
| version     | Contract version of the marketplace protocol, e.g. 'v2' | string |
| volume\_usd | USD volume traded on the marketplace                    | double |
| trades      | Number of trades on the marketplace                     | int    |


## OpenAPI

````yaml GET /v1/marketshare/{market}/{chain}
openapi: 3.0.1
info:
  title: OpenAPI for Markets API
  description: API for predefined DEX/AMM related endpoints
  version: 1.0.0
servers:
  - url: https://api.dune.com/api
security: []
paths:
  /v1/marketshare/{market}/{chain}:
    get:
      summary: Get the market share for DEX or NFT market for a given chain
      description: >-
        Given a chain, get the market share in terms of USD transacting volume
        and number of trades for either `dex` or `nft` sector.
      operationId: marketMarketshare
      parameters:
        - in: header
          name: X-DUNE-API-KEY
          schema:
            type: string
          description: API Key for the service
          required: true
        - in: query
          name: api_key
          schema:
            type: string
          description: >-
            API Key for the service, alternative to using the HTTP header
            X-DUNE-API-KEY.
          required: false
        - in: path
          name: chain
          required: true
          schema:
            type: string
          description: >-
            chain name (use Dune namespace, i.e. ethereum, solana, bnb, polygon,
            optimsm, etc)
        - in: path
          name: market
          required: true
          schema:
            type: string
          description: sector of the marketshare, either 'dex' or 'nft'
        - in: query
          name: limit
          required: true
          schema:
            type: integer
          example: 10
          description: >-
            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).
        - in: query
          name: offset
          required: false
          schema:
            type: integer
          description: >-
            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).
        - in: query
          name: filters
          required: false
          schema:
            type: string
          description: >-
            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`.
        - in: query
          name: sort_by
          required: false
          schema:
            type: string
          description: >-
            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.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  execution_id:
                    type: string
                    description: Unique identifier for the execution
                    example: 01HW6N7VF1H7VYQ91GC0NP673E
                  query_id:
                    type: integer
                    description: Unique identifier for the query
                    example: 3568055
                  is_execution_finished:
                    type: boolean
                    description: Flag to indicate if the execution is finished
                    example: true
                  state:
                    type: string
                    description: State of the query execution
                    example: QUERY_STATE_COMPLETED
                  submitted_at:
                    type: string
                    description: Time when the query was submitted
                    example: '2024-04-23T23:39:15.297947Z'
                  expires_at:
                    type: string
                    description: Time when the query will expire
                    example: '2024-07-22T23:39:29.38954Z'
                  execution_started_at:
                    type: string
                    description: Time when the execution started
                    example: '2024-04-23T23:39:18.83657Z'
                  execution_ended_at:
                    type: string
                    description: Time when the execution ended
                    example: '2024-04-23T23:39:29.389539Z'
                  result:
                    type: object
                    description: results from query
                    example:
                      rows:
                        - all_time_volume: 332594074340.3848
                          chain: ethereum
                          one_day_volume: 92699347.47933117
                          pool_ids:
                            - '0x9b208194acc0a8ccb2a8dcafeacfbb7dcc093f81'
                            - '0xd0382ad6fe3759ab65fc4bc435f47045ffea77c7'
                            - '0xee60ca08cca968dc1b36e7bbcc779efe34d7ef62'
                            - '0x31ac258b911af9a0d2669ebdfc4e39d92e96b772'
                            - '0x3ab6564d5c214bc416ee8421e05219960504eead'
                            - '0x21e7fd84385d47076208ca3ba993ecf292691394'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0xc537e898cd774e2dcba3b14ea6f34c93d5ea45e1'
                            - '0x4572f2554421bd64bef1c22c8a81840e8d496bea'
                            - '0xeef417e1d5cc832e619ae18d2f140de2999dd4fb'
                            - '0x7abd51bba7f9f6ae87ac77e1ea1c5783ada56e5c'
                            - '0x2673099769201c08e9a5e63b25fbaf25541a6557'
                            - '0x1033812efec8716bbae0c19e5678698d25e26edf'
                            - '0x81b7f92c7b7d9349b989b4982588761bfa1aa627'
                            - '0xa87e10cb085512931ccd277338e66cdacb52ca79'
                            - '0xb93f696e5c46b6772fc2ff65e459cf9685fac782'
                            - '0x43b4fdfd4ff969587185cdb6f0bd875c5fc83f8c'
                            - '0xdebf20617708857ebe4f679508e7b7863a8a8eee'
                            - '0x655edce464cc797526600a462a8154650eee4b77'
                            - '0xec577a919fca1b682f584a50b1048331ef0f30dd'
                            - '0x5b3b5df2bf2b6543f78e053bd91c4bdd820929f1'
                            - '0xc50cb225e0f45e814fd41bcb3a120463ab1f04c3'
                            - '0xd7b6d14b76595ab7938c2c781079d787ef3bd5ee'
                            - '0x9ca2a439810524250e543ba8fb6e88578af242bc'
                            - '0x06df3b2bbb68adc8b0e302443692037ed9f91b42'
                            - '0xecd5e75afb02efa118af914515d6521aabd189f1'
                            - '0xed279fdd11ca84beef15af5d39bb4d4bee23f0ca'
                            - '0x178e029173417b1f9c8bc16dcec6f697bc323746'
                            - '0xceaf7747579696a2f0bb206a14210e3c9e6fb269'
                            - '0x2dded6da1bf5dbdf597c45fcfaa3194e53ecfeaf'
                            - '0xa77d09743f77052950c4eb4e6547e9665299becd'
                            - '0x1ee383389c621c37ee5aa476f88413a815083c5d'
                            - '0xa5407eae9ba41422680e2e00537571bcc53efbfd'
                            - '0x79a8c46dea5ada233abaffd40f3a0a2b1e5a4f27'
                            - '0x02e1300a7e6c3211c65317176cf1795f9bb1daab'
                            - '0x0f9cb53ebe405d49a0bbdbd291a65ff571bc83e1'
                            - '0xe2f2a5c287993345a840db3b0845fbc70f5935a5'
                            - '0x9547429c0e2c3a8b88c6833b58fce962734c0e8c'
                            - '0x4f062658eaaf2c1ccf8c8e36d6824cdf41167956'
                            - '0xb04f13750cd764eeceb07e19254564787c9c72bf'
                            - '0xcc12532e95c2a6a4c53af153b9b739a3cc9218a7'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0x3252efd4ea2d6c78091a1f43982ee2c3659cc3d1'
                            - '0xb5214edee5741324a13539bcc207bc549e2491ff'
                            - '0x69d460e01070a7ba1bc363885bc8f4f0daa19bf5'
                            - '0x1f06f01fdbdcdf1a6604878cbd90e88ad6d3c654'
                            - '0x3e01dd8a5e1fb3481f0f589056b428fc308af0fb'
                            - '0xe6b5cc1b4b47305c58392ce3d359b10282fc36ea'
                            - '0xc88b0e9cbfdffc1ceac078321442d546874eb3ef'
                            - '0x618788357d0ebd8a37e763adab3bc575d54c2c7d'
                            - '0x5777d92f208679db4b9778590fa3cab3ac9e2168'
                            - '0xaad387f18e015cf9be4bdf96854845be51ddc977'
                            - '0x8ee017541375f6bcd802ba119bddc94dad6911a1'
                            - '0x5c6a6cf9ae657a73b98454d17986af41fc7b44ee'
                            - '0xaa5a67c256e27a5d80712c51971408db3370927d'
                            - '0xc0b2b0c5376cb2e6f73b473a7caa341542f707ce'
                            - '0x1b8874baceaafba9ea194a625d12e8b270d77016'
                            - '0xc270b3b858c335b6ba5d5b10e2da8a09976005ad'
                            - '0xae461ca67b15dc8dc81ce7615e0320da1a9ab8d5'
                            - '0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7'
                            - '0x57755f7dec33320bca83159c26e93751bfd30fbe'
                            - '0x06364f10b501e868329afbc005b3492902d6c763'
                            - '0x42d7025938bec20b69cbae5a77421082407f053a'
                            - '0x4807862aa8b2bf68830e4c8dc86d0e9a998e085a'
                            - '0x8038c01a0390a8c547446a0b2c18fc9aefecc10c'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0xe7b0ce0526fbe3969035a145c9e9691d4d9d216c'
                            - '0xd9e497bd8f491fe163b42a62c296fb54caea74b7'
                            - '0x2e9c6dcdca22a5952a88c4b18edb5b54c5155bc9'
                            - '0x3a70dfa7d2262988064a2d051dd47521e43c9bdd'
                            - '0x53dc703b78794b61281812f3a901918253beefee'
                            - '0xa2b47e3d5c44877cca798226b7b8118f9bfb7a56'
                            - '0x890f4e345b1daed0367a877a1612f86a1f86985f'
                            - '0x5a6a4d54456819380173272a5e8e9b9904bdf41b'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                            - '0x6870f9b4dd5d34c7fc53d0d85d9dbd1aab339bf7'
                            - '0xbd482ffb3e6e50dc1c437557c3bea2b68f3683ee'
                            - '0x8474ddbe98f5aa3179b3b3f5942d724afcdec9f6'
                            - '0xbc68fa58930a2f36d37d16f2f7cfebdd2b7902c6'
                            - '0x06cb22615ba53e60d67bf6c341a0fd5e718e1655'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0x52ea46506b9cc5ef470c5bf89f17dc28bb35d85c'
                            - '0xd632f22692fac7611d2aa1c0d552930d43caed3b'
                            - '0xaaf5110db6e744ff70fb339de037b990a20bdace'
                            - '0x1373e57f764a7944bdd7a4bd5ca3007d496934da'
                            - '0x4567fc23d02fc4ba0b960639d43ecfe8cac6e68f'
                            - '0xc74eba6863c11266dcffbbf39de34f5845e0ebe4'
                            - '0x87650d7bbfc3a9f10587d7778206671719d9910d'
                            - '0x72a8f00913226b49e63cb7f27bc31ee5cfd09646'
                            - '0x79c58f70905f734641735bc61e45c19dd9ad60bc'
                            - '0xc9c32cd16bf7efb85ff14e0c8603cc90f6f2ee49'
                            - '0xc45a95642bc59df699364237b80057eadc8d8a14'
                            - '0x3ef6a01a0f81d6046290f3e2a8c5b843e738e604'
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                            - '0x6c6bc977e13df9b0de53b251522280bb72383700'
                          projects:
                            - bancor
                            - carbon_defi
                            - curve
                            - mstable
                            - clipper
                            - 0x API
                            - defiswap
                            - uniswap
                            - pancakeswap
                            - maverick
                            - sushiswap
                            - dodo
                            - balancer
                            - airswap
                          seven_day_volume: 737039227.6180601
                          seven_day_volume_liquidity_ratio: 281.975796372453
                          thirty_day_volume: 3678990033.201309
                          token_a_address: '0x6b175474e89094c44da98b954eedeac495271d0f'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: DAI-USDC
                          usd_liquidity: 248314669.2889558
                        - all_time_volume: 116709024541.30284
                          chain: ethereum
                          one_day_volume: 347313.65828850656
                          pool_ids:
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0x3ab6564d5c214bc416ee8421e05219960504eead'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0xc537e898cd774e2dcba3b14ea6f34c93d5ea45e1'
                            - '0x2f9ec37d6ccfff1cab21733bdadede11c823ccb0'
                            - '0xeef417e1d5cc832e619ae18d2f140de2999dd4fb'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                          projects:
                            - bancor
                            - 0x API
                            - carbon_defi
                          seven_day_volume: 7494228.013474621
                          seven_day_volume_liquidity_ratio: 136.4840258342926
                          thirty_day_volume: 74588861.33509746
                          token_a_address: '0x1f573d6fb3f13d689ff844b4ce37794d79a7ff1c'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: BNT-USDC
                          usd_liquidity: 384364.36625934794
                        - all_time_volume: 94313504772.55698
                          chain: ethereum
                          one_day_volume: 1674146.1481379208
                          pool_ids:
                            - '0xe2f2a5c287993345a840db3b0845fbc70f5935a5'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0xe55e68925809784c8234dfcf6f8fa42c3a48b2c3'
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                            - '0xbc68fa58930a2f36d37d16f2f7cfebdd2b7902c6'
                            - '0x4572f2554421bd64bef1c22c8a81840e8d496bea'
                            - '0x1ee383389c621c37ee5aa476f88413a815083c5d'
                            - '0xecd5e75afb02efa118af914515d6521aabd189f1'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0x39529e96c28807655b5856b3d342c6225111770e'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0x33baeda08b8afacc4d3d07cf31d49fc1f1f3e893'
                            - '0xf1f27db872b7f6e8b873c97f785fe4f9a6c92161'
                          projects:
                            - mstable
                            - 0x API
                            - airswap
                            - balancer
                            - uniswap
                            - curve
                          seven_day_volume: 9336213.926152254
                          seven_day_volume_liquidity_ratio: 3588.0000155662356
                          thirty_day_volume: 50471927.563405074
                          token_a_address: '0x0000000000085d4780b73119b644ae5ecd22b376'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: TUSD-USDC
                          usd_liquidity: 39030.994505216884
                        - all_time_volume: 94051550278.08916
                          chain: ethereum
                          one_day_volume: 1610611.7966684166
                          pool_ids:
                            - '0xbd482ffb3e6e50dc1c437557c3bea2b68f3683ee'
                            - '0x00cef0386ed94d738c8f8a74e8bfd0376926d24c'
                            - '0x8fdb0bb9365a46b145db80d0b1c5c5e979c84190'
                            - '0xfe842e95f8911dcc21c943a1daa4bd641a1381c6'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0x81b7f92c7b7d9349b989b4982588761bfa1aa627'
                            - '0x9ca2a439810524250e543ba8fb6e88578af242bc'
                            - '0x524847c615639e76fe7d0fe0b16be8c4eac9cf3c'
                            - '0x5e35c4eba72470ee1177dcb14dddf4d9e6d915f4'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0x3ab6564d5c214bc416ee8421e05219960504eead'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                            - '0x4572f2554421bd64bef1c22c8a81840e8d496bea'
                            - '0x4807862aa8b2bf68830e4c8dc86d0e9a998e085a'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0x79a8c46dea5ada233abaffd40f3a0a2b1e5a4f27'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                          projects:
                            - mstable
                            - balancer
                            - pancakeswap
                            - uniswap
                            - bancor
                            - 0x API
                            - airswap
                            - curve
                          seven_day_volume: 9582693.692927752
                          seven_day_volume_liquidity_ratio: 5034.898797007897
                          thirty_day_volume: 52270429.14287423
                          token_a_address: '0x4fabb145d64652a948d72533023f6e7a623c7c53'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: BUSD-USDC
                          usd_liquidity: 34258.58064420375
                        - all_time_volume: 90294759705.52713
                          chain: ethereum
                          one_day_volume: 2827504.919142756
                          pool_ids:
                            - '0xd0fc8ba7e267f2bc56044a7715a489d851dc6d78'
                            - '0xab2044f105c43c25b1de3ee27504f0b889ce5953'
                            - '0x4572f2554421bd64bef1c22c8a81840e8d496bea'
                            - '0x72a8f00913226b49e63cb7f27bc31ee5cfd09646'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0xeef417e1d5cc832e619ae18d2f140de2999dd4fb'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                            - '0xc537e898cd774e2dcba3b14ea6f34c93d5ea45e1'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0x8762cb30fee5661521bd21cedbe64c5075275f2d'
                            - '0xc50cb225e0f45e814fd41bcb3a120463ab1f04c3'
                            - '0xe8bf7d7358a96fa870d3945bb37bfcc91a9041cc'
                            - '0xebfb684dd2b01e698ca6c14f10e4f289934a54d6'
                            - '0x9ca2a439810524250e543ba8fb6e88578af242bc'
                          projects:
                            - uniswap
                            - balancer
                            - bancor
                            - airswap
                            - carbon_defi
                            - 0x API
                            - pancakeswap
                          seven_day_volume: 20436505.74916102
                          seven_day_volume_liquidity_ratio: 51.273970307133546
                          thirty_day_volume: 100313531.19630384
                          token_a_address: '0x1f9840a85d5af5bf1d1762f925bdaddc4201f984'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: UNI-USDC
                          usd_liquidity: 6775769.374883028
                        - all_time_volume: 90092193021.80107
                          chain: ethereum
                          one_day_volume: 1748066.5905444843
                          pool_ids:
                            - '0x562c0b218cc9ba06d9eb42f3aef54c54cc5a4650'
                            - '0x4b6b06de9a52e8a3fb91df2d1615e17705371f86'
                            - '0x1373e57f764a7944bdd7a4bd5ca3007d496934da'
                            - '0x8287913adfa69adca06beb00deab68a99c9e8d46'
                            - '0xd8c8a2b125527bf97c8e4845b25de7e964468f77'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0xcb5cde8da12555bf770e185e8e323290e5c443d4'
                            - '0xc0b2b0c5376cb2e6f73b473a7caa341542f707ce'
                            - '0xc537e898cd774e2dcba3b14ea6f34c93d5ea45e1'
                            - '0x1f06f01fdbdcdf1a6604878cbd90e88ad6d3c654'
                            - '0xc88b0e9cbfdffc1ceac078321442d546874eb3ef'
                            - '0x5f752aa9e748ffc007a15b7ca0fad8f2127f186c'
                            - '0x68a241796628ecf44e48f0533fb00d07dd3419d2'
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                            - '0xe6c2e229c763ed3e1d5d57b3648aeb1d4011eacd'
                            - '0x9ca2a439810524250e543ba8fb6e88578af242bc'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0xb93f696e5c46b6772fc2ff65e459cf9685fac782'
                            - '0xfad57d2039c21811c8f2b5d5b65308aa99d31559'
                            - '0x1be21dd1fa2aced16656b7d765b88afa6853cc98'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0x032d9bc3f3c1042b431f29df63aaa547f5ed6ee6'
                            - '0xeef417e1d5cc832e619ae18d2f140de2999dd4fb'
                          projects:
                            - dodo
                            - balancer
                            - carbon_defi
                            - airswap
                            - pancakeswap
                            - uniswap
                            - 0x API
                            - bancor
                          seven_day_volume: 12528060.859976402
                          seven_day_volume_liquidity_ratio: 385.68845448165985
                          thirty_day_volume: 93276129.33738266
                          token_a_address: '0x514910771af9ca656af840dff83e8264ecf986ca'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: LINK-USDC
                          usd_liquidity: 812058.3280625618
                        - all_time_volume: 90020606554.59792
                          chain: ethereum
                          one_day_volume: 1680068.0993446708
                          pool_ids:
                            - '0xb06e7ed37cfa8f0f2888355dd1913e45412798c5'
                            - '0xdfa42ba0130425b21a1568507b084cc246fb0c8f'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0x14462305d211c12a736986f4e8216e28c5ea7ab4'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0xeef417e1d5cc832e619ae18d2f140de2999dd4fb'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                          projects:
                            - uniswap
                            - balancer
                            - 0x API
                            - bancor
                            - airswap
                          seven_day_volume: 11390285.80369365
                          seven_day_volume_liquidity_ratio: 976.8687139129809
                          thirty_day_volume: 72361946.88776392
                          token_a_address: '0xc944e90c64b2c07662a292be6244bdf05cda44a7'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: GRT-USDC
                          usd_liquidity: 116599.96518947062
                        - all_time_volume: 89938603799.63126
                          chain: ethereum
                          one_day_volume: 1680424.9979594469
                          pool_ids:
                            - '0xeef417e1d5cc832e619ae18d2f140de2999dd4fb'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0x0f9d9d1cce530c91f075455efef2d9386375df3d'
                            - '0xc88b0e9cbfdffc1ceac078321442d546874eb3ef'
                            - '0x4572f2554421bd64bef1c22c8a81840e8d496bea'
                            - '0xa5910940b97b7b8771a01b202583fd9331cb8be3'
                            - '0x340a5a2f73ebaa181ec2826802fdf8ed21fc759a'
                            - '0x5311b0bfd1eb656522ef75ea4d22ce8bcfa6fd42'
                            - '0xeeb82fa092e3cecb1ba99f8342775b70efb40cf8'
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                            - '0x21e7fd84385d47076208ca3ba993ecf292691394'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0xc486ad2764d55c7dc033487d634195d6e4a6917e'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                            - '0xc45a95642bc59df699364237b80057eadc8d8a14'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0xc50cb225e0f45e814fd41bcb3a120463ab1f04c3'
                            - '0x1373e57f764a7944bdd7a4bd5ca3007d496934da'
                            - '0x660f30293df5e2506b6a2e09ce64c1454eebd9a4'
                          projects:
                            - bancor
                            - balancer
                            - uniswap
                            - airswap
                            - 0x API
                          seven_day_volume: 11388980.237265486
                          seven_day_volume_liquidity_ratio: 6513.933534721894
                          thirty_day_volume: 72138393.39627787
                          token_a_address: '0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: MKR-USDC
                          usd_liquidity: 34968.057861068526
                        - all_time_volume: 89589137146.34175
                          chain: ethereum
                          one_day_volume: 1685868.3757632175
                          pool_ids:
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                            - '0x265b6d1a6c12873a423c177eba6dd2470f40a3b5'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                            - '0x07a6e955ba4345bae83ac2a6faa771fddd8a2011'
                            - '0x9ca2a439810524250e543ba8fb6e88578af242bc'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0x7401b004f6e1553e33fd0e7a9eb67cba6daf94db'
                            - '0xeef417e1d5cc832e619ae18d2f140de2999dd4fb'
                          projects:
                            - airswap
                            - balancer
                            - 0x API
                            - uniswap
                            - pancakeswap
                            - sushiswap
                            - bancor
                          seven_day_volume: 12018847.068346124
                          seven_day_volume_liquidity_ratio: 2586.896740382245
                          thirty_day_volume: 77636591.14741129
                          token_a_address: '0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: MATIC-USDC
                          usd_liquidity: 51106.53072772908
                        - all_time_volume: 89563986580.13017
                          chain: ethereum
                          one_day_volume: 1683159.3662283886
                          pool_ids:
                            - '0x94512fd4fb4feb63a6c0f4bedecc4a00ee260528'
                            - '0xeeb82fa092e3cecb1ba99f8342775b70efb40cf8'
                            - '0xd82fa167727a4dc6d6f55830a2c47abbb4b3a0f8'
                            - '0x9ca2a439810524250e543ba8fb6e88578af242bc'
                            - '0xeef417e1d5cc832e619ae18d2f140de2999dd4fb'
                            - '0x61935cbdd02287b511119ddb11aeb42f1593b7ef'
                            - '0xc549a5c701cb6e6cbc091007a80c089c49595468'
                            - '0xdef1c0ded9bec7f1a1670819833240f027b25eff'
                            - '0x522d6f36c95a1b6509a14272c17747bbb582f2a6'
                            - '0x72a8f00913226b49e63cb7f27bc31ee5cfd09646'
                            - '0x080bf510fcbf18b91105470639e9561022937712'
                            - '0x674e114dad81838d151d9beda2271228eeae0e8b'
                            - '0xdceaf5d0e5e0db9596a47c0c4120654e80b1d706'
                          projects:
                            - dodo
                            - balancer
                            - pancakeswap
                            - bancor
                            - 0x API
                            - airswap
                            - uniswap
                          seven_day_volume: 12000822.608613955
                          seven_day_volume_liquidity_ratio: 69472.9287573257
                          thirty_day_volume: 77411144.88987997
                          token_a_address: '0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9'
                          token_b_address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                          token_pair: AAVE-USDC
                          usd_liquidity: 2245.632891869851
                  metadata:
                    type: object
                    description: metadata about the results
                    example:
                      column_names:
                        - chain
                        - token_pair
                        - projects
                        - pool_ids
                        - token_a_address
                        - token_b_address
                        - one_day_volume
                        - seven_day_volume
                        - thirty_day_volume
                        - all_time_volume
                        - usd_liquidity
                        - seven_day_volume_liquidity_ratio
                      row_count: 10
                      result_set_bytes: 13594
                      total_row_count: 589932
                      total_result_set_bytes: 140805054
                      datapoint_count: 136
                      pending_time_millis: 3538
                      execution_time_millis: 10552
                  next_uri:
                    type: string
                    description: URI to get the next set of results
                    example: >-
                      https://api.dune.com/api/v1/execution/01HW6N7VF1H7VYQ91GC0NP673E/results?filters=chain%3D%22base%22+AND+token_a_address+%3D+%270xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48%27+or+token_b_address+%3D+%270xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48%27&limit=10&offset=10&sort_by=all_time_volume+desc
                  next_offset:
                    type: integer
                    description: Offset to get the next set of results
                    example: 10
        '400':
          description: >-
            Bad Request - The request could not be understood by the server due
            to malformed syntax or validation failure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      Core request validation failed, make sure you've given
                      required columns and followed formatting rules for the CSV
                      (no special characters or digits in column names)
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '500':
          description: >-
            Internal server error occurred. This usually happens due to
            unexpected issues in processing the request. It may include errors
            such as failure in core API execution, invalid query parameters, or
            issues with the customer data provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
components:
  schemas:
    UnauthorizedError:
      type: object
      properties:
        error:
          type: string
          description: 401 unauthorized error for invalid API key
          example: invalid API Key
    InternalServerError:
      type: object
      properties:
        error:
          type: string
          example: internal error
      description: >-
        Generic error message, given when an unexpected condition is encountered
        and no more specific message is available. Please consult the API
        documentation for more details.

````