REST API v2

RESTful endpoints mirroring all MCP tools. JSON responses with cursor-based pagination.

Authentication

Include your API key in every request using the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can also use the X-Api-Token header for backward compatibility.

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining.

GET/api/v2/get_market_overview

Get the current cryptocurrency market overview including total market cap, BTC dominance, 24h volume, sentiment score, short summary, and top 5 gainers/losers.

No parameters required.

Example Request

curl -X GET "https://cryptochase.ai/api/v2/get_market_overview" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "date": "2026-03-21",
  "market_cap": 2850000000000,
  "btc_dominance": 52.4,
  "volume_24h": 98500000000,
  "sentiment_score": 3,
  "short_summary": "Markets trending bullish with BTC leading recovery.",
  "top_gainers": [
    {
      "symbol": "SOL",
      "name": "Solana",
      "percent_change_24h": 8.5
    }
  ],
  "top_losers": [
    {
      "symbol": "DOGE",
      "name": "Dogecoin",
      "percent_change_24h": -3.2
    }
  ]
}

GET/api/v2/get_market_recap

Get the AI-generated daily market recap with narrative summary, sentiment scores, key movers, and market stats. Optionally include hourly breakdown.

Parameters

Name	Type	Required	Description
date	string	No	Date in YYYY-MM-DD format. Defaults to the latest available date.

Example Request

curl -X GET "https://cryptochase.ai/api/v2/get_market_recap?date=2026-03-21" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "date": "2026-03-21",
  "short_summary": "Markets trending bullish with BTC leading recovery.",
  "narrative": "Bitcoin surged past $87,000 today as institutional interest...",
  "sentiment": {
    "market_score": 3,
    "llm_score": 7,
    "confidence": 0.82
  },
  "market_stats": {
    "total_market_cap": 2850000000000,
    "volume_24h": 98500000000,
    "btc_dominance": 52.4
  },
  "key_movers": [
    {
      "symbol": "SOL",
      "change": 8.5,
      "reason": "DEX volume surge"
    }
  ]
}

GET/api/v2/search_cryptos

Search cryptocurrencies by name, symbol, or slug. Returns up to 10 results sorted by market cap rank.

Parameters

Name	Type	Required	Description
query	string	Yes	Search term to match against cryptocurrency name, symbol, or slug.

Example Request

curl -X GET "https://cryptochase.ai/api/v2/search_cryptos?query=bitcoin" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "results": [
    {
      "id": 1,
      "symbol": "BTC",
      "name": "Bitcoin",
      "slug": "bitcoin",
      "rank": 1,
      "latest_price": 87500,
      "percent_change_24h": 2.15,
      "market_cap": 1720000000000,
      "average_sentiment": 0.72
    }
  ],
  "count": 1
}

GET/api/v2/get_crypto_details

Get detailed information about a specific cryptocurrency including price, market cap, supply, rank, and recent performance.

Parameters

Name	Type	Required	Description
identifier	string	Yes	Query parameter: symbol (BTC), slug (bitcoin), or numeric ID.

Example Request

curl -X GET "https://cryptochase.ai/api/v2/get_crypto_details?identifier=bitcoin" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "id": 1,
  "symbol": "BTC",
  "name": "Bitcoin",
  "slug": "bitcoin",
  "rank": 1,
  "type": "coin",
  "latest_price": 87500,
  "percent_change_1h": 0.35,
  "percent_change_24h": 2.15,
  "percent_change_7d": 5.8,
  "percent_change_30d": 12.4,
  "market_cap": 1720000000000,
  "volume_24h": 45000000000,
  "circulating_supply": 19700000,
  "total_supply": 21000000,
  "max_supply": 21000000
}

GET/api/v2/get_trending

Get the top trending cryptocurrencies by market cap rank. Returns up to 20 results with price, 24h change, and sentiment.

Parameters

Name	Type	Required	Description
limit	integer	No	Number of trending cryptos to return. Default: 10, max: 20.

Example Request

curl -X GET "https://cryptochase.ai/api/v2/get_trending?limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "trending": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "slug": "bitcoin",
      "rank": 1,
      "price": 87500,
      "percent_change_24h": 2.15,
      "average_sentiment": 0.72
    },
    {
      "symbol": "ETH",
      "name": "Ethereum",
      "slug": "ethereum",
      "rank": 2,
      "price": 3200,
      "percent_change_24h": 1.8,
      "average_sentiment": 0.65
    }
  ],
  "count": 2
}

GET/api/v2/get_opinions

Get expert crypto opinions and trading signals. Filters by cryptocurrency, signal type, recency, and importance. Returns up to 20 opinions with source attribution and profit tracking.

Parameters

Name	Type	Required	Description
crypto	string	No	Symbol, slug, or ID to filter by a specific cryptocurrency.
signal	string	No	Signal slug to filter by (e.g., "buy", "sell", "strong-buy").
days	integer	No	How many days back to look. Default 7, max 30.
importance	integer	No	Minimum importance level (1-5).
limit	integer	No	Number of results to return. Default 20.

Example Request

curl -X GET "https://cryptochase.ai/api/v2/get_opinions?crypto=BTC&days=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "opinions": [
    {
      "id": 12345,
      "title": "Bitcoin bullish breakout imminent",
      "short_text": "BTC showing strong support at $85k with increasing volume.",
      "source": "CryptoAnalyst",
      "crypto": {
        "symbol": "BTC",
        "name": "Bitcoin"
      },
      "signal": {
        "name": "Strong Buy",
        "slug": "strong-buy"
      },
      "published_at": "2026-03-21T14:30:00+00:00",
      "importance": 4
    }
  ],
  "count": 1,
  "filters": {
    "days": 7,
    "crypto": "BTC",
    "signal": null,
    "importance_min": null
  }
}

GET/api/v2/get_sentiment_analysis

Get aggregated sentiment analysis for a specific cryptocurrency or the overall market. Counts buy vs sell opinions and returns bullish/bearish percentages.

Parameters

Name	Type	Required	Description
crypto	string	No	Query parameter. If omitted, returns market-level sentiment.
days	integer	No	Period for analysis in days. Default 7, max 30.

Example Request

curl -X GET "https://cryptochase.ai/api/v2/get_sentiment_analysis?crypto=BTC&days=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "mode": "crypto",
  "crypto": {
    "symbol": "BTC",
    "name": "Bitcoin",
    "slug": "bitcoin"
  },
  "period_days": 7,
  "buy_count": 42,
  "sell_count": 15,
  "neutral_count": 8,
  "total": 65,
  "bullish_percent": 64.6,
  "breakdown": [
    {
      "signal": "Strong Buy",
      "slug": "strong-buy",
      "count": 18
    },
    {
      "signal": "Buy",
      "slug": "buy",
      "count": 24
    },
    {
      "signal": "Sell",
      "slug": "sell",
      "count": 15
    }
  ]
}

GET/api/v2/compare_cryptos

Compare 2 to 5 cryptocurrencies side by side. Returns price, market cap, volume, percent changes, sentiment, and opinions count for each.

Parameters

Name	Type	Required	Description
identifiers	string	Yes	Comma-separated list of 2-5 cryptocurrency identifiers (symbols, slugs, or numeric IDs).

Example Request

curl -X GET "https://cryptochase.ai/api/v2/compare_cryptos?identifiers=BTC,ETH" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "compared": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "slug": "bitcoin",
      "rank": 1,
      "latest_price": 87500,
      "market_cap": 1720000000000,
      "volume_24h": 45000000000,
      "percent_change_24h": 2.15,
      "percent_change_7d": 5.8,
      "average_sentiment": 0.72,
      "opinions_count": 1540
    },
    {
      "symbol": "ETH",
      "name": "Ethereum",
      "slug": "ethereum",
      "rank": 2,
      "latest_price": 3200,
      "market_cap": 385000000000,
      "volume_24h": 18000000000,
      "percent_change_24h": 1.8,
      "percent_change_7d": 4.2,
      "average_sentiment": 0.65,
      "opinions_count": 980
    }
  ],
  "fields": [
    "price",
    "market_cap",
    "volume_24h",
    "percent_change_24h",
    "percent_change_7d",
    "average_sentiment",
    "opinions_count"
  ]
}

Ready to Get Started?

Follow the Quick Start guide to connect your client and make your first query.

Quick Start Guide MCP Tools