CoinMarketCap

Category: Market data · signals

CoinMarketCap exposes read-only crypto market data through Thirdfy provider cmc. Agents call get_cmc_* on the Thirdfy catalog. These actions do not move capital.

Actions

Composed briefs cost more than quote and metrics reads. Command shows the USD charge after the turn. See Credits and balance.

Responses include Powered by CoinMarketCap attribution where required.

Signals

These reads publish signals in the signal manifest (app cmc, manifest version 2). The tables come from the production catalog (api.thirdfy.com).

• Typed reads. Signal paths under typed. are parsed numbers and dates. Display strings such as "+6.26%" arrive as 6.26. Check parseIssues before you use a value.
• Context only. cmc.news, cmc.narratives, cmc.technicals and cmc.etf_demand point at the raw reply. They inform an agent but never drive a rule.
• One read, several signals. get_cmc_derivatives_metrics feeds cmc.market_funding, cmc.open_interest_change and cmc.liquidations in one call.
• Display. Values may be shown to users (displayValues: true) with the line "Powered by CoinMarketCap". The raw reply may not (displayRaw: false).

Signal fields

Credential model

CoinMarketCap reads use the same Thirdfy session as other catalog actions. CLI and MCP do not take a CoinMarketCap key. Thirdfy credits pay the catalog action.

Discovery

curl "https://api.thirdfy.com/api/v1/agent/actions/catalog"
thirdfy-agent actions --provider cmc --json

Use it

Ask your agent:

Using Thirdfy, what is the crypto fear and greed index right now, and what market regime does CoinMarketCap see?

Or call it yourself:

agentRun { action: "get_cmc_fear_greed" }

thirdfy-agent run --action get_cmc_fear_greed --provider cmc --json

curl -s -X POST https://mcp.thirdfy.com/tool/agentRun \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AGENT_API_KEY" \
  -d '{"action":"get_cmc_fear_greed"}'

Trimmed result from a real read on 2026-10-08:

{
  "typed": {
    "index": 58,
    "label": "Neutral",
    "asOf": "2026-10-08T14:08:10.207Z"
  },
  "parseIssues": [],
  "freshness": {
    "fetchedAt": "2026-10-08T14:23:22Z",
    "ttlMs": 300000,
    "cacheHit": false
  },
  "attribution": "Powered by CoinMarketCap"
}

What to check: read typed.index (0 to 100) and typed.label. Show values with the line "Powered by CoinMarketCap".

The market regime read takes no params either (get_cmc_market_regime). Its typed block carries the verdict and the inputs behind it:

{
  "typed": {
    "regime": "mixed_transition",
    "conviction": "medium",
    "leverageState": "mixed_positioning",
    "liquidationState": "contained",
    "recommendedAction": "stay_selective",
    "metrics": { "btcDominancePct": 59.23, "fearGreedIndex": 58, "averageFunding7dBps": 35.95 },
    "dataGaps": ["macro_curve_context_unavailable"]
  },
  "parseIssues": []
}

Use typed, not the raw result text. dataGaps names any input that was missing for this read.

Readiness checklist

• Agent authenticated for discovery and run (email OTP agent_wallet or agent API key per lane).
• Strategy treats CoinMarketCap output as advisory evidence.

Execution lanes

CoinMarketCap actions are read-only and fanoutSafe. They do not require delegation binding for research reads.

Related

• Signals and market data
• MCP discovery
• Actions reference