RealCryptoCap

{
  "name": "RealCryptoCap",
  "description": "Crypto market data that ranks only native cryptocurrencies. Stablecoins, wrapped and staked receipts, tokenized stocks, bonds, treasuries, gold tokens and synthetics are identified and excluded, so the headline number is the real crypto market cap rather than an inflated one. Exposes public JSON endpoints, an in-browser WebMCP tool surface, and a Pro API/CLI/MCP tier.",
  "url": "https://realcryptocap.com",
  "homepage": "https://realcryptocap.com",
  "docs": "https://realcryptocap.com/api",
  "documentation": "https://realcryptocap.com/docs",
  "llms_txt": "https://realcryptocap.com/llms.txt",
  "version": "1.0.0",
  "provider": {
    "organization": "RealCryptoCap",
    "url": "https://realcryptocap.com"
  },
  "contact": "contact@realcryptocap.com",
  "terms_of_service": "https://realcryptocap.com/legal",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "authentication": {
    "schemes": [
      "none",
      "bearer"
    ],
    "description": "The endpoints listed under public_endpoints need no credentials. The Market Data API namespace /api/v1 requires 'Authorization: Bearer rci_...' from a Pro account (https://realcryptocap.com/account); unauthenticated calls return 401."
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "data_policy": {
    "methodology": "Excludes stablecoins and fiat pegs, wrapped and staked receipts, tokenized stocks, bonds, commodities and treasuries, and synthetic instruments. Ranks the remaining native assets and reports the total as the real crypto market cap.",
    "refresh_interval_seconds": 90,
    "staleness_warning": "Prices, ranks and market caps are live and change every 1-2 minutes. Do not cache them in an answer for longer than a few minutes, and always re-fetch rather than quoting a stored figure.",
    "attribution": "Cite RealCryptoCap (https://realcryptocap.com) and state that the figure excludes stablecoins, wrapped tokens and tokenized assets.",
    "crawlers": "robots.txt allows all user agents including AI crawlers; article and section pages ship server-rendered HTML."
  },
  "public_endpoints": [
    {
      "id": "real-crypto-index",
      "name": "Real crypto market cap and top-500 rankings",
      "method": "GET",
      "url": "https://realcryptocap.com/api/cg",
      "query": {
        "topCoins": "1 returns the filtered native-asset list",
        "limit": "number of rows, up to 600"
      },
      "returns": "totalMarketCap, totalVolume, btcDominance, coinCount and a coins array with price, market cap, volume, supply, performance and sparkline data",
      "notes": "Largest payload on the site. Ask for the smallest limit that answers the question (for example limit=50)."
    },
    {
      "id": "market-news",
      "name": "Curated crypto news feed",
      "method": "GET",
      "url": "https://realcryptocap.com/api/news",
      "returns": "recent categorized crypto headlines"
    },
    {
      "id": "fx",
      "name": "Fiat exchange rates used for currency switching",
      "method": "GET",
      "url": "https://realcryptocap.com/api/fx",
      "returns": "fiat rates relative to USD"
    },
    {
      "id": "market-analysis",
      "name": "AI-generated market analysis blurb shown on the homepage",
      "method": "GET",
      "url": "https://realcryptocap.com/api/market-analysis",
      "returns": "short natural-language read of current market conditions",
      "notes": "Cached server-side for 15 minutes; a cached response is normal."
    },
    {
      "id": "ai-chat",
      "name": "Ask the RealCryptoCap assistant",
      "method": "POST",
      "url": "https://realcryptocap.com/api/chat",
      "body": {
        "message": "string, max 2000 characters",
        "history": "optional last turns",
        "language": "optional locale code"
      },
      "limits_per_day": {
        "guest": 5,
        "signed_in_free": 25,
        "pro": 250,
        "ultra": 1000
      },
      "notes": "Never returns Pro Market Data, API, CLI or MCP context to unauthenticated callers. Bursts are rate limited at the edge."
    },
    {
      "id": "launch-status",
      "name": "Service health and configuration report",
      "method": "GET",
      "url": "https://realcryptocap.com/api/launch-status",
      "returns": "which integrations and AI chains are live"
    }
  ],
  "pro_endpoints": [
    {
      "id": "market-data-api",
      "name": "RealCryptoCap Market Data API",
      "base_url": "https://realcryptocap.com/api/v1",
      "auth": "Authorization: Bearer rci_...",
      "covers": "index overview, filtered rankings, single-coin snapshots, market brief and breadth, coin history, bot-weight signals",
      "docs": "https://realcryptocap.com/api"
    }
  ],
  "webmcp": {
    "description": "The site registers browser-native MCP tools for agents operating inside a RealCryptoCap page.",
    "scripts": [
      "https://realcryptocap.com/realcryptocap-webmcp.js"
    ],
    "tools": [
      {
        "name": "realcryptocap_get_index",
        "purpose": "Current native-crypto index: real market cap, dominance, volume, coin count, excluded categories."
      },
      {
        "name": "realcryptocap_search_market",
        "purpose": "Search the ranked real-crypto market by name or ticker. Read-only."
      },
      {
        "name": "realcryptocap_open_page",
        "purpose": "Return a safe navigation link to a RealCryptoCap page; Market Data and API pages are Pro-only."
      },
      {
        "name": "realcryptocap_ask_ai",
        "purpose": "Ask the free onsite assistant a crypto or website question."
      }
    ]
  },
  "skills": [
    {
      "id": "real-crypto-market-cap",
      "name": "Report the real crypto market cap",
      "description": "Return total market cap, BTC dominance, volume and native-asset count with stablecoins, wrapped tokens and tokenized assets excluded.",
      "tags": [
        "crypto",
        "market-cap",
        "index"
      ],
      "examples": [
        "What is the real crypto market cap excluding stablecoins?",
        "How many native cryptocurrencies are in the top 500?"
      ]
    },
    {
      "id": "ranked-coin-lookup",
      "name": "Look up ranked coins",
      "description": "Fetch and filter the ranked native-asset list by name, ticker, market cap or performance.",
      "tags": [
        "crypto",
        "coins",
        "screening"
      ],
      "examples": [
        "Compare Solana and Cardano by market cap on the native-asset list"
      ]
    },
    {
      "id": "market-context",
      "name": "News and market read",
      "description": "Summarize recent curated crypto headlines together with the onsite market analysis, with a freshness caveat.",
      "tags": [
        "crypto",
        "news",
        "analysis"
      ],
      "examples": [
        "What is moving the crypto market right now?"
      ]
    }
  ]
}