Bitcompare Market API

Global market statistics

Operations 3

GET /api/v1/global-stats/summary Global market summary #
GET /api/v1/global-stats/fear-greed Fear & Greed index #
GET /api/v1/global-stats/movers Top gainers/losers #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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/bitcompare-net:bitcompare-net-market-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

bitcompare-net-market-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Bitcompare Market API
  summary: Crypto yield data, coin metadata, prices, market stats, and stablecoin data.
  description: Public REST API powering Bitcompare and the Bitcompare MCP server. Live and historical crypto yield data across lending, staking, borrowing, and stablecoin products, plus coin metadata, aggregated prices, market stats, and stablecoin peg-stability. Every endpoint is also exposed as an MCP tool at https://api.bitcompare.net/mcp.
  version: 1.0.0
  contact:
    name: Bitcompare API support
    email: info@bitcompare.net
    url: https://docs.bitcompare.net
  license:
    name: Commercial
    url: https://bitcompare.net/terms-of-use
  termsOfService: https://bitcompare.net/terms-of-use
servers:
- url: https://api.bitcompare.net
  description: Production
security:
- {}
- BearerAuth: []
tags:
- name: Market
  description: Global market statistics
paths:
  /api/v1/global-stats/summary:
    get:
      tags:
      - Market
      operationId: market_summary
      summary: Global market summary
      description: One-call summary of total market cap, 24h volume, BTC/ETH dominance, and recent trend.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  totalMarketCapUsd:
                    type: number
                    description: Combined market cap of all tracked coins
                  volume24hUsd:
                    type: number
                    description: Combined 24h trading volume
                  btcDominance:
                    type: number
                    description: BTC share of total market cap, 0-100
                  ethDominance:
                    type: number
                    description: ETH share of total market cap, 0-100
                  trend24h:
                    description: 24h trend as a decimal (0.02 = +2%)
                    type: number
                required:
                - totalMarketCapUsd
                - volume24hUsd
                - btcDominance
                - ethDominance
                additionalProperties: true
        '401':
          description: Missing or invalid API key
          $ref: '#/components/responses/Unauthorized'
        '429':
          description: Plan rate limit exceeded
          $ref: '#/components/responses/RateLimited'
      x-mcp-annotations:
        readOnlyHint: true
        destructiveHint: false
        idempotentHint: true
        openWorldHint: true
  /api/v1/global-stats/fear-greed:
    get:
      tags:
      - Market
      operationId: fear_greed_index
      summary: Fear & Greed index
      description: Current Fear & Greed index value and historical trend.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  value:
                    type: integer
                    minimum: 0
                    maximum: 100
                    description: Current index, 0 (extreme fear) to 100 (extreme greed)
                  classification:
                    type: string
                    description: Label, e.g. `Greed`, `Neutral`, `Extreme Fear`
                  updatedAt:
                    type: string
                  history:
                    description: Recent trend of the index
                    type: array
                    items:
                      type: object
                      properties:
                        timestamp:
                          type: string
                          description: ISO-8601 timestamp of the data point
                        value:
                          type: number
                          description: The recorded numeric value
                      required:
                      - timestamp
                      - value
                      additionalProperties: true
                required:
                - value
                - classification
                additionalProperties: true
        '401':
          description: Missing or invalid API key
          $ref: '#/components/responses/Unauthorized'
        '429':
          description: Plan rate limit exceeded
          $ref: '#/components/responses/RateLimited'
      x-mcp-annotations:
        readOnlyHint: true
        destructiveHint: false
        idempotentHint: true
        openWorldHint: true
  /api/v1/global-stats/movers:
    get:
      tags:
      - Market
      operationId: top_movers
      summary: Top gainers/losers
      description: Biggest 24h gainers and losers within a rank segment.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  gainers:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Canonical coin ID (e.g. `bitcoin`)
                        symbol:
                          type: string
                          description: Trading symbol (e.g. `btc`)
                        name:
                          type: string
                          description: Human-readable name (e.g. `Bitcoin`)
                        marketCap:
                          description: Market cap in USD
                          type: number
                        rank:
                          description: Market cap rank (1 = largest)
                          type: integer
                        price:
                          description: Current spot price in USD
                          type: number
                      required:
                      - id
                      - symbol
                      - name
                      additionalProperties: true
                    description: Top 24h gainers in the requested segment
                  losers:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Canonical coin ID (e.g. `bitcoin`)
                        symbol:
                          type: string
                          description: Trading symbol (e.g. `btc`)
                        name:
                          type: string
                          description: Human-readable name (e.g. `Bitcoin`)
                        marketCap:
                          description: Market cap in USD
                          type: number
                        rank:
                          description: Market cap rank (1 = largest)
                          type: integer
                        price:
                          description: Current spot price in USD
                          type: number
                      required:
                      - id
                      - symbol
                      - name
                      additionalProperties: true
                    description: Top 24h losers in the requested segment
                required:
                - gainers
                - losers
                additionalProperties: true
        '401':
          description: Missing or invalid API key
          $ref: '#/components/responses/Unauthorized'
        '429':
          description: Plan rate limit exceeded
          $ref: '#/components/responses/RateLimited'
      parameters:
      - name: segment
        in: query
        required: false
        description: Rank segment, default "top100"
        schema:
          type: string
          enum:
          - top10
          - top100
          - top1000
        example: top100
      - name: limit
        in: query
        required: false
        description: Number of gainers and losers to return on each side, default 10
        schema:
          type: integer
          minimum: 1
          maximum: 50
        example: 10
      x-mcp-annotations:
        readOnlyHint: true
        destructiveHint: false
        idempotentHint: true
        openWorldHint: true
components:
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            type: object
            required:
            - error
            properties:
              error:
                type: object
                properties:
                  message:
                    type: string
                  code:
                    type: string
                    example: INVALID_API_KEY
    RateLimited:
      description: Plan rate limit exceeded — see X-RateLimit-* headers and Retry-After
      content:
        application/json:
          schema:
            type: object
            required:
            - error
            properties:
              error:
                type: object
                properties:
                  message:
                    type: string
                  code:
                    type: string
                    example: RATE_LIMIT_EXCEEDED
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: ck_live_*
      description: 'API keys issued from https://pro.bitcompare.net/dashboard/keys. Send as `Authorization: Bearer ck_live_...`.'
externalDocs:
  description: Developer documentation
  url: https://docs.bitcompare.net