find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/cryptodataapi-com:cryptodataapi-com-market-health-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Crypto Data Market Health API
  description: 'Real-time crypto market intelligence API. Built for AI agents: gasless USDC payments via x402 protocol, one-call onboarding, and 180+ endpoints for prices, derivatives, funding, and sentiment.'
  version: '2026-10-28'
servers:
- url: https://cryptodataapi.com
tags:
- name: Market Health
  description: Dual-score (long-term + short-term) market health system with component breakdowns and history.
paths:
  /api/v1/market-health:
    get:
      tags:
      - Market Health
      summary: Get Market Health
      description: 'Full dual-score market health result with all 11 components.


        **`indicators` contract**


        Top-level `indicators` is a flat denormalization of the most-filtered values

        from `components..details`. Keys are **omitted entirely** when the source

        value is unavailable (never null) so consumers can safely use

        `dict.get(key, default)` for fallbacks. Committed key set:


        - `long_short_ratio` (float) — BTC long/short ratio (Binance perps)

        - `funding_rate` (float, %) — avg funding rate (aliased from `avg_funding_rate`)

        - `buy_ratio` (float, 0–1) — weighted taker-buy ratio across top spot pairs

        - `fear_greed_value` (int, 0–100) — averaged Fear & Greed index

        - `breadth_pct` (float, %) — share of top-30 coins above their 200D MA

        - `pct_from_200ma` (float, %) — BTC distance from 200D MA

        - `cross_status` (str) — Golden | Death | Neutral

        - `stablecoin_change_7d` (float) — 7-day stablecoin market-cap change


        Health is computed cross-exchange (CoinGlass aggregate + Binance) and is not

        scoped by any per-exchange filter. The `long_short_ratio` is BTC-on-Binance,

        used as a market-wide sentiment signal.'
      operationId: get_market_health_api_v1_market_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketHealthResponse'
      security:
      - APIKeyHeader: []
      x-timeout-seconds: 30
  /api/v1/market-health/summary:
    get:
      tags:
      - Market Health
      summary: Get Health Summary
      description: Scores + sentiment only (lightweight).
      operationId: get_health_summary_api_v1_market_health_summary_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: format
        in: query
        required: false
        schema:
          type: string
          description: 'Response format: ''markdown'' for LLM-friendly plain text'
          title: Format
        description: 'Response format: ''markdown'' for LLM-friendly plain text'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketHealthSummary'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-timeout-seconds: 30
  /api/v1/market-health/components:
    get:
      tags:
      - Market Health
      summary: Get Health Components
      description: All 11 component details.
      operationId: get_health_components_api_v1_market_health_components_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthComponentsResponse'
      security:
      - APIKeyHeader: []
      x-timeout-seconds: 30
  /api/v1/market-health/component/{name}:
    get:
      tags:
      - Market Health
      summary: Get Health Component
      description: Get a single component by name.
      operationId: get_health_component_api_v1_market_health_component__name__get
      security:
      - APIKeyHeader: []
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
        example: price_trend
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComponentScoreSchema'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-timeout-seconds: 30
  /api/v1/market-health/history:
    get:
      tags:
      - Market Health
      summary: Get Health History
      description: Health score history from database.
      operationId: get_health_history_api_v1_market_health_history_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 730
          minimum: 1
          default: 365
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthHistoryResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/market-health/altcoin-breadth:
    get:
      tags:
      - Market Health
      summary: Altcoin Breadth
      description: Altcoin breadth - % of coins above their MA with per-coin detail.
      operationId: altcoin_breadth_api_v1_market_health_altcoin_breadth_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: ma_period
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 5
          default: 200
          title: Ma Period
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AltcoinBreadthResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/market-health/refresh:
    post:
      tags:
      - Market Health
      summary: Force Refresh
      description: Force recalculate health score (Pro and Pro Plus tiers).
      operationId: force_refresh_api_v1_market_health_refresh_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthRefreshResponse'
      security:
      - APIKeyHeader: []
components:
  schemas:
    HealthComponentsResponse:
      properties:
        components:
          items:
            $ref: '#/components/schemas/ComponentScoreSchema'
          type: array
          title: Components
      type: object
      required:
      - components
      title: HealthComponentsResponse
      description: All component details.
    AltcoinBreadthResponse:
      properties:
        coins:
          items:
            $ref: '#/components/schemas/AltcoinDetail'
          type: array
          title: Coins
        breadth_pct:
          type: integer
          title: Breadth Pct
        ma_period:
          type: integer
          title: Ma Period
      type: object
      required:
      - coins
      - breadth_pct
      - ma_period
      title: AltcoinBreadthResponse
      description: Altcoin breadth with per-coin detail.
    MarketHealthResponse:
      properties:
        total_score:
          type: integer
          title: Total Score
        long_term_score:
          type: integer
          title: Long Term Score
        short_term_score:
          type: integer
          title: Short Term Score
        state:
          type: string
          title: State
        sentiment:
          type: string
          title: Sentiment
        long_term_sentiment:
          type: string
          title: Long Term Sentiment
        short_term_sentiment:
          type: string
          title: Short Term Sentiment
        components:
          items:
            $ref: '#/components/schemas/ComponentScoreSchema'
          type: array
          title: Components
        long_term_components:
          items:
            $ref: '#/components/schemas/ComponentScoreSchema'
          type: array
          title: Long Term Components
        short_term_components:
          items:
            $ref: '#/components/schemas/ComponentScoreSchema'
          type: array
          title: Short Term Components
        details:
          additionalProperties: true
          type: object
          title: Details
          default: {}
        indicators:
          title: Indicators
          additionalProperties: true
          type:
          - object
          - 'null'
        timestamp:
          type: string
          format: date-time
          title: Timestamp
      type: object
      required:
      - total_score
      - long_term_score
      - short_term_score
      - state
      - sentiment
      - long_term_sentiment
      - short_term_sentiment
      - components
      - long_term_components
      - short_term_components
      - timestamp
      title: MarketHealthResponse
      description: Full market health score response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HealthRefreshResponse:
      properties:
        total_score:
          type: integer
          title: Total Score
        long_term_score:
          type: integer
          title: Long Term Score
        short_term_score:
          type: integer
          title: Short Term Score
        state:
          type: string
          title: State
        sentiment:
          type: string
          title: Sentiment
        refreshed:
          type: boolean
          title: Refreshed
        timestamp:
          type: string
          format: date-time
          title: Timestamp
      type: object
      required:
      - total_score
      - long_term_score
      - short_term_score
      - state
      - sentiment
      - refreshed
      - timestamp
      title: HealthRefreshResponse
      description: Response after force-refreshing health score.
    MarketHealthSummary:
      properties:
        total_score:
          type: integer
          title: Total Score
        long_term_score:
          type: integer
          title: Long Term Score
        short_term_score:
          type: integer
          title: Short Term Score
        state:
          type: string
          title: State
        sentiment:
          type: string
          title: Sentiment
        long_term_sentiment:
          type: string
          title: Long Term Sentiment
        short_term_sentiment:
          type: string
          title: Short Term Sentiment
        timestamp:
          type: string
          format: date-time
          title: Timestamp
      type: object
      required:
      - total_score
      - long_term_score
      - short_term_score
      - state
      - sentiment
      - long_term_sentiment
      - short_term_sentiment
      - timestamp
      title: MarketHealthSummary
      description: Summary scores + sentiment only.
    HealthHistoryEntry:
      properties:
        date:
          type: string
          title: Date
        score:
          type: integer
          title: Score
        long_term_score:
          type: integer
          title: Long Term Score
        short_term_score:
          type: integer
          title: Short Term Score
        components:
          additionalProperties: true
          type: object
          title: Components
          default: {}
      type: object
      required:
      - date
      - score
      - long_term_score
      - short_term_score
      title: HealthHistoryEntry
      description: Single entry in health score history.
    AltcoinDetail:
      properties:
        symbol:
          type: string
          title: Symbol
        price:
          type: number
          title: Price
        ma:
          type: number
          title: Ma
        pct_from_ma:
          type: number
          title: Pct From Ma
        above_ma:
          type: boolean
          title: Above Ma
      type: object
      required:
      - symbol
      - price
      - ma
      - pct_from_ma
      - above_ma
      title: AltcoinDetail
      description: Per-coin altcoin breadth detail.
    HealthHistoryResponse:
      properties:
        history:
          items:
            $ref: '#/components/schemas/HealthHistoryEntry'
          type: array
          title: History
        count:
          type: integer
          title: Count
      type: object
      required:
      - history
      - count
      title: HealthHistoryResponse
      description: Health score history.
    ComponentScoreSchema:
      properties:
        name:
          type: string
          title: Name
        score:
          type: integer
          title: Score
        weight:
          type: number
          title: Weight
        description:
          type: string
          title: Description
        details:
          additionalProperties: true
          type: object
          title: Details
          default: {}
      type: object
      required:
      - name
      - score
      - weight
      - description
      title: ComponentScoreSchema
      description: Individual component score.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key