Skip to main content
Glama

Central Command — x402 Trading Intelligence

Long/Short Account Ratio

cc.long_short_account_ratio
Read-onlyIdempotent

Call cc.long_short_account_ratio — Global long vs short account positioning ratio from Coinglass showing retail sentiment with 60-min cache. Purpose: Global long vs short account positioning ratio from Coinglass showing retail sentiment with 60-min cache. Behavior: READ-ONLY. Does not place orders, move funds, or mutate your exchange account. Responses may be cached (~3600s). Auth: X-Api-Key or x402 payment proof (X-PAYMENT / __x_payment). Anonymous unauthenticated calls receive HTTP 402 with payment accepts. Cost: $0.001 USDC per successful call (x402 Base USDC pay-per-use or prepaid X-Api-Key balance). Linked Connect keys are free. This is billing, not a side effect. Rate limit: 60/min (per API key). Tier: standard. Returns: Time-series of long_percent, short_percent, and ratio showing crowd positioning shifts. Guidelines: Use for research / signal context. Pair with cc.agent_strategy (paper) before any live order. Do not invent fills from this data alone. Tags: sentiment, positioning, retail, long-short, contrarian.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
symbolYesParameter `symbol` (string). Required.
__x_paymentNoOptional x402 payment proof (same value as X-PAYMENT header). Use when retrying after HTTP 402 if your MCP client cannot set custom headers. Not a business parameter. Optional.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYesTrue when the gateway HTTP status is 2xx.
dataNoParsed JSON body from the endpoint (shape varies by slug).
errorNoError message when ok is false.
statusYesUpstream HTTP status from x402-gateway.
billingNoOptional payment / cost metadata when present.
endpointYesCatalog slug that was invoked (e.g. funding-rates).

TDQS

A4.3/5.0
Behavior5/5

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

Beyond annotations (readOnlyHint, idempotentHint), the description discloses caching behavior, authentication requirements (HTTP 402 with payment proof), cost, rate limits, and explicitly states it does not place orders or mutate accounts. This is rich behavioral transparency that adds significant value beyond the structured annotations.

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

Conciseness3/5

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

The description is well-structured with labeled sections, but it redundantly repeats the purpose sentence twice (first sentence and 'Purpose' line). This wastes space and could be tightened. Other details earn their place, but the repetition hurts conciseness.

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?

Covers all relevant aspects: purpose, behavior, auth, cost, rate limits, return format, usage guidelines, and safety warnings. Despite the redundancy, it is exceptionally complete for a data-fetching tool, leaving few unanswered questions.

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% with both symbol and __x_payment documented. The description adds context around __x_payment in the auth section but doesn't add additional parameter semantics beyond the schema. Baseline 3 applies since the schema already handles parameter documentation.

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?

The description clearly states the tool provides the global long vs short account positioning ratio from Coinglass, with specific data points (long_percent, short_percent, ratio) and context (retail sentiment, 60-min cache). It distinguishes from siblings by emphasizing sentiment/positioning and the contrarian tag, making its purpose specific and unambiguous.

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

Usage Guidelines4/5

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

Provides explicit usage guidance: 'Use for research / signal context' and cautions against inventing fills, recommending pairing with cc.agent_strategy before live orders. However, it doesn't explicitly contrast with alternative sentiment tools, so it lacks a full when-not-to-use comparison.

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.

TDQS

A3.7/5.0
Disambiguation2/5

Multiple tools have overlapping or unclear boundaries. The AI chat tools cc.squirrel_chat, cc.squirrel_chat_v2, and cc.openclaw_chat all provide conversational trading assistance with near-identical descriptions, while cc.central_signal and cc.external_signal both normalize signals for execution. Additionally, cc.asset_scanner, cc.auto_fetch_market_data, cc.data_tools, and cc.ma_fetch all supply technical indicator data with significant overlap.

Naming Consistency4/5

All tools share the 'cc.' prefix and use snake_case consistently, which creates a uniform feel. However, naming style mixes nouns (cc.asset_scanner, cc.data_tools) with verbs (cc.auto_fetch, cc.list_catalog) and compound forms (cc.strategy_backtest, cc.trade_builder), so it is not a strict verb_noun pattern. Minor deviations keep it from a 5.

Tool Count2/5

With 33 tools, the server is well beyond the typical well-scoped range of 3-15 and even above the 'heavy' 16-25 range. While the trading intelligence domain can be broad, this count feels overstuffed rather than curated, especially given the many overlapping data and AI tools.

Completeness3/5

The core trading workflow is covered: market data, technical analysis, signals, strategy backtesting, paper trading, and live execution all have tools. However, there is no dedicated account management tool (e.g., get_balance, list_positions) and no explicit delete_strategy, with these operations buried inside cc.agent_strategy's action parameter. Notable gaps remain for a complete lifecycle.

Resources