{
  "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"
    }
  ],
  "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"
          }
        }
      },
      "NotFoundError": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "description": "Error message for resource not found",
            "example": "The requested resource was not found."
          }
        }
      },
      "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."
      }
    }
  }
}