Skip to main content
Glama

Crypto & Macro Market Data (Tanod)

rank_funding_carry

Read-onlyIdempotent

chainpeek: Rank cross-venue perpetual funding carry. For Hyperliquid against dYdX alone use compare_funding_rates; for market data use get_perp_markets. Returns the best long and short venue pair per asset across Binance USDT-M, Bybit, OKX, Hyperliquid and dYdX v4, with the annualised funding spread gross and net of taker fees. Net subtracts four taker legs (open and close on both venues) at taker_fee_bps, spread over holding_days; with the default 0 bps net equals gross. Rates are normalised to hourly and annualised (simple); a venue that is down is listed in venues_failed. Cached up to 60 s. Data only, not trading advice. Bad input is a 422 (not charged). Typically 1-5 s. Price: USD 0.005. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/funding-rate-arbitrage-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": "rank_funding_carry"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoRows returned.
venuesNoSubset of hyperliquid, dydx, binance, bybit, okx (at least two). Default: all five.
symbolsNoOnly these base assets (case-insensitive, at most 50), such as BTC. Names listed on fewer than two of the chosen venues are returned in symbols_not_found.
holding_daysNoDays the position is held; the fees are amortised over it.
taker_fee_bpsNoTaker fee per side in basis points. Net APR subtracts 4 taker legs (open and close on both venues): 4 x bps / 100 x 365 / holding_days.
min_volume_usdNoA venue is only used for a symbol when its 24 h volume there reaches this (USD), so it applies to both legs. Default 0.

Output Schema

NameRequiredDescriptionDefault
noteNo
pairNo
cacheNo
countNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
sourceNo
marketsNo
sorted_byNo
rate_basisNo
net_formulaNo
venues_usedNo
holding_daysNo
annualizationNo
taker_fee_bpsNo
venues_failedNo
intervals_noteNo
markets_rankedNo
intervals_unknownNo
symbols_not_foundNo
fee_cost_annualized_pctNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed21 schema fields changed
    • changedInput schema / properties / holding_days / description
      Previous value: -"Days the position is held; the fees are amortised over it (default 7)."New value: +"Days the position is held; the fees are amortised over it."
    • removedInput schema / properties / holding_days / title
      Removed value: -"Holding Days"
    • changedInput schema / properties / limit / description
      Previous value: -"Rows returned, 1-100 (default 20)."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 listed on fewer than two of the chosen venues are returned in symbols_not_found."New value: +"Only these base assets (case-insensitive, at most 50), such as BTC. Names listed on fewer than two of the chosen venues are returned in symbols_not_found."
    • removedInput schema / properties / symbols / title
      Removed value: -"Symbols"
    • changedInput schema / properties / taker_fee_bps / description
      Previous value: -"Taker fee per side in basis points (default 0). Net APR subtracts 4 taker legs (open and close on both venues): 4 x bps / 100 x 365 / holding_days."New value: +"Taker fee per side in basis points. Net APR subtracts 4 taker legs (open and close on both venues): 4 x bps / 100 x 365 / holding_days."
    • removedInput schema / properties / taker_fee_bps / title
      Removed value: -"Taker Fee Bps"
    • removedInput schema / properties / venues / default
      Removed value: -null
    • changedInput schema / properties / venues / description
      Previous value: -"Optional subset of hyperliquid, dydx, binance, bybit, okx (at least two). Default: all five."New value: +"Subset of hyperliquid, dydx, binance, bybit, okx (at least two). Default: all five."
    • removedInput schema / properties / venues / title
      Removed value: -"Venues"
    • removedInput schema / title
      Removed value: -"rank_funding_carryArguments"
    • removedOutput schema / properties / intervals_unknown / additionalProperties
      Removed value: -{
      -  "type": [
      -    "integer",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / markets / items
      Removed value: -{
      -  "properties": {
      -    "annualized_pct_by_venue": {
      -      "additionalProperties": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "long": {
      -      "properties": {
      -        "funding_annualized_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "funding_hourly": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "funding_rate": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "index_price": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "interval_h": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "mark_price": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "open_interest_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "venue": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "volume_24h_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "long_venue": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "net_annualized_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "short": {
      -      "properties": {
      -        "funding_annualized_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "funding_hourly": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "funding_rate": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "index_price": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "interval_h": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "mark_price": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "open_interest_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "venue": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "volume_24h_usd": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "short_venue": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "spread_annualized_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "symbol": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "venues_compared": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / rate_basis / additionalProperties
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / source / additionalProperties
      Removed value: -{
      -  "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"
      -  ]
      -}
    • removedOutput schema / properties / venues_failed / items
      Removed value: -{
      -  "properties": {
      -    "reason": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "venue": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / venues_used / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
  2. Added

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already cover read-only, idempotent, non-destructive and open-world, yet the description still adds real behavioral detail: results cached up to 60 s, failed venues surfaced in venues_failed, bad input returns 422 without charge, typical latency 1-5 s, and the exact fee-amortisation model behind the net figure. The only omission is pagination/ordering behavior for the ranked rows, which keeps it off a 5.

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, then routing alternatives, then output semantics, then operational facts — a logical order with no filler sentences. It runs long, and the pricing/free-tier/docs tail is adjacent to the tool's job rather than central, but each clause still carries information an agent can act on.

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?

Even though an output schema exists and return values need not be spelled out, the description defines the ranked unit (best long/short venue pair per asset), the gross-vs-net distinction, and failure/degradation paths. Combined with full schema coverage and annotations, nothing needed 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.

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3; the description still adds meaning by tying taker_fee_bps to holding_days through the four-taker-leg netting formula and by clarifying that the default 0 bps makes net equal gross. It also explains the symbols_not_found consequence of symbol/venue mismatch, which the schema states more tersely.

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 ('Rank cross-venue perpetual funding carry') and immediately scopes it to five named venues with a per-asset long/short pair output. It explicitly separates itself from compare_funding_rates and get_perp_markets, so an agent can pick it without opening the 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?

Names two concrete alternatives with the exact condition that selects each: Hyperliquid-vs-dYdX only → compare_funding_rates; raw market data → get_perp_markets. That is explicit when-to-use and when-not-to-use guidance rather than implied context.

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.