CoinGraph

Everything CoinGraph holds on one coin: price and moves, decline from the true all-time high and recovery from the low, the 0–100 survival rating with its band and every itemised deduction, data confidence, the risk read (turnover, dilution ahead, volatility), market figures and links. Use this when a person asks what is happening with a coin or whether the project behind it is still going. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "The coin's CoinGecko id (e.g. 'ethereum'), symbol (e.g. 'ETH') or name. Ids resolve exactly; symbols and names resolve to the highest-ranked match."
    }
  },
  "required": [
    "coin"
  ]
}

The survival rating alone for one coin: score 0–100 (higher is healthier), band (Active, Weakening, Distressed or Dormant), each deduction with the input that produced it, and a citation line with the page URL. Faster than the full profile. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "The coin's CoinGecko id (e.g. 'ethereum'), symbol (e.g. 'ETH') or name. Ids resolve exactly; symbols and names resolve to the highest-ranked match."
    }
  },
  "required": [
    "coin"
  ]
}

Find coins by name or symbol. Returns CoinGecko ids to pass to the other tools, with market cap rank. Use when a name is ambiguous or you need the id.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Name or symbol, at least two characters."
    }
  },
  "required": [
    "query"
  ]
}

Coins currently in one survival band, from today's daily snapshot, ordered by market cap rank. Bands are computed for the scored tier: the top 100 by market cap plus every coin with a report, a watch or a monitored thesis. A coin absent from a band is unscored today, not Active. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "band": {
      "type": "string",
      "enum": [
        "Active",
        "Weakening",
        "Distressed",
        "Dormant"
      ],
      "description": "One of Active, Weakening, Distressed, Dormant."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    }
  },
  "required": [
    "band"
  ]
}

Today's largest 24-hour gainers and losers among the top 1,000 coins by market cap, stablecoins excluded, with 7- and 30-day context and market cap. A move is a fact about price, not a rating.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  }
}

Coins down 60% or more from their all-time high that have outrun Bitcoin over the last 30 days, with turnover as a liquidity check. The recovery half of the story. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  }
}

The market's own read: total crypto market cap and its 24-hour change, Bitcoin dominance, Bitcoin's 7- and 30-day moves and distance from its peak, and the regime CoinGraph derives from them (rally, falling or flat). Use it to put a single coin's move in context.

{
  "type": "object",
  "properties": {}
}

The full v1 asset object: identity, market, peak and recovery, health (survival 0–100 with every factor and input), risk (with graded factors), venues, market context. Every group carries source and as_of; scores carry confidence; missing factors are listed under unassessed. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "The coin's CoinGecko id (e.g. 'ethereum'), symbol (e.g. 'ETH') or name. Ids resolve exactly; symbols and names resolve to the highest-ranked match."
    }
  },
  "required": [
    "coin"
  ]
}

What changed for an asset since a moment: rank, price, market cap, volume, turnover, survival score and band, each with before and after values; scoring deductions that appeared, cleared or moved in points; contract permission flags raised or cleared; unlock-schedule events added, removed or resized; repository commits, contributors and stars; and the signals that opened or resolved inside the window. Every group is compared independently. Any group with fewer than two observations for this asset is named in not_compared with the reason — an empty change list is never a claim that a group named there held steady. Each baseline is the nearest earlier observation; check baseline_drift_days before treating a window as the one you asked for. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "CoinGecko id, symbol or name."
    },
    "since": {
      "type": "string",
      "description": "A window (24h, 7d, 30d) or an ISO timestamp. Required — a diff needs a stated baseline."
    }
  },
  "required": [
    "asset",
    "since"
  ]
}

Evaluate an asset before acting: each check (health, drawdown, volume trend, dilution, volatility, turnover, regime) as pass, caution or unassessed against published thresholds; warnings with numbers; and an actionability roll-up of clear, caution or insufficient_data. The agent decides. Records the assessment so its outcome can be measured. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "CoinGecko id, symbol or name."
    },
    "intent": {
      "type": "string",
      "enum": [
        "buy",
        "sell",
        "hold",
        "research"
      ],
      "description": "What the agent is considering."
    },
    "horizon_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    },
    "size_usd": {
      "type": "number",
      "minimum": 0,
      "description": "Position size under consideration, in USD."
    }
  },
  "required": [
    "asset"
  ]
}

Up to five assets side by side as full v1 objects, plus a difference row naming the highest health, lowest risk, highest confidence, strongest 30-day move, smallest decline from peak and highest turnover. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "assets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 5
    }
  },
  "required": [
    "assets"
  ]
}

Find candidates in today's scored tier by band, health score range, market cap range, minimum turnover, maximum decline from peak and minimum 30-day change. Returns ranked candidates with reasons and the coin page URL. Unscored is not Active. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "bands": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Active",
          "Weakening",
          "Distressed",
          "Dormant"
        ]
      }
    },
    "min_score": {
      "type": "number"
    },
    "max_score": {
      "type": "number"
    },
    "min_market_cap_usd": {
      "type": "number"
    },
    "max_market_cap_usd": {
      "type": "number"
    },
    "min_turnover": {
      "type": "number",
      "description": "24h volume as a share of market cap, e.g. 0.02 for 2%."
    },
    "max_decline_from_peak_pct": {
      "type": "number"
    },
    "min_change_30d_pct": {
      "type": "number"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  }
}

Pre-trade validation for an order of a given size: estimated slippage from order books CoinGraph sampled itself, the size as a share of resting depth, the median spread, supply unlocking inside the horizon, contract flags, and the asset's health and risk. Slippage is estimated only inside the depth actually measured; a larger order is reported as exceeding sampled depth rather than extrapolated. Send your own thresholds as `policy` and each is evaluated against the observed values and returned rule by rule — whether a rule held is your rule's answer, never CoinGraph's. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "The coin's id, symbol or name."
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "size_usd": {
      "type": "number",
      "description": "Order size in US dollars."
    },
    "horizon_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "How long the position is expected to be held; sets the unlock window."
    },
    "policy": {
      "type": "object",
      "description": "Your own thresholds. Each is evaluated against the observed value and returned with whether it held.",
      "properties": {
        "max_risk_score": {
          "type": "number"
        },
        "min_health_score": {
          "type": "number"
        },
        "min_confidence": {
          "type": "number"
        },
        "max_slippage_pct": {
          "type": "number"
        },
        "min_depth_2pct_usd": {
          "type": "number"
        },
        "max_size_share_of_depth": {
          "type": "number"
        },
        "max_unlock_share_in_horizon": {
          "type": "number"
        },
        "max_spread_bps": {
          "type": "number"
        },
        "no_contract_flags": {
          "type": "boolean"
        }
      }
    }
  },
  "required": [
    "asset",
    "side",
    "size_usd"
  ]
}

What changed in CoinGraph's stored state: survival band moves, volume anomalies against a coin's own baseline, order-book depth collapse, spread widening, approaching unlocks and extreme perpetual funding. Each carries the inputs that produced it, a severity, a confidence and a first-seen time; an open signal is one whose condition still holds. Computed hourly from stored rows, never a live read. CoinGraph ratings are opinions derived from disclosed market inputs — never predictions, never financial advice.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "Limit to one coin, by CoinGecko id. Omit for the whole feed."
    },
    "kind": {
      "type": "string",
      "enum": [
        "band_change",
        "volume_anomaly",
        "depth_collapse",
        "spread_widening",
        "unlock_approaching",
        "funding_extreme"
      ]
    },
    "severity": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "include_resolved": {
      "type": "boolean",
      "default": false
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50
    }
  }
}