Skip to main content
Glama

Crypto & Macro Market Data (Tanod)

compare_funding_rates

Read-onlyIdempotent

chainpeek: Compare perpetual funding rates between Hyperliquid and dYdX. For five venues net of fees use rank_funding_carry. Returns each venue's hourly and annualised funding and the spread (Hyperliquid minus dYdX v4), ranked by absolute spread. Only assets on both venues are compared; the others come back in symbols_not_found, and min_volume_usd must be met on both. Cached up to 60 s. Data only, not trading advice. Bad input is a 422 (not charged). Typically 0.3-2 s. Price: USD 0.003. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/funding-rate-spread-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": "compare_funding_rates"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoRows returned.
symbolsNoOnly these base assets (case-insensitive, at most 50), such as BTC. Names not listed on both venues are returned in symbols_not_found.
min_volume_usdNoSkip markets whose 24 h volume on either venue is below this (USD). Default 0.

Output Schema

NameRequiredDescriptionDefault
noteNo
cacheNo
countNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
sourceNo
spreadNo
marketsNo
sorted_byNo
annualizationNo
markets_on_bothNo
funding_intervalNo
symbols_not_foundNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"Rows returned, 1-50 (default 10)."New value: +"Rows returned."
    • removedInput schema / properties / limit / title
      Removed value: -"Limit"
    • removedInput schema / properties / min_volume_usd / title
      Removed value: -"Min Volume Usd"
    • removedInput schema / properties / symbols / default
      Removed value: -null
    • changedInput schema / properties / symbols / description
      Previous value: -"Optional: only these base assets (case-insensitive, at most 50), such as BTC. Names not listed on both venues are returned in symbols_not_found."New value: +"Only these base assets (case-insensitive, at most 50), such as BTC. Names not listed on both venues are returned in symbols_not_found."
    • removedInput schema / properties / symbols / title
      Removed value: -"Symbols"
    • removedInput schema / title
      Removed value: -"compare_funding_ratesArguments"
    • removedOutput schema / properties / markets / items
      Removed value: -{
      -  "properties": {
      -    "dydx": {
      -      "properties": {
      -        "funding_annualized_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "funding_hourly": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "mark_price": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "open_interest_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "volume_24h_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "hyperliquid": {
      -      "properties": {
      -        "funding_annualized_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "funding_hourly": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "mark_price": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "open_interest_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "volume_24h_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "spread_annualized_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "spread_hourly": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "symbol": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / source / properties
      Removed value: -{
      -  "dydx": {
      -    "properties": {
      -      "docs": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "url": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "hyperliquid": {
      -    "properties": {
      -      "docs": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "url": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / symbols_not_found / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
  2. Added

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already declare read-only, idempotent, open-world semantics, yet the description still adds substantial value: 60 s caching, 0.3-2 s latency, 422-on-bad-input with no charge, per-call price, and a 10-free-reads-per-IP daily limit. The 'data only, not trading advice' disclaimer is a useful behavioral caveat for an agent deciding how to present results.

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?

Front-loaded with purpose and the sibling routing before the operational details. Dense but well ordered; the pricing, rate-limit, and docs lines are somewhat list-like but each carries decision-relevant information for an agent.

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?

Given an output schema exists, the description needn't explain return values, yet it still previews hourly/annualised funding and the ranked spread. Combined with constraints, error semantics, and cost, an agent has everything needed to call it correctly.

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 schema already documents limit, symbols, and min_volume_usd in detail, including the symbols_not_found behavior. The description's note that the volume threshold must be met on both venues is a marginal restatement rather than new meaning, so baseline 3 applies.

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 (compare perpetual funding rates between Hyperliquid and dYdX) and immediately distinguishes itself from the sibling rank_funding_carry by venue count. The scope, direction of the spread (Hyperliquid minus dYdX v4), and ranking order are all explicit.

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?

Names the alternative (rank_funding_carry for five venues) and the condition that selects it, plus an implicit exclusion: only assets listed on both venues are compared, with the rest routed to symbols_not_found. The min_volume_usd-on-both-venues constraint further disambiguates when this tool applies.

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.