Skip to main content
Glama

Crypto & Macro Market Data (Tanod)

get_dex_volume

Read-onlyIdempotent

chainpeek: Get DEX volume by protocol and chain. For TVL use get_protocol_tvl. Returns DEX volume over 24 hours, 7 days and 30 days with change: a DEX's chains, a chain's largest DEXs, a DEX on a chain, or the market total and the largest DEXs, from Tanod's cache of DefiLlama data. Input: optional protocol, optional chain and limit; give one, both or neither. Cached DefiLlama data (refreshed every few hours), never live; as_of shows its age; chain tables cover the 25 chains with the most volume; an unknown name is a 422 with suggestions and a missing or over-2-day-old cache a 503 (neither charged). Informational only. Typically under 1 s (a local cache read). Price: USD 0.004. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/defi-data-api.html

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_dex_volume"
  }
}

Input Schema

NameRequiredDescriptionDefault
chainNoChain name among the 25 chains with the most DEX volume, e.g. Solana, Ethereum, Base, BSC. With protocol: that DEX's volume on the chain. Alone: the chain and its largest DEXs.
limitNoRows in a ranking or a breakdown.
protocolNoDEX name or slug, e.g. uniswap, uniswap-v3, curve-dex, pancakeswap-amm (a parent such as uniswap sums its versions). Omit for a chain or the overview.

Output Schema

NameRequiredDescriptionDefault
noteNo
as_ofNo
chainNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
scopeNo
staleNo
marketNo
reasonNo
sourceNo
protocolNo
other_matchesNo
top_protocolsNo
cache_age_hoursNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • removedInput schema / properties / chain / default
      Removed value: -null
    • removedInput schema / properties / chain / title
      Removed value: -"Chain"
    • changedInput schema / properties / limit / description
      Previous value: -"Rows in a ranking or a breakdown, 1-50 (default 10)."New value: +"Rows in a ranking or a breakdown."
    • removedInput schema / properties / limit / title
      Removed value: -"Limit"
    • removedInput schema / properties / protocol / default
      Removed value: -null
    • removedInput schema / properties / protocol / title
      Removed value: -"Protocol"
    • removedInput schema / title
      Removed value: -"get_dex_volumeArguments"
    • removedOutput schema / properties / chain / properties
      Removed value: -{
      -  "as_of": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "change_1d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_30d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_7d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "name": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "protocol_count": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "volume_24h_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "volume_30d_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "volume_7d_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / market / properties
      Removed value: -{
      -  "change_1d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_30d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_7d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "protocol_count": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "volume_24h_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "volume_30d_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "volume_7d_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / other_matches / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / protocol / properties
      Removed value: -{
      -  "chain_count": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "chains": {
      -    "items": {
      -      "properties": {
      -        "chain": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "change_1d_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "change_30d_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "change_7d_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "share_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "volume_24h_usd": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "volume_30d_usd": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "volume_7d_usd": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "type": [
      -      "array",
      -      "null"
      -    ]
      -  },
      -  "change_1d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_30d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_7d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "name": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "share_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "slug": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "type": {
      -    "enum": [
      -      "protocol",
      -      "parent",
      -      null
      -    ]
      -  },
      -  "versions": {
      -    "items": {
      -      "properties": {
      -        "change_1d_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "change_30d_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "change_7d_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "name": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "share_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "slug": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "volume_24h_usd": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "volume_30d_usd": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "volume_7d_usd": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "type": [
      -      "array",
      -      "null"
      -    ]
      -  },
      -  "volume_24h_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "volume_30d_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "volume_7d_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / top_protocols / items
      Removed value: -{
      -  "properties": {
      -    "change_1d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "change_30d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "change_7d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "share_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "slug": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "type": {
      -      "enum": [
      -        "protocol",
      -        "parent",
      -        null
      -      ]
      -    },
      -    "volume_24h_usd": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "volume_30d_usd": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "volume_7d_usd": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
  2. Added

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnly/idempotent annotations, it discloses that data is cached and refreshed only every few hours, never live, that `as_of` exposes staleness, that chain tables cover only the top 25 chains, plus exact failure modes (422 with suggestions, 503 on missing/stale cache, neither charged), latency, price and free-tier limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and the TVL disambiguation are front-loaded, then result shapes, then caching/error/cost facts in a dense but scannable flow. It is on the long side, and the pricing/docs/free-tier tail is useful context rather than filler, so only minor tightening is possible.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return fields need no explanation, yet the description still characterizes the result sets and covers staleness bounds, chain coverage limits, error semantics and cost. Nothing an agent needs to call this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the per-parameter descriptions already explain the protocol/chain combinations and the limit range in detail. The description's 'give one, both or neither' summarizes that logic but adds little beyond the schema; baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Get DEX volume by protocol and chain') and names the sibling it must not be confused with ('For TVL use get_protocol_tvl'). An agent can distinguish it from adjacent DeFi tools without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes TVL queries to get_protocol_tvl and spells out the four call shapes the tool serves: a DEX's chains, a chain's largest DEXs, a DEX on a chain, and the market overview. It also states the argument rule ('give one, both or neither'), leaving no inference needed.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.